mod基于《秘密のエクスポーズ バレないように露出するマナカさん》开发。unity新人,第一次尝试,可能存在问题,仅作记录与分享。
先看效果展示



这次修改的需求其实很简单:角色身上存在一件外层大衣,我希望视觉上隐藏它,从而直接看到内部服装,但又不能触发游戏自身的换装逻辑。
换句话说,我需要的不是:角色脱下大衣,游戏服装状态改变,NPC、交互、逻辑随之变化。
而是:大衣依然穿着,大衣不可见,其他保持原状。
这两个目标看起来相似,但从 Unity 的实现角度其实完全不同。
最直接也最“低侵入”的思路,是不修改角色状态,只修改负责绘制衣服的 Renderer。
Unity 的 Renderer 是负责让对象出现在画面中的组件,而 Renderer.enabled 可以直接控制该 Renderer 是否参与显示;SkinnedMeshRenderer 又继承自 Renderer,因此对于绑定骨骼的角色服装,同样可以使用这一机制。
因此整个 Mod 最核心的一行代码最终非常简单:
coatRenderer.enabled = false;
怎么确定“coatRenderer”到底是哪一个?
游戏是 Unity IL2CPP 项目。
最开始我使用 AssetRipper 和其他 Unity 资源分析工具检查游戏内容。AssetRipper 的定位本身就是读取 Unity serialized files、AssetBundle 等内容,并将资源转换/恢复为 Unity 可以理解的格式,因此它非常适合用于资产结构分析和恢复 Unity Project。静态分析确实让我看到了大量:Mesh,AnimationClip,AnimatorController,Avatar,GameObject,Material等资源。
但很快遇到了一个问题:静态资源中的名称和层级≠游戏实际运行后的玩家实例。例如一开始静态数据里看到的一些 Animator 和 Avatar,看起来很像角色相关对象,但后来通过运行时探针证明,它们并不是实际玩家。
于是开发策略发生了变化:使用AssetRipper理解资源,BepInEx Runtime Inspector用于确认真正的对象。
正式插件基于 BepInEx 6 IL2CPP。
BepInEx 的 IL2CPP BasePlugin 提供 Load() 作为插件入口,同时提供 Config、Log,以及 AddComponent<T>(),后者可以把自己的 MonoBehaviour/Component 加入 Unity 场景并注册到 IL2CPP 类型系统。
因此我先没有写“修改器”,而是写了一个 Inspector:ManakaAnimationInspector。它只负责枚举运行时对象,不负责修改游戏。

