HyLogger

HyLogger

服务端 Hytale 插件，可捕获完整服务器日志，并将 Hytale 引擎输出与模组/插件输出分离，整理到带有时间戳的文件中——这样您就无需在庞大的日志中费力排查问题。

---

功能简介

HyLogger 会将 所有 服务器控制台输出记录到磁盘，并按来源和严重级别分类到不同的日志文件中。您可以获得服务器及模组操作的完整审计轨迹，并单独保存 Hytale 专属错误、模组专属错误、警告及严重条目。无需配置：安装 JAR 文件并启动服务器即可；日志会自动创建。

---

特性

• 完整服务器日志 — 标准输出 (stdout) 和标准错误 (stderr) 的所有内容（包括插件加载前产生的输出）都会写入一个带时间戳的文件，确保您不会丢失任何输出。
• 按来源和严重级别分类：
  • ServerLogs — 完整的服务器输出（*_full.log）。
  • HytaleLogs — Hytale 引擎输出（*_hytale_errors.log），通过 Hytale 日志标签（例如 [HytaleServer]、[PluginManager]、[AssetStore|...]、[SERR]）或包名 com.hypixel.hytale 进行识别。
  • ModLogs — 模组/插件输出（*_mod_errors.log）。标准输出和标准错误 都会被逐行捕获，因此模组消息（包括大多数 INFO 行）会出现在此处，而不仅仅是错误信息。
  • WarningLogs — 所有 WARN/WARNING 条目（*_warnings.log）。
  • SevereLogs — 所有 SEVERE 条目（*_severe.log）。
• 管理员警报 — 当服务器管理员在线时，SEVERE 日志条目会触发游戏内通知弹窗和聊天消息，让您无需紧盯着控制台就能做出反应。
• 无需配置 — 将 JAR 文件放入您的 mods 文件夹并启动服务器；HyLogger 会立即创建日志文件夹并开始写入。

---

日志存放位置

所有日志均存储在您的服务器文件夹下：

<server folder>/mods/HyLogger/

子文件夹	内容
ServerLogs/	完整服务器日志文件：YYYY-MM-DD_HH-mm-ss_full.log
HytaleLogs/	Hytale 专属错误：*_hytale_errors.log
ModLogs/	模组/插件错误：*_mod_errors.log
WarningLogs/	所有 WARN/WARNING 条目：*_warnings.log
SevereLogs/	所有 SEVERE 条目：*_severe.log

文件名包含时间戳（例如 2026-03-08_14-30-00_full.log），因此每次运行会话都拥有自己的一套文件。标准输出和标准错误 均被捕获并逐行分配到 Hytale/模组/警告/严重文件中，并且 Java 日志框架（JUL） 也会被捕获，无论游戏或模组采用何种日志方式，您都能获取输出。

---

安装方法

1. 下载 本页面（文件标签页）最新的 HyLogger JAR 文件。
2. 放置 该 JAR 文件到您的 Hytale 服务器的 mods 文件夹（根据您的设置，也可能是 plugins 文件夹）。
3. 启动 服务器。HyLogger 会在首次运行时创建 mods/HyLogger/ServerLogs、HytaleLogs、ModLogs、WarningLogs 和 SevereLogs 文件夹，并开始记录日志。

无需配置文件或游戏内设置。

---

管理员通知

如果拥有 op 权限的玩家在线，当写入 SEVERE 日志条目时（例如区块加载超时、未处理的异常），HyLogger 会发送：

• 通知弹窗（带有警告图标）。
• 聊天消息，包含日志级别和消息文本。

这对于在不打开控制台或日志文件的情况下捕获关键问题非常有用。

---

系统要求

• Hytale 服务器（正式版或预发布版）。此插件针对特定的服务器构建版本；请使用与您的服务器版本匹配的 JAR 文件。
• 仅服务端安装 — 无需客户端安装。玩家无需安装此模组。

---

适用人群

• 服务器所有者，他们需要完整的、带时间戳的日志，并希望快速了解崩溃或警告来自游戏本身还是某个模组。
• 模组制作者，他们希望在日志中将模组的错误与 Hytale 本身的错误分开。
• 管理员，他们希望在出现问题时获得游戏内警报，而无需时刻盯着控制台。

---

总结

HyLogger 为您提供 完整服务器日志 以及 分类日志（Hytale 与模组日志、警告和严重日志分别归档），并为严重条目提供 可选的管理员游戏内警报。安装 JAR 文件，启动您的服务器，当您需要调试时，检查 mods/HyLogger/ServerLogs、HytaleLogs、ModLogs、WarningLogs 和 SevereLogs 文件夹即可。