亚历克的NPC调试界面！

Hytale 游戏内的 NPC 调试工具。可与任何模组配合使用，旨在通过 UI 工具检查实时 NPC 行为，而不是使用命令刷屏。

安装 Alec's Tamework 后，检查器还会利用 Tamework 的公开 API，在实时 ECS 状态之外，额外显示已保留的驯服/档案状态。

功能概览

• 添加了一个游戏内 NPC 调试检查器工具物品，可以：
  • 链接/取消链接多个 NPC
  • 打开已链接的 NPC 清单
  • 快速检查已链接的 NPC
  • 为每个 NPC 切换内置的角色调试标志
• 包含一个 固定悬浮窗，让你在继续游戏时，所选检查器字段始终可见。
• 在检查器数据中追踪 最近的状态/事件变化。
• 当 Tamework 存在时，会添加额外的基于 API 的调试部分，用于查看：
  • 已保存的档案和快照状态
  • 命令链接/家园位置状态
  • 所有权 / 认领 / 伤害策略评估
  • 已解析的 Tamework 配置视图
  • Tamework 持久化诊断
  • 最近的 Tamework 捕获 / 死亡 / 丢失 / 档案更改事件

快速上手

1. 将模组 jar 文件放入你的 mods 文件夹。
2. 启动服务器并加入游戏。
3. 生成物品 Npc_Debug_Inspector_Tool 并对 NPC 使用。
   • 可选：或者，看着 NPC 时使用命令 /npcdebug 打开检查器，无需物品。

检查器工具行为

物品资产：Server/Item/Items/Debug/Npc_Debug_Inspector_Tool.json

• 左键点击：链接/取消链接目标 NPC。
• 右键点击：打开已链接的 NPC 清单。

每个工具都会在物品元数据中存储自己链接/高亮的 NPC 集合，因此多个工具可以追踪不同的测试组。

UI 界面

1）检查器页面

• 分段的 NPC 详细信息（概览、AI/状态、传感器、寻路、计时器、组件、群体等）。
• 安装 Tamework 后，除了实时 Tamework 组件部分外，还会显示基于 API 的持久化/策略/配置/诊断部分。
• 可展开/折叠分段。
• 支持分段重新排序。
• 刷新率滑块（150ms 到 2000ms，步进 50ms）。
• 最近事件类别过滤器（核心、目标、计时器、警报、需求、群体）。
• 固定模式，用于选择要在悬浮窗中镜像的字段。

2）已链接清单

• 已链接 NPC 的卡片视图，显示基本实时状态。
• 过滤控制：
  • 文本搜索
• 每个 NPC 的操作：
  • 检查
  • 调试标志
  • 高亮
  • 复制 UUID（复制到 UI 内缓冲字段，以便手动 Ctrl+C）
  • 取消链接

3）调试标志页面

• 按类别分组的内置角色调试标志切换开关。
• 批量操作：
  • 启用全部
  • 禁用全部
• 作用于当前选中的已链接 NPC。

4）固定悬浮窗 HUD

• 独立的非阻塞悬浮窗视图，在与你世界互动时保持可见。
• 仅显示当前固定 NPC 的固定字段。
• 保留分段分组/顺序以便阅读。
• 包含可选的固定事件日志流。

感谢 Lait's Entity Inspector

如果你对外部工具感兴趣，可以查看 Lait's Entity Inspector，它是一款更强大的实体检查工具！

• 在基于 Web 的 GUI 中查看类似数据
• 在界面中实时编辑资源
• 检测 Hytalor 以进行实时资源修补