角色预设管理器（CET）

CET主界面将保存、加载、文件夹、分享、回收站、设置和帮助集中在一个窗口中。

公寓镜子包含完整的捏脸选项，而非游戏中通常提供的较小子集。

要求

Cyber Engine Tweaks 1.37.1或更新版本

无需其他模组或程序。

安装模组

1. 从Nexus Mods下载最新版本。
2. 将下载的压缩包解压到你的**《赛博朋克2077》游戏文件夹**中。
3. 启动游戏并打开Cyber Engine Tweaks覆盖层。
4. 选择角色预设管理器 (CET)。

窗口首次打开时会出现在屏幕右侧附近。CET会在你移动或调整大小后记住其位置和尺寸。

设置可选按键

1. 打开CET并选择Bindings。
2. 找到角色预设管理器 (CET)。
3. 为打开完整外观编辑器设置一个按键。
4. 你也可以为**切换角色预设管理器 (CET)**设置一个按键。
5. 在游戏中使用编辑器按键前，请先关闭CET覆盖层。

当CET提供按键信息时，帮助面板会显示已分配的按键。如果CET无法显示某个按键，面板会报告你在当前游戏会话中是否使用了该输入。

从旧版本更新

新预设使用格式8。其文件布局更易于阅读，可识别由CPM保存的文件，并记录预设名称和CET库文件夹。它保留了格式7引入的相同外观信息。旧版角色预设管理器的预设以及兼容的ACU .preset文件仍然可以加载。

现有预设文件不会仅仅因为模组发现它们就被重写。覆盖保存旧预设会将其更新为格式8。保存其可选备注或标签也会更新该文件。在替换任何你可能仍需要与旧版模组一起使用的预设之前，请保留备份。

不要在当前的模组旁边保留旧版模组副本。版本3.0.5不会移动旧版本遗留的散落文件。

1. 备份你想要保留的角色预设中的.preset、.cpmfolder和.cpmbackup文件。
2. 删除旧的Character Preset Manager文件夹。
3. 安装版本3.0.5。
4. 将你保存的预设和捆绑包放回角色预设中。

保存预设

1. 打开完整外观编辑器、镜子、义体医生角色界面或新游戏捏人界面。
2. 在CET中打开角色预设管理器。
3. 在保存和替换预设下，打开保存位置。
4. 选择一个文件夹或所有预设。
5. 输入名称并选择保存新预设。

如果该名称已存在，只有在确实要覆盖时才确认替换现有预设。

加载预设

此示例展示了完整的加载过程，包括自动编辑器刷新和最终外观。

1. 打开上述支持的其中一个角色界面。
2. 在加载和恢复外观下选择一个预设。
3. 检查其文件夹、保存的选项数量、来源、详细信息和兼容性摘要。
4. 点击一次加载所选预设。
5. 等待最终结果。绿色消息表示每个保存的选项都已确认。黄色消息会列出游戏未确认的选项。

《赛博朋克2077》可能会多次刷新编辑器。模组会等待并自动继续。它会先应用保存的外观，再清除任何剩余选项，然后再次检查预设。如果需要停止，请选择取消加载。

恢复先前外观位于加载和恢复外观下。在每次正常的预设加载前，模组会静默保存当前的外观。打开一个支持的角色界面，使用此按钮即可撤销最近一次的预设加载。

兼容性摘要会在模组和角色编辑器打开时自动刷新。它会在编辑器更改后更新，无需你切换预设再切回来。其他所选中预设的详细信息也会同时更新。

自动加载会快速检查一次待处理的更改，然后在普通轮询之间留出更多时间。如果更改添加、移除、禁用或重新排列了某个选项，模组会等待更长时间让编辑器稳定下来。在摘要前会进行一次最终的只读检查以确认任何迟到的更改。

如果相同的选项在三次检查后仍然缺失，加载将停止。模组不会猜测。缺失选项通常意味着角色选项模组、其版本或其加载顺序发生了变化。请修正外观并重新保存预设。

预设保存的内容

格式8预设存储每个可见选项、其在编辑器中的位置、当有稳定可用名称时其所选的选择项，以及其在选择列表中的编号。它们还可以存储来源、日期、备注和标签。

该信息有助于模组在CCXL向列表添加项目后找到已保存的选择。如果某个发型以新名称替换了相关的旧选项，当编辑器的槽位和唯一保存的选择均匹配时，当前预设可以自动匹配它。强制完整加载可以尝试不太确定的基于编辑器位置的匹配。更改选项模组后请务必检查结果。

对于需要基于位置匹配的旧预设，强制完整加载会自动开启，并在你选择当前预设时自动关闭。你仍然可以在加载和恢复外观下手动更改它。

当强制完整加载应用到来自旧预设的重命名选项时，只要其位置、名称、出现次数、槽位和应用编号仍然一致，加载后清理功能会保护该精确的实时匹配。

