Added

• EzCountdown integration (optional soft-dependency):
  • RTP countdown display can now be delegated to EzCountdown for richer, configurable display channels.
  • Configurable display types per RTP world: ACTION_BAR, BOSS_BAR, TITLE, CHAT, SCOREBOARD, DIALOG.
  • Configurable MiniMessage format string with {formatted} placeholder for remaining time.
  • Each teleporting player receives an ephemeral, per-player countdown with permission-scoped visibility.
  • Falls back to the built-in bossbar/chat countdown automatically when EzCountdown is absent or ezcountdown.enabled: false.
  • New countdown.ezcountdown.* config section in rtp.yml (disabled by default).
• EzCountdown added as optional soft-dependency in plugin.yml.
• Factions RTP (TeamsAPI):
  • Added /rtp faction to open a claim-selection GUI from all TeamsAPI claims available to the player's team.
  • Added TeamsAPI subcommand integration for /f rtp via the TeamsAPI subcommand API (when provided by the installed TeamsAPI version).
  • Claim selection now sets the selected claim chunk as RTP center and then applies normal per-world RTP behavior/settings.
• New faction-gui.yml file for full claim-GUI configuration.
• Heatmap claim overlays (admin insight):
  • Added claim border overlay mode for /rtp heatmap and /rtp heatmap save via claims-overlay flag.
  • Added rtp.yml options under heatmap.claims-overlay.*:
    • enabled
    • style (border)
    • color
    • line-width
• Claim-constrained fake RTP simulation:
  • Added /rtp fake <amount> claims [world] to generate simulated points on faction claims owned by the executor’s team.

Changed

• TeamsAPI dependency bumped from 1.4.1 to 1.8.0.
• TeamsAPI /f rtp subcommand integration rewritten: replaced the reflection-based Proxy approach with a proper AbstractTeamsSubcommand subclass (requires TeamsAPI ≥ 1.8.0).
• TeamsAPI subcommand registration now uses an explicit isPluginEnabled("TeamsAPI") guard instead of relying on NoClassDefFoundError suppression.
• Faction claim GUI icons now attempt to use player skulls when claimant/owner identity is available, with configurable fallback material when unavailable.
• Added configurable title, size, claim item format/lore, skull toggle, and navigation slot/name settings for faction GUI pages.
• Update checker refactored to use mc-plugin-update-notifier with Modrinth as primary source and GitHub Releases as fallback source.

Fixed

