REDcode

REDcode

REDcode 是一个构建在 VSCode 之上的完全集成、往返式《赛博朋克2077》模组开发环境,支持 AI 辅助的模组创建。

[center][img]https://raw.githubusercontent.com/Edgemodders/REDcode/main/docs/assets/brand/banner.png[/img][/center]

[center][size=5][b][color=#fcee0a]一个基于 WolvenKit 构建的《赛博朋克 2077》模组制作工作区,运行于 VS Code 中。[/color][/b][/size][/center]

[center]浏览游戏档案,将文件添加到 WolvenKit 项目,在树状视图和属性网格中编辑它们,查看纹理、3D 网格和声音,浏览 TweakDB 和游戏文本,然后打包、安装并启动游戏。全部在一个窗口中完成,与你的代码和 AI 助手并列。[/center]
[center][/center]
[center][size=3]这是我们 EDGEmodders 社区发布的首批众多 VSCode 扩展工具之一。所有工具将协同工作,并提供可选的 AI 助手。[/size][/center]
[center][/center]
[center][color=#f6b26b][size=3][i]这是一个早期但功能完整的版本。[/i][/size][/color][/center]
[line]

[quote][size=4][b][color=#fcee0a]状态:预览版[/color][/b][/size]
现有功能均可用,并已针对游戏进行测试。新功能会在小型更新中陆续加入。
[b]这不是一个游戏模组。[/b]它是 VS Code 的扩展,因此请在 VS Code 中安装(步骤如下),而不是通过 Vortex 安装。最快的方式是直接从 [url=https://marketplace.visualstudio.com/items?itemName=Edgemodders.redcode-cyberpunk]VS Code Marketplace[/url] 或 [url=https://open-vsx.org/extension/edgemodders/redcode-cyberpunk]Open VSX[/url] 安装;此处的文件是同一个扩展。[/quote]完整的原生音频编辑器
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35356/35356-1792178922-1211899946.png[/img]

全连接、可搜索、快速、带超链接的 TweakDB 浏览器和编辑器。
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35356/35356-1792178926-415640651.png[/img]

3D 网格查看器,支持单独部件和分段选择。
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35356/35356-1792178927-243433757.png[/img]

[size=5][b][color=#fcee0a]REDcode 是什么[/color][/b][/size]

REDcode 由 [url=https://edgemodders.ai/]EDGEmodders[/url] 构建,这个模组制作社区的理念很简单:[b]任何人都可以制作模组[/b]。它将游戏文件带入 VS Code——大多数模组制作者和 AI 助手已经在使用的编辑器。

REDcode 基于 [b]WolvenKit[/b]。每个游戏文件都由 WolvenKit 自己的库读写,这些库运行在 [b]REDbridge[/b] 中——一个由 REDcode 下载、启动并与之通信的小型本地程序。项目就是 WolvenKit 自己的 [i].cpmodproj[/i] 项目,逐字节一致,因此可以在 REDcode 和 WolvenKit 之间自由迁移。文件格式、档案读取器、导入器和导出器以及多年研究的功劳归于 WolvenKit 团队和贡献者。

[size=5][b][color=#fcee0a]亮点[/color][/b][/size]

[size=4][b][color=#19f3ff]以树状形式呈现的游戏档案[/color][/b][/size]
游戏中的每个文件,以文件夹组织,支持即时搜索,以及在你输入时缩小范围的过滤器([i]osprey mesh[/i]、[i]ep1\weapons\.xbm[/i])。以只读方式打开任意文件,或将其添加到你的项目中以获得可编辑的副本。

[size=4][b][color=#19f3ff]真正的 CR2W 编辑器[/color][/b][/size]
.ent、.app、.mesh、材质、场景等以树状视图和属性网格打开:枚举下拉菜单、数组的添加和删除、撤销和重做、全文件搜索。本地化文件以表格形式打开,可就地编辑。图集在其纹理上打开,每个部分都绘制在其上,可移动和调整大小。

[img]https://staticdelivery.nexusmods.com/mods/3333/images/35356/35356-1792179920-170863714.png[/img]

[size=4][b][color=#19f3ff]纹理、网格和声音[/color][/b][/size]
纹理以图像显示。网格在 3D 中打开:环绕、选择 LOD、切换外观、开启和关闭子网格、查看每个子网格的材质。语音台词和音效在带波形的播放器中播放,[b]浏览游戏声音[/b] 将游戏的 73,000 个音效列为可过滤和播放的事件。

[color=#19f3ff][i][img]https://staticdelivery.nexusmods.com/mods/3333/images/35356/35356-1792180039-1848638956.png[/img][/i][/color]

[color=#19f3ff][size=4][b]完整的 Blender 往返编辑[/b][/size][/color]

[color=#ffffff][size=3]在 REDcode 中查看,将模型启动到 Blender,进行编辑并保存,保存后会无缝导入回 REDcode。[/size][/color]
[color=#19f3ff][i][img width=406]https://staticdelivery.nexusmods.com/mods/3333/images/35356/35356-1792189663-827977558.png[/img][img width=418]https://staticdelivery.nexusmods.com/mods/3333/images/35356/35356-1792189673-2071866892.png[/img][/i][/color]


[size=4][b][color=#19f3ff]可浏览的 TweakDB[/color][/b][/size]
每种记录类型和记录,每条记录都有一个页面,其中的链接可带你到它引用的记录,LocKey 显示其文本,资源路径可打开文件。[b]从此记录新建 Tweak[/b] 会写入一个 TweakXL 文件,克隆或修改它,所有 flat 都已列出并准备取消注释。在 tweak 文件中悬停记录路径即可查看它是什么。

[color=#19f3ff][i][img]https://staticdelivery.nexusmods.com/mods/3333/images/35356/35356-1792180246-1379258345.png[/img][/i][/color]
[color=#19f3ff][i][img]https://staticdelivery.nexusmods.com/mods/3333/images/35356/35356-1792180248-2025710685.png[/img][/i][/color]

[color=#00ffff][size=4][b]游戏文本,涵盖 19 种语言[/b] [/size][/color]
[b]LocKeys 视图可找到任何 [i]LocKey#[/i] 背后的文本,以及任何文本背后的 LocKey,涵盖基础游戏和《往日之影》。点击结果可在其文件中打开。一键将其添加到项目自己的文本文件中——如果你没有,则会创建并配置好 ArchiveXL——这样你就能更改游戏所说的内容。在 tweak、脚本或 CR2W 文件中悬停 LocKey 即可阅读它。 [/b]
[b][img]https://staticdelivery.nexusmods.com/mods/3333/images/35356/35356-1792195114-1378531843.png[/img][/b]

[color=#00ffff][size=4][b]打包、安装、游玩[/b][/size][/color]
[b]打包[/b] 按 WolvenKit 的方式构建你的模组(Ctrl+Shift+B),[b]安装[/b] 将其放入游戏(当你拥有 EDGEdeck 时通过它进行,以便可以撤销),[b]运行游戏[/b] 启动赛博朋克。[b]打包并试用[/b] 一键完成,当你拥有 Red Hot Tools 时可直接进入运行中的游戏。导出为 glTF、PNG 和 WAV,编辑,再导入回来:GLB 可以变成新的网格,编辑后的音效会回到游戏的音效库中。REDmod 包会携带你的自定义声音。

[size=4][b][color=#19f3ff]TweakXL 文件[/color][/b][/size]
为 TweakXL 的 [i].tweak[/i] 格式提供语法高亮、括号、注释和代码片段。

[size=4][b][color=#19f3ff]面向 AI 助手[/color][/b][/size]
[url=https://www.npmjs.com/package/@edgemodders/redcode-mcp]@edgemodders/redcode-mcp[/url] 为 Claude Code 和其他助手提供相同的引擎:浏览档案,读取和修补 CR2W 文件,导出、导入、打包,以及查询 TweakDB 和游戏文本。让你的助手制作模组,并观看它在同一个项目中工作。

[size=4][b][color=#19f3ff]即将推出[/color][/b][/size]
计划: [b]REDnode 循环[/b],用于编辑 REDnode 模组并在运行中的游戏里看到它而无需重启,并可在 VS Code 中查看游戏日志和使用调试器。

[size=5][b][color=#fcee0a]要求[/color][/b][/size]

[list]
[
]Windows 10 或 11,64 位。[/]
[
][url=https://code.visualstudio.com/]VS Code[/url] 1.70 或更高版本、[url=https://vscodium.com/]VSCodium[/url] 或 EDGEkit。[/]
[
]PC 版《赛博朋克 2077》:Steam、GOG 或 Epic 安装版。REDcode 会自动找到它。[/]
[
]REDbridge:REDcode 首次启动时会提示下载。无需任何设置。[/]
[
].NET 10 运行时,REDbridge 运行于其上。REDcode 在缺失时会提示安装。[/]
[
]可选:[url=https://www.nexusmods.com/cyberpunk2077/mods/35366]EDGEdeck[/url],用于可撤销的安装。[/*]
[/list][size=5][b][color=#fcee0a]安装[/color][/b][/size]

[b]从商店安装(推荐,会自动更新):[/b] 在 VS Code 中打开扩展视图(Ctrl+Shift+X),搜索 [b]REDcode for Cyberpunk 2077[/b] 并点击安装。或打开其 [url=https://marketplace.visualstudio.com/items?itemName=Edgemodders.redcode-cyberpunk]Marketplace[/url] 或 [url=https://open-vsx.org/extension/edgemodders/redcode-cyberpunk]Open VSX[/url] 页面。

[b]从此处文件安装:[/b]
[list]
[]使用 [b]手动下载[/b] 下载主文件并解压到任意位置。[/]
[]在 VS Code 中打开扩展视图(Ctrl+Shift+X),点击顶部的 [b]...[/b],选择 [b]从 VSIX 安装...[/b] 并选择 [i]redcode-cyberpunk-<version>.vsix[/i]。[/]
[]点击活动栏中的 REDcode 图标。REDcode 会寻找游戏并提示下载 REDbridge。[/]
[/list]不要使用 Vortex 安装:它不是游戏模组,Vortex 会将其放入游戏文件夹。

[size=5][b][color=#fcee0a]EDGE 平台[/color][/b][/size]

REDcode 是 EDGE 工具之一。每个工具可独立工作,也可协同工作:

[list]
[][b][url=https://www.nexusmods.com/cyberpunk2077/mods/35366]EDGEdeck[/url][/b]:VS Code 中的简易模组管理器。REDcode 的安装功能通过它进行。[/]
[][b][url=https://www.nexusmods.com/cyberpunk2077/mods/35355]REDnode[/url][/b]:用 JavaScript 制作模组、在游戏上叠加网页,以及 REDagent——游戏内的 AI 助手。EDGEdeck 识别 REDnode 包并将其放到正确位置。[/]
[][b][url=https://github.com/Edgemodders/REDbridge]REDbridge[/url][/b]:为 REDcode、EDGEdeck 和 REDnode 运行 WolvenKit 的库。[/]
[][b]REDnode HUD 主题[/b]:REDcode 页面所采用的深色、黄色和青色主题,在同一商店中提供。[/]
[][b][url=https://github.com/Edgemodders/EDGEkit]EDGEkit[/url][/b]:一个内置所有 EDGE 工具的编辑器。[/]
[/list][size=5][b][color=#fcee0a]常见问题[/color][/b][/size]

[b]它会替代 WolvenKit 吗?[/b]
不会。它运行 WolvenKit 的库并写入 WolvenKit 的项目,因此你可以在同一个项目上在两者之间切换。根据任务选择适合的工具。

[b]为什么 REDbridge 需要单独下载?[/b]
WolvenKit 的库采用 GPL-3.0 许可并运行在 .NET 上,因此它们存在于自己的程序 REDbridge(GPL-3.0)中,REDcode 与之通信。REDcode 本身保持 MIT 许可。REDcode 从其 GitHub 发布页下载 REDbridge,并在有更新版本时通知你。

[b]它会更改我的游戏文件夹吗?[/b]
仅在你按下安装(或打包并安装)时,且仅使用你模组的文件。通过 EDGEdeck,安装可以精确撤销。

[b]它是免费的吗?[/b]
是的,并且在 MIT 许可下开源。代码位于 [url=https://github.com/Edgemodders/REDcode]GitHub[/url]。

[line]

[size=5][b][color=#fcee0a]链接[/color][/b][/size]

[list]
[]EDGEmodders:[url=https://edgemodders.ai/]edgemodders.ai[/url][/]
[]文档:[url=https://edgemodders.github.io/REDcode/]edgemodders.github.io/REDcode[/url][/]
[]源码与问题:[url=https://github.com/Edgemodders/REDcode]github.com/Edgemodders/REDcode[/url][/]
[]VS Code Marketplace:[url=https://marketplace.visualstudio.com/items?itemName=Edgemodders.redcode-cyberpunk]Edgemodders.redcode-cyberpunk[/url][/]
[]Open VSX:[url=https://open-vsx.org/extension/edgemodders/redcode-cyberpunk]edgemodders/redcode-cyberpunk[/url][/]
[]社区 Discord:[url=https://discord.gg/63qP3Erw43]discord.gg/63qP3Erw43[/url][/]
[/list][size=5][b][color=#fcee0a]致谢[/color][/b][/size]

[list]
[][b][url=https://www.nexusmods.com/profile/Cyberbuilds]Cyberbuilds [/url]负责概念、设计和全部开发。[/b][/]
[][b]WolvenKit[/b] 及其团队和贡献者(GPL-3.0):REDcode 读写的每个游戏文件都通过他们在 REDbridge 中的库完成。[/]
[][b]three.js[/b](MIT):3D 网格视图。[/]
[][b]opus-decoder[/b] 和 [b]libopus[/b]:播放游戏的 Opus 声音。[/]
[][b]TweakXL[/b] 作者 psiberx:REDcode 写入和高亮的 tweak 格式。[/]
[]《赛博朋克 2077》模组制作社区,本工具建立在其工具和知识之上。[/]
[/list][size=2]REDcode 与 CD PROJEKT RED、WolvenKit 团队或 Microsoft 无关联。Cyberpunk 2077 和 REDengine 是 CD PROJEKT 的商标。Visual Studio Code 是 Microsoft 的商标。[/size]