最近在搭一个偏日系风格的小游戏demo角色模型成了第一道坎。市面上付费角色资产风格不一定匹配免费资源想要统一风格又得折腾很久。我把主意打到了MMDMikuMikuDance模型库上——这些模型自带骨骼、表情、大量免费配布拿来当游戏角色原型再合适不过。于是就有了这篇开发日志把MMD模型导入Unity顺便把材质丢失的问题彻底解决掉。这篇内容适合打算用MMD模型做Unity角色、却卡在模型变紫、贴图丢失、人物半透明这些坑里的小伙伴读完你能直接照着落地。1. 项目背景与方案选型1.1 为什么选择MMD模型先说说为什么放着正规渠道的付费模型不用非要折腾MMD。原因其实很现实小团队做demo美术预算有限想快速验证玩法和表现效果MMD模型库是最快的“原型素材池”。MMD生态发展了十几年模型风格以日系二次元居多正好覆盖我的项目类型而且大部分模型都自带骨骼绑定和基础表情不需要我从零开始刷权重。另一个好处是资源密度高。你在各大模型配布站能找到发丝、衣服、配件已经分好层的.pmx模型精度普遍比早期低模好得多。比起从建模软件里拿回来还要自己重新绑骨骼MMD模型几乎就是“半成品角色”省掉了最脏最累的环节。需要注意的坑是版权和作者使用规约。每个模型配布页都有明确的使用条款比如“允许用于游戏”“禁止用作商业用途”“二次配布禁止”等等。正式商用之前务必把作者的规约截图留存尤其是付费项目别等上架了再改模型那种返工成本太高。1.2 三条导入路线的横向对比把MMD模型弄进Unity主流有三条路线。我一开始也想直接拖.pmx进Unity结果发现Unity原生根本不认识这个格式。于是把网上的方案都试了一遍整理成下面这张表方案优点缺点适合场景方案Ammd-for-unity插件直接导入.pmx操作快几秒出模型自动生成骨骼和材质插件年久失修新Unity版本下Shader兼容性风险高快速验证模型个人demo方案BBlender MMD Tools/CATS转FBX后再导入可做二次修复骨骼干净能导出FBX或glb流程长每一步都可能出错需要维护贴图路径正式项目、需要改模型、跨引擎复用方案CMMD4Mecanim整套流程自带Avatar设置和动作导入做MMD舞蹈复现最方便学习成本高依赖项多和Unity版本冲突概率大做MMD动画复现、想让动作直接驱动角色我测试的时候先把方案A跑通了但材质问题随之而来后来做正式版本时改用方案B稳定了很多。如果你只是想把模型摆进场景里看看效果方案A完全够用省下来的时间可以去调关卡。1.3 我最终的选择两个方案我都保留了。当前demo阶段先用方案A快速迭代表情和动作等玩法确定后再把模型统一走Blender中转导出规范化的FBX资源用于正式包。这样既不耽误前期验证也不会在后期被一个接一个的材质问题拖死。现在回看很多人在论坛里说“MMD导入Unity就是材质地狱”我这次的体验完全印证了这句话。下面进入正题先讲环境准备再具体拆材质丢失的修复过程。2. 工具准备与初始化2.1 Unity版本和渲染管线的选择这不是随便选的很多材质问题到最后都指向渲染管线不兼容。我当前用的是Unity 2021.3.40f1LTS版本渲染管线选择Built-in。MMD时代的所有贴图和着色器几乎都是为Built-in和Gamma空间设计的用URP或HDRP后各种Shader要重新适配透明排序也会乱掉。如果你非要在URP里用那得做好手改Shader的心理准备。Unity 6也就是6000系列我也装了一台机器实测跑mmd-for-unity插件的时候会有编译报错需要删掉一部分旧接口代码才能过新手不建议一上来就挑战这个。Unity 2021 LTS是我的首选稳定、插件兼容性好等模型管线成熟了再考虑升版本。2.2 插件与工具清单这次用到的工具不算多但每个都关键mmd-for-unity直接导入.pmx/.pmd模型的核心插件UniVRM里面自带MToon卡通着色器材质修复的主力Blender 4.x MMD Tools 2.10.3Blender端处理MMD模型我用的就是这个版本CATS可选Blender插件用来修复骨骼和网格老模型经常用得上MMD4Mecanim后续做动作导入时的辅助工具安装没什么特殊技巧插件文件夹直接放进Assets目录就行。要注意的是旧版本插件残留如果你之前装过先删干净再装新的不然同名脚本冲突会报出一些莫名其妙的错误。2.3 模型资源整理三件事准备模型的时候有三个细节容易忽略第一解压之后不要乱动贴图文件。MMD模型的贴图路径是记录在.pmx内部的你把贴图从一个文件夹挪到另一个文件夹导入Unity后贴图就会丢失材质看起来也像坏掉一样。我自己就是因为重命名了一份皮肤贴图导致一个角色硬生生变成“紫薯人”。第二模型文件最好放在一个单独的文件夹里连同贴图一起。这样mmd-for-unity导入时可以相对路径解析到贴图省去手动指定贴图的麻烦。第三导入前确认模型格式是.pmx还是.pmd。老模型多为.pmd骨骼和表情功能少一些新模型基本都是.pmx支持更多材质效果。如果手里只有.pmd建议先用Blender转成.pmx或直接导出FBX避免在Unity里修半天发现是格式太老。3. 实操用mmd-for-unity把模型导入Unity3.1 安装插件和导入前的检查先把mmd-for-unity插件包解压到Assets目录等Unity编译完成。随后在菜单栏里会多出一组MMDForUnity相关的选项这就说明插件加载成功。导入前我会再做一次检查打开模型文件夹确认有没有.pmx主文件有没有配套贴图文件夹。如果有SPA、Toon贴图这类额外文件也一并放好。顺便看一眼文件夹名和文件名里有没有中文或特殊符号Unity对中文路径的支持虽然比早年好了但插件未必可靠稳妥起见我习惯全部改成英文名。3.2 导入.pmx的完整步骤实际操作很简单在Project窗口选中.pmx文件然后在顶部的插件菜单里点击导入命令。插件会自动解析模型层级、生成材质和骨骼结构并把一个预设体Prefab写到Assets目录下。导入完成后把生成的Prefab拖到场景里大概率会看到两种情况模型正常显示或者模型变成紫色/半透明/黑漆漆一片。如果是第一种恭喜你运气好如果是第二种别急这是正常的我们稍后就来修。导入过程中还可以勾选一些选项比如是否包含网格、是否处理骨骼名。我的建议是默认设置先跑一遍遇到问题再回头调整不要一上来就追求“完美配置”。3.3 导入后第一时间的参数调整模型进场景后第一件事是检查缩放比例。MMD模型的单位体系和Unity不同导入后经常出现两种极端模型大得填满整个场景或者小得几乎看不见。我那个“恶魔娘”模型导入后直接把我Camera都吞了检查Transform才知道Scale是1而Unity场景里这个尺寸已经远超常规。解决方案是把根节点的Scale改成0.01到0.1之间根据实际需求微调。如果是走Blender导出FBX再导入还要注意导入设置里的Bake Axis Conversion和Scale Factor。MMD原本是Z轴向上的坐标Unity是Y轴向上导出的FBX需要勾选轴转换否则模型会横躺在场景里。这些设置都在FBX的Import Settings里Apply后立刻生效。3.4 为什么材质会在这里开始出问题很多人在第一步导入后就以为大功告成其实材质问题早在导入时就埋下了。mmd-for-unity插件能为模型生成材质但生成出来的材质用的是Unity Standard Shader和MMD原本的卡通着色器逻辑完全不同。MMD材质里常见的边缘光、描边、透明发丝、明暗分界在Standard Shader下要么表现不正确要么直接不显示。更麻烦的是如果贴图因为路径问题没有被正确加载材质就彻底“丢”了。我这次的模型表现是头发一个材质是半透明黑色裙子是全紫脸倒是正常。看到这种“一半好一半坏”的情况我基本能断定是贴图加载和着色器不兼容两个问题叠加接下来就要逐项排查。4. 材质丢失问题排查与修复4.1 材质丢失的三种典型表现整理一下我遇到过、以及在社区里看到过的材质丢失表现方便你对号入座全紫/洋红色最常见。Unity找不到材质或贴图时会用默认洋红色显示提醒你“这里有资源缺了”。半透明且发黑贴图加载了但着色器不支持MMD的透明模式导致发丝、裙摆这些半透明部位被错误渲染成黑色。全白无光照材质存在但使用了不支持的光照模型或者法线贴图没有正确导入整个模型看起来像块塑料。如果你看到的是这三种情况之一材质丢失基本实锤。接下来不要急着重新导入先在Console窗口看一遍有没有报错特别是Shader相关的错误能帮你省很多时间。4.2 根因分析为什么Unity会“丢”材质材质丢失不是一个简单原因它是多种问题的综合结果。第一个原因是MMD模型里的材质数量特别多几乎每个Mesh Renderer上都挂着一堆Material一旦某个Material的Shader不被Unity支持整个模型就会渲染异常。第二个原因是贴图路径失效。MMD模型在设计时是按本地文件路径引用贴图的导入Unity后Unity把贴图当作独立Asset。如果插件在解析时找不到贴图材质上对应的贴图槽就是空的表现出来就是“材质丢失”。第三个原因是坐标和渲染状态不匹配。MMD材质里很多设置了双面渲染、顶点色、透明排序这些状态在Unity的Standard Shader里需要手动配置插件自动生成的材质大概率没有完全还原这些设置。结果就是模型能显示但各种细节不对劲。4.3 快速修复用MToon重建材质我的修复方案是给模型换上MToon着色器它本来就是为VRM/MMD这类卡通模型设计的对透明发丝、皮肤阴影、描边的支持都很好。具体分几步第一步在Assets里新建一个文件夹存放材质命名为Materials避免和模型自带的混合。第二步选中要修复的Mesh Renderer在Inspector面板里找到Materials列表。把列表中材质数量记下来然后依次处理。如果是全紫的状态直接删掉所有材质重新创建同数量的空材质。第三步新建材质Shader选择“VRM/MToon”。把模型原始贴图拖到MainTex槽位。贴图一般在模型文件夹里能直接找到按名字匹配即可比如皮肤、头发、衣服各一张。第四步按照模型部位调整MToon的核心参数RenderMode设置为Opaque不透明、Cutout有透明边缘的硬边切换、Transparent半透明。衣服的蕾丝用Transparent头发刘海如果带透明过渡用Cutout普通皮肤用Opaque。第五步如果模型有法线贴图记得把贴图的Texture Type设为Normal map并勾选sRGB选项。这一步不做模型会出现奇怪的凹凸和光照看起来也像材质坏了。这套流程处理一个模型大约需要十分钟胜在直观。如果你有十几个材质耐心逐个配置就行大部分情况下能恢复到和MMD里差不多的效果。4.4 更彻底的方案走Blender导出FBX如果MToon重建材质还是不能满足项目要求建议直接用Blender中转。这个方案适合正式开发阶段能一次性把模型骨骼、材质、坐标都整理干净。在Blender里启用MMD Tools插件后直接把.pmx导入插件会自动识别模型的网格和材质。这里可以做几步清理合并多余的网格、统一骨骼命名、重新计算法线。随后把模型导出为FBX导出选项中勾选“仅导出选中物体”“应用变换”等关键项。回到Unity把FBX拖进Assets目录在Import Settings的Materials标签页里把Material Creation Mode改为Standard并勾选Extract Materials。这样Unity会从FBX里提取出所有材质生成可编辑的材质文件。再对这些材质统一替换成MToon或UTS2问题就一次性解决。这个方案比插件直导入繁琐但胜在可控。特别是那些经过“改模”的模型在Blender里能把这些历史问题都处理掉。4.5 其他细节修复描边、透明度与眼睛材质重建只是第一步要让模型在游戏里真正“好看”还有三个细节值得留意。一个是描边。MMD模型的描边通常是单独的一个“OutLine”网格材质是纯黑或纯白如果这个网格的材质丢失整个模型会失去描边感。修复方式同样是给描边材质指定MToon然后把CullMode设为Off让描边在旋转时不被裁掉。一个是透明排序。透明头发和裙摆在和身体重叠时如果RenderQueue设置不当会出现一半在前面一半在后面的诡异效果。MToon里可以调整RenderQueue头发一般设为3000或更高身体设为1000左右让头发优先绘制看起来就正常了。还有一个是眼睛。MMD模型的眼球通常靠贴图和UV实现如果材质导出后贴图偏移了眼球就会变成“斗鸡眼”或者“白眼”。这时候要检查MainTex的Tiling和Offset有没有被意外修改正确值一般是0,0和1,1除非源模型本身就有特殊偏移。5. 常见问题速查与避坑清单把这些天踩过的坑整理成速查表以后遇到类似问题可以直接翻现象可能原因解决方案模型显示为洋红色/紫色材质缺失或Shader不支持用MToon重建材质指定贴图头发/裙摆半透明但发黑着色器透明模式未设置MToon的RenderMode改为Transparent模型亮得发白没有卡通阴影法线贴图类型错误或光照模型不对贴图改为Normal map或换MToon/UTS2模型进入场景后巨大/横躺坐标系和缩放比例问题调整Scale Factor勾选Bake Axis Conversion描边消失描边网格材质丢失或CullMode不对重建描边材质CullMode设为Off身体和头发穿插顺序混乱透明RenderQueue排序不对把透明部分的RenderQueue调高眼睛贴图偏移、斗鸡眼Tiling/Offset错误复核主贴图的UV坐标参数导入时报Shader编译错误插件与Unity版本不兼容换Unity 2021 LTS或改走Blender FBX方案模型动起来后网格撕裂骨骼权重未转换完整用Blender重算权重或检查骨骼命名用Blender导出后贴图全部丢失FBX导入设置未提取材质在Import Settings里勾选Extract Materials并Apply5.1 阴影和包围盒的连带问题材质修复完又会出现一个容易忽略的连带问题阴影显示错误。MMD模型很多网格没有正确设置阴影参数会出现大片黑斑或者角色自带“黑圈”。解决方案是在每个Mesh Renderer的Lighting设置里把Shadow Casting Mode调整为Off或Two Sided并配合MToon里的阴影颜色调节。另一个是Renderer的包围盒Bounds计算错误。材质丢失期间模型网格的网格信息可能被Unity错误缓存导致裁剪范围不对角色走到屏幕边缘就被“腰斩”。修复方法很简单选中模型根节点在Inspector里找到Mesh Renderer的Bounds点一下Recalculate按钮包围盒会自动重置。5.2 MMD4Mecanim动作导入的额外提醒如果你的项目不只是让模型站桩还要播放动作那就会用到MMD4Mecanim。这个工具可以生成Unity Avatar把.vmd动作转成Unity可识别的动画。实际操作中我建议先完成材质修复再去生成Avatar。因为MMD4Mecanim在生成Avatar时如果材质丢失或网格异常动画绑定很容易错乱。另外MMD的动作是每秒30帧Unity动画系统默认也是30帧但如果你改了项目帧率动作会变快或变慢需要在动画导入设置里重新采样。这里我踩过一次坑一个舞蹈动画导入后整个角色像开了2倍速后来把动画文件的Sample Rate改回30才正常。如果你的目标平台是WebGL还可以考虑把模型在Blender里导出为glb格式再通过Unity的glTFast插件直接导入。这样模型和材质分离加载速度更快也能避开一部分Unity材质兼容性问题。6. 这套流程跑通后的个人体会折腾了整整两个晚上把MMD模型导入Unity并解决材质丢失后我对这套资源管线有了很深的体感。最大的感悟是MMD模型可以用但它是一个“需要二次加工”的素材源而不是开箱即用的Unity资产。所有材质问题的根源本质上都是同一个Unity和MMD的材质体系从底层就不一样理解这一点再碰到任何奇怪的显示问题你就知道往哪个方向查了。给后来人一个最实用的建议把Blender中转当成默认选项。前期为了快用插件直导入没问题一旦决定正式使用花半小时走一遍Blender的MMD Tools导出FBX流程能帮你省掉后面几十个小时的材质调试时间。另外每修好一个材质就顺手记录一下参数我一开始偷懒没记录结果换一个模型又得从头试效率低得让人抓狂。后面我还会继续更新这个系列接下来准备写MMD表情导入和动作复现的部分。如果这篇日志能帮你少踩几个坑那这些折腾就值了。