5 2 Home Module

Home 模块

中文版本 | English version

功能

这个模块为每位玩家提供个人 home 列表，并支持设置默认 home。

和 warp 不同，home 完全按玩家个人保存。每位玩家只能看到和管理自己的 home，不会影响其他人的数据。

适用场景

如果服务器允许玩家长期经营固定地点，例如基地、农场、商店或据点，home 往往会是使用频率最高的功能之一。默认 home 的存在，也让回到常驻地点这件事更方便。

命令

/sethome <name>
/tmphome <name>
/home
/home <name>
/delhome <name>
/renamehome <name> <newName>
/updatehome <name>
/defaulthome <name>
/homes
/homes <page>
/homes <dimension>
/homes <page> <dimension>
/maphome <name> <true|false>

配置

主要相关的配置有 home.enabled、home.playerMaximum、home.temporaryHomeTtlSeconds、home.deleteInvalid、teleporting.delay、teleporting.cooldown、teleporting.preloadEnabled 和 teleporting.defaultSafetyCheck。

行为说明

当 /home 不带名称时，系统会使用默认 home。home.playerMaximum 用来限制每位玩家可保存的数量，而 home.deleteInvalid=true 时，加载存储会自动清理失效的 home。

除了传送本身，这个模块还包含一整套管理操作，例如重命名、删除、设置默认 home、把已有 home 更新到当前位置，以及查看带分页、支持过滤和排序的 home 列表。维度过滤既支持 minecraft:overworld 这样的原始 world id，也支持 overworld、nether、end 这些简写别名。真正执行传送时，同样会受到全局 delay 和 cooldown 的影响。默认是否尝试目标安全检查由 teleporting.defaultSafetyCheck 决定，但目标安全检查只会在目标预加载开启时运行。

如果启用了 Xaero 联动，/maphome <name> <true|false> 还可以控制某个 home 是否继续显示在当前玩家自己的地图里。这个操作不会删除 home 本身，也不会影响其他玩家。

使用时要注意

如果没有设置默认 home，直接输入 /home 时不会自动替玩家挑选一个点位。另一方面，当某个 home 所在维度已经失效时，是否自动清理，取决于 home.deleteInvalid 的设置。