WildRTP
- CIRCLE & SQUARE Shapes
- 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
[params...] - /customrtp
- /customrtp
Note <> are required arguments, [] are only optional arguments and can be omitted. %player% is a placeholder for the player that executed the command (only in /customrtp).
Integrations
- WorldGuard
- ProtectionStones
- Towny
- Residence
- GriefDefender
- GriefPrevention
- Lands
- Vault
Addons
- WildRTP GUI
- WildRTP Fights (coming soon)
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
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 and z will be ignored
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.
# Effect settings
effects:
start: # Give an effect when teleport starts.
type: false # Set to 'false' to disable. Use any valid Bukkit PotionEffectType enum, e.g., "BLINDNESS".
time: 1 # Duration in seconds for the effect to last.
end:
type: false
time: 1
# Blocks to avoid when teleporting
# Use LEAVES to disable all teleports in leaves.
blocks:
- LAVA
- WATER
- AIR
# Y-limits for teleporting
# null = no limit
y-min: null
y-max: null
# Biomes to avoid when teleporting
# Example: biomes: [OCEAN, DESERT, PLAINS, FOREST, TAIGA, MUSHROOM_FIELDS, JUNGLE]
# Set to '[]' to disable.
biomes: [ ]
# 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
# If true, the player's individual spawn point will be set to the new location upon teleporting.
# Set to 'false' to disable.
set-spawnpoint: false
# Custom teleportation command to execute before/after teleporting.
# %player% = player name
# %x%, %y%, %z% = teleportation coordinates
# Example: start: [ "say %player% is teleporting to %x%, %y%, %z%", "give %player% minecraft:ender_pearl 1" ]
custom-command:
start: [ ]
end: [ ]
# 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 the 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:
enabled: false # After a player dies
prioritize-bed: false # If true, players will be teleported to their bed spawn point if they have one set.
# List mode: use 'blacklist' or 'whitelist'
list: blacklist
# Set to '[]' to disable the blacklist.
# Add blocked worlds here
blacklist: [ ]
# Set to '[]' to disable the whitelist.
# Add allowed worlds here
whitelist: [ ]
# 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 2500 and if not set here it will be 2500 as well)
# To enable, remove { } and add your worlds below:
# A short example is shown below:
custom: { }
# my_custom_world:
# min: 500
# max: 1500
# cooldown:
# time: 30
# biomes: [OCEAN, DESERT]
# 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: "&8[&2WildRTP&8] &6"
# Hook settings for third-party plugins
hooks:
worldguard: false
protectionstones: false
towny: false
residence: false
griefdefender: false
griefprevention: false
lands: false
vault:
enabled: false
settings:
pay-by-distance:
enabled: false
price-per-block: 0.01
pay-by-teleport:
enabled: false
price: 5.0
# 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 :)
# 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
prevent-spam: true # Block multiple searches while one is in progress
# Debug mode
debug: false
# Config version (do not change)
config-version: 18
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
Placeholders
To view both internal placeholders and external placeholders, please visit the wiki.
Performance
Using async chunk loading on paper servers should have no impact on the performance besides the time it takes to load or generate a chunk async. You can use Chunky to pre-generate chunks, which makes the teleporting a bit faster.
Need help?
If you need any help, I'd be delighted to help you – just join my Discord support server. If you have found a bug or a feature you would like to request, please get in touch – I can't wait to hear from you!
bStats
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
|
R
4.0
|
22h ago | 1 | |||
| 22h ago | 1 | ||||
|
R
3.7
|
22h ago | 1 | |||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
|
R
3.6.5
|
22h ago | 1 | |||
|
R
3.6.4
|
22h ago | 1 | |||
|
R
3.6.3
|
22h ago | 1 | |||
|
R
3.6.2
|
22h ago | 1 | |||
|
R
3.6.1
|
22h ago | 1 | |||
|
R
3.6
|
22h ago | 1 | |||
|
R
3.5
|
22h ago | 1 | |||
|
R
3.4.3
|
22h ago | 1 | |||
|
R
3.4.2
|
22h ago | 1 | |||
|
R
3.4.1
|
22h ago | 1 | |||
| 22h ago | 1 | ||||
|
R
3.4
|
22h ago | 1 | |||
|
R
3.3.5
|
22h ago | 1 | |||
|
R
3.3.4
|
22h ago | 1 | |||
|
R
3.3.3
|
22h ago | 1 | |||
|
R
3.3.2
|
22h ago | 1 | |||
|
R
3.3.1
|
22h ago | 1 | |||
|
R
3.3
|
22h ago | 1 | |||
|
R
3.2.3
|
22h ago | 1 | |||
|
R
3.2.2
|
22h ago | 1 | |||
|
R
3.2.1
|
22h ago | 1 | |||
|
R
3.2
|
22h ago | 1 | |||
|
R
3.1.3
|
22h ago | 1 | |||
|
R
3.1.2
|
22h ago | 1 | |||
|
R
3.1.1
|
22h ago | 1 | |||
|
R
3.1
|
22h ago | 1 | |||
|
R
3.0
|
22h ago | 1 | |||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 |
- Added max: world-border automatically uses the available radius inside a world’s border
- Added optional RTP location caching to reduce repeated safe-location searches. Cached locations are validated again before teleporting, with optional keep loaded chunks.
- Added reusable profiles for shared RTP settings across worlds and destinations.
- Added named /rtp <destination> commands through configurable destinations, including per-destination overrides.
- Added round-robin for tp-in-other-world: [mining_1, mining_2] alternates RTPs between listed worlds. Usefull for "load-balancing" between worlds.
- Added a small public WildRTPApi for plugins and addons to trigger config-driven RTP without using internal services.
- Added /wild performance, with an in-game inventory dashboard for RTP timing, cache statistics, cache pools, held chunks, and per-world measurements. This is op-in and does have near zero performance impact when disabled. However it is useful for analytics for your server performance when rtp is used.
- improved vaulthook
- added vault options to customrtp
- added vault option for cross world tp charge
- GriefPrevention hook
- Lands hook
- Vault hook
- refactor
- compability to WildRTP GUI 1.4
- error tracking with faststats (anonymous)
- updated checking for updates
- improved logging messages
- updated bstats
- added faststats
- added ondeath prioritize bed respawn
- fixed wrong rtp world in autortp ondeath
- PATTERN FOR HEX COLOR CHANGED FROM &#HEEEX TO <#HEEEX>**
- => to improve readability in config
- other small internal changes
- spawnpoint now applies to autortp if enabled
- prevents rtp outside of world border now
- promoted to stable
- added set spawn point on rtp (won't work with autortp currently)
- improved customrtp cmd, see [wiki](https://github.com/LasaJoniHD/WildRTP/wiki/CustomRTP-Command-Reference)
- BETA! This isn't fully tested yet, bugs could exists
- major refactor of code base (command logic)
- improves maintainability
- fixed minor bugs
- improved code base
- added more placeholders
- %wildrtp_player_cooldown_<world>%
- %wildrtp_world_cooldown_time_<world>%
- %wildrtp_world_movetimer_time_<world>%
- fixed residence hook
- residence hook
- fixed comments in config.yml
- improved update checking
- per world cooldowns
- imrpoved cooldowns
- improved customrtp and it's tab completion
- force close inventories on teleport (glitch prevention)
- strategies: allow changing the strategy used to determine how safe locations are found (AUTO, HIGHEST_BLOCK, BOTTOM_UP, TOP_DOWN)
- updated some config comments
- delay:seconds as an optional parameter for customrtp command that delays the rtp for seconds
- towny hook
- new PlaceholderAPI placeholder: %wildrtp_player_cooldown_time%
- added ProtectionStones Hook
- fixed hex color support to allow both uppercase and lowercase patterns
- added \n support in language files
- improved /wildrtp help
- added more internal Placeholder to lang files [(click here to see them all)](https://github.com/LasaJoniHD/WildRTP/wiki/Placeholders)<br><br>
- new permissions:
- wildrtp.admin - Grants all WildRTP permissions
- wildrtp.list.bypass - Bypass the list of disallowed worlds
- wildrtp.list.bypass.world_name - Bypass a specific world from the list of disallowed worlds
- added more Placeholder [(click here to see them all)](https://github.com/LasaJoniHD/WildRTP/wiki/Placeholders)
- added Russian translation (ru.yaml) provided by vanapro1
- some internal refactoring
- fixed tab complete not exposing world names when not having wildrtp.custom