justRTP

NEW FEATURES

[1] NEW FEATURE: Cylinder RTP zones - circular zone regions for round arenas, towers, and non-rectangular waiting areas [2] NEW FEATURE: Block-selection RTP zones - pick individual blocks with a wand to build irregular, non-cubic arena shapes [3] NEW FEATURE: Shape-aware zone wands - each shape gets its own wand (BLAZE_ROD for cuboid/blocks, END_ROD for cylinder) with shape-specific lore [4] NEW FEATURE: Zone particle system - 5 premade animated styles (OUTLINE, BEAM, SWIRL, PULSE, DUST_WALL) plus NONE, all shape-aware [5] NEW FEATURE: Live setup particle preview - while in /rtpzone setup, particles show the current selection in real time so admins can see exactly what they're building [6] NEW FEATURE: Per-zone particle style configurable via /rtpzone particles <zone_id> <style> with tab completion [7] NEW: /rtpzone setup <id> [cuboid|cylinder|blocks] - choose zone shape at setup time (defaults to cuboid for backward compat) [8] NEW: /rtpzone done - finish block selection and continue setup flow [9] NEW: Cylinder setup - left-click sets center, right-click on edge measures radius, or type radius in chat; Y-range configurable per zone or auto for full world height [10] NEW: Block setup - left-click adds block, right-click removes, shift+left-click clears selection [11] NEW: New zone_particles.yml config with per-style particle, color, density, and animation speed settings

CRITICAL FIXES

[12] FIXED: respawn_rtp not working on Folia - PlayerRespawnEvent fires during a player state transition on Folia and returns stale world data, causing the respawn teleport to never trigger. Switched to PlayerPostRespawnEvent (Paper API) which fires after respawn completes, ensuring reliable respawn RTP on both Paper and Folia servers [13] FIXED: Zone holograms not appearing after server restart, player rejoin, or world change - visibility was only pushed once at hologram creation, missed if timing did not line up with player join. Added a periodic 5-second visibility sweep over all online players plus three staggered join refreshes (1s, 3s, 6s after join). Holograms now appear without needing /rtp reload. [14] FIXED (PR #9): Folia thread-safety violations across NearClaimRTPManager, HologramManager cleanup, JumpRTPListener, RTPService border tracking, and bundled bStats Metrics. Async block reads, off-region entity removals, parallel HashMap writes, and hardcoded Bukkit.getScheduler() calls all corrected for Folia 1.21.x and 26.1 [15] FIXED (PR #9): Matchmaking spread distance bug - per-player safety search was passing absolute coordinates as min/max radii, scattering duel partners hundreds of blocks apart on servers with non-zero spawn coords. Fixed to pass proper (0, safety_search_radius) distances [16] FIXED: RTPCommand nearplayer was using synchronous player.teleport() while every other path used teleportAsync - inconsistency causing potential hangs on Folia, now async everywhere

COMPATIBILITY

[17] COMPATIBILITY: Minecraft 26.1 (released March 24, 2026, protocol 775, data version 4786) verified working alongside 1.21.11. Plugin compiled against Paper 1.21 API with api-version: '1.21' so a single JAR runs on both versions. No code changes needed - new 26.1 blocks (e.g., GOLDEN_DANDELION) and data-driven villager trades do not affect teleport logic. Server-side Java 25 requirement for 26.1 does not affect the plugin (Java 21 bytecode runs on the Java 25 JVM)

CONFIGURATION

[18] NEW: shape field on zone config entries - CUBOID, CYLINDER, or BLOCKS [19] NEW: Cylinder fields - center, radius, min-y, max-y [20] NEW: Blocks field - blocks: [x,y,z, ...] list of block coordinates [21] NEW: particle-style field per zone - persists chosen particle style across restarts [22] NEW: zone_particles.yml - 5 premade styles + global tuning (update_interval, render_distance, max_particles_per_tick, setup_preview) [23] NEW: matchmaking.safety_search_radius (default 5) - tunable safety search radius for matchmaking spread (PR #9) [24] CONFIG: rtp_zones.yml version bumped to 13 - existing cuboid zones auto-migrate without changes [25] CONFIG: messages.yml version bumped to 21 - new zone setup messages for cylinder/block modes and particle commands

IMPROVEMENTS

[26] IMPROVED: Particle system uses chunk-batched dispatch on Folia (one task per chunk instead of per particle) and direct inline spawning on Paper - no scheduler overhead in either case [27] IMPROVED: Particle Y-range automatically clamped to a window around the zone center, so auto Y-range cylinders/cuboids no longer waste the per-tick particle budget on locations far below the player's view [28] IMPROVED: Zone region logic refactored to a ZoneRegion interface - cleaner separation of cuboid/cylinder/blocks containment checks [29] IMPROVED: Tab completion for /rtpzone setup <id> <shape>, /rtpzone done, and /rtpzone particles <zone> <style> [30] IMPROVED: Respawn RTP scheduler delay bumped from 1 to 2 ticks for extra entity state stability [31] IMPROVED: Early-return safety check added to respawn RTP handler when player goes offline during the delay [32] IMPROVED: Zone setup messages carry a <shape> placeholder so admins can see which shape they started [33] IMPROVED (PR #9): JumpRTPListener atomic via ConcurrentHashMap + compute(...) - parallel PlayerMoveEvent on Folia no longer races [34] IMPROVED (PR #9): RTPService border-warning set is now ConcurrentHashMap.newKeySet() - prevents duplicate border warnings under parallel findSafeLocation [35] IMPROVED (PR #9): Tab completer now exposes queue, matchmaking, sendlocation plus their sub-args and world suggestions [36] IMPROVED: Existing zones loaded without particle-style field automatically pick up the global default style on next reload

FOR SERVER ADMINS

• Existing cuboid zones continue to work unchanged (auto-detected when shape is missing)
• Circular arenas: /rtpzone setup my_arena cylinder
• Non-cubic arenas (stairs, L-shapes, scattered platforms): /rtpzone setup my_arena blocks
• All three shapes share the same teleport, hologram, particle, and effects system
• Change zone particles live: /rtpzone particles my_arena swirl (or outline, beam, pulse, dust_wall, none)
• If you run Folia/Canvas and respawn_rtp wasn't teleporting players on death, this update fixes it
• Holograms missing on restart/rejoin/world change? Fixed in this version - no more /rtp reload workaround needed
• Matchmaking duels scattered too far apart? Fixed - and tunable via matchmaking.safety_search_radius