WildRTP
WildRTP - Another RTP Plugin build on Performance & Features
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
WildRTP
WildRTP
- Algorithms CIRCLE & SQUARE - Adjust teleport settings - Multi Worlds Support - Cooldown - MoveTimer - CustomRTP - AutoRTP
Please let me know if you have any issues
Commands
- /wild - Teleport to a random location
Aliases: [/rtp /randomtp /randomteleport /wildrtp] - /wild reload - Reloads the config
- /wild info - Display plugin information - /wild updates - Checks for plugin updates - /wild help - Display help message - /customrtp <player> <world> <startRadius> <endRadius> <originX> <originZ> [params...]
Note optional arguments are optional arguments, optional arguments are only optional arguments and can be omitted.
%player% is a placeholder for the player that executed the command (only in /customrtp).
Permissions
- wildrtp.rtp - Allows you to run /wild - Default
- wildrtp.reload - Allows you to run /wild reload - wildrtp.updates - Allows you to run /wild updates - wildrtp.custom - Allows you to run /customrtp - wildrtp.cooldown.bypass - Bypass the cooldown, if enabled
- wildrtp.movetimer.bypass - Bypass the movetimer, if enabled
- wildrtp.list.bypass - Bypass the list of disallowed worlds - wildrtp.list.bypass.world_name - Bypass a specific world from the list of disallowed worlds
(blacklist or whitelist, whichever is enabled) - wildrtp.help - Allows you to run /wild help - wildrtp.admin - Grants all WildRTP permissions
Config
Show config
```
__ ___ _____ _______ _____
/ (_) | | | __ __ __| __
/ / / _| | __| | |__) | | | | |__) |
/ / / | | |/ ` | / | | | ___/
/ / | | | (_| | | | | | |
/ / |||__,|| || |_|
#
by Joni - Thank you for using this plugin
Language setting
Available: [en, de, ru]
You can add/edit languages in the plugin folder (/lang)
lang: "en"
Global RTP settings
This section defines the main settings for random teleportation
Custom settings per world can be defined in the custom section
If 'something: null' is present, and you want to use that feature, remove null and add your settings
global:
Min & max teleportation range
min: 1000 max: 2500
Shape of the teleportation area [CIRCLE/SQUARE]
shape: CIRCLE
Teleportation center
center: player: false # If true, teleportation is centered on the player x: 0 # X coordinate of center z: 0 # Z coordinate of center
Cooldown settings
cooldown: enabled: true # Enable cooldown between RTP uses time: 5 # Cooldown time in seconds
Move timer settings
movetimer: enabled: true # If true, no movement allowed before teleportation time: 5 # Time in seconds sound-canceled: ENTITY_VILLAGER_NO # Set to 'false' to disable.
Message settings
messages: start: false # Show message when RTP starts end: true # Show message when RTP ends
Title messages displayed when RTP starts/ends
titles: start: enabled: false fadeIn: 0.5 stay: 2 fadeOut: 0.5 end: enabled: true fadeIn: 0.5 stay: 2 fadeOut: 0.5
Sound settings
sound: start: false # Play a sound when teleport starts. Set to 'false' to disable. end: ENTITY_PLAYER_LEVELUP # Use any valid Bukkit Sound enum, e.g., ENTITY_PLAYER_LEVELUP.
Blocks to avoid when teleporting
blocks: - LAVA - WATER - AIR
Y-limits for teleporting
y-min: null y-max: null
Biomes to avoid when teleporting
Example: biomes: [OCEAN, DESERT, PLAINS, FOREST, TAIGA, MUSHROOM_FIELDS, JUNGLE]
Set to 'null' to disable.
biomes: null
Teleport to another world
If set to a valid world name, players will be teleported to that world instead of their current one.
Set to 'false' to teleport within the same world.
tp-in-other-world: false
RTP generation strategy used to determine how safe locations are found.
This controls the algorithm used to pick valid teleport positions.
#
Available strategies:
AUTO - Automatically chooses the best strategy based on world environment.
HIGHEST_BLOCK - Uses the highest non-air block. Extremely fast. Perfect for normal Overworld and The End.
BOTTOM_UP - Scans from minY upwards for a solid block with space above it. Essential for the Nether or Cave worlds.
TOP_DOWN - Scans from maxY downward.
#
Recommended: AUTO (handles most worlds correctly without configuration)
strategy: AUTO
Auto-RTP settings
Should the plugin teleport players automatically?
auto-rtp: onfirstjoin: false # When a player first joins the server onjoin: false # Every time a player joins the server ondeath: false # After a player dies
List mode: use 'blacklist' or 'whitelist'
list: blacklist
Set to 'null' to disable the blacklist.
blacklist: null # Add blocked worlds here
- my_blacklisted_world
Set to 'null' to disable the whitelist.
whitelist: null # Add allowed worlds here
- my_whitelisted_world
Uncomment and modify to customize settings for specific worlds
YOU CAN remove any fields you don’t want to customize,
BUT missing values will be set to the global values
(e.g. max in global is 1000 and if not set here it will be 1000 as well)
An example is shown below:
custom: null
custom_world_name:
min: 1000
max: 2500
shape: CIRCLE
center:
player: false
x: 0
z: 0
cooldown:
enabled: true
time: 30
movetimer:
enabled: true
time: 5
sound-canceled: ENTITY_VILLAGER_NO
messages:
start: false
end: true
titles:
start:
enabled: false
fadeIn: 0.5
stay: 2
fadeOut: 0.5
end:
enabled: true
fadeIn: 0.5
stay: 2
fadeOut: 0.5
sound:
start: false
end: ENTITY_PLAYER_LEVELUP
blocks:
- LAVA
- WATER
- AIR
y-min: null
y-max: null
biomes: null
tp-in-other-world: false
strategy: AUTO
Maximum attempts to find a safe location before failing
max-tries: 25
If you want to change the prefix, you can do it here
prefix: "[&2WildRTP&f] &6"
Hook settings for third-party plugins
hooks: worldguard: enabled: false # When enabled, checks if a location is inside any protected region and skips it if so protectionstones: enabled: false # When enabled, checks if a location is inside any protected region and skips it if so towny: enabled: false # When enabled, checks if a location is claimed and skips it if so residence: enabled: false # When enabled, checks if a location is claimed and skips it if so
Check for updates
check-updates: true
Notify admins about plugin updates when they join
notify-updates-on-join: true
If I am allowed to collect anonymous data about your server and this plugin. So I can see how many servers are using this plugin :)
Learn more https://bstats.org/
And you can see the data as well here https://bstats.org/plugin/bukkit/WildRTP/17799
metrics: true
Advanced settings
force-close-inventories: true per-world-cooldowns: false
Debug mode
debug: false
Config version (do not change)
config-version: 10 ```
Placeholders
To view both internal external placeholders and external placeholders, please visit the external placeholders.
Integrations
- WorldGuard - ProtectionStones - Towny - Residence
Performance
Using async chunk loading on paper servers should have no impact on the performance besides the time it takes to load a chunk async. You can use Chunky to pre-generate chunks, which makes the teleporting maybe a bit faster.
Need help?
If you need any help, feel free to join my discord support server, or if you have found a bug, you can also use the github issue system. If you have a feature request, you can also make a request via discord or github.