Ember’s Log Filtering

LogFilter

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

Wiki：https://tysontheember.dev/log-filter/intro/

功能

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

配置

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 即可启用它们。