FastRTP

快速随机传送 (Fast RTP)

一个不会造成卡顿的快速随机传送指令。

指令

• /rtp - 将玩家传送到随机位置。
• /rtpback - 将玩家传送回他们上次随机传送的位置。
• /rtp <玩家> <参数> - 将指定玩家传送到随机位置。需要权限。
• /rtp reload - 重新加载配置文件。

权限

• fast-rtp.command.root - 当 requirePermission 设置为 true 时，允许玩家使用 /rtp 指令。
• fast-rtp.command.advanced - 允许你传送其他玩家、指定维度、半径等。
• fast-rtp.command.reload - 重新加载配置文件。
• fast-rtp.bypass.cooldown - 允许玩家绕过 RTP 冷却时间。

配置

配置文件位于 /config/fast-rtp.json

{
  // 是否要求使用 /rtp 的玩家拥有 "fast-rtp.command.root" 权限
  "requirePermission": false,
  // /rtp 是否使用玩家当前所在的世界。
  // 如果为 false，且指令中未指定维度，将使用默认世界。
  "useCurrentWorld": false,
  // 添加严格的目标定位/移动检测，防止玩家利用指令逃离危险情况。
  "useStrictTeleportCheck": false,
  // /rtp 使用的默认维度。
  "defaultDimension": "minecraft:overworld",
  // 从世界中心搜索安全位置的最大半径。
  // 如果设置为 -1，半径将延伸至世界边界。
  "radius": -1,
  // 从世界中心搜索安全位置的最小半径。
  "minRadius": 0,
  // 检查危险周围方块的范围半径。此值不会超过 4。
  "safetyCheckRadius": 1,
  // 使用 /rtp 后应用的冷却时间（秒）。
  "cooldown": 30,
  // 可以被位置查找器跳过的特定生物群系标识符。
  // 这些也可用于跳过昂贵的区块加载，显著加快位置查找速度。
  "blackListedBiomes": [
    "minecraft:small_end_islands",
    "minecraft:the_end",
    "minecraft:the_void"
  ],
  // 可以被位置查找器跳过的生物群系标签。
  "blackListedBiomeTags": [
    "minecraft:is_beach",
    "minecraft:is_ocean",
    "minecraft:is_deep_ocean",
    "minecraft:is_river"
  ],
  // 指令消息。文本格式使用 https://placeholders.pb4.eu/user/text-format/ 进行设置。
  "messages": {
    "rtpStartSearch": "<yellow>正在寻找安全位置...",
    "rtpLocFound": "<yellow>在 ${seconds} 秒内找到了安全位置",
    "rtpTeleportPlayer": "<dark_aqua>已传送到 <green>${x} ${y} ${z} <dark_aqua>位于 <green>${world}",
    "rtpLocNotFound": "<red>[✖] 找不到安全位置！",
    "rtpOnCooldown": "<red>[✖] <gold>请等待 <yellow>${seconds} <gold>秒后再使用 RTP！",
    "preventedRtp": "<red>[✖] 无法开始随机传送。\n原因：${reason}",
    "rtpBackSuccess": "<dark_aqua>已传送回你上次随机传送的位置！",
    "rtpBackLocNotFound": "<red>[✖] 你没有任何最近的随机传送记录。",
    "preventedRtpBack": "<red>[✖] 无法传送回你上次 RTP 的位置。\n原因：${reason}",
    "tpSecondsLeft": "<yellow>将在 ${seconds} 秒后传送...",
    "tpCancelled": "<red>[✖] 传送已被取消。"
  }
}