红色日志头

【标题】
《赛博朋克2077》Redscript 日志函数补全 MOD 使用指南

【核心介绍】
为 Redscript 脚本提供缺失的 `Log*` / `FTLog*` / `Trace*` 等日志调用函数，解决因缺少头文件导致的「函数未找到」错误。

【安装指南】

1. 下载本 MOD 文件（通常为 `.zip` 包），解压后将全部内容（含 `redscript` 文件夹及其中的 `.rs` 头文件）复制到游戏根目录 `/mods` 文件夹；
2. 必须确保本 MOD 在加载顺序中位于所有依赖日志函数的模组之前（例如：需先加载本 MOD，再加载使用 `LogError` 或 `FTLog` 的模组）；
3. 安装完成后重启游戏或重新加载 Redscript（按 `F4` → 点击「Reload Scripts」）；
   ✅ 缺一不可：若未放入 `/mods` 或加载顺序错误，日志函数仍无法调用。

【功能详情】
✅ 已优化：

• 补全全部 11 个日志相关函数：`Log`、`LogWarning`、`LogError`、`LogChannel`、`LogChannelWarning`、`LogChannelError`、`FTLog`、`FTLogWarning`、`FTLogError`、`Trace`、`TraceToString`；
• 所有函数可直接在任意 Redscript 脚本中调用，无需额外声明；
  ❌ 未修改：
• 不修改游戏本体、不更改任何 `.json` / `.xml` 配置、不替换任何 `.red` 资源文件；
  ✨ 额外调整：
• 函数实现严格遵循官方 Redscript 维基文档规范，与原生行为一致；
• 兼容所有基于 Redscript 2.1+ 版本开发的模组。

【使用要求】

• 必须已安装并启用「Redscript」模组（版本 ≥ 2.1），推荐使用最新稳定版（如「Redscript v2.4.0」）；
• 游戏本体需为正式版（非测试分支），支持「夜之城」主线及所有官方扩展包（无需额外 DLC）；
• 无需修改 `redscript_rCURRENT.log` 文件或手动编辑日志配置。

【兼容性说明】

• 兼容范围：所有调用上述日志函数的 Redscript 模组（如「Cyber Engine Tweaks」插件脚本、「Quick Hack Enhancer」等）；
• 不兼容模组：无直接冲突；但若其他模组自行重复注入同名函数（如自定义 `LogChannel.rs`），可能导致覆盖或报错，此时应禁用该冲突模组；
• 兼容补丁：暂未推出（本 MOD 本身即为通用兼容方案，无需额外补丁）。

【注意事项】

• 若 `redscript_rCURRENT.log` 中仍出现 `函数 'LogChannel' 未找到`，请确认：
• 本 MOD 已正确放入 `/mods` 文件夹（非子文件夹）；
• 加载顺序中本 MOD 排在依赖它的模组之前；
• Redscript 已成功重载（F4 → Reload Scripts 后无报错）；
• 此 MOD 不修复脚本逻辑错误或崩溃问题，仅解决日志函数缺失导致的运行时错误；
• 开发者可直接在模组描述中声明依赖本 MOD（例：“依赖「Redscript 日志函数补全」”）。

【更新日志】

• 2024 年 5 月 12 日 首次发布，支持 Redscript v2.1–v2.4；
• 2024 年 6 月 3 日 新增对 `TraceToString` 函数的完整实现，修复部分调试脚本调用失败问题。