EDGEquest

EDGEquest

EDGEquest 是一款面向《赛博朋克》的革命性新任务编辑器。通过直观且易于上手的设计浏览游戏任务。使用简单的可视化任务节点创建你自己的任务。添加自定义内容、生成配音等。甚至只需描述你想要的任务,工具就会为你构建出来。可与其他 EDGE 工具集成。

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

[center][size=5][b][color=#fcee0a]在 VS Code 中的《赛博朋克 2077》EDGE 任务制作器。[/color][/b][/size][/center]

[center]以通俗文字阅读游戏中的任何任务:它的步骤、它的选择、谁说了什么,以及日志中写了什么。然后以短篇故事的形式编写你自己的任务,EDGEquest 便会据此生成游戏的任务文件:阶段、日志、场景及其文本。[/center]
[center][/center]
[center][color=#f6b26b][size=3][i]早期预览:带有 V、选择与分支的小型任务,已在游戏中测试。[/i][/size][/color][/center]
[line]
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35750/35750-1793794557-1854056394.png[/img]

[img]https://staticdelivery.nexusmods.com/mods/3333/images/35750/35750-1793794601-768857101.png[/img]
[quote][size=4][b][color=#fcee0a]状态:预览[/color][/b][/size]
现有功能均可用,并已在游戏中测试。新功能会以小版本更新的形式发布。
[b]这不是一个游戏模组。[/b]它是 VS Code 的扩展,因此请在那里安装(步骤见下),而不是用 Vortex。最快的方式是直接从 [url=https://marketplace.visualstudio.com/items?itemName=edgemodders.edgequest]VS Code Marketplace[/url] 或 [url=https://open-vsx.org/extension/edgemodders/edgequest]Open VSX[/url] 安装;此处的文件是同一个扩展。[/quote]
[size=5][b][color=#fcee0a]EDGEquest 是什么[/color][/b][/size]

EDGEquest 由 [url=https://edgemodders.ai/]EDGEmodders[/url] 打造,这是一个理念很简单的模组社区:[b]人人都能做模组[/b]。任务是《赛博朋克 2077》中最难制作模组的内容之一:节点图、事实、日志条目、场景及其文本,全都存放在必须相互一致的二进制文件中。EDGEquest 将这一切转化为文字。你以编号步骤的形式阅读游戏任务,并以故事的形式编写任务:带有目标、地点的节拍,以及带有台词和选择的场景。

它通过 [b]REDbridge[/b] 读写游戏文件,REDbridge 运行 [b]WolvenKit[/b] 的库;它与 [url=https://www.nexusmods.com/cyberpunk2077/mods/35421]REDcode[/url] 配合使用,后者负责打包并安装你的任务。文件格式与多年研究的功劳属于 WolvenKit 团队和模组社区。

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

[size=4][b][color=#19f3ff]阅读游戏的任务[/color][/b][/size]
游戏中的每一个任务、阶段和场景,都在以任务名称命名的树形结构中呈现。任务页面以编号步骤的通俗文字展示一个任务或阶段,包括其事实、日志条目、场景、阶段、人物和地点;它播放的阶段和场景都是链接。场景页面展示其中有哪些人、每句台词的说话者与文本,以及每个选择及其去向。[b]Find Quest[/b] 可按游戏内标题、文件名、事实、日志条目、人物或地点进行搜索。

[size=4][b][color=#19f3ff]以故事的形式编写任务[/color][/b][/size]
[b]New Quest[/b] 会基于一个可运行的模板,在你的 WolvenKit 项目中新建任务。故事文件是一组节拍,每个节拍都有一个日志目标和若干步骤:前往某地、播放场景、等待、设置事实、结束任务。场景中的选择可以将任务导向另一个节拍,从而形成分支,分支也可以再次汇合。结局分为成功或失败。

[size=4][b][color=#19f3ff]故事板[/color][/b][/size]
你的任务以卡片形式呈现,每个节拍一张,以其目标为标题,箭头标有所指向的选择。点击卡片可查看其页面:它的步骤、其场景的台词与选择,以及每句台词如何说出。添加和重命名节拍、将选择指向某个节拍、就地编辑台词和选项。所有更改都会写入故事文件,并保留注释。

[size=4][b][color=#19f3ff]保存,任务即生成[/color][/b][/size]
保存故事文件即可生成任务的游戏文件:任务阶段、日志、场景、文本和 ArchiveXL 文件,并相互校验。问题会显示在 VS Code 的问题面板中,并定位到对应行。使用 REDcode 打包并安装,即可游玩。

[size=4][b][color=#19f3ff]地点、选择、音乐与音效[/color][/b][/size]
[list]
[][b]地点[/b]是游戏已有的地图标记。任务会等到 V 进入该地点的触发区域,正如游戏自身的任务一样。[/]
[][b]选择[/b]可以是黄色(推动任务前进)、白色、仅限某条人生路径、属性检定,或消耗欧元(eddies)的付款。[/]
[][b]音乐与音效:[/b]在节拍中或场景台词之间,开始和停止游戏的音乐提示,播放游戏的音效事件,或使用 [url=https://github.com/Edgemodders/EDGEwave]EDGEwave[/url] 制作的你自己的音效。选择器会在你选择之前播放每一个。[/]
[/list]
[size=4][b][color=#19f3ff]清单[/color][/b][/size]
仍然是占位的内容(例如仅以文本显示、尚无配音的台词),会在故事文件中连同可完成它的 EDGE 工具一起列出,并在完成后自动勾选。

[size=4][b][color=#19f3ff]检查任务模组[/color][/b][/size]
[b]Check Quest Mod[/b] 会读取任务模组的归档、WolvenKit 项目或已提取的文件,并以通俗文字列出问题所在:缺失的文件、指向空处的条目、不存在的文本。

[size=4][b][color=#19f3ff]面向 AI 助手[/color][/b][/size]
[url=https://www.npmjs.com/package/@edgemodders/edgequest-mcp]@edgemodders/edgequest-mcp[/url] 为 Claude Code 及其他助手提供同样的任务制作器:阅读游戏任务、新建任务、修改其故事、生成任务,并处理其清单。

[size=4][b][color=#19f3ff]后续计划[/color][/b][/size]
计划中:与游戏角色的电话通话、将游戏场景复制到你的任务中、在场景中站立的人物,以及游戏中的配音台词。

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

[list]
[]Windows 10 或 11,64 位,以及 PC 版《赛博朋克 2077》2.5。[/]
[][url=https://code.visualstudio.com/]VS Code[/url] 1.70 或更高版本、[url=https://vscodium.com/]VSCodium[/url] 或 EDGEkit。[/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/35421]REDcode[/url]:它会找到游戏、安装 REDbridge(0.11.0 或更高版本)和 .NET 10 运行时,并打包和安装你的任务。[/]
[]游戏中的 [url=https://www.nexusmods.com/cyberpunk2077/mods/4198]ArchiveXL[/url],用于你制作的任务。[/]
[]可选:[url=https://github.com/Edgemodders/EDGEwave]EDGEwave[/url] 用于查找、试听和制作音效;[url=https://github.com/Edgemodders/REDnode]REDnode[/url] 用于在运行中的游戏里试听音乐。[/]
[/list][size=5][b][color=#fcee0a]安装[/color][/b][/size]

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

[b]从此处的文件安装:[/b]
[list]
[]先从其页面或商店安装 REDcode。[/]
[]使用 [b]Manual download[/b] 下载主文件,并解压到任意位置。[/]
[]在 VS Code 中打开扩展视图(Ctrl+Shift+X),点击顶部的 [b]...[/b],选择 [b]Install from VSIX...[/b],然后选择 [i]edgequest-<version>.vsix[/i]。[/]
[]点击活动栏中的 EDGEquest 图标。[/]
[/list]请勿使用 Vortex 安装:它不是游戏模组,Vortex 会将其放入游戏文件夹。

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

EDGEquest 是 EDGE 工具之一。各工具既可独立使用,也可协同工作:

[list]
[][b][url=https://www.nexusmods.com/cyberpunk2077/mods/35421]REDcode[/url][/b]:VS Code 中的模组工作区。它负责打包并安装你的任务。[/]
[][b][url=https://github.com/Edgemodders/EDGEwave]EDGEwave[/url][/b]:音效工作室。为你的任务台词制作音效,以及日后的配音。[/]
[][b][url=https://github.com/Edgemodders/EDGEdeck]EDGEdeck[/url][/b]:VS Code 中的简易模组管理器,可撤销安装。[/]
[][b][url=https://github.com/Edgemodders/REDnode]REDnode[/url][/b]:以 JavaScript 和网页形式在游戏之上运行模组;它为 EDGEquest 的选择器在运行中的游戏里播放音乐。[/]
[][b][url=https://github.com/Edgemodders/REDbridge]REDbridge[/url][/b]:为 EDGE 工具运行 WolvenKit 的库。[/]
[/list][size=5][b][color=#fcee0a]常见问题[/color][/b][/size]

[b]我需要了解任务内部是如何运作的吗?[/b]
不需要。你编写节拍、地点、台词和选择;EDGEquest 负责编写节点、事实和文件。当你想查看原始文件时,只需在 REDcode 中一键即可打开。

[b]在我的场景中,人们可以和 V 对话吗?[/b]
目前还不行。在此预览版中,V 独自说话并做出选择。场景中站立的人物、电话通话和配音台词将在后续推出。

[b]它会改动我的游戏文件夹吗?[/b]
不会。EDGEquest 写入你的 WolvenKit 项目。只有当你使用 REDcode 或 EDGEdeck 打包并安装时,你的任务才会进入游戏。

[b]它是免费的吗?[/b]
是的,并且以 MIT 许可证开源。代码位于 [url=https://github.com/Edgemodders/EDGEquest]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/EDGEquest/]edgemodders.github.io/EDGEquest[/url][/]
[]源码与问题反馈:[url=https://github.com/Edgemodders/EDGEquest]github.com/Edgemodders/EDGEquest[/url][/]
[]VS Code Marketplace:[url=https://marketplace.visualstudio.com/items?itemName=edgemodders.edgequest]edgemodders.edgequest[/url][/]
[]Open VSX:[url=https://open-vsx.org/extension/edgemodders/edgequest]edgemodders/edgequest[/url][/]
[]社区 Discord:[url=https://discord.gg/63qP3Erw43]discord.gg/63qP3Erw43[/url][/]
[/list][size=5][b][color=#fcee0a]致谢[/color][/b][/size]

[list]
[][b]WolvenKit[/b] 及其团队和贡献者(GPL-3.0):EDGEquest 读写的每一个游戏文件都经由他们在 REDbridge 中的库处理。[/]
[]psiberx 的 [b]ArchiveXL[/b]:任务模组向游戏添加阶段、日志和文本的方式。[/]
[]《赛博朋克 2077》模组社区,本工具建立在其任务研究与工具之上。[/]
[/list][size=2]EDGEquest 与 CD PROJEKT RED、WolvenKit 团队或 Microsoft 无关联。Cyberpunk 2077 和 REDengine 是 CD PROJEKT 的商标。Visual Studio Code 是 Microsoft 的商标。[/size]