EzRTP

We have worked hard to make it happen, EzRTP has been updated to Minecraft 26.1.2, what does this mean for you?

So far we have only tested EzRTP on Minecraft 26.1.*, we think it should stay functional for previous versions. Please report any issues in our Discord for a better EzRTP 🚀

Added

• world: auto support in rtp.yml — uses the player's current world as the RTP world
• world: auto support in /forcertp and /rtp forcertp commands
• world: auto support in GUI world options (current-world button)
• EzRtpLogger message catalogue for structured console logging

Changed

• Console output: stripped [EzRTP] prefix and condensed log messages
• API jar is now shaded into the Bukkit module

Fixed

• Adapted to Paper 26.1 API changes
• Removed redundant applyChunkLoadingSettings calls in teleport service
• Compiler fork now uses java.home-relative javac path

Build / CI

• Bumped version to 3.0.0
• Updated Minecraft API dependencies to 26.1.2
• Updated JDK to 25
• Corrected api-version in plugin.yml files (iterated to final value 26.1.2)

✨ Major Features

New Plugin API Module

• Public API for third-party plugins — New ezrtp-api artifact that allows other plugins to trigger random teleports programmatically
• Simple helper methods in EzRtpAPI for common use cases, with optional callbacks for async operations
• Bukkit Services Manager integration for clean dependency injection
• Minimal compile-time footprint — only ezrtp-api needs to be in the classpath of dependent plugins

Performance Monitoring & Observability

• Performance metrics collection — Track RTP operation timings, cache efficiency, chunk loads, and biome filter performance
• Slow RTP warnings — Automatically detect and log RTPs that exceed a configurable threshold (default 100ms)
• Percentile tracking — Snapshot P50, P75, P90, P95, P99 response times using a ring-buffer sample
• Periodic JSON export — Export metrics to JSON for integration with monitoring systems or manual analysis
• New /rtp stats performance subcommand to view current metrics in-game
• Configurable via plugins/EzRTP/performance.yml

Unsafe Location Monitoring

• Track rejection causes — Understand why locations are unsafe (void, liquid, lava, unsafe blocks, etc.)
• Per-cause statistics — Breakdown of all-time rejection counts by cause
• Optional warning system — Log or warn when unsafe rejection rate exceeds a threshold
• Periodic metrics export — Export rejection statistics to JSON
• New /rtp unsafe-stats subcommand to view unsafe location statistics in-game
• Configurable via plugins/EzRTP/unsafe-location-monitoring.yml

Improved Chunk Loading

• Paper 1.21+ async API detection — Automatically use World.getChunkAtAsync() on qualifying servers, bypassing the legacy tick-based throttle queue entirely
• Async/non-blocking chunks — When running on Paper/Folia 1.21+, chunk loads no longer compete for tick time
• Backward compatible — Legacy throttle queue is still available for older servers or when explicitly configured
• Smart auto-detection — Defaults to auto-detect mode, gracefully falls back to legacy queue if needed
• Configurable via chunk-loading.use-paper-async-api in rtp.yml

Biome Filtering Enhancements

• Master switch for biome system — New biomes.enabled setting disables the entire biome infrastructure (search, cache, rare biome tracking)
• Master switch for include/exclude filters — New biome-filtering.enabled separate from the overall biome system
• Automatic filter-aware performance budgets — When include/exclude biome filters are active but no explicit budget is configured, tighter limits are applied automatically (100ms wall-clock, 10 chunk-loads)
• New performance-budget section — Cleaner configuration path for search budgets (biome-filtering.performance-budget)
• Better timeout tracking — Biome filter timeouts are now monitored and reported in performance stats
• Async-mode toggle — Serialize biome searches through a dedicated executor thread instead of the common fork-join pool when async-mode: false

Rare Biome Hotspot Persistence

• MySQL-backed hotspot storage — Persist discovered rare-biome hotspots across restarts and share them between network nodes
• HikariCP connection pool — Efficient, non-blocking database operations
• Background loading — Hotspots are loaded asynchronously on startup
• Configurable persistence backend — Switch between in-memory only (none) or MySQL (mysql)
• Automatic table creation — Database schema is initialized automatically

🔧 Configuration Changes

New Configuration Files

• plugins/EzRTP/performance.yml — Performance monitoring and warning settings
• plugins/EzRTP/unsafe-location-monitoring.yml — Unsafe location rejection tracking and warnings

rtp.yml Changes

• biomes.enabled (new) — Master switch for the entire biome system (default: true)
• biome-filtering.enabled (new) — Separate toggle for include/exclude biome filters (default: true)
• biome-filtering.performance-budget (new, preferred) — Search budget configuration moved here for clarity
• search.* (legacy path still works) — Old budget location, now aliases to new path
• chunk-loading.use-paper-async-api (new) — Auto-detect or explicitly enable/disable Paper async chunk loading (default: auto-detect)
• chunk-loading.legacy-throttle (new) — Nested section for old throttle settings, replaces flat enabled/interval-ticks/max-chunks-per-tick
• heatmap.enabled — Toggle heatmap feature per world (was implicit before)
• safety.reject-liquid-above-nether (new, default: true) — Reject locations with lava above in the Nether
• safety.reject-liquid-above-overworld (new, default: true) — Reject locations with water above in the Overworld

