CompendiumZZ

CompendiumZZ 的功能

• 直接基于 Hytale 原生资源建立物品与配方索引，而非使用外部目录。
• 提供一个带有文本搜索、分类筛选、命名空间筛选和详情侧边栏的浏览器界面。
• 为每个物品显示制作配方和“用于合成”的配方。
• 存储玩家的收藏、近期历史和视图偏好。
• 包含一个用于手动重建索引和目录诊断的管理面板。

命令与工作流程

• /compendium 打开主浏览器。
• /compendium admin 为授权用户打开管理面板。
• /compendium reload 重新加载配置和消息。
• /compendium reindex 强制手动重建目录索引。
• 普通玩家的流程以 UI 为先，从 /zz 和 compendium 中心入口进入。

运行时文件与数据

• config.json 存储中心入口、命令、网格密度、历史、收藏和重建索引设置。
• messages.json 存储可编辑的操作消息目录。
• 该模块将其运行时数据存储在 ZonaZeroMc/ZZCompendium 下。
• players/ 按 UUID 存储收藏、近期项目和视图偏好。
• cache/index-state.json 存储最新的索引状态和最近的索引错误。
• 实时索引是根据 Hytale 物品和制作资源重建的。

可见配置示例

这是模块生成其设置时你会看到的一种 config.json 文件：

{
  "enableHubEntry": true,
  "enableCommands": true,
  "defaultGridColumns": 5,
  "defaultGridRows": 6,
  "maxRecentHistory": 16,
  "allowFavorites": true,
  "showNamespaceFilter": true,
  "showCraftableFilter": true,
  "enableInspectOverlay": true,
  "adminReindexCooldownSeconds": 20,
  "debugLogging": false
}

以下部分用通俗语言解释每一行改变的内容。

配置参考

config.json 中的主要设置

• enableHubEntry (true/false)：在生态系统中心中显示或隐藏 compendium 入口。
• enableCommands (true/false)：启用或禁用 /compendium 命令界面。
• defaultGridColumns (数字)：浏览器中默认的网格列数。
• defaultGridRows (数字)：浏览器中默认的网格行数。
• maxRecentHistory (数字)：每个玩家保留的最大近期项目数。
• allowFavorites (true/false)：启用或禁用收藏功能。
• showNamespaceFilter (true/false)：在界面中启用命名空间筛选器。
• showCraftableFilter (true/false)：在界面中启用仅显示可制作物品的筛选器。
• enableInspectOverlay (true/false)：启用物品检查覆盖层。
• adminReindexCooldownSeconds (数字)：再次触发手动重建索引前的冷却时间。
• debugLogging (true/false)：启用额外的调试日志记录。

权限

• compendium.use
• compendium.admin
• compendium.reindex

安装

1. 先将 ZZCore.jar 复制到服务器的 mods 文件夹中。
2. 然后将 ZZCompendium.jar 复制到同一个服务器的 mods 文件夹中。
3. 启动 Hytale。
4. 让模块索引资源，然后根据需要配置玩家/管理员权限。

许可证

版权所有。

未经作者书面许可，不允许重新分发、转载、转售修改或重新上传分支版本。