
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 即可启用它们。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。