REDnode

REDnode

REDnode是《赛博朋克2077》的mod制作框架,可在游戏旁运行Node.js模组,在其上绘制HTML窗口和HUD控件,并为每个模组提供完整的游戏API,类型直接从游戏自身数据中提取。它附带一个AI助手,可与你一同编写模组、在游戏中运行并修复。

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

[center][size=5][b][color=#fcee0a]用 JavaScript 为夜之城制作模组。在游戏之上绘制网页。调用任意游戏函数。[/color][/b][/size][/center]

[center][size=3]REDnode 是《赛博朋克 2077》的模组框架,它在游戏旁边运行 Node.js 模组,在游戏之上绘制 HTML 窗口和 HUD 小部件,并为每个模组提供完整的游戏 API,其类型来自游戏自身的数据。它附带一个 AI 助手,可以与你一起编写模组、在游戏中运行它并修复它。[/size][/center]

[line]

[quote][size=4][b][color=#fcee0a]状态:预览版[/color][/b][/size]
REDnode 公开构建,并在每个阶段结束后于游戏内测试,游戏版本为 2.31。本页面上的所有内容目前都能在游戏中正常工作。这是一个预览版:API 仍可能在各版本之间发生变化,部分内容(列在路线图中)尚待推出。
[b]玩家:[/b]当你想要的模组需要 REDnode 时,安装它即可。
[b]模组作者:[/b]从[url=https://edgemodders.github.io/REDnode/overlay-apps.html]指南[/url]开始;你的第一个模组只需一个文件夹和一个文件。[/quote][line]
制作各种屏幕应用、小部件,甚至可以实现真正的透明效果。
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35355/35355-1792177505-2048305127.png[/img]

易用的模组管理器,用于管理 REDnode 应用和模组(可以把它们理解为 CET 模组)。
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35355/35355-1792177505-1995929837.png[/img]

完整的 3D 游戏内编辑器,名为 EDGEbuilder。
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35355/35355-1792177511-1467588338.png[/img]

可从 3 种不同主题中选择,包括这种类似游戏 UI 的 HUD 红色主题。
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35355/35355-1792177511-1847338957.png[/img]

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

REDnode 由[url=https://edgemodders.ai/]EDGEmodders[/url]构建,这是一个模组社区,其理念很简单:[b]人人都能制作模组[/b]。《赛博朋克》模组制作一直意味着 C++、redscript 或 Lua。REDnode 加入了大多数人已经熟悉的语言——JavaScript(以及 TypeScript),以及 npm 和用于制作界面的 Web 工具。

它包含三个部分,全部在此下载中:

[list]
[][b][color=#19f3ff]插件[/color][/b],游戏内的一个 RED4ext 插件。它在游戏自身的帧上绘制覆盖层,在你打开它时(F10)接管鼠标和键盘,并安全地在游戏线程上执行游戏调用。[/]
[][b][color=#19f3ff]覆盖层宿主[/color][/b],游戏旁边的一个小应用,由插件随游戏一起启动和停止。它渲染窗口,并在各自的进程中运行每个 Node 模组,因此一个崩溃的模组不会拖垮游戏或其他模组。[/]
[][b][color=#19f3ff]rednode 包[/color][/b],模组和应用导入的 API:游戏、窗口、声音、TweakDB、世界、AI 助手等等。[/]
[/list][size=5][b][color=#fcee0a]亮点[/color][/b][/size]

[size=4][b][color=#19f3ff]游戏之上的网页[/color][/b][/size]
任何 HTML 页面都可以成为游戏中的窗口:拖动它、调整大小、卷起、关闭。HUD 小部件在你游玩时留在屏幕上,在菜单、拍照模式和过场中自动隐藏,并让点击穿透其透明部分。页面与游戏在 GPU 上共享,因此覆盖层的开销很小([b]Perf[/b] 示例准确展示了开销有多大)。

[size=4][b][color=#19f3ff]完整的游戏 API,带类型[/color][/b][/size]
[b]api[/b] 按名称调用任意游戏函数:全局函数、静态函数以及游戏对象的方法。它根据游戏自身的反射数据生成类型,因此你的编辑器能补全游戏中的每个类、方法和枚举值。相同的数据以可浏览的[url=https://edgemodders.github.io/REDnode/game/]游戏 API 参考[/url]形式发布。

[code]import { api, game } from 'rednode';

const player = await api.GetPlayer(game.instance);
const shop = await api.GameInstance.GetTransactionSystem(game.instance);
await shop.GiveItem(player, await api.MarketSystem.Money(), 100); // 100 eddies[/code][size=4][b][color=#19f3ff]REDagent:游戏内的 AI 模组作者[/color][/b][/size]
REDagent 由 Claude 驱动,是游戏中的一个聊天窗口,它会与你一起编写 REDnode 模组、启动它们、读取日志、查看屏幕,并修复出错的地方,而你则在游玩。其他模组也可以向它提问。它是从其[url=https://github.com/Edgemodders/REDagent]仓库[/url]单独下载的,并使用你自己的 Anthropic API 密钥。
REDnode 还提供一个 MCP 服务器,因此你桌面上的 Claude Code 可以读取模组的日志、查看覆盖层的窗口、查询游戏类型并调用游戏。

[img]https://staticdelivery.nexusmods.com/mods/3333/images/35355/35355-1792183544-1962604485.png[/img]

[size=4][b][color=#19f3ff]热重载[/color][/b][/size]
在游戏运行时保存模组的文件,模组会带着更改重新启动。无需重启游戏,无需重新加载存档。

[b][color=#00ffff][size=4]性能 GPU 共享[/size][/color]
[/b]
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35355/35355-1792183728-887783471.png[/img]

[size=4][b][color=#19f3ff]空间[/color][/b][/size]
将窗口归入具名空间,就像虚拟桌面一样,并通过启动器或 Ctrl+1 到 9 在它们之间切换。REDnode 自身的工具会显示在每个空间中。

[size=4][b][color=#19f3ff]模组管理器[/color][/b][/size]
一张表格中管理所有 REDnode 包:开启或关闭它、将其固定到启动器或 HUD、将其移动到某个空间,并授予或收回它请求的权限(AI 助手、游戏文件、置顶)。如果一个包需要其他模组(Codeware、TweakXL、ArchiveXL……),它会说明是哪个,以及你是否已安装。

[img]https://staticdelivery.nexusmods.com/mods/3333/images/35355/35355-1792182783-77381118.png[/img]

[size=4][b][color=#19f3ff]你自己的声音[/color][/b][/size]
从你的模组播放 WAV、OGG、MP3 和 FLAC 文件,无需声音库,也无需 REDmod。它们遵循游戏的音量滑块,在菜单中暂停,支持淡入淡出、循环和声像。

[size=4][b][color=#19f3ff]TweakDB,读取与修改[/color][/b][/size]
从运行中的游戏读取任意记录,并通过 TweakXL(社区标准)修改它,因此你的更改会与其他所有 TweakXL 模组并存。当你的模组停止时,它的更改会被撤销。

[size=4][b][color=#19f3ff]世界中的物体[/color][/b][/size]
生成带有网格和组件的实体,移动和移除它们,并在它们附着和分离时收到通知(配合 Codeware)。EDGEbuilder——一个游戏内的世界构建器——正是由此构建的。

[size=4][b][color=#19f3ff]游戏内的调试器[/color][/b][/size]
开启开发者模式,即可在任意窗口或 Node 模组上打开 Chromium 的 DevTools,作为游戏中的窗口:断点、控制台、网络、页面。

[size=4][b][color=#19f3ff]HUD 风格的 UI 套件[/color][/b][/size]
按钮、开关、滑块、标签页、菜单、工具提示和滚动条,外观与游戏一致,提供两种主题。或者完全不使用 HTML,直接从 Node 构建窗口:

[code]import { game, ui } from 'rednode';

const where = ui.text('Waiting for the game...');
ui.window({ title: 'Hello mod', children: [ui.heading('Where is V'), where] });

setInterval(async () => {
  const p = await game.player.position();
  where.set({ text: X ${p.x.toFixed(1)}  Y ${p.y.toFixed(1)}  Z ${p.z.toFixed(1)} });
}, 1000);[/code][img width=884]https://staticdelivery.nexusmods.com/mods/3333/images/35355/35355-1792183359-417269450.png[/img]

[size=5][b][color=#fcee0a]下载内容[/color][/b][/size]

[list]
[]插件、其脚本以及覆盖层宿主。[/]
[]内置工具:启动器、模组日志和模组管理器。[/]
[]六个示例,在你于启动器中开启它们之前全部处于关闭状态:[b]Hello mod[/b](来自 Node 的窗口)、[b]Ask mod[/b](向 AI 助手提问的模组)、[b]UI kit[/b](所有小部件)、[b]Vitals[/b] 和 [b]Coords[/b](HUD 小部件)以及 [b]Perf[/b](覆盖层的开销)。[/]
[/list][size=5][b][color=#fcee0a]前置要求[/color][/b][/size]

[list]
[]PC 上的《赛博朋克 2077》,Windows 10 或 11,64 位。已在游戏版本 2.31 上测试。[/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/2380]RED4ext[/url](1.30 或更高版本):加载插件。[/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/1511]redscript[/url]:编译插件的脚本。[/]
[]仅用于请求它们的包:[url=https://www.nexusmods.com/cyberpunk2077/mods/7780]Codeware[/url](世界中的物体)、[url=https://www.nexusmods.com/cyberpunk2077/mods/4197]TweakXL[/url](TweakDB 更改)、[url=https://www.nexusmods.com/cyberpunk2077/mods/4198]ArchiveXL[/url]。模组管理器会在缺少某个时告知你。[/]
[]仅用于读取游戏文件的包:REDbridge。它不在此下载中:模组管理器会在这样的包上显示一个 [b]Get REDbridge[/b] 按钮,它会从 GitHub 下载它,并在缺失时为你的 Windows 用户下载 .NET 10,无需管理员权限。一份通过 [url=https://github.com/Edgemodders/EDGEdeck]EDGEdeck[/url] 或 [url=https://github.com/Edgemodders/REDcode]REDcode[/url] 获取的副本同样可用。[/]
[/list]REDnode 可与 Cyber Engine Tweaks、其他 RED4ext 插件、redscript 模组和 REDmod 并存。

[size=5][b][color=#fcee0a]安装[/color][/b][/size]

[list]
[][b]Vortex:[/b]Mod Manager Download,然后启用并部署。[/]
[][b]EDGEdeck:[/b]添加 zip,开启它,部署。[/]
[][b]手动:[/b]将 zip 解压到游戏文件夹中,使 [i]red4ext/plugins/REDnode/REDnode.dll[/i] 位于其他 RED4ext 插件旁边。[/]
[/list]启动游戏并按 [b]F10[/b]。第一次按下让覆盖层接管鼠标和键盘,第二次隐藏它,第三次再次显示它。[b]Esc[/b] 将鼠标还给游戏。左下角的 [b]REDNODE[/b] 标签是启动器。

[b]卸载:[/b]在你的模组管理器中移除该模组,或删除 [i]red4ext/plugins/REDnode[/i]。你的设置保存在 [i]%APPDATA%\@rednode\overlay[/i] 中;也要删除该文件夹以获得干净的状态。

[size=5][b][color=#fcee0a]制作 REDnode 模组[/color][/b][/size]

一个 REDnode 模组是一个包含 [b]rednode-app.json[/b] 的文件夹,以及一个网页(应用)或一个 JavaScript 文件(Node 模组),位于 [i]red4ext/plugins/REDnode/apps/[/i] 中。在 Nexus 上发布时,将 zip 内的路径设为该路径,并将 REDnode 列为前置要求。

[list]
[][url=https://edgemodders.github.io/REDnode/overlay-apps.html]含测试示例的指南[/url]:你的第一个应用、窗口、HUD 小部件、声音、游戏 API、TweakDB、世界、调试。[/]
[][url=https://edgemodders.github.io/REDnode/api/]rednode 包的 API 参考[/url]。[/]
[][url=https://edgemodders.github.io/REDnode/game/]游戏 API 参考[/url]:基础游戏中的每个类、结构体、枚举和函数。[/]
[][url=https://github.com/Edgemodders/REDnode/tree/main/packages/overlay/apps]示例[/url],包括此下载中的示例。[/]
[/list][color=#00ffff][size=4]实时调试[/size][/color]

[color=#ffffff][size=3]使用你已熟悉的工具……[/size][/color]
img[/img]


[size=5][b][color=#fcee0a]路线图[/color][/b][/size]

[list]
[][b]覆盖层[/b]:窗口、UI 套件、应用、HUD 小部件、GPU 共享、带游戏 API 的 Node 模组、模组管理器、调试器、图层和空间。已完成。[/]
[][b]REDagent[/b]:聊天、创作、游戏画面、模组向助手提问。已完成。[/]
[][b]世界 API[/b] 和 [b]TweakDB API[/b]:已完成。接下来是通过 REDbridge 在游戏未运行时读取 TweakDB。[/]
[][b]声音 API[/b]:在游戏中使用你自己的文件,已完成。[color=#19f3ff]下一步:[/color]在世界中、实体上和位置上放置声音;然后是效果、语音和游戏声音事件。[/]
[][b]控制台[/b]:游戏内的控制台,用于运行自由形式的 JavaScript,整个 rednode 包随时可用。已提议。[/]
[][b]显示[/b]:覆盖层直接支持 HDR,配合帧生成,在超宽屏上,以及跨分辨率和窗口模式更改。已计划。[/]
[][b]拦截器[/b]:在游戏内运行的小脚本,在游戏自身函数运行时更改它们。已计划。[/]
[/list]完整表格,包含每一项游戏内测试:[url=https://edgemodders.github.io/REDnode/]REDnode 文档[/url]。

[size=5][b][color=#fcee0a]常见问题[/color][/b][/size]

[b]我需要安装 Node.js 吗?[/b]
不需要。覆盖层宿主自带它。

[b]它会让游戏变慢吗?[/b]
在什么都不绘制时影响非常小,而一个不发生变化的窗口几乎不产生开销。Perf 示例显示游戏的帧率和覆盖层每帧自身的耗时,所以你可以自行查看。

[b]一个损坏的模组会让我的游戏崩溃吗?[/b]
Node 模组在游戏之外、各自的进程中运行。崩溃的模组会被记录并重新启动(如果持续崩溃则保持停止);游戏和其他模组继续运行。

[b]AI 助手免费吗?[/b]
REDagent 使用你自己的 Anthropic API 密钥,因此每个回答会向你收取少量费用,支付给 Anthropic。EDGEmodders 不收取任何费用,REDnode 在没有它的情况下也能工作。

[b]为什么下载这么大?[/b]
覆盖层宿主自带一份 Chromium 和 Node(Electron),因此它完全像浏览器一样绘制页面,无需安装其他任何东西。

[b]仅限单人游戏?[/b]
是的。《赛博朋克 2077》是一款单人游戏,REDnode 用于单人游戏模组制作。

[b]它免费吗?[/b]
是的,并且在 MIT 许可证下开源。代码位于 [url=https://github.com/Edgemodders/REDnode]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/REDnode/]edgemodders.github.io/REDnode[/url][/]
[]源代码和问题:[url=https://github.com/Edgemodders/REDnode]github.com/Edgemodders/REDnode[/url][/]
[]REDagent:[url=https://github.com/Edgemodders/REDagent]github.com/Edgemodders/REDagent[/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]制作了 Edgemodders 和这些工具。[/b][/]
[][b]RED4ext[/b] 和 [b]RED4ext.SDK[/b] 由 WopsS 及贡献者制作(MIT):REDnode 进入游戏的方式。[/]
[][b]redscript[/b] 由 jac3km4 制作:REDnode 插件使用的脚本。[/]
[][b]Codeware[/b]、[b]TweakXL[/b] 和 [b]ArchiveXL[/b] 由 psiberx 制作:世界和 TweakDB 支持建立在其之上。[/]
[][b]miniaudio[/b] 由 David Reid 制作(公有领域或 MIT-0):REDnode 的音频引擎。[/]
[][b]Electron[/b] 和 [b]Chromium[/b]:覆盖层宿主。[/]
[][b]WolvenKit[/b] 及其团队,REDbridge 运行其库。[/]
[]《赛博朋克 2077》模组社区,本项目建立在其工具和知识之上。[/]
[/list][size=2]REDnode 与 CD PROJEKT RED 或 Anthropic 无关联。Cyberpunk 2077 和 REDengine 是 CD PROJEKT 的商标。Claude 和 Claude Code 是 Anthropic 的商标。[/size]