EDGEmat

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

[center][size=5][b][color=#fcee0a]看清每件服装由什么构成。然后为它重新上色，或让 AI 来做。[/color][/b][/size][/center]

[center][size=3]EDGEmat 是一个用于《赛博朋克 2077》服装的材质编辑器，运行在 VS Code 中。输入一件服装的游戏内名称，它会用通俗语言展示该服装的每一层、每层所处位置的地图，以及带有颜色的 3D 服装模型。Claude 和其他 AI 助手也可以向它提出相同的问题。[/size][/center]

[line]

[quote][size=4][b][color=#fcee0a]状态：预览版[/color][/b][/size]
版本 0.2 可以读取服装的材质并将其展示出来。它尚不能修改材质：重新上色是下一阶段的工作。本页所述的一切均已在开发者的电脑上、游戏版本 2.31 上构建并测试。
[b]这是一个 VS Code 扩展，不是游戏模组。[/b]它读取你的游戏文件，但从不修改它们。请勿使用 Vortex 安装它。[/quote]
[line]
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35422/35422-1792555111-1794644463.png[/img]
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35422/35422-1792555152-884232716.png[/img]


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

《赛博朋克 2077》中的大多数服装的外观来自[b]多层材质[/b]：最多 20 层的堆叠，例如皮革、金属铆钉和缝线。每一层都有一个表面、一个取自该表面颜色列表的颜色，以及一个将该层绘制到服装某一部分的遮罩。重新上色意味着编辑这个堆叠，而目前这需要专业工具和一份能分清哪个文件是哪个的详细地图。

EDGEmat 由 [url=https://edgemodders.ai/]EDGEmodders[/url] 打造，这是一个模组社区，其理念很简单：[b]人人都能制作模组[/b]。先呈现通俗语言，原始数值一键即可查看，所有功能在按钮中和面向 AI 助手时都同样可用。

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

[size=4][b][color=#19f3ff]按名称查找服装[/color][/b][/size]
输入“punk jeans”或“Sunny Ammo”。EDGEmat 会为你遍历游戏的文件链：物品、每种体型的对应外观、其网格，以及它们的材质。两种体型甚至可以穿着不同的网格，EDGEmat 会把两者都显示出来。

[color=#19f3ff][i][img]https://staticdelivery.nexusmods.com/mods/3333/images/35422/35422-1792555213-90041381.png[/img][/i][/color]

[size=4][b][color=#19f3ff]用通俗语言展示每一层[/color][/b][/size]
“皮革，黑色，大部分有光泽，轻微凹凸，占夹克的 6%。”每一层的表面、颜色、光泽、金属感、凹凸、平铺和细节纹理，以及它覆盖服装的比例。勾选 Raw values（原始值）可查看游戏自身的名称和数值。未显示的层会说明原因，EDGEmat 还会标记出看起来有误的地方，例如某个表面并不提供的颜色（游戏会将其绘制为白色）。

[size=4][b][color=#19f3ff]可点击的颜色地图[/color][/b][/size]
服装的纹理，平坦展开，每一层按遮罩所在的位置以其颜色绘制。点击某个位置即可找到其所属的层；选中某一层即可点亮它所在的确切位置。

[img]https://staticdelivery.nexusmods.com/mods/3333/images/35422/35422-1792555298-902814000.png[/img]
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35422/35422-1792555343-682766462.png[/img]

[size=4][b][color=#19f3ff]3D 服装模型[/color][/b][/size]
一键在 REDcode 的 3D 查看器中打开网格，并带有来自 EDGEmat 的颜色：每一层都在其应在的位置，贴花和缝线则作为各自的纹理。目前仅有颜色；光泽和凹凸将随完整预览一同推出。

[color=#19f3ff][i][img]https://staticdelivery.nexusmods.com/mods/3333/images/35422/35422-1792555416-1046393162.png[/img][/i][/color]

[size=4][b][color=#19f3ff]每个表面和每种颜色都有名称[/color][/b][/size]
一个包含游戏中所有表面（约 390 个）和细节纹理（约 130 个）的库，从你自己的游戏中构建，带有缩略图。每个表面的页面都会将其提供的每种颜色显示为带通俗名称的色块（如“dark muted blue”），并按与你输入或选取的颜色的接近程度进行排序。

[img]https://staticdelivery.nexusmods.com/mods/3333/images/35422/35422-1792555604-1072948209.png[/img]

[size=4][b][color=#19f3ff]打开任意材质文件[/color][/b][/size]
可从游戏中、你的 WolvenKit 项目中、磁盘上的文件，或在另一个模组的压缩包内打开，无需解压。EDGEmat 会找到正确的遮罩，且从不更改原始文件。

[size=4][b][color=#19f3ff]询问 Claude[/color][/b][/size]
EDGEmat 附带一个 MCP 服务器，因此 Claude Code 可以查找服装的材质、描述其各层，并找到某个表面最接近的颜色。“punk jeans 使用了哪些材质？”“皮革能接受的最接近的深红色是什么？”它自身不进行任何网络调用，也不发送任何遥测数据。

[color=#19f3ff][i]询问 Claude：“使用 EDGEmat，制作一个深绿色蛇皮材质，并将其应用到我项目 C:\Users\dgovo\Documents\EDGEmat_M3 中的 Light Azure composite-lined slim-fits，两种体型都要”

[img]https://staticdelivery.nexusmods.com/mods/3333/images/35422/35422-1792551062-1027016100.png[/img]
将生成的 Material 添加到你的项目中，并在提示中提到的服装物品上覆盖它。

在 [url=https://www.nexusmods.com/cyberpunk2077/mods/35421]REDcode [/url]中点击“Run”，你的新材质的皮肤就出现了。
[img]https://staticdelivery.nexusmods.com/mods/3333/images/35422/35422-1792551120-517137483.png[/img]
[/i][/color]

[size=5][b][color=#fcee0a]下载内容包含什么[/color][/b][/size]

[list]
[][b]edgemat-x.y.z.vsix[/b]：VS Code 扩展。[/]
[][b]edgemat-mcp-x.y.z.cjs[/b]：面向 AI 助手的 MCP 服务器，单个文件。可选。[/]
[]README.txt（安装方法）、LICENSE.txt 和 THIRD-PARTY-NOTICES.txt。[/]
[/list]其中不包含任何来自游戏的内容：EDGEmat 会在首次运行时从你自己的游戏中构建其库，用时不到半分钟，且在游戏更新后仍保持最新。

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

[list]
[]PC 上的《赛博朋克 2077》，Windows 10 或 11，64 位。已在游戏版本 2.31 上测试。[/]
[][url=https://code.visualstudio.com/]VS Code[/url] 1.70 或更高版本（或 VSCodium，或 EDGEkit）。[/]
[]REDbridge 0.8.0 或更高版本，即读取游戏文件的引擎。简便方法：安装 [url=https://github.com/Edgemodders/REDcode]REDcode[/url] 并运行其 [b]Install REDbridge[/b]，它还会为你的 Windows 用户获取 .NET 10。设置好 REDcode 后，EDGEmat 完全无需配置。[/]
[]使用“View in 3D”：需要 REDcode。[/]
[]使用助手：Node.js 20 或更高版本，以及 Claude Code 或其他 MCP 客户端。[/]
[/list]
[size=5][b][color=#fcee0a]安装[/color][/b][/size]

[list]
[]下载 zip 并解压到任意位置。[/]
[]在 VS Code 中，打开扩展视图（Ctrl+Shift+X），点击其顶部的 [b]...[/b]，选择 [b]Install from VSIX...[/b]，然后选取 [i]edgemat-x.y.z.vsix[/i]。[/]
[]点击活动栏中的 EDGEmat 图标。库会自行构建。[/]
[/list]或在终端中：[i]code --install-extension edgemat-x.y.z.vsix[/i]。分步指南：[url=https://edgemodders.ai/wiki/edgemat/install.html]安装与设置[/url]。

[b]卸载：[/b]在 VS Code 的扩展视图中卸载。库位于 [i]%LOCALAPPDATA%\EDGEmat[/i]；如需彻底清除，也请删除该文件夹。

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

[list]
[][b]Library[/b] 和 [b]Read[/b]：库、表面页面、设置编辑器、查找、View in 3D、助手的工具。已完成：即此版本。[/]
[][color=#19f3ff]下一步：[/color][b]Edit[/b]：更改某一层的表面、颜色、平铺和细节，支持撤销，并保存到你的模组项目中，或让助手来完成。[/]
[][b]Make[/b]：为新衣服和物件制作材质，可基于模型的纹理、基于照片，或由你选择的 AI 图像服务根据你的文字（如“棕色皮革”）生成，使用你自己的密钥。[/]
[][b]Preview[/b]：在 3D 模型上预览光泽、凹凸、金属感和细节，而不只是颜色。[/]
[][b]Beyond layers[/b]：任何表面都不提供的颜色、其他类型的材质。[/]
[][b]Ship[/b]：VS Code Marketplace 和 Open VSX。[/]
[/list]完整计划及每一项测试：[url=https://edgemodders.github.io/EDGEmat/]EDGEmat 文档[/url]。

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

[b]这是一个游戏模组吗？[/b]
不是。它是一个用于制作模组的工具，运行在 VS Code 中。它读取游戏文件，但从不修改它们。你的游戏不需要它。

[b]我现在可以用它给衣服重新上色吗？[/b]
还不能。此预览版会先向你展示你所需了解的一切：哪些文件、哪些层、每个表面提供哪些颜色。编辑是下一阶段的工作。

[b]我需要 AI 或账号吗？[/b]
不需要。EDGEmat 完全独立运行。AI 助手是可选的；它使用你自己的 Claude 账号。

[b]它与 MlsetupBuilder 有何不同？[/b]
MlsetupBuilder 是许多模组作者熟悉的编辑器，EDGEmat 从它的行为方式中有所借鉴。EDGEmat 是一个从零编写的新编辑器，运行在 VS Code 中：它能根据名称找到服装的文件，用通俗语言描述各层，从你自己的游戏中构建其库，并可与 AI 助手协同工作。

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

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

[line]

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

[list]
[]手册：[url=https://edgemodders.ai/wiki/edgemat/]edgemodders.ai/wiki/edgemat[/url][/]
[]文档与更新日志：[url=https://edgemodders.github.io/EDGEmat/]edgemodders.github.io/EDGEmat[/url][/]
[]源码与问题反馈：[url=https://github.com/Edgemodders/EDGEmat]github.com/Edgemodders/EDGEmat[/url][/]
[]REDcode：[url=https://github.com/Edgemodders/REDcode]github.com/Edgemodders/REDcode[/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]MlsetupBuilder[/b]，作者 Neurolinked：EDGEmat 研究了它的行为方式，但未使用其任何代码或数据。EDGEmat 并非由其作者制作或背书。[/]
[][b]WolvenKit[/b] 及其团队，REDbridge 运行其库来读取游戏文件。[/]
[][b]Cyberpunk 2077 modding wiki[/b] 及更广泛的模组社区，本工具建立在其对材质系统的知识之上。[/]
[]捆绑的开源软件包，已在 THIRD-PARTY-NOTICES.txt 中连同许可证一并列出。[/]
[/list][size=2]EDGEmat 与 CD PROJEKT RED 或 Anthropic 无关联。Cyberpunk 2077 和 REDengine 是 CD PROJEKT 的商标。Claude 和 Claude Code 是 Anthropic 的商标。[/size]