AlphaTPAHelpTroubleshooting

Troubleshooting

The problems server owners actually hit, matched to the console line or symptom you will see.

On this page

Check the server console first. Each card gives the symptom, the likely cause and the fix.

Startup

Console: AlphaTPA is disabled — this server is waiting for approval.

Cause: A new server starts as pending, and the plugin stays off until AlphaStudio approves it.
Fix: Send the server id from the next console line to AlphaStudio, then restart once it is approved. See Server approval.

Console: … was outdated (version X < Y)

Cause: A bundled menu or message file has a higher file-version than yours, so the plugin replaced it with the new default.
Fix: Your old file is saved next to it as *.old. Copy your edits across. If you see Could not back up, the folder was not writable.

Console: Took over N command label(s) from other plugins

Cause: Normal when CMI or EssentialsX is installed. features.override-conflicts is on.
Fix: Nothing to do. Set override-conflicts: false if you want the other plugin's /tpa instead.

/tpa runs another plugin's command

Cause: features.override-conflicts is false, or the other plugin re-registered its labels after AlphaTPA loaded.
Fix: Turn the option on, and restart so AlphaTPA loads after CMI and EssentialsX. The other plugin's namespaced commands such as essentials:tpa still work.

A player cannot send a request

Cause: One of: the target turned requests off with /tpatoggle or /tpaheretoggle; the sender is on the request.cooldown for that target; they hit request.daily-limit or request.max-outgoing; or a world is in teleport.blocked-worlds.
Fix: Check those settings. Grant alphatpa.bypass.cooldown or alphatpa.bypass.limit to people who should skip a limit. Operators do not skip them automatically.

The accept menu does not open on its own

Cause: gui.popup-on-request is false by default. The target gets the chat message first, and the menu opens when they click [accept] or run /tpaccept.
Fix: Set popup-on-request: true if you want it to pop up. Players who ran /tpaguitoggle never get the menu.

The countdown cancels straight away

Cause: teleport.allowed-walk-range is 0, so any change of block cancels it, including being pushed. Taking damage cancels it too.
Fix: Raise allowed-walk-range, or turn off cancel-on-damage.

The teleport is refused at the last moment

Cause: No safe spot was found within search-radius and search-vertical, or the destination player is flying and cancel-if-destination-flying is on.
Fix: Raise the search distances, or turn the flying check off.

Operators still wait for the countdown

Cause: By design. The bypass nodes are false even for ops.
Fix: Grant alphatpa.bypass.warmup through your permissions plugin. See Permissions.