玩家身体义体注射器

曾经希望将我的机械臂模组整合到玩家身体中，无论你选择什么服装都能一直存在，并且在淋浴和过场动画中也能显示吗？现在，你可以做到了！

与其构建单独的替换模组（这是一项繁琐的工作），我设计了一种脚本机制，允许你将普通衣柜装备中的义体保存下来，并将这些组件注入到玩家身体中。这让你可以轻松地组合物品并调整其组件，以及在不退出游戏或移动档案的情况下更改你的义体配置！

[center][size=5][b][color=#ff0000]请仔细阅读文档！这个模组试图实现一些复杂的操作！[/color][/b][/size][/center]


[b]特性[/b]

[list]
[]将 KiasuBurger 机械臂模组物品的任意组合保存到一个配置中，该配置将集成到玩家身体中，与所穿衣物无关[/]
[]配置始终存在：在淋浴、角色创建器和所有过场动画中[/]
[]配置尊重物品外观选择，包括我的无机皮肤颜色[/]
[]无需退出游戏或重新加载存档即可移除和更改配置（如果你愿意费些周折）[/]
[]为每个游玩角色单独保存配置，并跨多个存档追踪[/]
[]服装支持对于任何通常具有该功能的物品继续有效[/]
[]高级功能：手动创建自己的 json 文件，以包含任何模组中的任何物品！[/]
[/list][b]升级到 2.0.0 或更高版本[/b]

如果你一直在使用旧版本的注入模组并保存了男性和/或女性配置，这些配置将不再被模组使用。转向按角色配置意味着当你加载旧存档（或创建新角色）时，会为该角色生成一个唯一 ID，并存储在后续存档中。从此，该 ID 将跟随你的角色。由于 ID 是唯一的，你无法预先知道它是什么。但很容易找到它。
[list]
[][b]重要提示[/b]：在再次保存游戏之前，唯一 ID 也不会被保存。每次加载旧存档都会生成一个新 ID。你必须再次保存，然后不要再使用之前的存档。从此时起，ID 将保持不变，如果你想的话，可以创建多个分支存档 - 但旧存档将始终缺少 ID，并且每次加载时都会得到一个全新的 ID.[/]
[]一旦你有一个包含 ID 的存档，它将保持不变。[/]
[]调出 CET 覆盖层并打开控制台。然后点击“Kiasu Burger Replacer”窗口中的“Dump loadout”按钮。在控制台中，你会看到一行文本，告诉你它试图导出的配置文件名。由于此时你没有配置，你不会看到其他内容，但现在你知道了文件名。[/]
[]复制文件名（在 CET 中 Ctrl+C 有效），然后转到游戏安装目录内的“\r6\storages\KiasuBurgerReplacer\”子目录。[/]
[]将你现有的男性/女性 json 文件复制到新文件名。[/]
[]回到游戏中，“Dump loadout”应立即显示文件内容。[/]
[]重新加载存档以激活配置。虽然技术上不是必须的，但这样做简单得多。[/]
[]尽情享受！[/]
[/list]
[b]鸣谢
[/b]
[list]
[][url=https://www.nexusmods.com/profile/psiberx]psiberx[/url] 在找到解决网格组件路径和使 GS 工作的正确方法方面提供了极大的帮助[/]
[/list][list]
[][url=https://www.nexusmods.com/profile/RayshaderFR]Rayshader[/url] 为 RedFilesystem 提供了所有帮助[/]
[/list]
[i][u]虚拟摄影师[/u][/i]

[list]
[][url=https://next.nexusmods.com/profile/iLikeCaramels]iLikeCaramels[/url][/]
[][url=https://www.nexusmods.com/profile/ThisIsACryForHelp]ThisIsACryForHelp[/url][/]
[/list]

[i][u]额外测试[/u][/i]

[list]
[][url=https://www.tumblr.com/amonvp]Amon[/url][/]
[][url=https://next.nexusmods.com/profile/alternatevy/about-me]Alternatevy[/url][/]
[][url=https://next.nexusmods.com/profile/lalla12]lalla12[/url][/]
[/list]
[b]使用方法[/b]

[list]
[]在衣柜中设置你想要使用的 KiasuBurger 手臂义体[/]
[]打开 CET 覆盖层并找到 Kiasu Burger Replacer 窗口。[/]
[]点击 Save current loadout，你当前外观中的所有 Kiasu Burger 手臂物品将被保存。[/]
[]要验证，或者如果你好奇，点击 Dump saved loadout to console 查看保存的内容。[/]
[]要删除保存的配置，点击 Delete saved loadout。[/]
[]新的或移除的配置将在你下次更改衣柜服装时生效。[/]
[]每个游玩角色都有独立的配置。[/]
[/list]
[b]最佳实践[/b]

[list]
[]激活/停用/切换配置最可靠的方法是保存配置，然后保存游戏并重新加载。[/]
[]虽然你的配置不一定需要有保存的衣柜服装，但如果你有，回去修改它会容易得多。如果你没有保存的服装并且想修改配置，你必须将所有部件放回衣柜中。如果你改变肤色或身体模组，这也允许你刷新配置 - 你保存的配置会将这两者锁定。[/]
[]如果你打算在不重新加载存档的情况下更改配置，请尝试以下步骤：
退出到第一人称视角
* 进入衣柜切换到另一套服装，然后再切换回你偏好的那套。此时，库存视图应该是正确的。
* 进入照片模式。它看起来应该是正确的。
* 退出照片模式。这应该会更新第一人称视角。
* 如果仍然不起作用，请保存并重新加载。[/]
[/list]
[b]限制[/b]

[list]
[]保存的组件列表反映了保存时所使用的身体模组。如果你切换到不同的身体模组，它将持续使用与旧模组匹配的网格。你必须重新保存列表来更新它。[/]
[]它还包括肤色。如果你改变肤色，必须重新保存配置。[/]
[]如果你尝试使用我的无机皮肤模组来重新着色基础身体手臂（而不是使用我的手臂模组之一），它将无法保存你的无机外观。我使用了一种不同的技术来改变皮肤外观，这种技术不是基于组件的，所以没有可保存的内容。[/]
[]安装注入器后首次加载存档时，它会生成一个唯一 ID，将配置与该存档绑定。你[b]必须[/b]再次保存游戏以保存该唯一 ID！如果你重新加载旧的存档，每次都会获得一个新的唯一 ID。如果你在安装注入器之前有多个存档，并且你保留并积极使用，你将无法在它们之间共享一个 ID - 抱歉。[/]
[]CET 界面只会保存 Kiasu Burger 组件。如果你想包含其他作者的物品，你需要自己向 json 文件添加条目，并记住，如果你再次使用 CET 界面“保存”，它们将被覆盖。[/]
[]它不能用于保存 Kiasu Burger 腿部组件或其他类似鞋子的物品，因为没有 AXL 隐藏腿部很困难，而且尚未实现。[/]
[]最多可存储 50 个组件，但这对于任何人来说应该足够了。[/]
[]如果你在 CET 覆盖层中“重新加载所有模组”，配置保存可能会停止工作。这应该只影响其他模组开发者，但如果你需要“重新加载所有模组”，请在尝试保存另一个配置之前重新启动游戏。[/]
[]此模组与 Spawn0 身体模组不兼容。这些模组切换了玩家身体使用的实体定义，这破坏了我们依赖的 AXL 注入。[/]
[/list]

[b]开发者评论[/b]

自从我开始发布我的模组以来，很多人问我是否有办法将它们永久添加到玩家身体中，以便它们在所有情况下都能出现，比如在淋浴或玩家穿着故事指定服装的过场动画中。创建这类模组（通常称为“替换模组”）是可能的，因为它替换了玩家身体的现有组件，或者利用 Nim 的 More Body Mods，在这种情况下，你是在“替换”Nim 添加到身体上的不可见假组件。但是替换模组的可用性很差 - 你必须退出游戏并移动档案来添加/移除模组，以及更改外观（颜色等）。你还受到可替换组件的限制，而且没有办法在不替换的情况下隐藏某些东西。这意味着你不能轻易地将 ArchiveXL 模组转换为替换模组 - 它必须完全重新组织，并且维护同一模组的两种风格的版本成本太高。这也是我告诉人们我无法支持它的原因，但这不是一个令人满意的答案，我想找到一种方法来实现它，而不必承担两个完全独立的模组的成本。

所以我进行了调查，并且已经在我的无机皮肤模组中证明了可以通过脚本在运行时重写组件（你可以更改网格、外观和 chunkMask），我知道应该可以构建一些东西来动态地将 ArchiveXL 物品组件摄取到玩家身体中。在理想的世界中，我们会动态创建组件，而不是替换任何东西，但我（我认为其他人也没有）找到了正确的方法 - 以这种方式添加的任何组件都不会连接到身体动画装备，因此它永远不会移动。相反，我注入了一堆假组件（类似于 Nim 的工作方式），然后用脚本替换它们。

最后一块拼图是提出一种用户友好的方式来定义要注入的组件集。我最终确定了简单的方法，即一个按钮，可以保存所有带有我的名字的东西（粗略地说）。当然，我希望有某种组件选择器，用户可以在其中快速选择，无论模组作者是谁，都可以选择他们想要的任何东西，但我没有时间构建如此复杂的东西。尽管如此，我认为这是一个很好的解决方案，可以满足人们的需求，而不会给我带来巨大的维护负担。

[b]常见问题解答[/b]

[i][u]为什么不支持腿部模组？[/u][/i]

腿部模组更难处理，因为它们需要部分隐藏玩家身体的某些部分，而不是完全隐藏整个组件。由于与玩家可能正在使用的其他 ArchiveXL 物品的交互，很难跟踪在哪些时间点需要隐藏和显示哪些部分。

[i][u]支持其他作者的模组怎么样？[/u][/i]

正如我上面讨论的，你总是可以创建自己的自定义 JSON 文件，其中包含任何模组的组件，但如果你是模组作者，希望这个模组支持你的模组，请联系我。只要组件有清晰的命名模式，我就可以轻松添加支持。

[i][u]我在哪里可以找到配置文件？[/u][/i]

在“r6\storages\KiasuBurgerReplacer\”目录中。如果你保存了配置，你会找到一个“Male.json”和/或“Female.json”文件。

[i][u]当我保存配置时游戏开始崩溃了！[/u][/i]

首先，你应该将保存的配置文件移开 - 这将阻止任何崩溃。之后，一般的建议是在你的衣柜中从头开始重新创建配置并再次保存。特别是如果你正在安装和卸载模组，或者在身体模组之间切换，配置可能会引用不再存在的网格，这将导致游戏崩溃；重新创建配置可确保保存当前有效的网格名称。

[b]安装[/b]

[list=1]
[]确保所有需求已安装。请注意，这个模组有一些不常见的需求。请仔细阅读列表。[/]
[]下载主文件并将其解压到你的《赛博朋克 2077》目录中（例如：Steam\steamapps\common\Cyberpunk 2077）[/]
[/list]

[b]卸载[/b]

[list]
[]删除安装期间提取的文件[/*]
[/list]

[b]高级用法[/b]

注入的配置存储在一个人类可读/可写的 json 文件中，你可以创建或修改一个来包含不是来自我模组的组件 - 它们可能来自其他作者的机械臂模组，甚至服装物品。要创建自定义配置，你需要熟悉模组组件是如何定义的，以及如何发现它们使用的网格。有时这些是有文档记录的，但通常不是。在这种情况下，你需要愿意使用 Wolvenkit 或 RedHotTools 来发现这些信息。

另外，请记住，如果你在 CET 界面中保存配置，它总是会覆盖当前文件。如果你有自定义配置，请确保保留额外的副本。