ВЕРСИИ (35)

### Fixed - Fixed `/rtp` intermittently failing (observed on Purpur) with `CompletionException - java.lang.IllegalArgumentException: argument type mismatch` during async location search. The Folia region/global-scheduler reflection bridges in `PaperPlatformScheduler` and `BukkitPlatformScheduler` only caught `ReflectiveOperationException` around `Method.invoke()` calls; they now also catch `RuntimeException` and fall back to the standard Bukkit scheduler instead of letting the exception propagate. This can occur even on non-Folia servers whose classpath carries the Folia regionized-runtime marker class. - `BukkitPlatformScheduler#executeRegion`/`executeGlobal`/`executeGlobalDelayed`/`executeRegionDelayed` now consistently fall back to the standard Bukkit scheduler when the reflective Folia scheduler call fails, instead of silently dropping the task (matching existing `PaperPlatformScheduler` behavior). ### Added - Regression test coverage for the scheduler reflection-fallback fix: - `PaperPlatformSchedulerReflectionFallbackTest` and `BukkitPlatformSchedulerReflectionFallbackTest` simulate a broken region/global-scheduler reflection call and verify the submitted task still runs via the standard scheduler fallback. - `PlatformRuntimeCapabilities.PURPUR_REGIONIZED` constant documenting the exact capability combination that triggered the bug. ---

### Fixed - `/rtp reload` now immediately applies GUI configuration updates from `gui.yml` by rebuilding GUI rendering from the current in-memory configuration instead of startup-cached values. - Reload now closes both standard RTP GUI sessions and faction-claim GUI sessions so open inventories cannot retain stale pre-reload settings. ### Added - Focused regression test coverage for GUI reload behavior: - `RandomTeleportGuiManagerReloadConfigTest` verifies that opening the GUI after configuration replacement uses the updated title and row count immediately. ---

### Added - Minecraft `26.2` compatibility updates: - added `SULFUR_CAVES` to rare-biome defaults/search paths, - updated biome compatibility handling for modern registry-based lookup paths. ### Changed - CI server download resolution migrated to PaperMC Fill API (`fill.papermc.io`) and now sends an explicit non-generic `User-Agent` header as required by the service. - Smoke testing workflow expanded from a single Folia target to a matrix that validates: - latest Folia build, and - Paper `1.13.x` for earliest supported compatibility coverage. - Dependency and tooling updates merged via Dependabot: - `com.github.ez-plugins:teams-api` `1.8.0` -> `2.4.0`. - GitHub Actions `actions/checkout` `v6` -> `v7`. - GitHub Actions `DavidAnson/markdownlint-cli2-action` `v23` -> `v24`. - Kyori Adventure BOM and related versions moved to `5.2.0` for current Paper API compatibility. ### Fixed - GitHub Actions workflow resolver for smoke-test target versions: - fixed YAML parsing issues in embedded resolver scripting, - fixed selector propagation into Python resolver invocation, - fixed mixed-type version sort key handling that could fail on Paper version token comparisons. - Removed a duplicate stale block in `messages/en.yml` that produced duplicate-key warnings at startup. - Replaced deprecated `Biome.valueOf`/`Biome.values` usage with compatibility-safe registry-backed resolution paths used across biome-related logic. ---

### Added - **EzCountdown integration** (optional soft-dependency): - RTP countdown display can now be delegated to [EzCountdown](https://modrinth.com/plugin/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](https://www.spigotmc.org/resources/combatlogx.31689/)** — auto-detected at startup; soft dependency. - **[PvPManager](https://modrinth.com/plugin/pvpmanager)** — auto-detected at startup; soft dependency. - **[Simple Combat Log](https://modrinth.com/plugin/simple-combatlog)** (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 - `BukkitPlatformScheduler` now handles Folia servers correctly. Previously, running EzRTP on Folia without the Paper runtime module caused an `UnsupportedOperationException` during plugin enable because the Bukkit `CraftScheduler` rejects all synchronous task scheduling on Folia. The scheduler now detects `regionizedRuntime` capabilities and routes all scheduling calls through Folia's `GlobalRegionScheduler` / `RegionScheduler` via reflection, matching the behaviour already present in `PaperPlatformScheduler`. ---

