BetterRTP - 随机传送插件

BetterRTP 是一款专为服务器管理员设计的随机传送插件，它允许你精确控制玩家在预设边界内的传送位置，支持自定义中心安全区、黑名单方块，并为不同世界设置独立的边界规则。

💡支持与社区

• 需要更多帮助或支持？欢迎加入我们的 Discord 服务器！

- Discord 邀请码：`8Kt4wKm`

- 或点击链接：[http://discord.gg/8Kt4wKm](http://discord.gg/8Kt4wKm)

• 查看我们的官方 YouTube 频道以获取更多视频教程：@RonanNetwork
• 欢迎在 GitHub 上帮助翻译插件或提出建议！

关于数据统计

本插件会收集匿名统计数据（如服务器数量、核心数、在线玩家数等），以激励开发者发布更多更新。你可以在 bStats 配置文件中随时选择退出，但我们建议保持开启。

⭐核心亮点

BetterRTP 旨在为服主提供对随机传送的全面控制，主要特性包括：

• Folia 支持：兼容 1.19+ 的 Folia 多线程服务器，提升性能。
• 世界边界控制：可遵循原版 /worldborder set <直径> 设置的边界，或自定义每个世界的最大/最小 X、Z 坐标。
• 世界禁用：可禁用特定世界，不允许在其中使用 /rtp。
• 方块黑名单：列出玩家不能被传送至其上的方块（如水和岩浆）。
• 安全尝试次数：设置寻找安全传送点的尝试次数，以减少延迟。
• 多插件区域保护支持：尊重其他保护插件的区域，防止玩家随机传入受保护领地。

✨功能列表

• 多世界支持：为不同世界设置自定义边界和中心点。
• 冷却与延迟：设置命令使用冷却时间，以及传送前的等待延迟（移动会取消）。
• 音效与标题：可自定义传送成功或等待时的音效，并支持变量占位符的标题显示。
• 世界覆盖：例如，当玩家在下界或末地时，可设置其传送到主世界。
• 经济系统：可为特定世界的传送设置费用。
• 粒子与药水效果：传送时可触发粒子效果和药水效果。
• 首次加入传送：玩家首次加入服务器时可自动传送。
• 无敌时间：传送后为玩家提供一段时间的伤害免疫。
• 权限组：可根据玩家拥有的特定权限，应用不同的传送限制规则。

🔧插件集成

BetterRTP 与众多主流领地保护插件兼容，并支持 PlaceholderAPI。

区域保护插件支持

• WorldGuard
• GriefPrevention
• Towny
• RedProtect
• FactionsUUID
• Lands
• Residence
• KingdomsX
• hClaims
• GriefDefender
• UltimateClaims
• MinePlots
• CrashClaims
• BetterClaims (由 RonanCraft 开发)

软依赖与库

• PlaceholderAPI：在消息、GUI（如 AdvancedCustomMenu）或插件内的物品中使用变量占位符。
• ParticleLib (已内置)：由 ByteZ1337 开发的粒子效果库。
• PaperLib (已内置)：用于异步区块加载的 PaperMC API 接口库。
• FoliaLib：为 1.19+ 的 Folia 服务器提供计时支持。

🎮安装指南

• 下载 BetterRTP.jar。
• 安装你计划使用的任何软依赖插件（如 PlaceholderAPI）。
• 将所有文件上传至服务器的 /plugins 文件夹。
• 重启服务器，进行配置，然后执行 /rtp reload 使配置生效。
• 设置权限：为了让插件正常工作，请确保给予玩家相应权限：

- `betterrtp.world.<世界名>`：允许在指定世界使用随机传送。

- `betterrtp.world`：允许使用 `/rtp world <世界名>` 命令。

[/] 命令列表

命令格式说明：[ ] 内为可选参数，< > 内为必填参数。

• /rtp

- 随机传送。

- 权限：`betterrtp.use` 及 `betterrtp.world.<世界名>`

- 若使用权限组，还需：`betterrtp.group.<组名>`

• /rtp help

- 在聊天栏显示所有命令。

- 权限：`betterrtp.use`

• /rtp edit <参数>

- 快速编辑世界参数，无需手动修改配置文件。

- 权限：`betterrtp.edit`

• /rtp player <玩家名> [世界名] [标识...]

- 随机传送另一名玩家。

- **或**：`/rtp player_sudo <玩家名> [世界名]` (以管理员身份传送玩家)

- 权限：`betterrtp.player`

• /rtp world <世界名> [生物群系1, 生物群系2...]

- 随机传送到另一个世界。

- 权限：`betterrtp.world` 及 `betterrtp.world.<世界名>`

• /rtp reload

- 重载插件配置。

- 权限：`betterrtp.reload`

• /rtp version

- 查看当前插件版本。

- 权限：`betterrtp.use`

• /rtp biome <生物群系1, 生物群系2...>

- 传送到指定生物群系内。

- 权限：`betterrtp.biome`

• /rtp info

- 显示所有世界及其已配置的传送参数。

- 权限：`betterrtp.info`

• /rtp location <地点名称>

- 使用预设的地点名称进行传送。

- 权限：`betterrtp.location`

- 若在 `locations.yml` 中启用了 `UseLocationsInSameWorld`，则可以使用 `/rtp location <地点>` 传送到非当前世界的任何地点，需权限：`betterrtp.location.bypass`

• /rtp test

- 测试传送效果（不会实际传送）。

- 权限：`betterrtp.admin`

• /rtp queue

- 查看所有已生成并排队的传送位置。

- 权限：`betterrtp.admin`

• /rtp addons <...>

- 仅在安装 `BetterRTPAddons` 扩展插件时启用。

🔧权限节点

• betterrtp.* - 所有权限
• betterrtp.world - 使用 /rtp world <世界名> 命令
• betterrtp.world.* - 在所有已启用的世界中使用 RTP
• betterrtp.world.<世界名> - 在指定世界中使用 RTP
• betterrtp.bypass.* - 绕过所有 RTP 要求（冷却、延迟、经济等）
• betterrtp.use - 允许使用 /rtp 命令
• betterrtp.player - 使用 /rtp player <玩家名> 命令
• betterrtp.biome - 使用 /rtp biome 命令
• betterrtp.bypass.cooldown - 绕过冷却时间
• betterrtp.bypass.delay - 绕过延迟等待
• betterrtp.bypass.economy - 绕过经济费用
• betterrtp.bypass.hunger - 绕过饥饿值消耗
• betterrtp.reload - 使用 /rtp reload 命令
• betterrtp.updater - 接收新版本更新通知
• betterrtp.info - 使用 /rtp info 命令
• betterrtp.admin - 在调试模式下使用 /rtp test 和 /rtp queue 命令
• betterrtp.config.<组名> - 使用指定的权限组配置
• betterrtp.location - 使用 /rtp location <地点名> 命令

❓附加说明与建议

• 扩展插件：查看 BetterRTPAddons 插件，它提供了传送门、物品和额外效果等更多功能。
• API：集成的 API 允许其他插件通过扩展来增强 BetterRTP 的功能。
• 反馈：如果你喜欢这个插件，请留下五星好评！请不要在评价中提交 Bug，请将 Bug 或错误报告发布在讨论页面。
• 贡献：欢迎为项目做出贡献或自行编辑代码，项目地址可在 GitHub 上找到。

使用条款

• 你可以分发此插件，但下载链接必须指向本页面。
• 禁止复制代码并声称是自己的作品。
• 你可以克隆此插件的仓库供私人使用。