Log Begone — 用于过滤 Minecraft 日志消息的模组

Log Begone — 用于过滤 Minecraft 日志消息的模组

Log Begone 是一款 Minecraft 实用模组，可从控制台和 latest.log 文件中移除指定的行。原版游戏会将所有警告写入日志文件，其中包括关于缺失结构、生物群系、方块或物品的重复消息，这些都是整合包中先前已删除内容遗留下来的。该模组会隐藏此类行，从而让控制台和日志文件在整个会话期间保持可读。它既可用于客户端，也可用于专用服务器——过滤会针对每个环境单独运行，因此两者之间无需进行版本同步。

适用于哪些场景

主要场景是已删除部分模组或内容的整合包。此类删除的残留会以成千上万条关于 "missing entry" 或未知注册表标识符的同类警告形式出现。如果没有过滤，加载世界时控制台会被数百条这样的连续行刷屏，而 latest.log 文件在一次会话中会膨胀到数十兆字节。

另一种典型情况是关于原版客户端尝试连接到已修改服务器的消息，或关于网络通道的服务行。在开放端口的服务器上，每当第三方客户端进行扫描时都会出现此类消息，从而产生背景噪声，使人更难发现真正的问题。

第三种场景是优化。如果日志每分钟写入数千行，那么磁盘写入操作和消息格式化会占用相当一部分资源。将预期的噪声从过滤列表中移除后，便可将这些资源归还给游戏线程——这在长时间运行的服务器上尤为明显。

过滤的工作原理

该模组会在日志事件到达标准输出之前就将其拦截。如果某条消息符合所设定的某一条件，它就不会被写入控制台和文件。没有任何命令、图形界面或游戏内通知：一切都通过单个文本配置文件进行设置。

支持两种比较模式。第一种是子串搜索：如果消息文本中出现列表中的任意短语，该行就会被滤除。这对大多数重复警告来说已经足够，因为它们的模板通常包含一个稳定且唯一的部分。第二种模式是正则表达式：对于需要考虑可变元素（数字、标识符、时间）的消息，使用 Java-regex 语法设定一个模式，匹配即意味着该行被滤除。

配置

该文件名为 logbegone.json，会在首次启动时自动在游戏配置文件的 config 文件夹中创建。在 1.0.1 之前的版本中使用的是 TOML 格式，但由于与 NeoForge 中 TOML 的打包不兼容，作者通过 GSON 库将配置改为了 JSON。

文件结构

默认情况下，两个列表包含相同的行——Disconnecting VANILLA connection attempt 和 Channels（末尾带一个空格，这对正确匹配很重要）。这些值会移除在具有活动的已修改网络协议的服务器上经常出现的消息。

结论

Log Begone 借助短语列表或正则表达式隐藏 Minecraft 日志文件中预先已知的噪声。它并非传统意义上的优化模组：世界渲染和区块加载保持不变，但在严重刷屏时，性能和日志大小上的间接收益是通过让成千上万条重复行根本不被写入磁盘来实现的。

它适合拥有稳定模组组合的服务器管理员、删除内容后的整合包作者，以及希望将日志文件缩减到可读大小、以便后续诊断真正问题的玩家。