B-RTP

BlanketRTP

BlanketRTP 是一个功能丰富的服务端 Fabric 模组，为你的世界提供有趣、安全且高度可配置的随机传送（RTP）系统。无论你是想让玩家探索随机地点、寻找特定生物群系，还是从天空中缓缓滑翔而下，BlanketRTP 都能提供完善且高性能的解决方案。

---

---

依赖项

• Fabric API
• Fabric Language Kotlin
• E-Utils (EverlastingUtils)

---

功能特性

• 标准与生物群系 RTP：使用 /rtp 传送到随机安全地点，或使用 /rtp biome <biome_id> 指定目标生物群系。
• 平滑滑翔机制：玩家不是直接出现，而是被传送到高空并自动开始滑翔，附带可自定义的粒子效果和视觉上装备的鞘翅。
• 注重性能的“慢速加载”：通过在玩家到达前缓慢预加载目标区域，防止传送到新区块时造成服务器卡顿（TPS 下降）。
• 分级冷却系统：使用权限为不同玩家等级创建不同的冷却时间（例如，VIP 拥有更短的冷却时间）。
• 维度重定向：强制在某些维度（如末地或下界）使用 /rtp 的玩家被传送到另一个指定的世界。
• 丰富的配置：控制从传送半径和冷却时间到滑翔物品的 NBT、粒子效果以及所有面向玩家的消息等一切内容。
• 管理工具：使用 /rtp reload 实时重载配置，并在需要时强制停止玩家的滑翔。

---

命令

主命令为 /rtp。所有权限节点均可在配置文件中完全配置。

命令	权限	描述
/rtp	blanketrtp.rtp	将玩家传送到随机安全地点。
/rtp no_glide	blanketrtp.rtp.noglide	执行随机传送，但强制本次不使用滑翔机制。
/rtp biome <biome_id>	blanketrtp.rtp.biome	寻找并将玩家传送到指定生物群系内的随机地点。
/rtp biome <biome_id> no_glide	blanketrtp.rtp.biome	传送到指定生物群系，并强制关闭滑翔。
/rtp reload	blanketrtp.admin.reload	从磁盘重新加载 blanketrtp.json 配置文件。
/rtp stopgliding <player>	blanketrtp.admin.stopgliding	强制停止指定玩家由 RTP 引起的滑翔。

---

配置

BlanketRTP 使用单个综合配置文件，位于 config/blanketrtp/blanketrtp.json。它允许对几乎每个功能进行深度自定义。

主 RTP 设置

• rtpRadius：玩家可以被传送到的距世界中心（0,0）的最大距离（以方块为单位）。
• dimensionRedirects：一个用于控制跨维度 RTP 的强大功能。默认情况下，它被配置为将任何在下界或末地使用 /rtp 的玩家发送到主世界。你可以移除这些条目以允许在这些维度内进行 RTP，或添加自己的自定义重定向。
• cooldowns：此列表允许你创建分级冷却系统。模组会从上到下检查权限。你可以为不同等级定义层级（例如 blanketrtp.cooldown.vip），并使用空权限（""）定义默认回退。

滑翔系统（glidingOptions）

此部分控制“从天而降”机制。

设置	描述
enabled	全局开启或关闭滑翔机制的总开关。
teleportHeight	玩家在开始滑翔前被传送到地面上方的高度（Y 层级）。
particlesEnabled	切换玩家滑翔时跟随的粒子轨迹。你可以自定义 particleType、amount 等。
glider	控制玩家视觉上装备的物品。你可以更改 gliderItemId（例如，改为自定义材质的鞘翅），甚至通过 gliderNbtData 指定其 NBT 数据，使其看起来带有附魔或具有特定的自定义模型。

性能（slowLoadOptions）

此部分对于防止服务器卡顿至关重要，尤其是在玩家传送到未生成的区块时。

• enabled：如果为 true，模组将在传送玩家之前缓慢预加载目标位置的区块。
• radius：目标位置周围要加载的区块半径。半径为 1 会加载 3x3 的区块区域。
• loadDelayMillis：队列中加载每个区块之间的暂停时间（以毫秒为单位）。值越高，传送准备越慢但越平滑，对服务器性能的影响越小。
• keepLoadedSeconds：玩家到达后，区块保持强制加载的时间，以确保平稳落地。

消息

• 发送给玩家的每条消息均可配置，从冷却通知到成功消息。它们都支持 MiniMessage 格式，允许使用渐变、自定义颜色等。