【VRoidMod/插件发布】换装、捏人、露出，真能在七日杀里体验塞雷卡了！（更新1.0.1）

Lv.5

插件简介：

基于 VRoidMod 的超级增强插件！实用工具、服装编辑、形态键修改、预设管理、镜头控制、多人支持。兄弟，这次你真的可以在七日杀里玩塞雷卡了！只需将下述补丁放至 Custom Avatars 文件夹即可体验。如果你在之前没使用过七日杀 / VRoidMod，下面也贴了快速入手教程！

插件度盘地址见帖子底部

（不要发人机回复！设金币是为了过滤无意义回复的，里面啥也没有）

！！！非常重要的版本对应表：

因为大改了前置mod非常多的代码（甚至dll代码量已经接近它了），所以很难做到比较大的兼容，请尽可能确保版本对应，网盘文件夹里面后面的数字就是插件版本号：

七日杀版本	CustomAvatars(原VRoidMod) 版本	本插件版本
A21~1.0 等	~	本人还没玩
2.0~2.4	2.4.0~2.5.0均支持	不支持
2.0~2.4	2.5.1~2.5.2	1.0.0~1.0.1
2.0~2.4	2.6.0	仅1.0.1

注意：VRoidMod 2.5.1 自2025.9.20之后，更名+大改优化为了Custom Avatars 2.5.1，请参考上述版本对应表下载对应的版本

因为本人精力有限，因此只会保证对最新版七日杀+最新版Custom Avatars的支持，你可以从N网或者勇气佬的转载帖下载最新版：

N网地址：https://www.nexusmods.com/7daystodie/mods/3501
或者，勇气佬搬运的地址：【搬运】Custom Avatars (原VRoid 2.5.1) 9.20更新 – MOD下载 – 七日杀中文网

感谢：一二三・安卓喵 提供的人物模型作为模特（这期模特他还在优化，应该马上发），包含了非常多的服装+形态键+预设，以及相关动作用以演示，请自行前往下载，本贴不提供下载。

Custom Avatars的mod文件夹说明图：

更新日志（点击展开）：

v1.0.1

移除对手臂的修正，因为前置mod 2.6.0已更换了算法
添加一个开关，允许第一人称时也开启前置镜头（但是第一人称动作和第三人称动作不一致，会有点怪，而且开启后无法看到下半身）
重写前置Mod的舞蹈加载机制，使得现在可以在Dances里面嵌套一层文件夹以方便管理、分类
重写前置mod的透明、正常模式切换，现在Transparency选项可以正常使用了
服装、形态键的同步也会同步给下半身了
添加一个开关，允许编辑后自动广播给好友
添加一个新的舞蹈镜头：固定镜头，可以通过方向键、翻页键控制位置，shift/ctrl控制移动速度
优化GUI的显示

功能介绍：

VRoid 实用功能：

重置为默认角色（我这个UI优先级在系统UI上，所以爆红字的时候你可以尝试用这个按钮自救）
热重载人物列表
热重载舞蹈列表

（游戏过程中新增角色、舞蹈文件，再也不用大退游戏了！）
更方便的舞蹈选择列表
（点一下就能自动切换！非常方便！此外插件重写了舞蹈加载逻辑，因此现在你可以在Dances里面创一层文件夹，用以分类、整理不同类型的舞蹈）

服装层级面板

人物模型层级的修改，切换。用于修改模型各个服装物体的切换隐藏。除了服装，还可以利用这个机制实现很多事！
（例如你可以在模型物体挂一个 Skinned Mesh Renderer 以被插件检测，然后挂一个喇叭来实现在模型里放自定义音乐！当然这只是一个最浅显的应用）

形态键面板

模型形态键的访问、修改。用于修改模型表情、身体等的网格。自定义模型表情、体型、身体部位等等！

（表情修改，其他的没法过审就不放了自己研究吧）

预设管理器

将上述两个面板的编译后的模型状态（服装层级状态、形态键状态）作为不同的预设进行管理、保存、增删改等等
保存的模型预设会放在 mod 的 ModelStates 文件夹下，里面按照名称、预设名保存在不同的.txt 文件中
前俩个面板操作很复杂？服装太多不想自己试？直接下载大佬提供的预设文件就能实现快速预设切换！
加载模型时，会尝试加载默认预设（default.txt），因此建议把经常玩的设置为默认预设

（感谢一二三・安卓喵提供的模特）

镜头控制面板

人物正面镜头，时刻全面欣赏你的人物模型！（模仿塞雷卡的常驻正面视角镜头，可以调整大小、距离）
插件1.0.1支持第一人称也开启，但是因为第一人称动画和第三人称不一致，所以看上去会有点怪。而且开启后将没有下半身
开启舞蹈运镜（仅支持的舞蹈开启后才会有运镜），旧运镜补丁的优化版本，可以通过滑块调整缩放来适配不同的模型大小
舞蹈时第三人称（即没跳舞时的第三人称视角位置，可由 B 键人物面板控制偏移）
舞蹈时第一人称，晕3D警告！！！（会把镜头贴到人物双眼之间模仿第一人称，但是因为是基于骨骼 + 网格 + 射线计算，因此有可能自动计算失败，此时可以手动调整）
舞蹈时固定镜头，可以通过箭头方向键+上下翻页键控制位置、高低，按住shift/ctrl调整移动速度

多人广播面板：

上述的操作都是基于本地的，不用担心被好友发现自己在搞涩涩！不过如果你想和好友玩露出 play，也可以使用这个面板同步模型状态给队友！现在，七日杀真能算是塞雷卡了，只不过露出的对象从 NPC 变成了好友！（也许下一步得想办法搓互动了，开银帕）
广播服装层级
广播形态键层级
自动广播按钮，开启后编辑时将会自动广播同步（建议不要频繁编辑）

