srandomrtp

SAVE ALL YOUR PLUGIN(SRANDOMRTP)

DATA BEFORE UPDATING!!!!!!!!!!!!!!!!

New Commands Added!

1. The following admin/support commands have been added:

/rtp settings /rtp doctor /rtp dump /rtp stats /rtp portal check /rtp tpsbar

/rtp rambar /rtp msptbar /rtp allbars

1.1. /rtp settings - opens a clickable in-game menu for enabling or disabling plugin subcommands. Permission: sRandomRTP.Command.Settings Default: disabled in Settings/commands.yml

1.2. /rtp doctor - shows the plugin health status: Java version, server version, Paper/Folia, language, optional plugins, config versions, active RTP searches, portal tasks, and admin bossbar status. Permission: sRandomRTP.Command.Doctor Default: disabled in Settings/commands.yml

1.3. /rtp dump - creates a support zip in plugins/sRandomRTP/Diagnostics with diagnostics, recent errors, and runtime information. Permission: sRandomRTP.Command.Dump Default: disabled in Settings/commands.yml

1.4. /rtp stats - shows live runtime statistics: active searches, total RTP count, cooldowns, portal tasks, completed/cancelled/refunded teleports, and average search timings. Permission: sRandomRTP.Command.Stats Default: disabled in Settings/commands.yml

1.5. /rtp portal check - checks portals for missing worlds, duplicate world + portal names, and active portal tasks. Permission: sRandomRTP.Command.Portal.Check Default: disabled in Settings/commands.yml

1.6. /rtp tpsbar, /rtp rambar, /rtp msptbar, /rtp allbars - optional admin bossbars for TPS, RAM, MSPT, or all bars at once. Permissions: sRandomRTP.Command.TpsBar, sRandomRTP.Command.RamBar, sRandomRTP.Command.MsptBar, sRandomRTP.Command.AllBars Default: disabled in Settings/commands.yml

New Stability Features!

1. Chunk warming, portal particles/triggers, admin bossbars, and update-check callbacks now avoid unsafe async Bukkit API access.

2. RTP counting is now saved in batches instead of writing Data/rtpCount.yml after every teleport.

3. Cooldown-bypass teleports are counted correctly.

4. Cooldown permissions such as sRandomRtp.Cooldown.N now work more consistently and also affect the bossbar countdown.

5. Reload now sends a successful reload message after the plugin finishes reloading.

6. /rtp cancel, movement cancellation, duplicate RTP requests, player quit during teleport, and refund handling were made safer.

7. Fixed Minecraft version detection for the new Java Edition version scheme, including 26.1, 26.1.1, and newer 26.x builds.

Configuration & Localization Update!

config.yml: added diagnostic, Command-Aliases-Enabled, Command-Aliases, metrics.rtp.slow-request-threshold-ms, and updated permission comments.

Settings/commands.yml: added runtime switches for /rtp settings, /rtp doctor, /rtp dump, /rtp stats, /rtp portal check, and admin bossbar commands. These debug/admin commands are disabled by default.

Settings/admin-bars.yml: added configurable TPS, RAM, and MSPT bossbars with titles, colors, styles, thresholds, and messages.

Settings/biome.yml: added a dedicated profile for /rtp biome search behavior.

Settings/teleport.yml: added safer search and chunk options, including parallel-search and prefer-generated-chunks settings.

plugin.yml: permissions were expanded for the new commands, and static aliases were removed from plugin.yml.

Command aliases were moved to config.yml:

Command-Aliases-Enabled: false Command-Aliases:

• randomtp
• randomteleport

Aliases are disabled by default. Set Command-Aliases-Enabled to true if you want /randomtp and /randomteleport to work.

