Skip to main content

Troubleshooting

Plugin Fails to Start​

Check: The server console for an error on startup.

Common causes:

  • Running on Spigot or CraftBukkit instead of Paper/Folia.
  • Java version below 21.
  • Corrupt jar — re-download and try again.

Commands Not Found​

Symptom: /tpa, /home, /warp, etc. show "Unknown command".

Causes and fixes:

  1. Module disabled — check modules.tpa/home/warp in config.yml. If a module is false, its commands are not registered.

  2. Essentials conflict — if Essentials is installed, it may be claiming /home or /warp. Set the relevant command-overrides entries to true:

    command-overrides:
      home: true
      warp: true

    Then restart (not just /tpreload).

  3. Plugin not enabled — check the console for a startup error. The plugin silently skips features it cannot load rather than crashing.

Tab Completion Not Working for /tpa​

This typically means another plugin (usually Essentials) owns the /tpa command name.

Fix: set command-overrides.tpa: true and restart.

Economy Not Charging / Showing Errors​

  1. Confirm economy.enabled: true in config.yml.
  2. Confirm Vault is installed and a compatible economy plugin is present.
  3. Run /vault-info to check if Vault detected your economy plugin.
  4. Check console for errors on startup.

Lands Integration Not Working​

  1. Confirm Lands is installed and loaded before TeleporterPro.
  2. Check console on startup for: Lands integration enabled — land entry checks active.
  3. Confirm integrations.lands.enabled: true in config.yml.
  4. Check debug: true in config.yml and watch console logs during a TPA attempt.

Home Limits Not Updating After Rank Change​

If limits are not updating in real-time:

  1. Confirm LuckPerms is installed.
  2. Check console on startup for: LuckPerms permission-change hook enabled for home enforcement.
  3. Ensure home.over-limit-checks.luckperms-events.enabled: true in config.yml.
  4. If not using LuckPerms, enable the periodic check as a fallback: 
    home:
      over-limit-checks:
        periodic:
          enabled: true
          interval-minutes: 5

PlaceholderAPI Placeholders Showing Raw Text​

  1. Confirm PlaceholderAPI is installed.
  2. Check console on startup for: PlaceholderAPI integration enabled.
  3. Make sure you are using the correct placeholder format: %teleporterpro_home_count% (with % signs, not {}).

Bedrock Players Not Getting Forms​

  1. Confirm Floodgate is installed (the Floodgate component of Geyser, not just Geyser proxy-side).
  2. Check console on startup for: Floodgate detected - Geyser Bedrock form support enabled.
  3. Bedrock players must be connecting through Geyser. This does not apply to Java-edition players regardless of client.

Changes in config.yml / messages.yml Not Taking Effect​

Run /tpreload after saving the files. Most settings apply immediately.

Exception: modules, command-overrides, and any changes that add or remove registered commands require a full server restart.

Teleport Cancelled by Lands After Acceptance​

This is expected behavior when integrations.lands.block-on-execute: true.

  • The destination land's entry flag is off for the teleporting player.
  • Both players receive a cancellation message.
  • No economy charge is applied.

To disable this check while keeping the warning: set block-on-execute: false.

Need More Help?​

Enable debug logging:

debug: true

This prints detailed information to the console for every teleport attempt, economy check, and Lands check. Reproduce the issue and share the relevant console output.