全局键盘快捷键

默认为 End 键，可调

针对 VRoidMod 的性能优化：

极大减轻按 B 打开菜单、人物菜单翻页时的卡顿
（通过协程分摊加载负担，加载过程后移到点击按钮而不是按 b 打开菜单优化。现在基本不可能卡顿）
强制禁用视角靠近镜头时人物透明（菜单里的 Transparency 选项），因为这玩意会吃性能 + 有一堆 bug
（但是这样会在一些场景有点麻烦，例如爬梯子，会被模型挡住视野，后续考虑优化一下）
将人物面板预览的模型改为复用玩家自身的模型和状态
（预览行为会和之前有点不一致，可以对比一下，现在的方式应该能极大优化面板性能）
修复左手手臂扭曲 180° 的 bug（感谢一二三・安卓喵佬），修复左手小拇指扭曲的 bug，尝试修复了两只手大拇指扭曲的 bug（但是这些都是针对绑骨正确的模型，如果你模型绑骨错了还是没用）。但是因为 VRoidMod 的底层机制还是有问题（我反馈给原作者了，他说正在研究新的手指方法）。1.0.1版本已移除
模型加载卡顿，尝试改为了协程加载。但是模型加载卡顿是由 2 个部分组成的，第 2 个部分有点麻烦所以还没办法修，所以该卡还是卡，长久玩的话还是定时大退游戏，游戏内尽量不要频繁切角色，因为有一些角色资源是无法（很难）由GC释放的，这是由unity机制决定的
修复VRoidMod人物列表最后一页的显示问题（应该消失的角色缩略图没变透明）
部分舞蹈在新版本CustomAvatars无法使用，针对性的进行了修复

面向新人的 VRoidMod 简易使用教程：

VRoidMod 怎么用？
V2.0–V2.3 版本七日杀的 Vroid mod 安装与教程 – 角色模型 – 七日杀中文网
注意本插件仅支持 CustomAvatars 2.5.1（原VRoidMod 2.5.1以上）
从N网或者勇气佬的转载帖下载最新版Custom Avatars：
N网地址：https://www.nexusmods.com/7daystodie/mods/3501
或者，勇气佬搬运的地址：【搬运】Custom Avatars (原VRoid 2.5.1) 9.20更新 – MOD下载 – 七日杀中文网

面向开发者的 VRoidMod 自定义模型、舞蹈教程：

自定义模型原作者（JustAlter）教程：Home · JustAlter/VRoid-Mod Wiki
或者参考我写的两期：

【VRoidMod 教程 / 转载翻译】VRM 模型转换到七日杀（.unity3d） – 角色模型 – 七日杀中文网【VRoidMod 教程 / 转载】自定义模型第一人称手臂 (CustomArms) – 角色模型 – 七日杀中文网
此外建议结合 b 站相关的 VRM 、unity、blender 教程配合食用。
自定义舞蹈
【VRoidMod 舞蹈 / 图文 & 视频教程 / 自制插件】5 分钟内教会你在七日杀内跳舞蹈 / MMD – 角色模型 – 七日杀中文网
此外可以参照 b 站的相关教程食用

未来计划（咕咕）：

重写 GUI 面板，因为现在是基于 IMGUI 的，和七日杀的 UI 系统不兼容，会导致鼠标事件穿透的问题，不晓得咋修（有大佬会修可以帮帮我）
人物、舞蹈加载时的本地预览。现在如果多人的话，加载模型会卡一下队友很难受。
更好的第一、第三人称。
更好的第一人称的手臂
互动功能？没有互动的黄油不是一个成功的黄油
战败 CG？这块其实很依赖模型的设计，和插件 DLL 反而无关了
不同角色的不同语音包。后续会考虑约定一个规范，然后分角色增删改七日杀的内置语音等等。

鸣谢：

JustAlter VRoidMod 作者，本插件的所有功能完全基于 VRoidMod，请务必多支持原作者
一二三・安卓喵插件编写过程中提出非常多的建议，提供了很多帮助。也是本期插件的模特提供作者
勇气佬 MMD 领域大神！没有勇气佬转的 MMD 我就没法活了。

Bug反馈&建议反馈：

使用本插件遇到了 bug？请移除本插件，消融对比以确认问题的确发生在本插件，并且提供可复现的详细步骤。如果是本插件的问题会尝试修复，如果是前置mod的问题会尝试反馈给原作者，如果没修复再考虑在本插件修复
功能&建议反馈视情况添加，精力有限不可能面面俱到，见谅

其他问题：

使用本插件遇到了 bug？请移除本插件，消融对比以确认问题的确发生在本插件，并且提供可复现的详细步骤。
支持的七日杀、VRoidMod 版本？因为精力有限，本插件只会支持、维护对最新版七日杀、最新版 VRoidMod （现CustomAvatars）的支持，不对其他任何版本负责！请自行尝试、解决问题。
本插件对模型的要求？本插件能允许模型层级下面带 Skinned Mesh Renderer（蒙皮网格渲染器）的组件显示在 GUI、展示出相关的形态键，允许用户激活、关闭 SMR 所在的游戏物体。因此，建议模型的网格、SMR 合理规划！此外，尽管只能显示出 SMR 所在的游戏物体，但是你可以通过这个特性实现对任何物体的激活和关闭
模型、舞蹈的表情、运镜支持？请看我主页自定义舞蹈那期教程，有详细的原理解释。