### 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](https://modrinth.com/plugin/teams-api) 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 ### Changed ### Fixed ### Removed --- #### Notes > 🌙 Automated nightly beta build from `v3.x` (May 10, 2026). > > Built from [`a335e34`](https://github.com/ez-plugins/EzRTP/commit/a335e3437e138f29a8ae5f6f7aa86825d5aa892f)

### 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

#### What changed - **Ci/automatic nightly release** [#77](https://github.com/ez-plugins/EzRTP/pull/77) — @ez-plugins - **ci: fix direct push** [#76](https://github.com/ez-plugins/EzRTP/pull/76) — @ez-plugins - **ci: fix main branch to v3.x** [#75](https://github.com/ez-plugins/EzRTP/pull/75) — @ez-plugins - **Ci/automatic nightly release** [#74](https://github.com/ez-plugins/EzRTP/pull/74) — @ez-plugins - **ci: fix markdown changelog format** [#73](https://github.com/ez-plugins/EzRTP/pull/73) — @ez-plugins - **ci: added automatic nightly releases** [#72](https://github.com/ez-plugins/EzRTP/pull/72) — @ez-plugins - **chore(deps): bump actions/configure-pages from 5 to 6** [#71](https://github.com/ez-plugins/EzRTP/pull/71) — @app/dependabot - **chore(deps): bump DavidAnson/markdownlint-cli2-action from 16 to 23** [#70](https://github.com/ez-plugins/EzRTP/pull/70) — @app/dependabot - **chore(deps): bump actions/upload-pages-artifact from 3 to 5** [#69](https://github.com/ez-plugins/EzRTP/pull/69) — @app/dependabot - **chore(deps): bump actions/deploy-pages from 4 to 5** [#68](https://github.com/ez-plugins/EzRTP/pull/68) — @app/dependabot - **chore(deps): bump actions/checkout from 4 to 6** [#67](https://github.com/ez-plugins/EzRTP/pull/67) — @app/dependabot - **docs: fix SCSS syntax error in ezrtp.scss (split comment separators)** [#66](https://github.com/ez-plugins/EzRTP/pull/66) — @ez-plugins - **docs: fix YAML syntax error in _config.yml (split comment separators)** [#65](https://github.com/ez-plugins/EzRTP/pull/65) — @ez-plugins - **Docs/GitHub pages** [#64](https://github.com/ez-plugins/EzRTP/pull/64) — @ez-plugins - **Fix/module adapters** [#63](https://github.com/ez-plugins/EzRTP/pull/63) — @ez-plugins #### Notes > 🌙 Automated nightly beta build from `v3.x` (April 22, 2026). > > Built from [`7901de6`](https://github.com/ez-plugins/EzRTP/commit/7901de65359e7273219b28968e4fc8f7f5b32283)

#### What changed - Fixed issue in registering the module providers #### Notes > **Please make sure to install the core EzRTP plugin and the platform dependand module, this for increased performance with multiple-platform support**

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 🚀 > **Please make sure to install the core EzRTP plugin and the platform dependand module, this for increased performance with multiple-platform 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`)

## ✨ 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

- Added [Chunky integration](https://modrinth.com/plugin/chunky) for async pregeneration of EzRTP radius through Chunky - Added option to disable countdown chat messages ```yaml countdown: # Enable or disable countdown chat messages. When disabled, only bossbar and particles will be shown. chat-messages: false ``` - 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

- 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` ```yaml safety: water: # When enabled, RTP will solidify shallow water by placing a block before teleporting. # NOTE: the old key 'place-dirt-on-surface' is deprecated; use 'place-block-on-surface'. place-block-on-surface: true # Material to place on the surface when solidifying shallow water. Defaults to ICE. # Valid values are Bukkit Material names (e.g., DIRT, GRASS_BLOCK, ICE). material: ICE ```