Localizations in lang/*.yml were extended for:

/rtp settings, /rtp doctor, /rtp dump, /rtp stats, /rtp portal check, admin bossbars, invalid-command, reload success messages, and updated help lines.

Small Changes!

1. LuckPerms is no longer required as a hard dependency; optional integrations now fail more gracefully.

2. The unknown-command message is now configurable through localization instead of always using the server default.

3. Config updates now create backups and write Diagnostics/config-changes.txt.

4. Startup, reload, config-change, backup, and slow RTP diagnostics now run only when diagnostic: true is enabled.

5. Portal storage, portal cleanup, portal particles, and portal cooldown handling were improved.

6. PlaceholderAPI values and public RTP/portal events were added for integrations.

7. Auto-reload now applies config.yml language/diagnostic/alias changes and Settings/commands.yml command switches after saving the file.

Important for Server Owners!

1. Player RTP commands stay enabled by default. The new support/debug commands and admin bossbars are disabled by default, even for OP, until you enable them in Settings/commands.yml or through /rtp settings after enabling that menu.

2. /rtp settings is also disabled by default. To manage command switches in-game, first set commands.admin.settings.enabled: true in Settings/commands.yml.

3. /rtp doctor, /rtp dump, /rtp stats, /rtp portal check, /rtp tpsbar, /rtp rambar, /rtp msptbar, and /rtp allbars are intended for server owners, administrators, and support/debug use. Regular players do not need them for normal RTP gameplay.

4. diagnostic: false is the default. With this setting, the plugin will not create Diagnostics files automatically. Enable diagnostic: true only when you want full startup/reload/config-change/slow-RTP reports.

5. Command aliases are also disabled by default. Enable Command-Aliases-Enabled: true in config.yml if you want /randomtp and /randomteleport.

6. Existing configs are migrated without overwriting your custom values. As usual, make a backup before updating a production server.

Notes

Update 3.1 is mainly a stability, diagnostics, and compatibility update after the large 3.0 release. Most new admin/support commands are disabled by default, so normal players will keep using the plugin like before unless you enable those tools in Settings/commands.yml.

Please report bugs on the Discord server or create a GitHub issue.

New Commands Added!

1. The following commands have been added:

2. /rtp far

3. /rtp middle

4. /rtp portal set

5. /rtp portal del

6. /rtp portal list

7. /rtp chunky

8. /rtp chunky stop

9. /rtp player [world]

10. /rtp biome <biome|biome1,biome2>

• 1.1. /rtp far — teleports you farther than the default /rtp, using the radiuses from far.yml.
• Permission: sRandomRTP.Command.Far
• 1.2. /rtp middle — teleports you a bit farther than the default /rtp, using the radiuses from middle.yml.
• Permission: sRandomRTP.Command.Middle
• 1.3. /rtp portal <set|del|list> — creates and manages protected portals (circle/square) with particles and materials from the config, plus a personal cooldown.
• Permission: sRandomRTP.Command.Portal
• 1.4. /rtp chunky <radius|stop> — starts or stops chunk pre-generation via Chunky directly from the plugin (Chunky plugin required).
• Permission: sRandomRTP.Command.Chunky
• 1.5. /rtp player [world] — can send a player to another world, respects blocked worlds and sends notifications/redirects.
• Permission: sRandomRTP.Command.Player
• 1.6. /rtp biome <biome1,biome2> — you can now specify one or multiple biomes for teleportation.
• Permission: sRandomRTP.Command.Biome

New Teleport Features!

• 1. Separate radius presets: base (teleport.yml), medium (middle.yml), and far (far.yml).
• 1. Y-level limits for Overworld/Nether/End, automatic blocking of cave and ocean/river biomes, and protection from teleporting outside the world border.
• 1. Search timeouts (attempt/total), parallel coordinate selection, and the long-teleport-wait hint so searching doesn’t feel stuck.
• 1. Chunk warming and chunk pre-loading (chunk-warming/chunk-loading) for smoother teleports on Paper and Folia.
• 1. Portals can execute commands on enter and can optionally start RTP into a specified world immediately.
• 1. And much more!

Configuration & Localization Update!

1. config.yml: Disable-Moved-Too-Quickly-Messages, short language codes (en, ru, ...), updated permissions list.
2. teleport.yml: minY, minY-nether, minY-end, block-cave-biomes, block-ocean-river-biomes, per-world radiuses, coordinate-generation, use-absolute-coordinates, parallel-search, teleport-timeout, break-block-cancel-rtp, and redirects for blocked worlds.
3. far.yml and middle.yml: separate radiuses and generation shapes for the new commands.
4. portal.yml: portal materials/particles, block protection, cooldown after jumping, and a list of commands on enter.
5. chunk-loading.yml: pre-loading around the target point, timeouts, limits, and a warm-up scheduler.
6. near.yml: simplified radiuses for /rtp near.

Localizations were moved to lang/*.yml and extended with new keys:

• long-teleport-wait, titleMessage-loading/subtitleMessage-loading, worldborder-error, redirect-world/rederictworldnear-error;
• full message set for portals, block protection, Chunky, extended hints for /rtp player, and the %y% placeholder in teleported/title/subtitle.

Small Changes!

• 1. Logging is now more flexible, and you can suppress “moved too quickly” spam in the console.
• 1. Teleport messages now display the Y coordinate and include new hints for long searches.
• 1. Fixed repeated /rtp player requests, sending to blocked worlds, portal deletion, and handling when WorldGuard/Vault/Chunky are missing.
• 1. Added checks for invalid radiuses, portal names, and empty list pages to prevent crashes or freezes.
• 1. Many small optimizations to teleport safety and task management.

Notes

Update 3.0 took a very long time to make, so some things may have been missed. Please report bugs on the Discord server or create a GitHub issue.