Network Configuration (network.yml)

• Moved to plugins/EzRTP/network/ namespace for better organization

Dependency Updates

• Bukkit/Paper actions — Updated from v4 to v6
• Java compiler — Updated to 3.15.0
• bstats — Updated from 3.0.2 to 3.2.1
• WorldGuard — Updated from 7.0.9 to 7.0.16
• PlaceholderAPI — Updated from 2.11.7 to 2.12.2
• Adventure — Multiple library versions updated to 4.26.1
• HikariCP 7.0.2 — New dependency for MySQL hotspot storage
• JUnit & Mockito — Updated test dependencies

🐛 Bug Fixes & Improvements

GriefPrevention Compatibility

• Fixed reflection fallback to handle multiple getClaimAt() method signatures across GriefPrevention versions

Import/Package Reorganization

• Configuration classes reorganized into semantic packages: biome.*, effects.*, network.*, safety.*, teleport.*, gui.*, performance.*
• Old import paths still work through backwards-compatible re-exports (zero breaking changes)

Code Quality

• Introduced ConfigurationDefaults class to centralize all default numeric constants
• Improved documentation and JavaDoc throughout
• Better error handling and logging in reflection-based code (ChunkyAPI, GriefPrevention, PlaceholderAPI)

Platform Abstraction

• Enhanced PlatformScheduler — New methods executeGlobal(), executeGlobalDelayed(), executeRegionDelayed() for cleaner code
• Folia compatibility — All scheduler calls now route correctly on Folia's regionalized threads
• Centralized capability detection — New PlatformRuntimeCapabilitiesDetector.isPaper121PlusAsync() for version-aware optimization

API Extensions

• RandomTeleportService now implements the new com.skyblockexp.ezrtp.api.TeleportService interface for type-safe service registration

📊 New Statistics & Metrics

Tracked in RtpStatistics

• Timing percentiles — P50, P75, P90, P95, P99 milliseconds
• Min/max operation times — Absolute bounds across the ring buffer
• Slow operation count — Number of RTPs exceeding the slow-threshold
• Chunk loads breakdown — Total, async, and sync counts
• Biome rejection counts — Total rejections and per-RTP max
• Biome filter timeouts — Number of times a search was terminated due to biome rejection limit

bStats Charts (New)

• unsafe_location_cause — Top rejection cause (pie chart)

🎮 New Commands

/rtp stats performance

• Shows real-time performance metrics including response times, cache hit rate, chunk loading breakdown, and recommendations

/rtp unsafe-stats

• Shows all-time unsafe location rejection statistics broken down by cause

📝 Configuration Validation

New Warnings

• Missing protection providers — Single consolidated warning when all configured protection plugins are unavailable
• Heatmap disabled check — /rtp heatmap now validates that heatmap.enabled: true before proceeding
• Chunky reflection fallback — Graceful degradation if Chunky API changes or is unavailable

♻️ Removed/Deprecated

• ChunkLoadingSettings legacy flat-format constructors are deprecated (but still work)
• No breaking changes to public APIs — All existing plugin code continues to function

For Server Owners

Update Guide:

1. Back up your plugins/EzRTP/ folder
2. Replace the EzRTP .jar file
3. Restart the server (config files will be auto-generated)
4. Optionally enable performance or unsafe-location monitoring in the new .yml files
5. For Paper 1.21+ users, chunk-loading will automatically switch to async mode (no config needed)

Recommendations:

• Enable performance monitoring if you want insight into RTP responsiveness and cache efficiency
• Enable unsafe-location monitoring if you're debugging biome filter issues or want to understand rejection patterns
• Upgrade to Paper 1.21+ to get true non-blocking chunk loading (no configuration required; auto-detected)

• Fixed cached fallback when avoiding claims fails
• Upgraded version to 2.0.1

• Added opt-in /rtp <worldguardRegionName>
  • Added configuration override options per WorldGuard region
• Added /rtp addcenter <name>
• Added /rtp <name> besides /rtp <worldName>
• Improved performance, refactored server software fallback logic
  • Moved from single .jar to main EzRTP.jar with server modules (ezrtp-spigot.jar, ezrtp-purpur.jar, ezrtp-paper.jar)
• Split config.yml into multiple, more clear configuration files
  • Added new limits.yml configuration
  • Added new rtp.yml configuration
  • Added new storage.yml configuration

• Added HEX color support for the configurable messages
• Fixed issue async chunk loading for Paper servers