- Added `triangle` search pattern  - Added `diamond` search pattern  - Fixed MiniMessage translating issue in `/rtp stats` - Improved backwords compatiblity for new features for Minecraft 1.7

- Added fallback for new glass panes for older Minecraft servers - Changed default config materials to older materials to by default support the older versions without needing the fallback

- Added new `/forcertp` command to replace `/rtp forcertp ...` - Added new `force-rtp.yml` configuration file: ```yml # Force RTP configuration # This file controls the behavior of the /forcertp command # Default world to use when no world is specified default-world: world # Bypass settings for the /forcertp command bypass: # Whether to bypass cooldown restrictions cooldown: true # Whether to bypass permission checks (except for the forcertp permission itself) permission: true # Whether to bypass safety checks (teleport even to unsafe locations) safety: false ``` - 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.**

- Fixed issue in showing cooldown when player is bypassed from cooldown - Improved bStats stats tracking - Fixed avg wait time - Fixed success rate - Added total RTPs - Added total wait time

- **Fixed**: Shift-clicking in GUI now shows "no permission" error instead of allowing item theft - **Added**: Option to show cache filter info only to admins (`admin-only-cache-info: false` in `gui.yml`) - **Added**: Configurable cache filter info message (`cache-filter-info` in `messages.yml`) - **Added**: Option to allow GUI access during cooldowns (`allow-gui-during-cooldown: true` in `rtp-limits`) - **Added**: Human-readable cooldown formatting (`human-readable-cooldown: true` in `config.yml`) - **Added**: Extensive placeholder system for messages: - Core Teleport: `<world>`, `<x>`, `<z>`, `<target-biome>`, `<cached-locations>` - Economy: `<cost>` - Queue: `<position>` - Cooldown/Time: `<hours>`, `<minutes>`, `<seconds>` - Countdown: `<seconds>` - Network: `<server>`, `<status>`, `<ping>` - **Fixed**: Spigot server compatibility by including MiniMessage API in JAR (increased size to ~936KB) - **Improved**: Time formatting displays as "1h 30m 45s" instead of raw seconds when enabled

- Fixed issue in cooldowns

- Added new `/rtp forcertp <player>` command to bypass queue, cooldown, GUI for portals and such

- Preperation for multi-language support - MiniMessage support for configurable messages - Added `language` selection in `config.yml`

- Added fallback to cached location when failing a search so the player proceeds to random teleport

# New features in EzRTP 1.3.0 ##⚡ Smart Pre-Caching - Locations are now pre-cached per biome to minimize RTP failures and improve performance. - Per-biome configuration added to customize the number of pre-cached locations. - Graceful fallback logic when pre-cached locations are unavailable to avoid player frustration.  ## 🌍 Heatmap Visualization - Added the /rtp heatmap command to analyze RTP location data visually: Displays RTP density patterns in a heatmap-style visualization on an in-game map. - Heatmaps automatically render using Minecraft maps and are handed to the player upon execution. - Option to generate heatmaps by biome with /rtp heatmap <biome> or save as .png files for external usage with /rtp heatmap save.  ## 📊 Improved Statistics - Updated /rtp stats command with detailed biome-specific statistics: Displays total RTP attempts, success rates, failures, and average teleport times. - Shows stats like cache hits, biome success rates, and total biome finds. - Filters out unrelated biome failure logs for clearer representation of requested biome data. ## 🛠️ Telemetry and Debugging Enhancements Developers can access detailed logs (via debug mode): - Including cache hits/misses, teleport timings, biome RTP attempts, and fallback usage details. - Provides stack traces for pre-caching issues or RTP failures. ## 💬 Enhanced Messaging System - Improved RTP status messages with dynamic placeholders like <target-biome> or <location-count> make the user experience more engaging and informative. - Set to enabled by default but is fully configurable for advanced users.

* Fixed compatibility issue with GriefProtection

# 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.