Skip to content

What NOT to do!

Because common sense is not common, this page collects the things that go wrong with this plugin. They fall into two very different buckets, so they are split below:

Read the config files first

PLEASE read the configuration files in your RTP folder (also visible in this repository's resource folder) before asking for setup support. A lot of information is easily accessed and well described within the configuration files.

This will break the mod entirely

These mistakes prevent teleportation from working correctly.

Don't blacklist every biome (or whitelist zero biomes)

If no biome is eligible, every teleport attempt has nowhere valid to land, so teleportation fails outright. Always leave at least one usable biome.

Don't run conflicting /wild or /rtp providers together

Mixing plugins that both register /wild or /rtp without resolving the command conflict means the wrong plugin (or no plugin) may answer the command. Resolve the command conflict before running both.

Don't delete the default region/world configuration

LeafRTP uses the default region and world entries as the template for any new world or region. Removing them leaves the plugin with nothing to build from, and it will not behave correctly. See Intended usage.

Why is this running slowly?

These setups work, but they make teleports expensive - either lagging the player who teleports or stalling the whole server.

Don't pass dynamic parameter overrides to regular players

Passing dynamic override parameters (shape=, radius=, centerX=, centerZ=, etc. under the rtp.params permission) constructs an ephemeral, throwaway region on the fly. Because temporary regions are uncached and have no persistent spatial memory, every invocation forces on-demand chunk loading and real-time safety verification. Keep dynamic parameters restricted to staff testing, and configure permanent named regions for everyday player use.

Don't wire override parameters into player commands, signs, or portals

Override parameters (shape=, radius=, centerX=, ...) build a throwaway temporary region that is uncached and remembers no past failures, so every call pays full generation cost and can stall under load. Use them only to test settings, then bake them into a real named region and point players at a plain /rtp. (Targeting an existing region with world=<name> or region=<name> is fine - those stay cached.) See Intended usage.

Don't over-restrict biomes

Blacklisting most biomes (or whitelisting only a few) leaves so few valid landing spots that the engine has to reject many candidates before finding one, which causes major lag during teleportation even when it eventually succeeds. (Restrict all of them and you cross into the "breaks entirely" bucket above.)

See also