EnesRTPZone — Advanced Random Teleportation Zone System (Paper / Folia / Purpur)

What is EnesRTPZone?

EnesRTPZone is a Paper-compatible (API 1.21+), Folia-supported, and Purpur-friendly Minecraft plugin that transforms any designated region into an interactive teleportation hub. Players are automatically transported to safe random locations after a synchronized global countdown.

Who should download EnesRTPZone?

• Server owners who want a shared global countdown teleport system for all players in a zone
• Staff who need wand-based zone creation and configurable RTP radius settings
• Anyone searching for: Minecraft RTP plugin, random teleport zone, Paper 1.21 teleport, Folia teleport zone, global countdown teleport, safe location finder

Complete feature list

Commands

• /rtpzone — Displays the help menu with all available subcommands.
• /rtpzone wand — Gives you the selection wand (wooden axe) to define zone boundaries. Left-click sets position 1, right-click sets position 2.
• /rtpzone create <name> — Creates a new RTP zone from your selected positions. Selections are cleared automatically after creation.
• /rtpzone delete <name> — Deletes a named zone permanently. Tab-completion shows existing zone names.
• /rtpzone reset (or /rtpzone clear) — Clears your current position 1 and position 2 selections.
• /rtpzone reload — Reloads config.yml, messages.yml, and all zone data without a server restart.

Permissions

• rtpzone.admin — Grants access to all commands (zone creation, deletion, wand, reload, selections).

Global synchronized countdown

• All players inside any RTP zone see the same countdown timer, synced via a server-wide scheduler.
• Countdown displayed as immersive title/subtitle messages, updated every second.
• Configurable duration via rtp.countdown in config.yml (default: 30 seconds).
• When the timer reaches zero, every player currently inside a zone is teleported simultaneously to a random safe location.
• Players who enter mid-cycle join the current countdown immediately.
• Players who leave before the timer ends are removed from the queue; no teleport occurs.

Intelligent safe-location finder

• Random X/Z coordinates within configurable min-radius and max-radius bounds.
• Scans from the top of the world downward to find the first solid block (avoids air spawns).
• Built-in hazard rejection: lava, water, cactus, and void-adjacent positions are detected and skipped.
• Retries up to 15 times before giving up with a "safe area not found" message.

Wand-based zone selection

• Administrative players receive a wooden axe with a custom display name and lore via /rtpzone wand.
• Left-click a block to set position 1; right-click a block to set position 2.
• Both positions are stored per-player and cleared automatically after zone creation (or manually via /rtpzone reset).
• Zone bounds are saved to config.yml under zones.* with world name and min/max coordinates.

Player entry/exit tracking (CountdownManager)

• Thread-safe ConcurrentHashMap-backed set tracks which players are currently inside any zone.
• PlayerMoveEvent handler detects zone entry and exit with block-level movement filtering (ignores rotation/fluid jitter).
• Entering a zone starts the per-player title task and sends an "entered-zone" message.
• Leaving a zone cancels the title task, removes the player from the countdown set, and sends a "left-zone" message.
• Player quit event cleans up the title task automatically.

PlaceholderAPI integration

• Placeholder: %rtpzone_cooldown% — Returns the remaining seconds before the next global teleport.
• Time-based (System.currentTimeMillis), so the placeholder is always in sync with the displayed countdown.

Hologram support

• Compatible with FancyHolograms and DecentHolograms (auto-detected at startup).
• Displays the remaining countdown time on a hologram named rtpzone_cooldown.

Fully customisable messages (messages.yml)

• All player-facing text is YAML-driven with & colour codes and hex support (&#RRGGBB).
• Configurable chat prefix, wand name/lore, zone creation/deletion messages, countdown title/subtitle text, and help menu entries.
• Reloaded via /rtpzone reload without restart.

Multi-platform support

• Declared api-version: '1.21' and folia-supported: true in plugin.yml.
• Uses GlobalRegionScheduler, RegionScheduler, and EntityScheduler from the Paper/Folia API.
• Fully functional on Paper, Folia, and Purpur servers from a single jar.
• Maven build profiles produce platform-specific artifacts (-paper, -folia, -purpur) with ProGuard obfuscation.

Typical staff journey (in-game)

1. Staff runs /rtpzone wand — receives the selection wand with a gradient-coloured name and lore.
2. Staff left-clicks a block to set position 1 and right-clicks another block to set position 2 — chat confirms both selections.
3. Staff runs /rtpzone create spawnrtp — the zone is saved to config.yml and is now active.
4. A player walks into the zone — they see the countdown title and an "entered-zone" chat message.
5. When the global timer reaches zero, the player is teleported to a random safe location with a confirmation message.
6. Staff runs /rtpzone delete spawnrtp — removes the zone and its configuration entry.
7. Staff runs /rtpzone reload after editing messages.yml — all messages and zones reload without restart.

Installation

1. Download the EnesRtpZone jar matching your server platform (-paper, -folia, or -purpur) and place it in the plugins folder.
2. Start the server once to generate default config.yml and messages.yml under plugins/EnesRTPZone/.
3. Edit config.yml to set your countdown duration, radius bounds, and target world.
4. (Optional) Customise messages.yml to change the prefix, wand name, countdown titles, and all other player-facing text.
5. Run /rtpzone reload to apply changes without a full restart.

Configuration files

config.yml — Main plugin settings:

rtp:
  countdown: 30
  max-radius: 10000
  min-radius: 1000
  target-world: "world"

zones: {}

messages.yml — All player-facing messages including prefix, wand display name/lore, zone creation/deletion/entry/exit messages, countdown titles, help menu entries, and error messages. Supports & colour codes and &#RRGGBB hex colours.