99738724-fedf-4caa-871d-9692e78cbab8.png
resources.assets
PathID = 1724
Type = AnimationClip
Name = Female_Idle_Base
Generated AnimatorController Dependencies
PathID = 794
Type = AnimatorState
Name = Female_Idle_Base
Main Asset = SimpleManustia
然后得到这样的关系:
Female_Idle_Base [AnimationClip 1724]
↓
Female_Idle_Base [AnimatorState 794]
↓
Main Asset = SimpleManustia
然后继续升入探索,得到内容为:
运行时女主:
InGameManager/Player(Clone)/Manustia
Avatar = ManustiaAvatar
Controller = Player
静止动作:
Female_Idle_Base
经过几轮探测后,最终确认真正的玩家对象为:
InGameManager └─ Player(Clone) └─ Manustia
而目标外层大衣实际位于:InGameManager/Player(Clone)/Manustia/ ClothesParent/トレンチコート01
并且运行时确认:
Mesh = トレンチコート01 RootBone = Hips Renderer = SkinnedMeshRenderer
从这个阶段开始,后续程序不再“猜衣服叫什么”,而是只针对已经经过运行时验证的对象。
确认目标以后,我另外建立了正式项目:ManakaPersonalMod
这样诊断工具和真正的 Mod 完全分离。
第一版功能只做:
if (HideOuterCoat.Value) { coatRenderer.enabled = false; }
没有使用:gameObject.SetActive(false);
也没有修改游戏里的:CoatState,ClothesId,Animator Parameters,换装函数。
这么设计的原因就是“最小侵入”。
目标只涉及视觉,理论上就不应该把修改范围扩大到 GameObject 生命周期或游戏业务逻辑。
最终实机测试确认:黑色外层大衣消失,内部服装正常显示,玩家对象正常,原服装系统仍然运行
这说明“逻辑状态”和“渲染状态”成功解耦。
功能成立之后,我加入:ConfigEntry<bool> HideOuterCoat;
配置形式为:
[Visual] HideOuterCoat = true
BepInEx 官方的配置 API 本身就是为插件持久配置设计的。插件可以通过 Config.Bind(...) 创建配置项,默认配置文件保存在:BepInEx\config\<GUID>.cfg
并通过 ConfigEntry<T>.Value 读取值;API 同样支持手动保存和重新载入配置。从而得到下述关系:
HideOuterCoat = true,外套隐藏 HideOuterCoat = false,外套显示
第一次版本还有一个问题:游戏已经运行后修改 cfg,不会立刻反映到内存里的 ConfigEntry。
所以随后又增加了配置文件修改时间检测:File.GetLastWriteTimeUtc(...)
当发现 cfg 被修改时:Plugin.ModConfig.Reload();
于是实现了:
修改配置文件,Config Reload,HideOuterCoat.Value 更新,Renderer.enabled 更新,无需重新读档即可生效。
到这里已经是一个完整可用的功能了,但还不够像真正的游戏功能。
手改 cfg 毕竟很麻烦,如果。集成一个游戏内的开关选项,会方便得多。
所以目标进一步变成:进入选项,选择游戏系统,显示外层大衣 ☑
问题随之变成了另一个方向:游戏自己的设置菜单到底是怎么组织的?
为此又建立了:ManakaSettingsInspector
专门枚举运行时:
Toggle TMP_Text Text Dropdown UI Hierarchy
最终确认游戏系统菜单结构大致为:
GameSystemMenu(Clone) └─ Scroll View └─ Viewport └─ Content ├─ MenuItemCheck (1) ├─ MenuItemCheck (2) ├─ ... └─ MenuItemCheck (6) └─ Toggle
其中:MenuItemCheck (6)在简体中文下就是:显示振动状态。既然游戏已经有一套成熟的 Toggle,那么自己从零制造一套 UI 反而没有必要。
最终采用:Object.Instantiate(templateRow, content.transform, false);直接克隆原有设置行。
Unity 的 Object.Instantiate 会克隆目标对象,并可以指定新的父 Transform;对于 GameObject,克隆也会包含它的子对象和组件。
这使新选项天然继承了:字体、背景、Checkbox 图片、字号、行高、RectTransform、LayoutElement、原游戏视觉风格,而不需要手工复刻。
Unity 的 Toggle 本身就是一个布尔型 UI 控件,Is On 表示当前状态,而 On Value Changed 会在用户修改状态时发送新的 bool 值。
这里特意把 UI 语义设计成:显示外层大衣 ☑
而不是:隐藏外层大衣 ☑
因此 UI 与内部配置刚好相反:
UI ON → Show Coat → HideOuterCoat = false UI OFF → Hide Coat → HideOuterCoat = true
核心关系就是:HideOuterCoat.Value = !toggle.isOn;
然后:Config.Save();
所以设置会在下次启动时继续保留。
原游戏存在五种语言:日本語,English,简体中文,繁體中文,한국어。
但最终的 Mod 没有把语言逻辑写成:if (languageIndex == 2)
而是利用原游戏已有设置项作为“语言探针”。
同一个:MenuItemCheck (6)
在不同语言下会显示:
バイブ状態表示 Show Vibrator Status 显示振动状态 顯示振動狀態 바이브 상태 표시
因此只需要读取这个已经由游戏完成本地化的文本,就能够判断语言。
自己的 Mod 文本则对应:
コートを表示 Show Outer Coat 显示外层大衣 顯示外層大衣 코트 표시
这么做还有一个额外好处:Mod 不依赖语言菜单内部究竟把日语定义成 0 还是 3。只要原游戏本地化后的文字存在,语言识别就能成立。

最初直接尝试:GameObject.Find(fullHierarchyPath);
通过日志查询到:
BepInEx\LogOutput.log:24:[Info :Manaka Personal Mod] [Visual] Outer coat found. Path="InGameManager/Player (Clone)/Manustia/ClothesParent/トレンチコート01" | Mesh="トレンチコート01" BepInEx\LogOutput.log:25:[Info :Manaka Personal Mod] [Visual] Outer coat is hidden.
结果:
大衣功能正常 设置项完全没有出现 日志里也没有任何 [UI]
后来通过运行时 Inspector 才发现,完整 Hierarchy Path 并不像静态分析时那么稳定。
最终改成:Object.FindObjectsOfType<Toggle>(true);
然后寻找已经确认存在的局部结构:
GameSystemMenu(Clone) → Content → MenuItemCheck (6) → Toggle
找到 Toggle 后反向:
Toggle.parent → MenuItemCheck (6) Toggle.parent.parent → Content
这一次日志终于出现:
[UI] GameSystem Content found. [UI] Content Layout | Vertical=True | ContentSizeFitter=True
说明设置菜单被正确定位。
这是另一个很重要的经验:对运行时 Clone 出来的复杂 Unity UI,与其依赖一条脆弱的绝对路径,不如利用一个已经确认的局部特征节点,再沿父子关系定位结构。

