5 4 Warp

Warp 模块

中文版本 | English version

功能

这个模块提供全服共享的 warp 点，由管理员维护，玩家可以直接使用。

它适合放那些全服都需要反复到达的地点，例如主城、商店区、活动场地或公共设施。和 home 相比，warp 更偏向公共资源，而不是玩家私有点位。

适用场景

当服务器需要建立一套稳定的公共传送点体系时，warp 通常是最合适的选择。管理员负责创建和维护，玩家负责直接使用。

命令

/warp <name>
/warps
/warps <page>
/warps <dimension>
/warps <page> <dimension>
/setwarp <name>
/delwarp <name>
/renamewarp <name> <newName>
/updatewarp <name>
/mapwarp <name> <true|false>
/gwarpmap
/gwarpmap <name> <true|false>

配置

主要相关的配置有 warp.enabled、warp.maximum、warp.deleteInvalid、teleporting.delay 和 teleporting.cooldown。

行为说明

warp.maximum=0 表示不限制数量。/setwarp、/delwarp、/renamewarp 和 /updatewarp 由管理员维护；当 warp.deleteInvalid=true 时，加载存储时会自动清理无效的 warp。

玩家在使用 /warp 时，同样会受到全局 delay 和 cooldown 的影响。除了传送本身，这个模块也承担了一部分内容管理职责，例如命名、重命名、删除、原地更新，以及在维度失效时是否自动清理旧数据。/warps 现在支持分页查看，也支持按维度过滤；过滤参数既可以用原始 world id，也可以用 overworld、nether、end 这些简写别名。

如果启用了 Xaero 联动，/mapwarp 用于控制当前玩家自己是否继续看到某个 warp；/gwarpmap 则用于控制这个 warp 是否仍然作为公共地图航点同步给玩家。前者是个人可见性，后者是全局可见性。

使用时要注意

如果玩家报告某个 warp 找不到，先区分是名称不存在，还是对应维度已经失效。后一种情况在开启 warp.deleteInvalid 后通常会在加载时被自动清理，不会长期保留。