5 4 Warp

Warp 模块

中文版本 | English version

功能

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

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

适用场景

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

命令

/warp <name>
/warps
/warps <page>
/warps filter prefix <letter>
/warps filter dimension <dimension>
/warps sort <name|sequence> [asc|desc]
/setwarp <name>
/delwarp <name>
/renamewarp <name> <newName>
/updatewarp <name>
/mapwarp <name> <true|false>
/gwarpmap <name> <true|false>

配置

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

行为说明

warp.maximum=0 表示不限制数量。/setwarp、/delwarp、/renamewarp 和 /updatewarp 由管理员维护；当 warp.deleteInvalid=true 时，如果执行 warp 传送时发现目标世界不可用，会自动删除对应的无效 warp。加载存储时不会因为维度暂时不可用而清理 warp。

玩家在使用 /warp 时，同样会受到全局 delay 和 cooldown 的影响。默认是否尝试目标安全检查由 teleporting.defaultSafetyCheck 决定，但目标安全检查只会在目标预加载开启时运行。除了传送本身，这个模块也承担了一部分内容管理职责，例如命名、重命名、删除、原地更新，以及在维度失效时是否自动清理旧数据。/warps 支持分页、过滤和排序；管理员还可进入单个 warp 的管理页执行更新和带确认的删除，同时保留原列表的页码、筛选与排序状态。维度过滤参数既可以用原始 world id，也可以用 overworld、nether、end 这些简写别名。

如果启用了地图联动，/mapwarp 用于控制当前玩家自己是否继续看到某个 warp；/gwarpmap <name> <true|false> 则用于直接控制这个 warp 是否仍然作为公共地图航点同步给玩家。前者是个人可见性，后者是全局可见性。管理员也可以在 /warps 页面中查看和切换全局地图可见性。

使用时要注意

如果玩家报告某个 warp 找不到，先区分是名称不存在，还是对应维度已经失效。后一种情况在开启 warp.deleteInvalid 后，会在传送尝试发现目标世界不可用时被自动清理。