NPV Maker

NPV Maker

THIS IS NOT A MOD. It's an python NPV factory.

NPV Maker预览查看大图

描述

Nexus 可能不喜欢其中的 Python 组件，并将其标记为病毒

这里是 GitHub 链接

https://github.com/xraytwonine/NPV-studio/releases

使用视频教程可最快完成设置

视频教程

NPV（非玩家版）是你角色的独立副本，可通过“外观菜单模组”生成。它不会替换你可玩的 V、修改你的存档或永久改变你的角色。

传统 NPV 制作流程包括：

  • 在 Blender 中准备和塑形头部。
  • 找到正确的网格和外观。
  • 编辑 .app 和 .ent 资源。
  • 使用 WolvenKit 导入和编译文件。
  • 创建外观菜单模组注册。
  • 安排正确的 Vortex 归档结构。
  • 打包所有内容，同时避免意外写入游戏。

NPV Studio 通过一个引导式界面将这些步骤串联起来。你只需输入与《赛博朋克 2077》捏脸界面中相同的数值，验证所需程序，然后选择 生成 Vortex ZIP。 你无需了解 Blender 或 WolvenKit 即可使用基本工作流程。它们仍需安装，但 NPV Studio 会自动操作它们。

基本设置

  1. 将完整的 NPV Studio 发布版解压到一个可写文件夹。
  2. 运行 NPV-Studio.exe。
  3. 展开 依赖项和路径。
  4. 查看依赖项状态列表。
  5. 使用提供的链接下载任何缺失的组件。
  6. 选择所需路径：
    • 《赛博朋克 2077》安装文件夹
    • 可写的构建工作区
    • Blender 可执行文件
    • WolvenKit Blender IO Suite 文件夹
    • WolvenKit CLI 可执行文件
    • 已解压的 NPV 教程资源文件夹
  7. 选择 保存路径并刷新。

绿色表示构建要求已就绪。 安装模组 表示某个游戏内模组缺失。这不会阻止 NPV Studio 构建 ZIP，但你需要该模组才能使用相应的游戏内功能。

创建你的角色

你可以手动输入数值或加载角色文件。 要复制现有的 V：

  1. 如有必要，安装 Appearance Change Unlocker。
  2. 在游戏中打开镜子或外观编辑器。
  3. 记录你角色的编号数值。
  4. 按显示顺序将这些数值输入 NPV Studio。

你也可以从附带的 character templates 文件夹下的一个 JSON 文件开始。 选择：

  • 一个显示名称。
  • 一个唯一的内部命名空间。
  • 女性或男性身体框架。
  • 语音音调。
  • 所有可见的捏脸选项。
  • 一个预设保存文件夹。
  • 一个 Vortex ZIP 导出文件夹。

如果你想稍后重用或调整配置，可以将其保存为预设。

构建 NPV

  1. 选择 验证配置。
  2. 修正程序报告的任何不支持或缺失的选项。
  3. 选择 生成 Vortex ZIP。
  4. 等待 Blender 和 WolvenKit 完成。

构建可能需要几分钟。NPV Studio 运行 Blender 时没有正常的交互式导出对话框，因此你应该不需要关闭 Blender 弹窗。 成功后，应用程序底部将显示：

  • 完成的 ZIP 位置。
  • 其 SHA-256 校验和。
  • 打包的文件数量。
  • 调试日志位置。

安装结果

  1. 打开 Vortex。
  2. 使用 从文件安装。
  3. 选择 NPV Studio 生成的 ZIP。
  4. 启用并部署该模组。
  5. 启动《赛博朋克 2077》。
  6. 打开外观菜单模组。
  7. 打开 生成 选项卡。
  8. 搜索角色的显示名称。
  9. 生成角色。

生成的 NPV 会暴露一个名为 default 的公共外观。

安装说明

  1. 将完整的发行版 ZIP 解压到一个可写文件夹。
  2. 运行 NPV-Studio.exe。
  3. 展开顶部的 依赖项和路径。
  4. 选择任何未自动检测到的依赖项路径。
  5. 为保存的角色预设和完成的 Vortex ZIP 导出选择单独的文件夹。
  6. 完成或加载角色选项，进行验证，然后选择底部的 生成 Vortex ZIP。
  7. 可选：拿到 NPV zip 后，前往 Vortex，选择“从文件安装”并浏览到该 zip。或者，你也可以手动将 NPV 拖入游戏的 mod 文件夹。

NPV Studio 会在首次启动时在可执行文件旁边创建 settings.json 及其默认工作区。该应用程序捆绑了 Python、Qt、其 UI 及其无人值守的 Blender 工作进程；不需要单独安装 Python。

构建依赖项

便携式可执行文件不会重新分发 Cyberpunk、WolvenKit、Blender、WolvenKit Blender IO Suite 或可复用的 NPV 源项目。它们的路径可以在应用程序中选择。

外观菜单模组和 Codeware 是游戏内运行时模组。它们不用于构建 ZIP，缺失时显示为 安装模组 而非构建依赖项失败。

