Enes RtpZone | 插件

插件

原名 Enes RtpZone | Plugin · 作者 Enes9899

带有全局倒计时、即时传送和多平台支持(Paper/Folia/Purpur)的高级 RTP 区域系统。具备可配置的目标世界、异步区块加载和安全位置检测功能。

0 本站下载 0 关注 更新于 4 个月前

最新 1.0 · 1.21.11 · Purpur

一键开服(送7天)

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 进行混淆。

典型的管理人员操作流程(游戏中)

  1. 管理员运行 /rtpzone wand — 收到带有渐变色名称和描述 lore 的选择法杖。
  2. 管理员左键点击一个方块设置位置 1,右键点击另一个方块设置位置 2 — 聊天栏确认两个位置均已选定。
  3. 管理员运行 /rtpzone create spawnrtp — 区域保存到 config.yml 并立即生效。
  4. 一名玩家走进该区域 — 他们看到倒计时标题和一条“已进入区域”的聊天消息。
  5. 当全局计时器归零时,玩家被传送到随机的安全位置,并收到确认消息。
  6. 管理员运行 /rtpzone delete spawnrtp — 移除该区域及其配置条目。
  7. 管理员编辑 messages.yml 后运行 /rtpzone reload — 所有消息和区域在不重启的情况下重新加载。

安装

  1. 下载与你的服务器平台(-paper、-folia 或 -purpur)匹配的 EnesRtpZone jar 文件,并将其放入 plugins 文件夹中。
  2. 启动一次服务器,以在 plugins/EnesRTPZone/ 下生成默认的 config.yml 和 messages.yml。
  3. 编辑 config.yml 以设置倒计时时长、半径范围和目标世界。
  4. (可选)自定义 messages.yml 以更改前缀、工具名称、倒计时标题以及所有面向玩家显示的文本。
  5. 运行 /rtpzone reload 即可应用更改,无需完全重启服务器。

配置文件

config.yml — 插件主要设置:

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

zones: {}

messages.yml — 所有面向玩家的提示信息,包括前缀、工具显示名称/描述、区域创建/删除/进入/退出消息、倒计时标题、帮助菜单条目以及错误消息。支持 & 颜色代码和 &#RRGGBB 十六进制颜色。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源