清理控制台

清理控制台

Clean Console 通过过滤日志刷屏、移除重复警告,并允许你自定义隐藏哪些消息,让 7 Days to Die 的控制台保持可读。

CLEAN CONSOLE

保留有用的信息,清除控制台刷屏。

image

关于

Clean Console 是一个面向 7 Days to Die 的轻量级生活质量模组,通过过滤不需要的日志刷屏,同时保留有用的警告、错误和异常,让控制台保持可读性。

如果你曾经打开控制台,发现同一条警告重复出现了几十次甚至几百次,那么这个模组旨在让故障排查变得轻松得多。


功能特性

  • 隐藏 INFO 刷屏 — 可以隐藏普通的提示信息。
  • 可配置的警告过滤器 — 隐藏包含特定词语或短语的警告。
  • 可配置的信息过滤器 — 有选择地隐藏特定的 INFO 消息。
  • 重复警告抑制 — 同一条警告在每个游戏会话中只显示一次。
  • 空白字符归一化 — 细微的空格差异会被视为同一条警告。
  • 错误保持可见 — 错误默认显示。
  • 异常保持可见 — 异常默认显示。
  • 基于 Harmony 的过滤 — 使用游戏的日志系统,并提供控制台回退方案。
  • XML 配置 — 无需修改 DLL 即可自定义过滤规则。

重复警告清理

有些警告可能会彻底刷爆控制台。

例如:

WRN Type:SpawnParticleAtPosition, XavLaserGun was missing when we looked it up via Type.GetType()
WRN Type:SpawnParticleAtPosition, XavLaserGun was missing when we looked it up via Type.GetType()
WRN Type:SpawnParticleAtPosition, XavLaserGun was missing when we looked it up via Type.GetType()

Clean Console 会在该会话中只显示一次该警告,并抑制后续的重复项。

它也能处理内容相同、仅有细微空白字符差异的警告。

错误和异常不会被去重 — 它们会保持可见,以便仍能进行适当的排查。


可配置过滤器 [[不要跳过此部分]]

Clean Console 使用 CleanConsoleConfig.xml 来控制过滤。

你可以在相应的节点下添加自己的关键词或短语。

<Warnings>
    <Contains>ZZZZ_Pickup_Everything</Contains>
    <Contains>AddJournalEntry was missing when we looked it up</Contains>
    <Contains>Could not find type named WalkerSim</Contains>
</Warnings>

匹配规则为:

  • 不区分大小写
  • 基于部分/子字符串匹配
  • 完全可配置

因此你不需要匹配完整的控制台消息。


默认行为

消息类型 默认
INFO 隐藏
WARNING 可见 + 移除重复项
ERROR 可见
EXCEPTION 可见

已知的控制台刷屏

附带的配置已经过滤了多个已知的重复性控制台噪音来源,包括:

  • ZZZZ_Pickup_Everything [Yeah. Thats my mod. Hehe 😄]
  • AddJournalEntry was missing when we looked it up
  • Could not find type named WalkerSim
  • Type:ItemClassWildChicken
  • Failed to fetch Twitch entitlements
  • ChunkManager mesh regeneration thread blocked
  • GenerateTerrain
  • Next Airdrop
  • Missing script warnings
  • VideoPlayer warnings
  • EOS networking warnings
  • Invalid cache warnings
  • 其他已知的重复性消息

你可以自由编辑配置并添加自己的过滤器。


为什么?

7 Days to Die 的控制台在排查模组问题时非常有用。

问题在于,重复的警告会把真正需要的信息淹没。

Clean Console 并不试图让一切都静音。

它只是试图让控制台重新变得有用。

更少噪音,更多有用信息。


特别感谢

衷心感谢 LRazor 和 1science1 提出的建议和反馈,它们帮助塑造了 Clean Console。

LRazor 提出了基于关键词的可配置过滤,允许用户定义特定词语或短语并隐藏匹配的控制台消息。这成为了 Clean Console 可自定义过滤系统的基础。

1science1 提出应让控制台聚焦于真正对故障排查重要的消息,而不是让常规消息淹没有用的警告和错误。

两个想法都与 Clean Console 想要实现的目标完美契合:

更少噪音,更多有用信息。

❤️ 感谢你们帮助 Clean Console 变得更好!


安装

  1. 安装 0_TFP_Harmony。
  2. 将 00000-CleanConsole 解压到你的 7 Days to Die Mods 文件夹中。
  3. 启动游戏。

就这样。


需求

7 Days to Die: v3.1.0 Stable

依赖: Harmony


兼容性

Clean Console 不会修改玩法、AI、战利品、方块、物品、任务或进度。

它只过滤控制台日志。


保留有用的东西,清除噪音。

由 Bucksy 用 ❤️ 制作