EnesRTPZone — 高级随机传送区域系统(Paper / Folia / Purpur)
EnesRTPZone 是什么?
EnesRTPZone 是一款兼容 Paper(API 1.21+)、支持 Folia 且对 Purpur 友好的 Minecraft 插件,它将任何指定区域转化为一个交互式传送枢纽。在同步的全局倒计时结束后,玩家会被自动传送到安全的随机位置。
谁应该下载 EnesRTPZone?
- 希望为区域内所有玩家提供共享全局倒计时传送系统的服务器管理员
- 需要基于法杖的区域创建和可配置的 RTP 半径设置的管理人员
- 正在搜索以下内容的用户:Minecraft RTP plugin, random teleport zone, Paper 1.21 teleport, Folia teleport zone, global countdown teleport, safe location finder
完整功能列表
命令
/rtpzone — 显示包含所有可用子命令的帮助菜单。
/rtpzone wand — 给予你用于定义区域边界的选择法杖(木斧)。左键点击设置位置 1,右键点击设置位置 2。
/rtpzone create <name> — 根据你选定的位置创建一个新的 RTP 区域。创建完成后选择会自动清除。
/rtpzone delete <name> — 永久删除指定名称的区域。Tab 补全会显示现有的区域名称。
/rtpzone reset(或 /rtpzone clear)— 清除你当前的位置 1 和位置 2 的选择。
/rtpzone reload — 重新加载 config.yml、messages.yml 以及所有区域数据,无需重启服务器。
权限
rtpzone.admin — 授予对所有命令的访问权限(区域创建、删除、法杖使用、重载、选择)。
全局同步倒计时
- 所有处于任意 RTP 区域内的玩家都会看到相同的倒计时计时器,通过服务器范围内的调度程序进行同步。
- 倒计时以沉浸式的标题/副标题消息形式显示,每秒更新一次。
- 可通过 config.yml 中的
rtp.countdown 配置持续时间(默认值:30 秒)。
- 当计时器归零时,当前位于区域内的每位玩家都会被同时传送到随机的安全位置。
- 中途进入区域的玩家将立即加入当前的倒计时。
- 在计时器结束前离开的玩家将从队列中移除;不会发生传送。
智能安全位置查找器
- 在可配置的
min-radius 和 max-radius 范围内生成随机的 X/Z 坐标。
- 从世界顶端向下扫描,寻找第一个实心方块(避免空出生点)。
- 内置危险拒绝机制:检测并跳过岩浆、水、仙人掌以及虚空附近的位置。
- 最多重试 15 次,若仍失败则放弃并发送“未找到安全区域”的消息。
基于法杖的区域选择
- 管理员玩家通过
/rtpzone wand 获得一把具有自定义显示名称和描述 lore 的木斧。
- 左键点击方块设置位置 1;右键点击方块设置位置 2。
- 每个玩家的位置被单独存储,并在区域创建后自动清除(或通过
/rtpzone reset 手动清除)。
- 区域边界保存在 config.yml 的
zones.* 下,包含世界名称及最小/最大坐标。
玩家进出追踪(CountdownManager)
- 基于线程安全的
ConcurrentHashMap 支持的集合,追踪当前处于任意区域内的玩家。
PlayerMoveEvent 处理器检测玩家的区域进出,并采用方块级移动过滤(忽略旋转/流体抖动)。
- 进入区域时启动针对该玩家的标题任务,并发送“已进入区域”的消息。
- 离开区域时取消标题任务,将玩家从倒计时集合中移除,并发送“已离开区域”的消息。
- 玩家退出事件会自动清理标题任务。
PlaceholderAPI 集成
- 占位符:
%rtpzone_cooldown% — 返回下一次全局传送前的剩余秒数。
- 基于时间(System.currentTimeMillis),因此该占位符始终与显示的倒计时保持同步。
全息图支持
- 兼容 FancyHolograms 和 DecentHolograms(启动时自动检测)。
- 在名为
rtpzone_cooldown 的全息图上显示剩余的倒计时时间。
完全可自定义的消息(messages.yml)
- 所有面向玩家使用的文本均由 YAML 驱动,支持
& 颜色代码和十六进制颜色(&#RRGGBB)。
- 可配置聊天前缀、法杖名称/lore、区域创建/删除消息、倒计时标题/副标题文本以及帮助菜单条目。
- 通过
/rtpzone reload 重载,无需重启。
多平台支持
- 在
plugin.yml 中声明了 api-version: '1.21' 和 folia-supported: true。
- 使用来自 Paper/Folia API 的
GlobalRegionScheduler、RegionScheduler 和 EntityScheduler。
- 单个 jar 包即可在 Paper、Folia 和 Purpur 服务器上完全正常运行。
- Maven 构建配置文件生成针对特定平台的工件(
-paper、-folia、-purpur),并使用 ProGuard 进行混淆。
典型的管理人员操作流程(游戏中)
- 管理员运行
/rtpzone wand — 收到带有渐变色名称和描述 lore 的选择法杖。
- 管理员左键点击一个方块设置位置 1,右键点击另一个方块设置位置 2 — 聊天栏确认两个位置均已选定。
- 管理员运行
/rtpzone create spawnrtp — 区域保存到 config.yml 并立即生效。
- 一名玩家走进该区域 — 他们看到倒计时标题和一条“已进入区域”的聊天消息。
- 当全局计时器归零时,玩家被传送到随机的安全位置,并收到确认消息。
- 管理员运行
/rtpzone delete spawnrtp — 移除该区域及其配置条目。
- 管理员编辑 messages.yml 后运行
/rtpzone reload — 所有消息和区域在不重启的情况下重新加载。
安装
- 下载与你的服务器平台(
-paper、-folia 或 -purpur)匹配的 EnesRtpZone jar 文件,并将其放入 plugins 文件夹中。
- 启动一次服务器,以在
plugins/EnesRTPZone/ 下生成默认的 config.yml 和 messages.yml。
- 编辑
config.yml 以设置倒计时时长、半径范围和目标世界。
- (可选)自定义
messages.yml 以更改前缀、工具名称、倒计时标题以及所有面向玩家显示的文本。
- 运行
/rtpzone reload 即可应用更改,无需完全重启服务器。
配置文件
config.yml — 插件主要设置:
rtp:
countdown: 30
max-radius: 10000
min-radius: 1000
target-world: "world"
zones: {}
messages.yml — 所有面向玩家的提示信息,包括前缀、工具显示名称/描述、区域创建/删除/进入/退出消息、倒计时标题、帮助菜单条目以及错误消息。支持 & 颜色代码和 &#RRGGBB 十六进制颜色。
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)
- Staff runs
/rtpzone wand — receives the selection wand with a gradient-coloured name and lore.
- Staff left-clicks a block to set position 1 and right-clicks another block to set position 2 — chat confirms both selections.
- Staff runs
/rtpzone create spawnrtp — the zone is saved to config.yml and is now active.
- A player walks into the zone — they see the countdown title and an "entered-zone" chat message.
- When the global timer reaches zero, the player is teleported to a random safe location with a confirmation message.
- Staff runs
/rtpzone delete spawnrtp — removes the zone and its configuration entry.
- Staff runs
/rtpzone reload after editing messages.yml — all messages and zones reload without restart.
Installation
- Download the
EnesRtpZone jar matching your server platform (-paper, -folia, or -purpur) and place it in the plugins folder.
- Start the server once to generate default
config.yml and messages.yml under plugins/EnesRTPZone/.
- Edit
config.yml to set your countdown duration, radius bounds, and target world.
- (Optional) Customise
messages.yml to change the prefix, wand name, countdown titles, and all other player-facing text.
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