输出文件夹

  • 构建工作区： 临时副本、生成的资源、报告和调试日志。
  • 预设文件夹： 可复用的 JSON 角色配置。
  • Vortex ZIP 导出文件夹： 完成的、可通过 Vortex 安装的 ZIP 和校验和清单。

《赛博朋克》的安装目录始终被视为只读。NPV Studio 不会将文件部署到游戏中，也不会写入 Vortex 暂存区。

主要功能

  • 目前不支持身体绑定和/自定义发型 - 仅限原版身体/发型 - 我正在努力解决这个问题。
  • 支持女性和男性 V。
  • 角色选项按与游戏内创建者相同的顺序排列。
  • 加载和保存可复用的角色预设。
  • 支持 NPV Studio JSON 预设和简化的 TXT 角色表。
  • 通过 Blender 自动生成头部变形。
  • 通过 WolvenKit CLI 自动进行 REDengine 资源转换和打包。
  • 自动创建 AMM 自定义实体注册。
  • 生成最小化的、可通过 Vortex 安装的 ZIP。
  • 包含一个通用的初始服装。
  • 包含空的外观创建器模组槽位，以便日后添加衣物和配件。
  • 女性 NPV 包含经过测试的双身体和无缝修复选项。这是因为游戏处理玩家角色与 NPV 的胸部大小方式不同。
  • 构建日志能清晰地标识不支持的选项或失败的外部工具。
  • 从不直接安装到《赛博朋克 2077》。
  • 从不写入 Vortex 暂存区。
  • 将游戏安装目录视为严格只读的资源。

服装和配件槽位

生成的角色包含空的外观创建器模组槽位：

  • 五个面部槽位。
  • 五个头部槽位。
  • 五个躯干槽位。
  • 五个腿部槽位。
  • 五个物品/配件槽位。
  • 两个手部槽位。
  • 两个手臂槽位。
  • 两个脚部槽位。

这些槽位最初为空且已禁用。安装外观创建器模组后，你可以在游戏内为其分配服装或配件网格。这应能支持一些复杂的服装/配件搭配。

安全性

NPV Studio 遵循非破坏性构建流程：

  • 《赛博朋克 2077》是只读源。
  • 可复用的 NPV 资源被复制到隔离的工作区。
  • 原始模板资源不会被编辑。
  • Blender 和 WolvenKit 的输出保留在所选工作区内。
  • 完成的模组仅写入所选的 ZIP 导出文件夹。
  • 不会自动安装任何内容到游戏。
  • 不会自动写入任何内容到 Vortex 暂存区。

最终的 NPV 安装由用户控制。

当前限制

  • NPV Studio 不会直接从存档中提取角色数值。必须手动输入数值或从预设加载。
  • 修改版发型和自定义捏脸附加组件需要它们自己经过验证的映射。
  • 不支持的选项在验证时会被阻止，而不是猜测。
  • 生殖器、阴毛、穿孔颜色和脸颊妆容颜色值会保存在预设中，但尚未全部编译为视觉效果。
  • Cyberpunk 处理 NPC 的衣物变形方式不同。任意衣物不能保证适合所有身体选项。
  • 附带的初始服装旨在作为一个安全的基准。
  • 自定义衣物调整可能仍需要单独的 Blender 工作。
  • Cyberpunk、Blender、WolvenKit 或 Blender 插件的主要更新可能需要相应的 NPV Studio 更新。

硬性要求

模组（手动安装或通过 Vortex）：

软件：

  • Blender — NPV Studio 是围绕 Blender 5.1 开发的。 下载 Blender
  • Cyberpunk-Blender-add-on
  • WolvenKit Blender IO Suite — 此插件为 Blender 提供 Cyberpunk 特定的导入和导出功能，供自动化头部构建器使用。 下载 WolvenKit Blender IO Suite
  • 适用于 Windows 的 WolvenKit CLI — 下载 Windows 控制台包——而不是 Linux 控制台包，也不仅仅是桌面应用程序。在 NPV Studio 中选择的可执行文件应为 WolvenKit.CLI.exe。 下载 WolvenKit 发行版
  • NPV 教程源资源 — 从 ManaVortex 的资源页面下载 tutorial_npv_wolvenkit_2_3 源包。 此下载是一个源项目，不是一个可玩的模组。请勿通过 Vortex 安装。 将其解压到一个普通文件夹，并在 NPV Studio 中选择该文件夹。资源页面也明确将其标识为源项目而非模组管理器安装包。 下载 NPV 源资源

可选开发工具

  • WolvenKit 桌面版 — 桌面应用程序可用于手动检查资源，但 NPV Studio 的自动化构建过程不需要它。

鸣谢

  • ManaVortex —— 感谢他/她是最乐于助人、最活跃的模组作者，帮助社区成员！也感谢他/她创作了 NPV 指南、源项目和大量的 Cyberpunk 模组文档。
  • NoraLee —— 开拓性的 NPV 研究和流程。
  • WolvenKit 贡献者 —— REDengine 资源工具和 Blender 集成。
  • MaximiliumM 外观菜单模组，外观创建器模组
  • yamashi Cyber Engine Tweaks
  • psiberx Codeware

“NPV Studio”完全是通过 Chatgpt Codex 进行 vibe coding 开发的。