[1] **NEW FEATURE**: Economy Refund System - Players automatically refunded if RTP fails after payment
[2] **NEW FEATURE**: RTP Matchmaking Queue - Players can queue together for PvP duels (1v1, 2v2, etc.)
[3] **NEW FEATURE**: Console Send Location Command - Admins can teleport players to specific coordinates
[4] NEW: `economy.refund_on_fail` config option (default: true) - enables automatic refunds on failure
[5] NEW: Complete matchmaking system with `/rtp queue join/leave/status` commands
[6] NEW: `/rtp sendlocation <x> <y> <z> <world> <player>` admin command for precise teleports
[7] NEW: Matchmaking configuration section with team_size, spread_distance, tick_interval, queue_timeout
[8] NEW: VaultHook.depositPlayer() method for economy refunds
[9] IMPROVED: Economy system now handles failed teleports gracefully with automatic refunds
[10] IMPROVED: Players can find dueling partners via matchmaking queue system
[11] IMPROVED: Admins have more control with direct coordinate teleportation
[12] CONFIG: New `matchmaking` section with full queue configuration options
[13] CONFIG: New `economy.refund_on_fail` option for failed RTP refunds
[14] MESSAGES: Added 14+ new message keys for matchmaking, refunds, and sendlocation
[15] PERMISSIONS: New `justrtp.command.rtp.matchmaking` permission for queue access
[16] PERMISSIONS: New `justrtp.bypass.default_world` permission added
[17] COMPATIBILITY: Fully backward compatible - all new features are optional
[1] **NEW FEATURE**: Auto-open GUI option - `/rtp` can now automatically open the GUI instead of direct teleport
[2] **IMPROVED**: Disabled by default to preserve traditional `/rtp` behavior
[3] **FEATURE**: Hub servers can force players to choose worlds visually via auto-open GUI
[4] **FEATURE**: Traditional `/rtp <world>` commands still work for direct teleportation
[5] **FEATURE**: Added command alias support – `/rtp base` can now be configured as an alternative command
[6] **FEATURE**: WorldGuard support for `/rtp nearclaim` – allows RTP near protected regions
[1] **NEW FEATURE**: Smart cost formatting - displays clean numbers (100 instead of 100.00)
[2] **NEW FEATURE**: Separate actionbar message for teleport delay countdown
[3] **FIXED**: RTP GUI now enabled by default in config
[4] **FIXED**: Type casting errors in GUI system resolved
[5] **IMPROVED**: Cost display shows 100, 100.5, or 100.25 based on actual value
[6] **IMPROVED**: Cleaner economy messages throughout the plugin
[7] ENHANCED: FormatUtils helper class for consistent number formatting
[8] STABILITY: Enhanced reliability for GUI and update checker systems
[1] **NEW FEATURE**: Added configurable dynamic pitch toggle for delay countdown sounds
[2] **NEW FEATURE**: Delay sounds can now keep constant pitch by setting `dynamic_pitch: false`
[3] **NEW FEATURE**: Cross-server RTP support added to GUI system
[4] **NEW FEATURE**: GUI world buttons can now teleport to other servers via `server_name` configuration
[5] **NEW FEATURE**: Added `<server>` placeholder to GUI lore (shows "Local" or server name)
[6] IMPROVED: Enhanced RTP GUI with network-wide teleportation capabilities
[7] IMPROVED: Delay sound system now more customizable with static pitch option
[8] IMPROVED: Cross-server GUI buttons automatically use `/rtp <server>:<world>` format
[9] IMPROVED: GUI lore dynamically shows server information for cross-server worlds
[10] CONFIG: Added `dynamic_pitch` option to `effects.teleport_delay_sound` section
[11] Full backward compatibility with existing configurations
[12] Cross-server GUI teleportation functions properly with MySQL proxy
[13] OPTIMIZED: Server placeholder efficiently shows local vs remote server status
[1] CRITICAL FIX: Chunk generation corruption causing flat borders, missing chunks, and weird terrain generation
[2] CRITICAL FIX: Removed problematic chunk preloading that was causing corruption
[3] CRITICAL FIX: Now relies on PaperLib.teleportAsync() for safe chunk loading/generation
[4] 1.21+ FIX: Updated Registry.BIOME to use modern RegistryAccess API (deprecated API removed)
[5] IMPROVED: Works perfectly in both explored AND unexplored worlds
[6] IMPROVED: Enhanced Folia 1.21.11 and Paper 1.21+ full compatibility
[7] IMPROVED: PaperLib handles chunk generation safely with neighbor chunk loading on 1.15+
[1] Added option to disable the Update Checker and message: `c
heck_for_updates:`, `
notify_ops_on_update` in config.yml
[1] FIXED: Holograms disappearing after player teleportation (RTP) - now properly refresh visibility on world change and teleport events
[2] FIXED: Display entity holograms not respawning when chunks unload - added entity validity checks to detect dead holograms
[3] FIXED: PacketEvents holograms not updating for players after teleport - added automatic visibility refresh
[4] FIXED: FancyHolograms not refreshing for players after world change - added force update mechanism
[5] IMPROVED: Hologram healer task interval reduced from 5 seconds to 2 seconds for faster recovery
[1] NEW: Added RTP near online players feature with `/rtp nearplayer [world]` command
[2] NEW: Added SimpleClaimSystem hook integration for region protection
[3] NEW: Configurable nearplayer settings (min/max radius, silent mode, self-targeting)
[4] NEW: Tab completion and help integration for nearplayer command
[5] FIXED: Issue where Cross Server teleports did not respect custom max Radius correctly
[1] CRITICAL FIX: Resolved infinite teleport loop race condition in async queue
[2] CRITICAL FIX: Resolved infinite teleport loop for non-OPs (bug in DelayManager)
[3] CRITICAL FIX: Removed duplicate "[JustRTP]" log prefix in console output
[4] FIX: Ensuring debug logging respects config reload immediately
[5] Updated internal dependencie for full Paper/Folia 1.21.11 compatibility
[1] Migrated entire logging system to categorized RTPLogger for professional diagnostics
[2] Implemented premium dynamic pitch feedback for teleport warmups (escalating pitch)
[3] Added multi-server target support for RTP Zones via comma-separated string lists
[4] Optimized sound and actionbar tasks to significantly reduce redundant config I/O
[5] Fixed -c flag logic to strictly enforce delay/cooldown regardless of bypass permissions
[6] Added logic for selecting random target servers per teleport wave in cross-server zones
[7] Standardized all console output with unified headers, banners, and status indicators
[8] Improved FancyHolograms integration stability during concurrent zone updates
[1] Fixed per-world permission group cooldowns overriding each other
[2] Prevented disabled command aliases from being registered or suggested
[3] Implemented permission-based filtering for the /rtp help command
[4] Added proper handling for disabling the /rtpzone command and improved its permission logic
[1] Fixed Issues with Permissions
[2] Fixed minor issues with folia
[3] Other small changes/improvements
[1] Fixed Issue about random players being teleported
[2] Fixed Issue with World Border
[3] Mostly minor improvements
[1] Probably fixed Folia Region bug
[2] Fixed enabled world error
[3] Fixed "-c" option in /rtp
[4] Small fixes & other adjustments
[1] Fancyholograms issue with not saving was fixed
[2] /rtp is not a default cmd anymore and requires 'justrtp.command.rtp' permission
[3] Fixed some bugs
[1] Probably fixed Issues with fancyholograms
[2] Added API ->
https://kotori.ink/wiki/justrtp/api
[3] Fixed Several Reload Issues
[4] Added KingdomX/Lands Support
[5] Added new config feature
[1] Added time formatting placeholder
[2] Implemented OP and permission-based cooldown bypass system
[3] Added ability to disable messages -> ("")
[4] New radius based pricing system with configurable tiers
[5] Added dynamic cost calculation based on player-selected radius
[1] Fixed Issues with Sounds
[1] Fixed Issue with 1.21.4 and below
[1] Added new Placeholders -> See Github
[2] Added Fancyholograms Support (Experimental - bugs may appear)
[3] Fixed Per World Cooldowns
[4] Updated dependencies to latest versions
[5] Updated Cooldown warnings (every second now)
[6] Small additional changes and fixes
- Fixed RTPZone (previously in a buggy state)
- Resolved a critical issue where materials like Snow, Grass, etc. were incorrectly identified as Air
- Fixed excessive console debug messages appearing even when debug mode was disabled
→ Critical errors will now always display debug information
- Fixed RTPZone
- Placeholders fixed
- updated github page
- Added Cross Server auto complete (server:world)
- Fixed RTPZone and overall Nether root teleporting
- You can now use packetevents for holograms (more optimized)
- Fixed some issues with redis and mysql
- Updated some messages and added tips
- Updated some yml files with clearer descriptions
- Fixed spawning on Nether Roof
- Updated and adjusted messages
- Fixed issues with Redis
- Optimized the plugin
- Fixed spam messages
- Added Redis (experimental, use with caution)
- Added Zone Sync
- New Features + QoL Stuff
- Fixed some bugs & issus
- Fixed Critical bug where players could teleport with having the permission justrtp.command.rtp.others.
- Probably fixed weird glitch where players teleported in a random world?!
- Fixed unlimited /rtp usages while teleport process.
Probably fixed a weird bug that teleports other players instead
of the caller
You can use <server>:<world> when teleporting
Added Version Checker
New Startup Design
on_leave title fixed
RTPzone hologram fixed
RTPZone teleportation fixed and optimized
Invalid/(blacklisted values are now not shown anymore in TabComplete
Small changes/fixed and more optimization
Improved Cross-Server Teleportation (RTP Zone):
Players within the same RTP zone are now grouped into a single queue. This allows the target server to preload chunks and teleport all players at the same time safely and efficiently.
Bug Fixes:
- Fixed an issue where holograms could stack incorrectly.
- Setting a message to "" in the config will now correctly result in a blank message.
New Config Option:
yaml
# Number of players to teleport from the queue each time it is processed.
# Increasing this value can significantly speed up teleports on busy servers.
queue_batch_size: 5
fixed Issues with new Versions
probaby fixed RTPZone multi player teleport
fixed END DImension teleportation
More Stable
Fixed Critical Bugs
[+] Added folia/paper 1.21.7 support
[+] Added World Aliases
[/] Fixed Folia Issue using RTP Zone (probably)
[/] More Fixes and Optimizations
- [/] Fixed and adjusted things
[+] Key Highlights
- ⚔️ NEW - Arena-Style RTP Zones: Create dynamic zones where all players inside are teleported together on a global timer to a random location in a target world or even another server! Perfect for automated PvP events, boss fights, or server-wide adventures.
- ✨ NEW - Persistent Zone Holograms: Place beautiful, customizable holograms at the center of your RTP Zones. They display a live countdown, persist through server restarts, and are managed with simple in-game commands.
- Reworked Cross-Server Teleportation: The entire proxy teleport system has been re-engineered for stability and performance, now fully supporting group teleports for RTP Zones across your network.
[/] New Features & Quality of Life
- Interactive Zone Setup: A new guided command, /rtpzone setup <id>, walks you through creating a complete arena zone step-by-step, including setting the teleport timer, target destination, and random teleport boundaries.
- Zone Effects Engine: Each RTP Zone can have its own unique set of effects. You can now configure:
- on_enter effects (titles/sounds) for when a player enters a zone.
- on_leave effects for when they exit.
- teleport effects that play for the entire group on teleport.
- Zone Ignore Command: Players can now use /rtpzone ignore to toggle whether they are included in zone teleports, giving them control over their experience.
- Server Aliases: You can now set user-friendly display names for your proxy servers in config.yml. The plugin will show "Survival" in messages instead of a technical name like "survival-1".
- Hologram Customization: The new holograms.yml file allows you to globally configure the text, line spacing, and particle effects for all zone holograms.
- Nether: Spawning in lava when teleporting in nether is now fully fixed.
[/] Command & Permission Updates
- New Commands Added:
- /rtpzone setup <id>
- /rtpzone sethologram <id> [y-offset]
- /rtpzone delhologram <id>
- /rtpzone ignore
- New Permissions Added:
- justrtp.admin.zone for all zone management.
- justrtp.command.zone.ignore for the player-facing ignore command.
[+] Key Highlights
- Teleport Cost Confirmation: A new optional /rtp confirm step can be enabled to avoid accidental charges when teleports cost money.
[-] Major Bug Fixes & Critical Improvements
- Cooldown Reset on Fallback: If a cross-server RTP fails, the player’s cooldown is instantly reset, and they’re notified.
[/] New Features & Quality of Life
- Teleport Cost Confirmation Toggle: New config option: economy.require_confirmation. When enabled, users must run /rtp confirm to accept a paid teleport.
- Improved "Cancel on Look" Sensitivity: The cancel_on_look feature now includes look_sensitivity_threshold in config.yml to fine-tune sensitivity.
[/] Behind the Scenes & Optimizations
- "Moved Too Quickly" Warning Fixed: Teleport logic is now more stable and reduces console spam. Smoother experience overall.
- Efficient Chunk Handling: Still uses fast asynchronous loading with PaperLib. Chunks are briefly loaded for checks only, no memory bloat or lag.
Key Features & Improvements
[+] Intelligent Command System
- Choose Your Commands: You are now in complete control. A new commands.yml file lets you enable or disable any command alias (/rtp, /wild, /randomtp, etc.).
- Clean and Conflict-Free: By disabling aliases you don't need, you ensure a smooth experience for your players and prevent confusing command overlaps.
[+] Comprehensive Bug Fixes & Stability Hardening
- 'Cancel on Look' Fixed: The long-standing bug where the cancel_on_look setting was ignored has been permanently resolved.
- 'Blacklist:' A new Blacklist/Whitelist feature is now live!
Added Animation Engine (animations.yml)
fixed cancel on look feature
[+] Config to edit the teleport chat message
Auto Config Updater
much more fixes and improvements
The Cross-Server Overhaul: Now Powered by MySQL
[+] Rock-Solid, Reliable Teleports
No More Lost Players: The previous teleport system could fail if the player arrived before the data did (a "race condition"). The new architecture is bulletproof.
True Cross-Server Coordination: it's a synchronized, cross-server event. The plugin on the destination server is now fully aware of who you are, where you came from, and what your teleport parameters are, allowing for flawless execution.
[+] Simplified Setup & Admin Control
No More Bridge Plugin: The separate JustRTP-Velocity bridge plugin is no longer needed. This update removes all complexity. You only need one JustRTP.jar on your Spigot/Paper servers. The plugin now communicates directly and securely with the database.
Centralized Management: All cross-server communication happens through one MySQL table. It’s clean, efficient, and easy to manage for server owners.
New Admin Command: The /rtp proxystatus command was added to give you a clear, real-time diagnosis of your proxy setup, showing the connection status to your MySQL database.
Enhanced Core & Quality of Life
[+] Intelligent Configuration
Automatic File Generation: No need to manually create mysql.yml. JustRTP now generates a clean, documented configuration file on the first startup, ready for you to fill in your database credentials.
Optimized Performance: By removing the dependency on a Velocity bridge plugin and direct socket connections, the plugin is now lighter, faster, and has fewer points of failure. The connection pooling provided by HikariCP ensures that database connections are handled efficiently, even under heavy load.
[+] Full Folia & Paper Optimization
Modern Schedulers: JustRTP continues to be fully optimized for modern server software. It automatically detects if you are running Folia and uses its region-aware schedulers to ensure teleports have a minimal impact on server performance, even during peak hours.
[+] Full PlaceholderAPI Expansion
Deeper Integration: The PlaceholderAPI expansion is now more powerful. You can display a player’s current cooldown, their assigned teleport delay, and the min/max radius for the world they are in, allowing for deep integration with scoreboards, action bars, and other plugins.
Please remember to backup and regenerate your config.yml and messages.yml to access all the new features and comments.
[+] Additions / New Features
- Folia Support: JustRTP is now fully compatible with Folia servers! The plugin will automatically detect if you are running Folia and use its region-based scheduler for all tasks. This ensures optimal performance and stability without compromising server TPS.
- Cross-Server Teleportation (BungeeCord & Velocity):
- You can now teleport players to a random location on a different server within your network!
- Simply use /rtp <player> <server>.
- Enable this feature and list your server names in the new proxy section of the config.yml.
- New Command Permission:
- justrtp.command.rtp.server: Grants permission to specify a server name in the RTP command.
- New Sleek Startup Message: The plugin now features a new, stylish startup message in the console, providing a quick overview of the status of its hooks (Proxy, PlaceholderAPI, WorldGuard).
- Detailed Configuration Comments: Both config.yml and messages.yml have been fully commented in English to clearly explain every option and what it does.
[/] Changes & Improvements
- Command Parser Overhaul: The /rtp command is now significantly smarter. Arguments for [player], [world], and [server] can be provided in any order, making the command more flexible and intuitive for both players and console.
- Asynchronous Task Handling: The core logic for finding a safe location has been completely rewritten to be fully asynchronous and thread-safe, fixing the UnsupportedOperationException crash on Folia servers. This also improves performance on standard Paper/Spigot servers.
- Scheduler Abstraction: Implemented a new internal task system that seamlessly handles both the standard Bukkit scheduler and Folia's new scheduler, ensuring code stability and future compatibility.
- API & Dependencies Updated: The plugin is now built against the latest Paper API (1.20.6) and includes updated dependencies for BungeeCord and Velocity.
- /rtp credits is now permission based (edit in config.yml)