旧预设只知道选项名称和编号。如果新发型改变了列表顺序，旧预设可能会选择错误的发型，因为它无法知道原始选项。请修正一次，并以当前格式重新保存预设。

可读的预设文件

格式8将诸如%20和%3A之类的编码行替换为纯文本。每个选项保留其原始的OptionKey:SavedNumber行，并在可用时跟有可读的详细信息：

# CPM Preset
# Format: 8
# Name: Neon Street V
# Source: Character Preset Manager (CET)
# Created: 2026-08-15 13:19:27
# Modified: 2026-08-15 13:19:27
# Notes:
# Tags:
# Favorite: No
# Library folder: Favorites/Female V

LocKey#9502141975964618858:50
# Editor slot: hairstyle
# Saved choice: options:51

模组在读取预设时会忽略普通的注释行。这保证了文件易于检查，而不会将其标题视为损坏的数据。CPM Preset标识由该模组保存的文件。Name记录预设名称，Library folder记录其CET文件夹。如果保存的文件夹列表中没有该预设的条目，模组可以从这些行中重建其名称和文件夹。/表示所有预设。

基本文件夹使用

• 在加载和恢复外观下选择一个文件夹行以展开或折叠它。
• 没有文件夹的预设显示在所有预设下。
• 在保存或移动预设前，先选择一个文件夹或所有预设。
• 要在另一个文件夹内创建文件夹，请先选择父文件夹。
• 副本会出现在原始文件旁边，并使用诸如Copy和Copy 2之类的名称。
• 复制文件夹也会复制其中的所有预设和文件夹。
• 重命名预设也会重命名其.preset文件。
• 备注、标签和文件路径位于重命名和复制预设 > 标签、备注和文件下。
• 搜索会检查预设名称、文件夹名称和标签。标签也会显示在列表中的预设名称旁边。
• 复制文件路径会从《赛博朋克2077》游戏文件夹中复制所选预设的完整路径。

在加载和恢复外观下选择一个预设，然后打开收藏和详细信息并选择将所选预设添加到收藏。收藏的预设保留在其原始文件夹中，同时也会出现在常规文件夹列表上方的固定组中。此选择存储在可读的.preset文件中。

在CET中创建的文件夹

在CET中创建的文件夹仅在模组内部组织预设。它们不会创建或重命名Windows文件夹。没有数量限制。其组织结构存储在：

Data/Catalog/Virtual Folders.txt

角色预设内的Windows文件夹

模组会查找放置在角色预设内的Windows文件夹，包括其中的子文件夹。这些文件夹带有Imported标签。它们的预设文件会保留在你放置的位置，直到某个操作需要移动文件。

• 重命名Imported文件夹只会更改模组中显示的名称。
• 移动其中的一个预设只会更改它在模组中的显示位置。
• 移除文件夹，保留预设会将已知的.preset文件移动到主预设文件夹，保留所有预设，并且仅移除空的Windows文件夹。
• 未知文件永远不会被删除，包含此类文件的任何文件夹都会保留在原位。
• 如果模组无法确认某个条目是安全的，或者文件夹层级超过12层，它将停止检查该文件夹。
• 不支持链接文件夹和Windows联接。

移除文件夹但保留其内容

在你确认移除文件夹，保留预设后，所选文件夹将被移除，其所有内容将移动到上一级文件夹。对于Imported文件夹，已知的预设文件会先移动到主预设文件夹。只有在没有未知文件残留时，其Windows文件夹才会被移除。

预设文件和分享的文件夹位于此处：

bin/x64/plugins/cyber_engine_tweaks/mods/Character Preset Manager (CET)/Character Presets

分享单个预设

• 分享外观，请发送其.preset文件。
• 安装预设，请将其文件放置在角色预设中或其内部的Windows文件夹中。
• 在加载和恢复外观下，在游戏外更改文件后选择刷新。
• 启动时使用保存的预设列表，而非完整读取每个预设和回收站文件。当你选择或使用某个预设时，才会完整读取它。
• 单个.preset文件不包含其CET文件夹分配信息。

为了安全起见，导入的预设不能大于1 MB，不能包含超过16,448行和4,096个有效选项。选项名称不能超过256字节，选项编号必须适合无符号32位值。

分享完整文件夹

.cpmfolder文件包含所选的CET文件夹、其内部的所有文件夹以及该组中的所有预设。备注、标签和其他受支持的预设详细信息也包括在内。

导出文件夹

1. 打开创建和组织文件夹并选择一个非空文件夹。
2. 打开分享和导入文件夹，然后选择将所选文件夹导出为.cpmfolder文件。
3. 在角色预设中找到新的.cpmfolder文件。
4. 发送该单个文件。

分享的文件夹最多可包含512个预设，且不能大于32 MB。空文件夹无法导出。

