WarpUtils

WarpUtils

一个高度可自定义的传送功能模组，用于服务端特性，如tpa请求或家。

交通

WarpUtils预览查看大图

简介

WarpUtils 是一款轻量级、完全可配置的服务器端实用模组，提供基本的传送功能：家（Homes）、传送点（Warps）和传送请求（TPA）。 灵感来源于 VanillaTweaks Datapacks。

由于它仅位于服务器端，你可以将其安装在服务器上，纯原版客户端玩家无需任何额外下载或损失即可加入。

核心功能

  • 家（Homes）： 玩家可以设置个人传送点并传送回这些位置。
  • 传送点（Warps）： 管理员可以设置全局传送点（如商店或主城），所有玩家均可使用。
  • 传送请求（TPAs）： 玩家之间可以安全地发送传送请求。
  • 返回（Back）： 一个便捷命令，可在传送后返回之前的位置。

功能特点

每项传送功能均包含：

  • 冷却时间（Cooldowns）： 配置玩家在传送后需等待多久才能再次使用该命令。
  • 预热延迟（Warm-up Delays）： 配置传送执行前的“原地等待”计时器。若玩家移动、执行其他命令或受到攻击（若战斗冷却激活），此延迟将被取消。
  • 可配置性（Configurable）： 每项功能均可独立禁用和配置（详见下文配置信息）。
家（Homes）

允许玩家设置个人家并随时传送回去。服务器所有者可以配置每位玩家允许拥有的最大家的数量。

命令 描述
/home <家庭名称> 传送至指定家
/home 传送至你的默认家（若未设置默认，则自动选择一个）
/setdefaulthome <家庭名称> 将已有的家设置为默认
/sethome <家庭名称> 在你当前所在位置创建或覆盖一个家
/delhome <家庭名称> 删除指定的家
/renamehome <当前名称> <新名称> 重命名已有的家（若新名称已存在也可覆盖）
/homes 列出你所有保存的家及其坐标
传送请求（TPAs）

允许玩家向其他玩家发起传送请求。一旦接收方接受请求，请求方将被传送至接收方位置。

注意： 每位玩家同时只能有一个发出的活动请求，但可以接收多个收到的请求。冷却时间在传送完成后生效；延迟在请求被接受后生效。

命令 描述
/tpa <目标玩家> 向指定玩家发送传送请求
/tpaaccept <玩家> 接受来自特定玩家的请求
/tpaaccept 接受最近的传送请求。
/tpadeny <玩家> 拒绝来自特定玩家的请求
/tpadeny 拒绝所有收到的活动请求
/tpacancel 取消你发出的传送请求
/tpas 显示所有活动中的发出和收到的请求
传送点（Warps）

允许管理员管理所有玩家均可前往的全局兴趣点。

出生点传送点（Spawn Warp）： 默认情况下，Spawn 传送点已启用并关联至世界出生点（可通过 /setworldspawn ... 设置）。

  • 可通过执行 /setwarp Spawn 覆盖，使其脱离世界出生点。
  • 可通过删除自定义传送点 /delwarp Spawn 重新关联至世界出生点。
命令 描述
/warp <传送点名称> 传送至指定的全局传送点
/warps 列出所有可用的传送点及其位置
/setwarp <传送点名称> （管理员） 在当前位置创建或覆盖一个传送点
/delwarp <传送点名称> （管理员） 删除指定的传送点
/renamewarp <当前名称> <新名称> （管理员） 重命名已有的传送点

标记为 （管理员） 的命令只能由运营商执行

返回命令（Back）

允许玩家返回至他们上一次传送前所在的位置或死亡地点。其行为可通过配置文件高度定制（包括 mode 和 duration 设置）。

命令 描述
/back 传送回你最近一次传送前的位置
随机传送命令（Tpr）

允许玩家传送至随机位置。传送的最大和最小范围均可配置。

命令 描述
/tpr 将你传送至随机位置
玩家偏好与效果

使用以下命令个性化你的体验：/warputils personal <偏好> ...

可自定义选项：

  • 延迟显示： 传送时进度显示方式：none（无）、percentage（百分比）或seconds（秒数）。
  • 语言： 设置显示语言（目前仅支持英语）。
  • 消息位置： 选择模组消息显示位置：chat（聊天栏）或 actionbar（快捷栏上方）（某些消息可能强制在某处显示，例如家庭列表）。
  • 粒子效果： 调整传送的视觉效果。

视觉效果

