Ember的日志过滤

Ember的日志过滤

一个高度可配置的Minecraft日志过滤模组

管理

LogFilter

一个高度可配置的 Minecraft 日志过滤模组。抑制嘈杂的日志消息,突出显示重要的消息,保持控制台整洁——全部通过可热重载的规则实现。

功能

  • 正则消息过滤 — 使用正则表达式按内容匹配并抑制日志消息
  • 日志记录器名称过滤 — 按精确的日志记录器名称或正则表达式模式过滤,支持层级匹配
  • 日志级别过滤 — 针对特定的日志级别(DEBUG、INFO、WARN、ERROR)
  • 过滤操作 — 每条规则可设为 DENY(抑制)、ALLOW(强制显示)或 NEUTRAL(放行)
  • 逐规则启用/禁用 — 无需删除即可切换单条规则的开关
  • 热重载 — 编辑 logfilter.json 后更改立即生效,无需重启
  • 内置默认规则 — 附带针对常见日志刷屏的预制规则(默认禁用)

支持的平台

加载器 Minecraft 版本
Forge 1.20.1
NeoForge 1.21.1
Fabric 1.20.1
Fabric 1.21.1

配置

LogFilter 将配置存储在 Minecraft 配置目录下的 logfilter.json 中。该文件会在首次启动时自动创建,并带有合理的默认值。

配置示例

{
  "configVersion": 1,
  "enabled": true,
  "rules": [
    {
      "name": "Suppress OpenAL spam",
      "enabled": true,
      "type": "MESSAGE_REGEX",
      "pattern": "(?i)openal",
      "action": "DENY",
      "level": null
    },
    {
      "name": "Block debug logs from server level",
      "enabled": true,
      "type": "LOGGER_NAME",
      "pattern": "net.minecraft.server.level",
      "action": "DENY",
      "level": "DEBUG"
    },
    {
      "name": "Always show errors",
      "enabled": true,
      "type": "LEVEL",
      "pattern": "ERROR",
      "action": "ALLOW",
      "level": null
    }
  ]
}

规则类型

类型 描述
MESSAGE_REGEX 使用正则表达式模式匹配日志消息内容
LOGGER_NAME 按精确的日志记录器名称或前缀(层级)匹配
LOGGER_REGEX 使用正则表达式模式匹配日志记录器名称
LEVEL 按日志级别(DEBUG、INFO、WARN、ERROR)匹配

操作

操作 描述
DENY 抑制该日志消息
ALLOW 强制放行该消息,无视其他规则
NEUTRAL 无效果——传递给下一条规则

可选的级别限制

任何规则都可以包含 level 字段,以将其限制为特定的日志级别。例如,带有 "level": "DEBUG" 的 LOGGER_NAME 规则将只匹配来自该日志记录器的调试消息。

默认规则

LogFilter 附带若干预配置的规则(默认禁用),供你快速上手:

  • 抑制 OpenAL/LWJGL 信息刷屏
  • 抑制进度加载消息
  • 抑制来自 net.minecraft.server.level 的调试日志
  • 抑制配方加载消息
  • 始终允许 ERROR 级别的消息

在配置文件中设置 "enabled": true 即可启用它们。