Lait的实体检查器

Lait的实体检查器

允许模组制作者实时检查实体和组件

实用

Lait的实体检查器预览查看大图

警告：这是一款实验性调试工具，仅适用于本地开发服务器。请勿在生产或公共服务器上使用。使用风险自负。

快速安装

  • 克隆仓库，运行 laits-entity-inspector-gui/update.ps1 (Windows) 或 update.sh (Linux/Mac)
  • 在游戏中启用该模组
  • 在浏览器中打开 laits-entity-inspector-gui/index.html

在发布新版本时再次运行更新程序以自动更新——你会在仪表板上收到通知。

Hytale 模组开发的实时实体调试工具。

Hytalor 集成：检查器会在检测到 Hytalor 加载时自动解锁资源浏览器和实时资源修补功能——无需重启服务器即可将更改应用于游戏资源。

NPC 检查：如果你希望进行深入的 NPC 检查，可以查看 Alec 的模组！ Alec's NPC Debug UI

Lait's Entity Inspector

alt text

警告：这是一款实验性调试工具，仅适用于本地开发服务器。请勿在生产或公共服务器上使用。使用风险自负。

Hytale 模组开发的实时实体调试工具。

v0.1.5 新特性

实时指令检查器 - 组件检查器中新增的“指令”标签页会显示任何 NPC 实体的完整指令树。查看哪些指令（Instructions）和交互指令（InteractionInstructions）被触发，并配有实时事件日志，显示每次传感器评估和动作执行。

  • 重命名节点 - 右键点击任意指令行（或点击“重命名”文本）为其指定一个自定义名称。自定义名称会显示在事件日志中，并按实体类型应用，因此所有羊共享相同的标签。设置跨会话保留。
  • 折叠/展开 - 点击以折叠或展开指令节点。按住 Alt 键点击可同时折叠或展开所有子节点。
  • 可调整大小的事件日志 - 拖拽指令树和事件日志之间的手柄以调整大小。大小设置会被保留。
  • 全屏模式 - 展开组件/指令检查器以填充整个视口。
  • 字体缩放 - 使用滑块将指令文本大小从 90% 调整到 150%。设置会被保留。

调试功能开关 - 设置中新增的“调试”标签页允许你在运行时启用/禁用各个检查器子系统。适用于在调试期间隔离副作用，或在你只需要特定功能时降低开销。

开关 控制内容
位置跟踪 每 tick 轮询实体位置
实体生命周期 生成/消失事件处理
按需刷新 在详细查询前获取新数据
警报检查 inspector_get_entity_alarms
计时器检查 inspector_get_entity_timers
指令检查 inspector_get_entity_instructions
惰性展开 字段展开请求
资源浏览器 资源扫描和浏览
补丁管理 Hytalor 补丁发布/草稿/删除
实体操作 姓氏更改，传送

所有开关默认开启并持久化到配置文件中。

组件

实体检查器插件

通过 WebSocket 收集实时实体/组件数据的 Hytale 服务器插件。

特性：

  • 实时实体生成/消失/更新事件
  • 组件数据序列化
  • 在端口 8765 上运行的 WebSocket 服务器
  • 可配置的更新速率和实体过滤器

命令：

  • /inspector - 显示状态
  • /inspector on|off - 切换检查器
  • /inspector rate <ms> - 设置更新间隔
  • /inspector pause|resume - 暂停/恢复更新
  • /inspector reload - 重新加载配置

检查器 Web UI（从 github 克隆）

用于查看实体数据的 ASCII/终端风格网页界面。

特性：

  • 带动画效果的实时实体列表
  • 组件检查器面板
  • 搜索/过滤实体
  • 自动重连

手动安装

  1. 构建插件：

    cd laits-entity-inspector
gradle build -x test

    输出：build/libs/laits-entity-inspector-<版本号>.jar

  2. 将 JAR 复制到你的世界的模组文件夹：

    %APPDATA%/Hytale/UserData/Saves/<世界名>/Mods/

  3. 启动 Hytale 服务器

  4. 在浏览器中打开 laits-entity-inspector-gui/index.html（从 github 克隆）

许可证

MIT