• Heatmap enablement now resolves correctly for inherited/fallback world settings (heatmap.enabled) and no longer reads as disabled unexpectedly in world/GUI override paths.
• /rtp heatmap no longer hard-requires biome cache for non-biome heatmaps. Biome cache is only required for biome-filtered heatmap requests.
• Spigot startup compatibility fixed in update checking (JavaPlugin#getDescription().getVersion() used instead of Paper-only metadata calls).
• Message loading now supports both top-level keys and nested messages.* language-file layouts.
• Language file handling is now non-destructive: startup repair only targets clearly corrupted message files, with automatic backfill of missing message keys while preserving existing translations/customizations.

Added

• PvP tag integration: EzRTP now detects when a player enters combat and cancels their pending teleport or active countdown. Three plugins are supported out of the box:
  • CombatLogX — auto-detected at startup; soft dependency.
  • PvPManager — auto-detected at startup; soft dependency.
  • Simple Combat Log (NikeyV1/CombatLog) — auto-detected at startup; soft dependency.
  • All three are added to softdepend in plugin.yml so they load before EzRTP when present. No configuration change is required on servers that do not use any of them.
  • New pvp-tag-integration section in rtp.yml:
    • cancel-countdown-on-pvp-tag (default true): cancel an active countdown the moment the player is tagged.
    • cancel-queued-on-pvp-tag (default true): skip a queued teleport if the player is already in combat when their slot is dispatched.
  • New message keys countdown-pvp-cancel and queue-pvp-tag-cancel in messages/*.yml for the cancellation notifications.
  • Modrinth release metadata now declares pvpmanager and simple-combatlog as optional dependencies.

Fixed

• Folia teleport crash (UnsupportedOperationException: Must use teleportAsync while in region threading): BukkitPlatformScheduler now overrides teleportAsync and, when running on Folia (regionizedRuntime capability), calls player.teleportAsync(Location) via reflection instead of the forbidden synchronous player.teleport(). The Bukkit module was the only scheduler that still used the synchronous fallback from the interface default; PaperPlatformScheduler already called teleportAsync directly.

Fixed

• PerformanceSnapshot#fmt now passes Locale.US to String#format, ensuring decimal separators are always locale-independent (dots, not commas).

Changed

• Dependency scope for ezrtp-common in the ezrtp-paper and ezrtp-purpur modules changed to provided; the common module is bundled by the main plugin JAR and must not be re-included by platform modules.

Added

• TeamsAPI claim avoidance: EzRTP now integrates with TeamsAPI to skip chunk-claimed areas during RTP destination search.
  • New protection provider id: teamsapi. Works alongside the existing worldguard and griefprevention providers.
  • Enabled automatically when TeamsAPI (with a compatible claim provider) is installed. Silently skipped when absent, no errors, no configuration changes required.
  • teamsapi added to the default protection.providers list in rtp.yml.
  • TeamsAPI added to softdepend in plugin.yml.
  • Claim availability is evaluated dynamically per check, so a claim plugin that loads after EzRTP is picked up without a reload.

Added

• Message suppression via config (config.yml):
  • messages.suppress-player: when true, silences all teleport-related messages to players globally (searching, countdown, queue position, success, failure, cost).
  • messages.suppress-console: when true, silences the executor notification that /forcertp sends to the command sender globally.
• --skip-message command flag: can be appended to /rtp, /rtp <center|region>, /forcertp <player> [world], and /rtp forcertp <player> [world] to suppress both player-facing and executor messages for that single invocation. Tab-completion suggests the flag.
• BiomeCompat utility (ezrtp-common): reflection-based safeName(Biome) and safeValueOf(String) helpers that work correctly whether org.bukkit.block.Biome is an enum (Spigot/Bukkit ≤ Paper 25) or an interface (Paper 26+), preventing IncompatibleClassChangeError at runtime.
• Movement-cancel during countdown: if a player moves too far from their starting position while a countdown is running, the teleport is cancelled.
  • countdown.cancel-on-move (default true) — enable or disable the feature.
  • countdown.cancel-distance (default 2.0) — distance in blocks that triggers cancellation.
  • countdown.warn-distance (default 1.0) — distance in blocks that sends a one-time warning before cancellation. Set to 0 to disable the warning.
  • Two new message keys: countdown-move-warn and countdown-move-cancel (configurable in messages/en.yml).

Changed

• Minecraft version support expanded to 1.13+: api-version in plugin.yml lowered from 1.21 to 1.13; plugin will now load on any server from MC 1.13 onwards.
• Java 17 output bytecode: maven.compiler.release changed from 25 to 17 so the built JARs run on Java 17+ hosts. The build toolchain still requires JDK 25 to compile against paper-api.
• Modrinth game-versions broadened to >=1.13 in release and nightly workflows (was >=26.1).
• RareBiomeRegistry.getDefaultRareBiomes(): replaced a single try/catch wrapping all Biome.valueOf() calls with per-biome BiomeCompat.safeValueOf() guards, so a biome absent on the running server version (e.g. MODIFIED_JUNGLE removed in 1.18, DEEP_DARK added in 1.19) no longer silently prevents the remaining biomes from being registered.
• All biome.name() call sites replaced with BiomeCompat.safeName(biome) across RareBiomeRegistry, GuiSettings, BiomeLocationCache, StatsSubcommand, and HeatmapSubcommand.

Fixed

• Stale <fork>, <executable>, and <jvm> references to deleted java25.javac / java25.java properties removed from root pom.xml compiler and Surefire plugin configuration.

Fixed Folia support

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)

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)

• Added Chunky integration for async pregeneration of EzRTP radius through Chunky
• Added option to disable countdown chat messages

• Added RAM memory safety checks, disabling the pre-cache for preventing RAM overload
• Improved default radius to a bigger radius
  • Improved min. radius from 256 to 500
  • Changed max. radius from use world border to 2000
• Fixed issue issue in false positives
• Fixed bug in showing bossbar countdown

Changelog

• Improved water/surface satety
  • Added material option to change the material of the spawned block
  • Changed setting from place-dirt-on-surface to place-block-on-surface
  • Changed default from DIRT to ICE

Settings in the config.yml

• Added new /forcertp command to replace /rtp forcertp ...
• Added new force-rtp.yml configuration file:

• Added a lot of new configurable messages in the messages/en.yml configuration file
• Fixed issue in /rtp reload, it now reloads all configuration files again
• Fixed issue preventing /forcertp to be used from console

• Added configuration option to change search pattern
  • Added circle search pattern
  • Added square search pattern
  • Named existing search pattern to random
• Improved heatmaps
  • Added /rtp fake <amount> subcommand to generate locations with configured search pattern
  • Added legend and coloring to the heatmaps
• Improved default configuration settings
• Added new configurable messages
• Improved default search pattern for faster default found locations

For updating the plugin it's recommended to reset the configuration files.

For full changelog of version 1.3.0 check the release page

• Added option to prevent RTP from finding locations within WorldGuard safe zones
• Added biome whitelist and blacklist settings
• Added cost-per-world option

While updating from previous version: It's recommended to reset the configuration files for clean defaults.

EzRTP 1.1.0 Changelog

• Per-world cooldowns & usage limits – Added configurable cooldowns plus daily/weekly usage caps with group overrides, bypass permissions, and YAML/MySQL storage for tracking.
• Teleport countdown visuals – Optional per-player countdown now supports bossbar styling, particle rings, and custom start/tick messages in `messages.yml`.
• Proxy network destinations – New `network.yml` lets lobby servers surface proxy destinations in the RTP GUI with live status pings and click-to-connect.
• Y-level bounds & debug logging – Added `min-y`/`max-y` limits for safer landing ranges and a `debug-rejection-logging` toggle to audit skipped locations.
• Config file split – Moved GUI, queue, and network settings into `gui.yml`, `queue.yml`, and `network.yml` for cleaner organization.
• Boss bar countdown – Added boss bar countdown features
• Countdown particles – Added option to show particles around the player while counting down for RTP
• Improved default GUI – Added The End and Nether to the default GUI config and improved the styling of the GUI.

EzRTP version 0.4.0 ~ Countdown

• Improved location finding for less failures
• Improved async logic for Spigot servers
• Added configurable countdown option before teleportation
  • Added configurable countdown messages

EzRTP GUI Bugfix Changelog

• Fixed GUI opening error on Spigot/Paper - The world selector menu now works reliably when enabled, with no console errors or crashes. Titles are properly converted for compatibility.
• Improved compatibility - GUI inventory creation now supports all supported server types (Spigot, Paper, Purpur 1.21+).
• No impact on gameplay features - Only the GUI code was changed; teleport logic and config remain untouched.

EzRTP v0.3.1 Update ~ Changelog

• Spigot Compatibility Fixes: Resolved errors with async chunk loading by switching to safe synchronous chunk loading. No more console spam or teleport failures!
• Improved RTP Messages: Player messages now display correctly with color codes on Spigot, no more weird debug text.
• Teleport Queue Stability: Minor bug fixes and code cleanup for smoother teleport queue handling.
• No Impact on Other Plugins: Only EzRTP is updated, other modules remain unchanged.