服务器诊断

🛠️ 服务器诊断

ServerDiagnostics 是一款轻量级的 Hytale 服务端实用工具，用于检测重复出现的实体相关问题、减少嘈杂的服务器警告，并自动安全地修复特定问题。

实体诊断 • 自动修复 • 安全清理 • 服务端

它在后台静默运行，无需任何客户端安装。

---

功能

实体追踪器清理 自动清理受支持的过期实体追踪器更新，这些更新会在 Hytale 处理它们之前被清除。

更干净的服务器日志 有助于减少重复的 Removed invalid updates for removed entities 警告。

飞行 NPC 旋转修复 检测并修复受支持的飞行 NPC 上的无效 NaN / Infinity 旋转数据。

实体追踪器诊断 提供详细的实体追踪器诊断和实体分类。

实体分类 能够识别掉落物、弹射物、NPC 以及其他有问题的实体。

详细会话日志 为每个服务器会话创建详细的本地诊断日志。

模块化配置 每个功能都可以独立配置。

故障开放安全机制 不确定的情况将不予处理，由 Hytale 正常处理。

---

安全设计

ServerDiagnostics 不会盲目删除实体或隐藏警告。

清理系统仅移除那些可以被安全识别的过期追踪器更新。

它不会修改：

活跃掉落物 • 物品堆栈 • 物品数量 • 掉落计时器

玩家物品栏 • 有效数据包 • NPC AI • NPC 移动 • 有效旋转

如果 ServerDiagnostics 无法安全识别问题，则允许 Hytale 正常处理。

已支持问题 → 安全修复 • 不确定情况 → 保持原样

---

仅限服务端

无需安装客户端。

只需将 JAR 文件放入服务器的 mods 文件夹并启动服务器即可。

配置和诊断文件夹会自动创建。

安装。启动服务器。剩下的交给 ServerDiagnostics。

---

配置

所有功能都可以通过以下文件进行配置：

mods/ServerDiagnostics/config.properties

默认设置已适用于正常的正式环境使用。

---

兼容性

Hytale 服务器 0.5.6+ • 兼容 Hytale 0.5.x • 已在 Hytale 0.5.9 上测试

服务端 • 无需数据库 • 无客户端依赖 • 无外部服务或遥测

---

ServerDiagnostics 专注于有针对性的自动修复和有用的诊断，同时保证常规游戏玩法和有效的服务器行为不受影响。