这是整个过程中最有意思的 Bug。
日志已经显示:
Children = 13 Template row cloned Show Outer Coat setting was injected
画面里也确实多出了一行,但那一行完全是空白。同时日志疯狂出现:Removing cloned component: UnityEngine.Component
原因在于我一开始担心:克隆“显示振动状态”,会不会把它原来的游戏业务脚本也一起克隆?
于是写了一个清理程序:如果组件不是 Unity UI,Destroy。
问题就出在这里。
在当前 IL2CPP interop 环境中,用普通:component.GetType()
检查克隆组件时,一批实际组件被表现成了非常泛化的:UnityEngine.Component
程序因此错误地把大量真正需要的组件一起 Destroy 掉了。
最终结果非常典型:RectTransform 还在,Layout 空间还在。 但是:Text 没了,Toggle 没了,Image 没了。
于是画面里就出现了一块大小完全正常的“空气设置项”。
这也解释了为什么当时日志已经说:Injected
但肉眼却什么也看不到。
最终方案反而更简单:克隆完整原生 Row,保留组件,只替换 Toggle 的事件
即:toggle.onValueChanged =new Toggle.ToggleEvent();
然后再注册:
toggle.onValueChanged.AddListener( OnShowOuterCoatToggleChanged );
UI 的视觉对象全部保留。
这样一改,新的设置项立刻正常显示:
显示外层大衣 ☑
点击 Toggle 后:
取消,则大衣立即消失 重新勾选,则大衣立即出现
整个功能到这里正式完成。
运行时调查还发现:
Content VerticalLayoutGroup = True ContentSizeFitter = True
这意味着我们不需要自己计算每一行的 Y 坐标。
Unity 的自动布局系统允许 Layout Group 根据子元素提供的布局信息安排子项,而 Content Size Fitter 又可以根据 Layout 所提供的 preferred/minimum size 调整自己的 RectTransform。
因此只需要:Instantiate 新 Row,挂到 Content,刷新 Layout
原来的滚动区域就能自动给它分配空间。
这也是为什么后来屏幕里能够准确多出“第十三行”。
最终这部分 Mod 的逻辑可以概括为:ManakaPersonalMod 的核心控制逻辑分为配置与运行时两个部分:配置端管理“隐藏外套”(HideOuterCoat)的开关状态,运行时则负责查找玩家外套的 SkinnedMeshRenderer 组件,最终通过控制 Renderer.enabled 属性来实现外套的可见性切换。为了让玩家能够操作该功能,GameSystemMenu 会在构建菜单时,先找到现有的 Toggle 组件并定位其内容区域,接着克隆一个原始设置行作为模板,完成标签的本地化处理后,将其与“隐藏外套”的配置逻辑进行绑定,从而在界面中动态生成对应的控制开关。
技术上真正修改游戏视觉的依然只有:
coatRenderer.enabled = !HideOuterCoat.Value;
其余工作全部是在解决:如何找到对象?如何配置?如何保存?如何让用户操作?如何融入原生 UI?如何适配语言?如何不破坏原游戏逻辑?
第一,逆向 Unity 游戏时,静态资源分析和运行时分析不是竞争关系。AssetRipper 很适合恢复和分析 Unity 资源,而 BepInEx 更适合回答“游戏运行后真正实例化了什么”这种问题。AssetRipper 官方也将自身定位为分析 Unity 游戏文件并将资源转换为 Unity 原生格式的工具。
第二,应当尽可能选择“修改范围与需求范围相同”的方案。我要的只是“不显示一件衣服”,那么 Renderer.enabled 比修改换装状态、Animator 参数甚至 GameObject 生命周期都更合理。Unity 官方也明确把禁用 Renderer 作为使对象不可见的方式之一。
第三,原生 UI 克隆通常比重新制造 UI 更适合 Mod。Instantiate 本身能够复制 GameObject、子对象和组件,所以直接使用游戏自己的 UI Row 作为模板,可以自然复用视觉结构。
第四,不要过度相信 IL2CPP 环境下“看起来和普通 C# 一样”的运行时类型信息。本次最大的 UI Bug 就来自于一次过度积极的组件清理。对于未知对象,先观察,再最小化修改,通常比“自动智能清理”更安全。
第五,诊断工具应该和正式 Mod 分开。这一次单独制作 AnimationInspector、SettingsInspector,虽然前期看起来麻烦,却让很多猜测最终变成了可以验证的运行时事实。
免责声明:本文系网络转载或改编,未找到原创作者,版权归原作者所有。如涉及版权,请联系删