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
下载 Console Filter Next
下载 Console Filter Next
下载 Console Filter Next
下载 Console Filter Next
下载 Console Filter Next
下载 Console Filter Next
下载 Console Filter Next
下载 Console Filter Next
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Console Filter Next
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 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