粒子效果在三个阶段显示：

  1. 充能效果： 预热延迟期间。
  2. 离开效果： 在离开的位置。
  3. 到达效果： 在目的地位置。

注意：管理员可以在全局强制执行特效，覆盖玩家的个人偏好。

配置

注意：配置文件不用于直接配置。它仅设置创建世界时使用的默认值，或可在配置文件中使用 /warputils config reset、/warputils config <类别> reset 或 /warputils config <类别> <设置> default 重置特定世界的配置。

/warputils config <类别> 命令允许你作为管理员方便地配置每个功能。非管理员可以读取配置值，但无法编辑。

通用 此配置类别允许你设置更通用的配置，例如默认的 `messageTarget` 或用于传送的 `cooldown` 和 `delay` 值。每个传送功能默认继承 `cooldown` 和 `delay` 值（相应设置的值设为 -1），但可单独设置，例如使用 `/warputils config <功能> cooldown <值>`。

使用 /warputils config general <设置> <值> 进行访问。

设置 默认值 描述
cooldown 1200（1 分钟） 传送之间的等待时间（以刻为单位）
delay 60（3 秒） 执行命令与传送到位之间的时间（以刻为单位）
messageTarget actionbar 向玩家显示消息的主要位置

冷却时间默认值的例外是 /tpr 命令，其冷却时间为 24000（20 分钟）。

刻：1 刻 = 1/20 秒

家 使用 `/warputils config homes <设置> <值>` 进行访问。
设置 默认值 描述
interDimTP true 允许跨维度传送
maxHomeCount 3 每位玩家可以拥有的最大家的数量（0 = 无限）
disableHomes false 禁用家（不会删除已有的家）
传送请求（Tpas） 使用 `/warputils config tpas <设置> <值>` 进行访问。
设置 默认值 描述
interDimTP true 允许跨维度传送
duration 6000 传送请求的有效时长（以刻为单位，0 = 无限）
disableTpas false 禁用传送请求

刻：1 刻 = 1/20 秒

传送点（Warps） 使用 `/warputils config warps <设置> <值>` 进行访问。
设置 默认值 描述
interDimTP true 允许跨维度传送
disableSpawnWarp false 是否禁用出生点传送点
disableWarps false 禁用传送点（不会删除已有的传送点）
返回命令 使用 `/warputils config back <设置> <值>` 进行访问。
设置 默认值 描述
interDimTP true 允许跨维度传送
duration 0 传送请求的有效时长（以刻为单位，0 = 无限）
mode backBack /back 命令的操作模式
backOnDeath false 你的死亡是否设置返回位置
disableBack false 禁用 /back 命令

/back 命令的操作模式：

  • backBack（返回往返）： 你可以传送回使用 /back、/home、/tpa 或 /warp 之前的位置
  • singleUse（单次使用）： 每次使用 /home、/tpa 或 /warp 传送后，你只能传送回一次
  • persistent（持续保持）： 返回位置仅在您使用 /home、/tpa 或 /warp 时改变
随机传送命令（Tpr） 使用 `/warputils config tpr <设置> <值>` 进行访问。
设置 默认值 描述
minRange 500 随机传送可以将你传送远离当前位置的最小距离（以方块为单位）
maxRange 2000 随机传送可以将你传送远离当前位置的最大距离（以方块为单位）
disableTpr false 禁用 /tpr 命令
效果 使用 `/warputils config effects <设置> <值>` 进行访问。
设置 默认值 描述
chargeEffect RisingRings 延迟期间显示的默认效果
enforceChargeEffect false 强制使用默认充能效果；始终播放此效果，而非玩家选择的效果
teleporationEffect Smoke 离开位置时显示的默认效果
enforceTeleportEffect false 强制使用默认传送效果；始终播放此效果，而非玩家选择的效果
arrivalEffect Smoke 到达位置时显示的默认效果
enforceArrivalEffect false 强制使用默认到达效果；始终播放此效果，而非玩家选择的效果
disableEffects false 禁用此模组中的所有粒子效果

注意：若要禁用某个特定效果，可选择“无”效果并强制使用。

战斗冷却 使用 `/warputils config fightCooldown <设置> <值>` 进行访问。
设置 默认值 描述
cooldown 60 受到攻击后无法传送的持续时长
onlyPvP false 是否仅玩家能触发此冷却

注意：若要禁用此功能，请将冷却时间设为 0。

备注：

欢迎在我的 GitHub issues 页面分享任何关于添加或修改的建议。

另外，Minecraft 版本 26.1 及更高版本将不再支持 Forge。