模组会逐个写入和安装分享文件夹中的预设。大型捆绑包无需一次性全部保存在内存中。

要在安装前检查分享文件，请打开管理和移除.cpmfolder文件，选择该文件，然后选择查看所选.cpmfolder内容。预览会显示其主文件夹、嵌套文件夹和所有包含的预设，无需安装任何内容。

要仅移除导出的文件，请在同一个部分中选择它，然后选择将所选.cpmfolder文件移到回收站。这不会移除原始文件夹或其预设。

导入文件夹

1. 将下载的.cpmfolder文件放在角色预设中。
2. 打开角色预设管理器并展开创建和组织文件夹。
3. 打开分享和导入文件夹。
4. 选择从角色预设安装.cpmfolder文件。

模组会重建完整的文件夹组，并将.cpmfolder文件保留在原位。它会记住文件名、文件内容和导入的文件夹，存储于：

Data/Catalog/Imported Bundles.txt

在其导入的文件夹仍然存在时，未更改的捆绑包会被跳过。你可以在删除该文件夹后重新导入它。你也可以导入使用相同文件名的已更改捆绑包。如果文件夹名称已被使用，新文件夹会获得一个安全的Copy名称。失败的导入不会标记为完成，因此你可以修复文件后重试。

成功导入后，管理和移除.cpmfolder文件可以将源文件移至回收站，而不会移除导入的文件夹或预设。

导出所选预设

打开选择和管理多个预设。从任何文件夹中选择预设，然后选择导出所选。新的.cpmfolder文件在安装时会将其文件夹路径保留在单个所选预设组中。

备份完整库

打开导出和导入备份，然后选择导出完整库备份。角色预设中的新.cpmbackup文件包含所有预设、CET文件夹布局和当前设置文件。

要恢复备份，请在备份文件下选择其文件名，然后选择导入所选库备份。如果名称已被使用，导入的库将放置在新的导入库文件夹中，以便不会覆盖任何内容。备份不能大于256 MB。

要移除备份，请在备份文件下选择它，选择永久删除所选备份，并确认文件名。这只会删除所选的.cpmbackup文件。

• 选择和管理多个预设是一个独立的、用于处理多个预设的主要部分。
• 选择一个预设行即可将其添加到选择中。再次选择它可将其移除。
• 全选可见和清除选择使大范围选择更容易。
• 所选的预设可以移动到一个文件夹、一起导出或移至回收站。

• 将预设移至回收站仍可恢复。
• 在创建和组织文件夹下，你可以将文件夹及其中的所有内容移至回收站。
• 更多回收站选项允许你从当前搜索结果中选择多个预设。
• 全选可见和清除选择使大范围选择更容易。
• 将Imported文件夹移至回收站只会在其为空时移除其Windows文件夹。未知文件永远不会被删除。
• 恢复文件夹会重建整个文件夹组，包括其中的空文件夹，并恢复该回收站组中的所有预设。
• 你还可以逐个恢复预设。
• 如果名称已被使用，恢复的项目会获得Copy名称，而不会覆盖任何内容。
• 永久清空回收站是唯一会永久删除回收站文件的操作。
• 如果在回收站、恢复、批量移动或文件重命名操作期间游戏关闭，模组会在下次启动时完成或安全回滚该操作。
• 如果无法安全读取回收站文件夹，模组会保留其最后良好的回收站列表，并且不会替换已保存的名称或文件夹信息。

CC和CCXL角色选项模组

状态： 支持

当自定义选项出现在《赛博朋克2077》的正常角色界面中时，它们会被保存。支持重复和关联选项，包括不同的眼睛颜色。

请保持与创建预设时相同的选项模组、版本、身体和眼睛选择以及加载顺序。更改后请检查结果。

EKT Custom Character Creator - FEMV ONLY 是在使用游戏正常角色系统时的一个受支持示例。

Appearance Change Unlocker (ACU)

状态： 不兼容

使用角色预设管理器前，请移除ACU并重启游戏。移除ACU后，兼容的ACU预设文件仍然可以加载。

Character Customization Anywhere

状态： 不兼容

该模组修改了相同的镜子和角色界面。请移除它并重启游戏。

拍照模式和外观菜单模组

状态： 兼容但有一个限制

这些模组可以保留安装，但角色预设管理器无法在其菜单内保存或加载。请使用完整外观编辑器、镜子、义体医生或新游戏编辑器。

关闭编辑器后出现加载画面

《赛博朋克2077》有时会在任何角色编辑器关闭后停留在加载画面上。即使没有角色预设管理器也可能发生。服装、衣柜套装、Equipment-EX和精细服装可能会增加该情况的出现概率。

如果发生这种情况，请在打开编辑器前移除所有服装并选择无套装。之后再穿回所有装备。

设置

