REDnode 原生 UI 工具

REDnode 原生 UI 工具

REDnode 原生 UI 工具。在游戏内检查和组装原生 RED 引擎墨水元素。使用响应式 HTML 和 javascript 构建复杂界面、布局和控件。将任何游戏内 UI 或界面转换回 REDnode UI HTML 并进行编辑。从 UI Workbench 创建和管理 UI 项目——游戏内或游戏外。专业级。

[center][img]https://raw.githubusercontent.com/Edgemodders/REDnode/main/packs/ui-tools/nexus/brand/banner.png[/img][/center]

[center][size=5][b][color=#fcee0a]读取夜之城自己的 UI。选取任意控件。构建你自己的原生 UI。[/color][/b][/size][/center]

[center][size=3]REDnode UI Tools 是面向 UI 模组作者的应用程序包。其 UI Workbench 以实时树状结构展示游戏自身的界面,即引擎绘制的 ink 控件:指向 HUD 或菜单中的任意部分,它就会告诉你这是什么、来自哪里,以及它拥有的每一项属性。然后你还可以用 ink 标记编写自己的原生 UI,即游戏会像绘制自身界面那样绘制的 HTML 风格标签。[/size][/center]

[line]

[quote][size=4][b][color=#fcee0a]状态:预览版[/color][/b][/size]
公开构建,并已在游戏版本 2.5 上于游戏内测试。它运行于 [url=https://www.nexusmods.com/cyberpunk2077/mods/35419]REDnode[/url] 和 [url=https://www.nexusmods.com/cyberpunk2077/mods/7780]Codeware[/url] 之上,你需要先安装它们。Inspect 只会读取游戏 UI;Try 只会临时更改控件,直到你按下 Reset 或关闭 Workbench,并且任何内容都不会被保存进游戏。
[b]UI 模组作者:[/b]这是为你准备的。[b]玩家:[/b]你不需要它来游玩 UI 模组。[/quote][line]

[img]https://staticdelivery.nexusmods.com/mods/3333/images/36958/36958-1793701401-872708489.png[/img]

[youtube]7mIW0YldyZI[/youtube]

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

[size=4][b][color=#19f3ff]UI Workbench:Inspect[/color][/b][/size]
以树状结构查看游戏的每一个 ink 层:HUD 及其各个部分(生命值条、小地图、任务追踪器……)、菜单、通知。展开任意控件即可查看其子项。
[list]
[][b]选取:[/b]指向 HUD 或菜单。光标下的控件会被描边并显示名称;单击它,树就会展开到该项并选中其所在行。只会提供游戏实际绘制的控件,优先选取光标下最小的控件。[/]
[][b]选取时右键单击[/b]会将最上层的控件暂放一边,以便选取其下方的控件。[/]
[][b]在内部选取:[/b]选中某个控件后,仅在其子项中选取。[/]
[][b]详情:[/b]控件的类、路径、屏幕上的框、控制器、生成它所用的 .inkwidget 文件,以及每一项属性,各部分均可折叠。可复制其路径或将全部内容复制为 JSON。[/]
[]按名称、类、控制器或文本[b]筛选[/b]树。[/]
[]游戏尚未生成的 HUD 部件(Boss 生命值条、车辆 HUD)会被列出,并注明尚未生成。[/]
[/list][img]https://staticdelivery.nexusmods.com/mods/3333/images/36958/36958-1793701413-1431326827.png[/img]

[list]
[][b]Try:[/b]实时更改选中的控件,包括可见性、不透明度、色调、尺寸、边距、位置、文本或字体大小,以找出控制外观的属性。不会保留任何更改:[b]Reset[/b] 会将其恢复,关闭 Workbench 也会恢复一切。[/]
[][b]To source:[/b]将选中的控件及其下所有内容以 ink 标记复制到你自己的项目中。副本会与原控件并排运行,作为构建类似游戏原生面板的起点。[/]
[/list]

[size=4][b][color=#19f3ff]UI Workbench:Edit 与 Projects[/color][/b][/size]
编写你自己的原生 UI:一个由 [b]ink 标记[/b]构成的面板,即游戏会像绘制自身界面那样绘制的 HTML 风格标签([i]<column>[/i]、[i]<text>[/i]、[i]<image>[/i]、[i]<list>[/i]……),以及为其提供数据的 [b]脚本[/b]。
[list]
[][b]Projects:[/b]每个项目都是你 Documents 文件夹中的一个独立模组([i]Documents\REDnode\UI projects[/i]),不会受游戏更新和重装影响。[b]New[/b] 会从一个小型可用示例开始:一个滑块,在你拖动时驱动一个 HUD 面板。[/]
[][b]Edit:[/b]并排显示标记和脚本,支持高亮、标签与属性补全,并在你输入时于对应行显示每个错误。[/]
[][b]Run[/b] 会立即在游戏中显示;运行时 [b]Save[/b] 会显示每项更改;[b]Stop[/b] 会将其移除。你的项目崩溃绝不会连带 Workbench 一起崩溃。[/]
[][b]Export:[/b]将项目导出为 zip,可作为独立模组安装,随时可在 Nexus 上分享。[/]
[/list][img]https://staticdelivery.nexusmods.com/mods/3333/images/36958/36958-1793701420-481148003.png[/img]

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

[list]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/35419]REDnode[/url] 0.56.0 或更高版本,以及其所需依赖(RED4ext、redscript)。[/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/7780]Codeware[/url] 1.16 或更高版本。[/]
[]PC 版 Cyberpunk 2077,游戏版本 2.5。[/]
[/list][size=5][b][color=#fcee0a]安装[/color][/b][/size]

[list]
[][b]Vortex:[/b]使用 Mod Manager Download,然后启用并部署。[/]
[][b]手动:[/b]将 zip 解压到游戏文件夹,使应用落在 [i]red4ext/plugins/REDnode/apps/[/i]。[/]
[/list]在游戏中按 [b]F10[/b],并从启动器打开 [b]Mod Manager[/b](左下角的 [b]REDNODE[/b] 标签页)。开启 [b]UI Workbench[/b];它默认关闭。Inspect 可立即使用。To source、Try、Edit 和 Projects 需要其 [b]admin[/b] 权限,因为它们会启动和停止你的项目并更改游戏控件:请在 Mod Manager 中 Workbench 的详情里允许该权限。

[b]卸载:[/b]在模组管理器中移除,或从 [i]red4ext/plugins/REDnode/apps/[/i] 删除 [i]ui-workbench[/i] 文件夹。REDnode 本身会保留。

[size=5][b][color=#fcee0a]面向模组作者[/color][/b][/size]

Workbench 读取的一切都在 REDnode 的 [b]rednode[/b] 包中,可供你自己的模组使用:[i]ink.layers[/i] 用于游戏的层和 HUD 部件,[i]ink.read[/i] 用于一次调用获取控件树(包括其布局和外观),[i]ink.inspect[/i] 用于完整获取单个控件,[i]ink.at[/i] 和 [i]ink.boxes[/i] 用于获取某个点下方的控件,[i]ink.try[/i] 和 [i]ink.reset[/i] 用于更改游戏控件并将其恢复。你自己的原生 UI 可使用 ink 标记通过 [i]ink.load[/i] 和 [i]ink.parse[/i] 编写,或使用 [i]ink[/i] 系列函数编写。参见[url=https://edgemodders.github.io/REDnode/ink.html]原生 UI 文档[/url]。

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

[b]它会让游戏变慢吗?[/b]
一次选取会在 3 毫秒内读取约 450 个控件。Pick 开启时,每 1.5 秒会重新读取一次框;移动鼠标不会向游戏发出任何请求。

[b]Try 会永久改变我的游戏吗?[/b]
不会。每项更改都会保留控件原有的值;Reset 会将其恢复,并且 Workbench 关闭时 REDnode 会恢复一切。存档绝不会保存任何更改。

[b]我的项目在哪里?[/b]
在 [i]Documents\REDnode\UI projects[/i] 中,每个项目一个文件夹;Export 会将 zip 写入 [i]Documents\REDnode\UI exports[/i]。删除的项目会进入项目文件夹的 [i].trash[/i],你可以在那里将其恢复。

[b]为什么我无法在树中单击某个 HUD 部件?[/b]
游戏只在需要时才会创建许多 HUD 部件(视频、Boss 战、车辆)。在此之前没有内容可显示;当其出现在屏幕上后,刷新并再次选择即可。

[b]它免费吗?[/b]
是的,并且以 MIT 许可证开源,位于 [url=https://github.com/Edgemodders/REDnode]REDnode 的仓库[/url]中。

[line]
[b][size=5][color=#fcee0a]链接[/color][/size][/b]
[list]
[]REDnode:[url=https://www.nexusmods.com/cyberpunk2077/mods/35419]Nexus 页面[/url]、[url=https://edgemodders.github.io/REDnode/]文档[/url]、[url=https://edgemodders.github.io/REDnode/ui-tools.html]UI Tools 指南[/url][/]
[]源码与问题:[url=https://github.com/Edgemodders/REDnode]github.com/Edgemodders/REDnode[/url][/]
[]EDGEmodders:[url=https://edgemodders.ai/]edgemodders.ai[/url][/]
[]社区 Discord:[url=https://discord.gg/63qP3Erw43]discord.gg/63qP3Erw43[/url][/]
[/list][size=5][b][color=#fcee0a]致谢[/color][/b][/size]
[list]
[][b]Codeware[/b] 作者 psiberx:游戏的 ink 层通过它到达 REDnode。[/]
[][b]RED Hot Tools[/b] 作者 psiberx,其 Ink Inspector 展示了游戏 UI 检查器可以是什么样。[/]
[][b]RED4ext[/b] 及其 SDK,Workbench 通过其游戏类型描述进行读取。[/]
[]Cyberpunk 2077 模组社区,本作品建立在其对 ink 的研究之上。[/]
[/list][size=2]REDnode UI Tools 与 CD PROJEKT RED 无关联。Cyberpunk 2077 是 CD PROJEKT 的商标。[/size]