HomePlus

HomePlus

HomePlus 是一款适用于 Hytale 服务器的全能传送和生活便利套件。它将家、公共家、传送请求、随机传送、恢复工具和管理员控制整合在一个统一的系统中。

v1.4.1 更新内容

• 维护/稳定性更新，侧重于发布版本的加固。
• 改进了插件关闭清理：
  • 运行时系统现在在关闭/重载时能更干净地注销。
  • HomePlus 地图标记在关闭期间能更可靠地被清除。
• 强化了请求-目标解析：
  • 用户界面请求操作现在使用稳定的标识符，而不是脆弱的原始名称。
  • 家/家请求和 TPTO 请求解析更好地支持基于 UUID 的定位。
• 降低了内部状态泄漏风险：
  • HomeManager 现在通过防御性副本来保护存储的家状态。
• 减少了脆弱的标记清理行为：
  • 标记清除逻辑现在减少了对反射内部机制的依赖。
• 增加了回归测试覆盖：
  • 测试现在涵盖了配置迁移/清理、家持久化/排序规则、请求过期/查找行为以及命令输入解析。

先前功能发布：v1.4.0

• 添加了"仅家模式"访问控制流程：
  • 在启用"仅家模式"后，非 OP 玩家可以被命令锁定。
  • 游戏中的 OP 可以通过 /homeplus <玩家> 为某个玩家强制打开 HomePlus。
  • 游戏中的 OP 可以通过 /homeplus close <玩家> 关闭/撤销访问权限。
  • OP 玩家自动豁免。
• 添加了管理员默认家传送命令：
  • /home tpdefault <玩家|uuid> 将该在线玩家传送到其默认家。
  • 强制性的管理员传送忽略正常的家传送延迟/冷却。
• 扩展了 HomePlus 玩家管理员 面板：
  • 添加了 TP Player 按钮，用于将选定的在线玩家传送到默认家。
• 添加了"仅家模式"的重生路由：
  • 重生时，如果可用，玩家会被传送到其 HomePlus 默认家。
  • 如果没有有效的默认家/世界存在，重生意回退到正常行为。
• 添加了可选的床设置家行为：
  • home.bedSetsHomeEnabled 允许与床交互时创建一个 HomePlus 家，并阻止原版床的行为。
• 添加/扩展了命令行为：
  • /home <家名称> 直接传送到指定名称的家（除了已有的 /homes <名称> 支持）。
• 从 HomePlus 移除了连锁挖矿（本模组中没有连锁挖矿的配置/模块/UI）。

为什么服主选择 HomePlus

• 一个模组覆盖了大多数常见的传送工作流程，减少了插件/模组泛滥。
• 玩家体验简洁：/hp 打开完整菜单，无需记忆命令。
• 管理体验实用：/hpadmin 提供实时配置编辑和玩家/家管理。
• 安全优先的操作在存在破坏性行为时包含预览/确认。
• 向后兼容的配置/数据处理，确保服务器稳定升级。

核心功能

家系统

• /sethome [名称] 创建或更新家
• /home 传送到默认家
• /home <名称> 传送到指定名称的家
• /homes 管理已命名的家（传送、设为默认、重命名、删除、上移、发布）
• /delhomes <名称> 快速删除家
• 全局家数量上限，支持可选的 * 无限数量
• 可选的基于全局上限的玩家个人插槽授予
• 可选的床交互覆盖以设置家

仅家模式

• 可选的专用、以家为核心的玩家 UI 布局
• 为玩家隐藏/锁定非家的功能（RTP、TPTO、返回、死亡、堆叠、公共家、请求面板）
• 由 OP 控制的菜单访问流程（为特定玩家强制打开/关闭）
• 模式激活时可选的重生到默认家行为

公共家

• 发布/取消发布选定的家
• 使用分页和搜索浏览公共家
• 通过所有者+家名称传送到已发布的家
• 每个玩家的公共家数量限制

玩家到玩家传送

• /tpto 请求系统，包含接受/拒绝流程
• 启用时的批量决策（acceptall、denyall）
• 自动接受/自动拒绝偏好
• 通过 /home <玩家> 发送的家参观请求，支持接受/拒绝（在"仅家模式"限制之外）

随机传送 (RTP)

• /rtp 安全地随机传送到远离出生点的地方
• /rtp poi 变体，传送到兴趣点目标附近的随机位置
• 改进了区块/列探测策略和水域密集区块的拒绝
• POI 搜索支持自适应距离和可选的区块级缓存
• 可配置的尝试次数、距离范围和独立的冷却时间

恢复传送

• /return 传送后回到你之前的位置
• /death 返回到你最近的死亡地点
• 死亡传送的可选安全着陆处理

实用系统

• /stack 快速将背包物品堆叠到附近的容器中
• 营火治疗系统，带伤害冷却保护
• 营火恢复的可选原生增益图标支持
• 指南针/地图标记集成，用于家和返回点

游戏内 UI

/hp (别名: /homeplus)

• 多面板玩家菜单，用于家和传送/恢复工作流程
• 直接在 UI 中进行家行操作
• 传入请求管理（单个、批量及自动偏好）
• "仅家模式"可以切换到专用的、以家为核心的布局

/hpadmin (别名: /hpa，仅 OP)

• HomePlus 配置管理员 面板：
  • 实时编辑配置类别（家、tpto、stack、rtp、campfire、markers、death/return、logging）
  • 保存/重载控制
  • 跨设置过滤/搜索
• HomePlus 玩家管理员 面板：
  • 玩家/家搜索
  • 插槽授予控制（+1、-1、设置、清除）
  • 带预览优先行为的单按钮修剪
  • 每个家的操作：发布/取消发布、设为默认、删除（确认）、传送
  • TP Player 操作，将选定的在线玩家传送到默认家
  • 所有玩家模式，用于跨玩家浏览家

管理员命令参考

• /homeslots info <玩家|uuid>
• /homeslots grant <玩家|uuid> [数量]
• /homeslots revoke <玩家|uuid> [数量]
• /homeslots set <玩家|uuid> <数量>
• /homeslots clear <玩家|uuid>
• /homeslots trim <玩家|uuid>
• /homeslots trimapply <玩家|uuid>
• /homeplus <玩家> (OP: 为该玩家强制打开 HomePlus)
• /homeplus close <玩家> (OP: 关闭/撤销该玩家的会话)
• /home tpdefault <玩家|uuid> (OP: 将玩家传送到默认家)

别名：

• /homeslot
• /hslots
• /hp
• /hpa

配置模块

HomePlus 使用结构化的 config.json，包含以下部分：

• home
• tpto
• stack
• rtp
• campfire
• compassAndMapMarkers
• death
• return
• logging

持久化

HomePlus 会持久化数据以确保重启后的稳定性：

• homes.json
• returns.json
• deaths.json
• home-slot-grants.json
• home-request-preferences.json
• tpto-preferences.json
• home-quickstack.json

总结

如果你想要快速旅行、基于请求的传送、恢复工具以及实用的游戏内管理控制，而无需同时管理多个模组，HomePlus 提供了一个完整且统一的解决方案。