Console Filter Next
一个针对 Minecraft Forge、Fabric 和 NeoForge 的 ConsoleFilter 改进分支。支持按文本、正则表达式、日志级别、线程、记录器/来源以及 mod id 过滤控制台输出——而不仅仅是纯文本。在调试整合包和开发环境时,减少客户端或专用服务器的噪音。
加载器: Forge · Fabric · NeoForge(每个加载器有单独的 JAR 文件)
Discord: discord.gg/CcUNTJjPD · 问题反馈: GitHub · 版本发布: GitHub Releases
可安装在任意一侧或两侧(客户端和服务端均为可选):仅在需要读取日志的地方使用。
功能
- 过滤类型: 基本文本、正则表达式、日志级别、线程、记录器/来源、mod id
- 配置文件:
default、debug、production— 可在游戏中、通过 TOML 文件或/consolefilter profile命令切换(已持久化保存) - 模式: 黑名单(隐藏匹配项)或白名单(仅显示匹配项);可选
ignoreCase(忽略大小写) - 游戏内编辑器(Forge/NeoForge Mods → Config;Fabric Mod Menu):分页列表、正则验证、预设、导入/导出
- 命令(OP 权限等级 2):
reload、list、status、export、import、profile filterLatestLog— 将过滤器应用于latest.log及其他 Log4j 文件附加器skipMessagesWithStackTrace— 永远不会隐藏包含异常或堆栈跟踪的行- 统计信息: 在
/consolefilter status中显示每种过滤类型的命中次数 - 热重载: 支持从文件、命令或配置 UI 中的 Save & Apply(保存并应用)进行重载
配置
游戏内
- 进入 Options → Mods
- 找到 Console Filter Next
- 点击 Config
- 编辑过滤器和选项;Save & Apply 会写入
consolefilternext-common.toml并重载过滤器
配置文件
在实例文件夹中编辑 config/consolefilternext-common.toml。
示例 — 过滤来自 Server thread 的 INFO 消息:
[general]
activeProfile = "default"
ignoreCase = false
whitelistMode = false
filterLatestLog = true
skipMessagesWithStackTrace = false
basicFilters = []
levelFilters = ["INFO"]
threadFilters = ["Server thread"]
sourceFilters = []
modIdFilters = []
regexFilters = []
更多示例(白名单模式、mod id 过滤器、配置文件、正则表达式):README。
提示
过滤所有 DEBUG 消息
levelFilters = ["DEBUG"]
过滤来自特定包的消息
sourceFilters = ["com.example.mymod"]
白名单模式 — 仅显示匹配的消息
whitelistMode = true
basicFilters = ["ERROR", "WARN"]
如果任何过滤器匹配,该消息将被过滤掉(除非启用了白名单模式)。
兼容性
并非所有加载器都存在于每个 Minecraft 版本中。请选择与您的游戏 + 加载器匹配的文件。标签为 {mc}-4.2.0。
- 1.8.9 / 1.12.2 — Forge · Legacy Fabric(Java 8;无游戏内编辑器)。在 Modrinth 上,Fabric JAR 文件标记为 Legacy Fabric。
- 1.16.1 / 1.16.5 — Forge · Fabric(Java 8)
- 1.19.2 / 1.19.4 — Forge · Fabric(Java 17;无游戏内编辑器)
- 1.20.1 / 1.20.4 / 1.20.6 — Forge · Fabric · NeoForge
- 1.20.2 / 1.20.3 — Forge · Fabric
- 1.20.5 — Fabric
- 1.21.1 / 1.21.3–1.21.5 / 1.21.8 / 1.21.10 / 1.21.11 — Forge · Fabric · NeoForge
- 1.21.2 — Fabric
- 1.21.6 / 1.21.7 / 1.21.9 — Forge · Fabric
- 26.1 / 26.2 — Forge · Fabric · NeoForge(Java 25)
- 26.3 — Fabric · NeoForge(Java 25)
| Java | 8 (1.16 / 1.12.2 / 1.8.9) · 17 (1.19 / 1.20.1–1.20.4) · 21 (1.20.5+ / 1.21.x) · 25 (26.x) |
| Side | 客户端和专用服务器(每侧均为可选) |
从原版 ConsoleFilter 迁移?请参阅 MIGRATION.md。
支持
| Discord | |
| 问题反馈 | GitHub Issues |
| 源码 | alanjmrt94/ConsoleFilterNext |
| 版本发布 | GitHub Releases |
致谢
| Console Filter Next | alanjmrt94 |
| 最初基于 | Matthew Czyr 开发的 ConsoleFilter |
| ConsoleFilter 贡献者 | NgLoader, MarkKoz, ChaosTheDude |
| 许可证 | CC BY-NC-SA 4.0 |
为希望获得更整洁控制台的模组制作者 ❤️ 精心打造。
Console Filter Next
An improved fork of ConsoleFilter for Minecraft Forge, Fabric, and NeoForge. Filter console output by text, regex, log level, thread, logger/source, and mod id — not just plain text. Reduce noise on the client or dedicated server while debugging modpacks and development environments.
Loaders: Forge · Fabric · NeoForge (separate JAR per loader)
Discord: discord.gg/CcUNTJjPD · Issues: GitHub · Releases: GitHub Releases
Install on either or both sides (optional on client and server): use it only where you read logs.
Features
- Filter types: basic text, regex, log level, thread, logger/source, mod id
- Profiles:
default,debug,production— switch in-game, via TOML, or/consolefilter profile(persisted) - Modes: blacklist (hide matches) or whitelist (show only matches); optional
ignoreCase - In-game editor (Forge/NeoForge Mods → Config; Fabric Mod Menu): paginated lists, regex validation, presets, import/export
- Commands (OP 2):
reload,list,status,export,import,profile filterLatestLog— apply filters tolatest.logand other Log4j file appendersskipMessagesWithStackTrace— never hide lines with exceptions or stack traces- Statistics: per-filter-type hit counts in
/consolefilter status - Hot reload from file, commands, or Save & Apply in the config UI
Configuration
In-game
- Go to Options → Mods
- Find Console Filter Next
- Click Config
- Edit filters and options; Save & Apply writes
consolefilternext-common.tomland reloads filters
Config file
Edit config/consolefilternext-common.toml in your instance folder.
Example — filter INFO messages from the Server thread:
[general]
activeProfile = "default"
ignoreCase = false
whitelistMode = false
filterLatestLog = true
skipMessagesWithStackTrace = false
basicFilters = []
levelFilters = ["INFO"]
threadFilters = ["Server thread"]
sourceFilters = []
modIdFilters = []
regexFilters = []
More examples (whitelist mode, mod id filters, profiles, regex): README.
Tips
Filter all DEBUG messages
levelFilters = ["DEBUG"]
Filter messages from a specific package
sourceFilters = ["com.example.mymod"]
Whitelist mode — show only matching messages
whitelistMode = true
basicFilters = ["ERROR", "WARN"]
If any filter matches, the message is filtered out (unless whitelist mode is enabled).
Compatibility
Not every loader exists on every Minecraft version. Pick the file that matches your game + loader. Tags are {mc}-4.2.0.
- 1.8.9 / 1.12.2 — Forge · Legacy Fabric (Java 8; no in-game editor). On Modrinth the Fabric JARs are tagged Legacy Fabric.
- 1.16.1 / 1.16.5 — Forge · Fabric (Java 8)
- 1.19.2 / 1.19.4 — Forge · Fabric (Java 17; no in-game editor)
- 1.20.1 / 1.20.4 / 1.20.6 — Forge · Fabric · NeoForge
- 1.20.2 / 1.20.3 — Forge · Fabric
- 1.20.5 — Fabric
- 1.21.1 / 1.21.3–1.21.5 / 1.21.8 / 1.21.10 / 1.21.11 — Forge · Fabric · NeoForge
- 1.21.2 — Fabric
- 1.21.6 / 1.21.7 / 1.21.9 — Forge · Fabric
- 26.1 / 26.2 — Forge · Fabric · NeoForge (Java 25)
- 26.3 — Fabric · NeoForge (Java 25)
| Java | 8 (1.16 / 1.12.2 / 1.8.9) · 17 (1.19 / 1.20.1–1.20.4) · 21 (1.20.5+ / 1.21.x) · 25 (26.x) |
| Side | Client and dedicated server (optional on each) |
Migrating from the original ConsoleFilter? See MIGRATION.md.
Support
| Discord | |
| Issues | GitHub Issues |
| Source | alanjmrt94/ConsoleFilterNext |
| Releases | GitHub Releases |
Credits
| Console Filter Next | alanjmrt94 |
| Originally based on | ConsoleFilter by Matthew Czyr |
| ConsoleFilter contributors | NgLoader, MarkKoz, ChaosTheDude |
| License | CC BY-NC-SA 4.0 |
Crafted with ❤️ for modders who want a cleaner console.
下载 Console Filter Next
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Console Filter Next
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Console Filter Next
下载 Console Filter Next
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Console Filter Next
下载 Console Filter Next
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Console Filter Next
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Console Filter Next
下载 Console Filter Next
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Console Filter Next
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
Console Filter Next — 更新日志(仅代码)
4.2.0 · Minecraft 1.20.1, 26.1 和 26.2
- 共享的游戏内编辑器 (
platforms/{mc}/client/(1.20.1, 26.1, 26.2, …)):Mod Menu (Fabric) / Mods → Config (Forge 和 NeoForge) - 三个加载器使用相同的过滤器和 TOML
consolefilternext-common.toml - 按加载器分类的 JAR 包 (
*-forge/-fabric/*-neoforge) - Forge 26.1 / 26.2 (EventBus 7) 和 Fabric 1.12.2 / 1.8.9 (Legacy Fabric;无游戏内编辑器)
4.1.0 · Minecraft 1.20.1
- 除了 Forge 外,还移植了 Fabric 和 NeoForge
- 通用引擎 (
FilterEngine/FilterHost/ModIdLookup),过滤规则无变化 - 相同的 TOML 架构
consolefilternext-common.toml
4.0.3 · Minecraft 1.20.1
模组无功能变更。
4.0.2 · Minecraft 1.20.1
模组无功能变更。
4.0.1 · Minecraft 1.20.1
模组无功能变更。
4.0.0 · Minecraft 1.20.1
- 游戏内编辑器:分页列表、正则表达式验证、导入/导出及内置预设
- modIdFilters — 通过 Forge mod id 过滤行(从 logger 名称解析)
- skipMessagesWithStackTrace — 不隐藏包含异常或堆栈跟踪的行
/consolefilter status中按过滤器类型的统计信息/consolefilter profile将activeProfile持久化到consolefilternext-common.toml- 编辑器:配置路径屏幕、改进的列表编辑以及与 Save & Apply 的往返操作
- 新增组件:
ModIdResolver,StackTraceDetector,RegexValidator,ConfigPreset,FilterStats
3.5.0 · Minecraft 1.20.1
- 完整的游戏内配置编辑器(Forge Mod List → Config;无需额外依赖)
- 从 UI 编辑布尔值、活动/编辑配置文件以及所有过滤器列表
- Save & Apply 写入 TOML 并热重载过滤器
ConfigEditorModel,FilterListEditScreen以及扩展ConsoleFilterConfigScreen
3.4.0 · Minecraft 1.20.1
- loggerFilters(旧版别名,与源过滤统一)
- 过滤器配置文件:
default,debug,production - 命令
/consolefilter export,import和profile - filterLatestLog — 将过滤器应用于
latest.log和其他 Log4j appenders (Log4jAppenderFilters) - 客户端配置屏幕(Mod List 中的 Config 按钮)
ConfigFileHelper用于从命令和 UI 读取/写入 TOML
3.3.1 · Minecraft 1.20.1
- threadFilters 使用
contains匹配(与sourceFilters对齐) - 重构
Log4jFilter以扩展AbstractFilter
3.3.0 · Minecraft 1.20.1
- 命令
/consolefilter reload,list和status(需要 2 级 OP) - 配置选项 ignoreCase 和 whitelistMode
/consolefilter status中显示被过滤的消息计数
3.2.0 · Minecraft 1.20.1
- sourceFilters 按
contains过滤;levelFilters 忽略大小写 - 加载配置时预编译正则表达式模式(减少运行时故障)
- 迁移至
FMLJavaModLoadingContext构造函数(兼容 Forge 47.4+) - 在
mods.toml中声明 Minecraft/Forge 的依赖范围
3.1.0 · Minecraft 1.20.1
- 集成
JavaFilter,Log4jFilter,SystemOutFilter和SystemErrFilter - 仅通过 ForgeConfig 进行配置(无需手动创建文件)
- 通过
ModConfigEvent实现配置热重载 - 在纯文本控制台行中进行过滤(basic/regex),无需解析的日志格式
- 将
SystemFilter分离为专用的 stdout/stderr
3.0.1 · Minecraft 1.20.1
- 在
mods.toml中更新了分支归属和模组描述
3.0.0 · Minecraft 1.20.1
- MC 1.20.1 分支的初始发布(基于 Matthew Czyr 的 ConsoleFilter)
- 按级别、线程、源、基本文本和正则表达式进行过滤
consolefilternext-common.toml中的 Forge 配置
Pre-3.0.0 · 分支奠基
版本 3.0.0 之前的代码更改,按时间倒序排列(最新的在前)。
模组图标
- 添加
icon.png并在mods.toml中引用
重命名和自动配置
- 在代码和元数据中将模组重命名为 Console Filter Next
- 启动时若不存在则自动创建配置文件
修复过滤逻辑
JavaFilter,Log4jFilter和SystemFilter委托给LogMessage和ConsoleFilterConfig.shouldFilter(LogMessage)CustomFilter公开shouldFilter(LogMessage)以统一处理管道Log4jFilter注册为 Log4j 插件 (@Plugin) 以与日志记录核心集成
LogMessage 模型
- 具有时间戳、线程、级别、源和消息的
LogMessage类 FilterEntry在LogMessage上操作,而不是在纯String上操作
扩展过滤器和重构 — commit 0d7ef73
- 包迁移
com.chaosthedude.consolefilter→com.alanjmrt94.consolefilternext - 配置中的新过滤器类型:levelFilters, threadFilters, sourceFilters
FilterEntry扩展了工厂方法level(),thread()和source()ConsoleFilter.shouldFilter(String)使用模式[time] [thread/level] [source]: message解析行- 重新组织过滤器类 (
CustomFilter,JavaFilter,Log4jFilter,SystemFilter)
传承
最初基于 Matthew Czyr (MattCzyr) 的 ConsoleFilter。
Console Filter Next by alanjmrt94 · CC BY-NC-SA 4.0
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
模组
添加全屏世界地图,显示你在世界中已探索的区域。与 Xaero's Minimap 搭配使用效果极佳。
评论 0
登录后参与评分
还没有评论,来抢沙发吧