• 自定义提醒：启用/禁用 可打开或关闭角色界面提醒。
• 预设排序 按名称或最近修改的预设排序。
• 打开设置文件，然后选择重新加载设置文件，即可无需重启即可应用手动更改。

Data/Config/Config.txt

discoveryReminder=true
presetSort=name

presetSort接受name或modified。

模组数据文件夹

模组将其设置、文件夹列表、恢复文件、回收站和日志保存在Data下：

Data/
|-- Config/
|-- Catalog/
|-- Recovery/
|  `-- Trash/
`-- Logs/
    `-- Archive/

在CET内部创建的文件夹仅存在于模组的文件夹列表中。它们不会创建匹配的Windows文件夹。

空闲时的内存使用

版本3.0.5会在加载结束后立即释放临时加载数据。当模组窗口隐藏或CET覆盖层关闭时，它会卸载完整的预设内容并清除可重建的界面列表。预设名称、文件夹、备注、标签、收藏和其他库详细信息仍然可用。

搜索帮助

打开帮助，输入一个单词或短语，然后选择搜索。诸如share、bug、clothing、ACU、backup、Trash和favorite之类的搜索包含常见的相关术语。

活动日志

选择窗口顶部的日志。你也可以从帮助中打开它。你可以从CET中阅读或复制日志。

bin/x64/plugins/cyber_engine_tweaks/mods/Character Preset Manager (CET)/Data/Logs/Activity.log

每次完整启动游戏都会创建一个新的日志。旧日志会以其日期和时间为名保存，并且会保留最新的10份旧日志。日志包括启动详情、预设操作、加载结果、警告、错误、非活动选项和缺失的已保存选项。开发者信息位于更多技术细节下。

我可以使用旧版角色预设管理器或ACU的预设吗？

可以。版本3.0.5可以加载旧版角色预设管理器格式和兼容的ACU预设。新的和更新的预设使用格式8。

如果CET文件夹列表缺少条目会怎样？

当前格式8的CPM预设会记录其自身的名称和CET库文件夹。模组会使用这些详细信息重建缺失的条目。/表示预设属于所有预设。旧文件仍然可以加载，但它们不包含此恢复信息。

ACU或Character Customization Anywhere可以保留安装吗？

不可以。请移除它们并重启游戏。

拍照模式或外观菜单模组可以保留安装吗？

可以，但不要尝试在其菜单内保存或加载。请使用支持的角色界面。

截图中的角色是否包含在内？

不包含。截图展示的是模组。我的个人角色预设不包含在内，我也不计划发布它。

• 修复并验证了完整库备份导出，报告预设和文件夹总数，并增加了确认后的备份删除功能。
• 在当前格式8文件中添加# CPM Preset、# Name:和# Library folder:详细信息，以便重建缺失的目录分配。
• 保留旧版角色预设管理器格式和兼容的ACU预设的可读性，不会仅仅因为被发现或加载就更改它们。
• 在安装前增加了只读的.cpmfolder内容预览。
• 增加了持久收藏、完整库.cpmbackup控件、自动先前外观快照以及独立的批量预设部分。
• 增加了帮助搜索、顶部的日志按钮、预设标签搜索、预设名称旁的标签以及复制文件路径。
• 改善了加载确认、编辑器刷新计时、兼容性详细信息以及自动强制完整加载默认值。
• 通过空闲时释放已完成的加载数据和可重建的界面列表，减少了长时间游戏会话期间保留的内存。
• 使用更清晰的区块控件，并为每个主要工作流程提供一个一致的状态卡片。

注意： 有关完整的技术版本历史，请参阅GitHub上的完整更新日志。

AI披露

我仅使用AI来帮助规划和改进CET菜单的布局和外观。我做出了最终的设计选择，修改了AI辅助的工作以适应模组，并手动测试了保存、加载、文件夹、恢复和游戏功能。

致谢

• 角色预设管理器 (CET)： 我以dklyntly的身份创建并维护此模组。
• ACU - 角色预设管理器：PotatoOfDoom创建了启发此项目的ACU。我保留了对兼容ACU预设的支持，以免现有收藏丢失，同时使用我自己的当前格式和控件。
• Character Customization Anywhere：keanuWheeze创建了此模组。它在正常游戏中打开角色定制的方式启发了我制作完整外观编辑器。
• Cyber Engine Tweaks：yamashi创建了CET，其贡献者维护着它。我使用CET的脚本和菜单系统来构建角色预设管理器。
• CD Projekt Red： 我感谢CD Projekt Red开发了《赛博朋克2077》及其角色系统。
• 《赛博朋克2077》模组社区： 我感谢社区分享的测试、研究、兼容性信息和反馈。

我未包含或要求我所提及的启发灵感模组。请勿在角色预设管理器旁边安装ACU或Character Customization Anywhere。