
呀
将所有日志汇总到一处!Yap是一个小型原生插件,用于将所有模组、所有插件和整个游戏中的日志以人类可读、颜色编码的形式汇总到一处。
查看大图[center][size=6][b]yap[/b][/size]
[i]又一个日志记录器……但别具一格![/i][/center]
[line]
[size=5][b]它是什么?[/b][/size]
[b]yap[/b] 是一个面向模组作者的小型 [url=https://www.nexusmods.com/cyberpunk2077/mods/2380]RED4ext[/url] 日志插件工具,
它可以将来自[i]任何位置[/i]的人类可读、带颜色编码的日志汇总到一个统一文件中!
[b]玩家[/b]:除非某个模组明确将其列为必需项,否则你不需要 yap,
但这并非它的设计目的,所以可能性不大。
[size=5][b]功能[/b][/size]
它有两种版本。请选择其一。
[size=4][b]NO_HOOK[/b] 文件[/size]
[list]
[]新的日志方法:[color=#f1c232][font=Roboto]Life[/font][/color]、[color=#f1c232][font=Roboto]Trace[/font][/color]、[color=#f1c232][font=Roboto]Debug[/font][/color]、[color=#f1c232][font=Roboto]Info[/font][/color]、[color=#f1c232][font=Roboto]Warn[/font][/color] 和 [color=#f1c232][font=Roboto]Error[/font][/color],可从任何脚本调用,并带有调用方 [color=#f1c232][font=Roboto]Class::Func[/font][/color] 或 [color=#f1c232][font=Roboto]Func[/font][/color] 前缀(如果有)。[/]
[]遵循 RED4ext 中 [color=#f1c232][font=Roboto]red4ext\config.ini[/font][/color] 的 [color=#f1c232][font=Roboto][logging] level[/font][/color] 设置。[/]
[/list]
[size=4]标准文件[/size]
[list]
[]与上述相同,另加[/]
[]捕获游戏自身的 [color=#f1c232][font=Roboto]FTLog[/font][/color] 调用。[/]
[]捕获所有 RED4ext [color=#f1c232][font=Roboto]Logger[/font][/color] 调用。[/]
[/list]
全功能版本依赖游戏和 RED4ext 内部机制。
[color=#ea9999]预计[/color]会在游戏更新后失效,
但在 yap 更新之前,你可以临时切换到 [color=#f1c232][font=Roboto]NO_HOOK[/font][/color] 版本:
你的模组日志调用仍然有效。
鉴于它会将所有日志汇总到一个日志文件中,该文件可能会迅速膨胀,
你可能需要考虑增大 [color=#f1c232][font=Roboto]red4ext\config.ini[/font][/color] 中的 [b]max_file_size[/b],
或者在你不需要它时直接卸载。
每个主文件都附带一个可选的 [b]PDB[/b] 文件,仅用于分析崩溃报告。
[size=5][b]安装[/b][/size]
使用 Vortex 或 MO2 安装,或将压缩包解压到你的游戏文件夹中。你最终应得到:
[code]Cyberpunk 2077/red4ext/plugins/yap/yap.dll
Cyberpunk 2077/r6/scripts/Yap/Log.reds[/code]
要卸载,删除这两个文件夹即可。
[size=5][b]面向模组作者[/b][/size]
在你自己的模块中,导入你要调用的函数,例如在 [i]Cat[/i] 中:
[code]module Cat
import Yap.Info
public class CatServiceDebug extends ScriptableService {
private cb func OnLoad() {
Info("calling Yap from Cat");
}
}[/code]
它会写入 [color=#f1c232][font=Roboto]Cyberpunk 2077/red4ext/logs/yap-.log[/font][/color],格式如下:
[code][2026-10-09 18:12:56.460] [info ] [ 48396] [yap] 🔷 [ reds ] Cat.CatServiceDebug::OnLoad calling Yap from Cat[/code]
在 [color=#f1c232][font=Roboto]red4ext/config.ini[/font][/color] 中设置 [color=#f1c232][font=Roboto]level = "debug"[/font][/color](或 [color=#f1c232][font=Roboto]"trace"[/font][/color])以同时查看 [color=#f1c232][font=Roboto]Debug[/font][/color] / [color=#f1c232][font=Roboto]Trace[/font][/color] 行。
这些行使用 ANSI 转义码着色,在纯文本编辑器中看起来像 [color=#f1c232][font=Roboto][33m[/font][/color] 噪音。要关闭颜色,创建 [color=#f1c232][font=Roboto]Cyberpunk 2077/red4ext/plugins/yap/config.ini[/font][/color] 并写入:
[code][logging]
colors = false[/code]或设置 [url=https://no-color.org]NO_COLOR[/url] 环境变量。
每种行的外观(带钩子的版本):
[code][2026-10-09 18:12:56.277] [error ] [ 48396] [yap] 🔴 [ reds ] Yap.YapService::OnLoad Error WaWaWaWa
[2026-10-09 18:12:56.277] [warning ] [ 48396] [yap] 🔶 [ reds ] Yap.YapService::OnLoad Warn WaWaWaWa
[2026-10-09 18:12:56.278] [debug ] [ 48396] [yap] 🔹 [ reds ] Yap.YapService::OnLoad Debug WaWaWaWa
[2026-10-09 18:12:56.278] [info ] [ 48396] [yap] [FTLog] Yap.YapService::OnLoad FTLog WaWaWaWa
[2026-10-09 18:12:51.888] [info ] [ 48396] [yap] [octopak] on RTTI post register[/code]
[size=5][b]源代码[/b][/size]
在 [url=https://github.com/cyb3rpsych0s1s/yap]GitHub[/url] 上开源,发布版本由 CI 构建。
欢迎在那里或 Bugs 标签页中提交错误报告和建议。
[size=5][b]免责声明[/b][/size]
这些钩子是在 AI 的部分协助下实现的,但[i]每一次提交[/i]都经过手动测试。
如果运用得当并处理了审查意见,欢迎在贡献中使用 AI。
[size=5][b]鸣谢[/b][/size]
[list]
[][url=https://www.nexusmods.com/profile/Demon9ne]Demon9ne[/url]:最初提出这个建议 💡。[/]
[][url=https://github.com/WopsS]WopsS[/url]:[url=https://github.com/WopsS/RED4ext]RED4ext[/url] 的作者。[/]
[][url=https://github.com/jac3km4]jekky[/url]:[url=https://github.com/jac3km4/red4ext-rs]red4ext-rs[/url] 和 [url=https://github.com/jac3km4/redscript]Redscript[/url] 的作者。[/]
[][url=https://github.com/psiberx]psiberx[/url]:[url=https://github.com/psiberx/cp2077-codeware]Codeware[/url] 及许多其他库的作者。[/*]
[/list]
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。