WildRTP

WildRTP - Another RTP Plugin build on Performance & Features

65,41k

Quick challenge

How far can you run before the mobs catch you?

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.

bStats

ADS