lilToon → NonToon 一键转换 + 切换开关（Unity 编辑器扩展）
选中对象右键即可：把对象里的 lilToon 材质转换成 NonToon、保存到指定文件夹， 并自动创建 Modular Avatar 的 MA Material Setter + 菜单开关（一键切换 shader 的开关）。
| 包 | 用途 | 是否必需 |
|---|---|---|
jp.lilxyzw.liltoon |
转换来源 shader | 必需 |
jp.lilxyzw.nontoon + jp.lilxyzw.shadercore |
转换目标 shader | 必需 |
nadena.dev.modular-avatar |
切换组件（Material Setter / Swap、Menu Item） | 只在需要做开关时必需 |
| VRChat SDK3 Avatars | 把菜单装进 avatar | 只在需要菜单开关时必需 |
都可以从 VCC / ALCOM 的 VPM 安装。针对 NonToon 0.1.x 编写；属性名是运行时从 shader 里读的， 所以后续 NonToon 增删模块、改名字也能跟上。
lilToon 一共有 65 个 shader，绝大多数材质用的是隐藏变体（
Hidden/lilToonOutline、Hidden/lilToonTransparent等）。本工具全部识别。
-
打开 VCC（或 ALCOM）→ Settings → Packages → Add Repository
-
填入总仓库地址（一个链接就够，本插件和 NonToon Light Limit 都在这份索引里）：
https://njsgdd10086.github.io/vpm-listing/index.json -
回到项目的 Manage Project，在
LilToNonToon Switcher上点 Add。 之后有新版本时，VCC / ALCOM 会直接提示升级。
这个索引是「ATRI_NAIXU VPM Packages」总仓库（独立的 vpm-listing 仓库，由 Actions 自动从各插件仓库的 Release 生成），包含
com.nontoon.switcher（本插件）与com.atrinaxu.nontoon.lightlimit（NonToon 亮度控制），按需勾选安装即可。
- 从 Releases 下载
LilToNonToonSwitcher.unitypackage。 - 拖进 Unity 项目 → Import。
- 菜单里出现
Tools > LilToNonToon Switcher就装好了。
把 Editor/ 文件夹、package.json 以及配套的 .meta 文件放到 Assets/LilToNonToonSwitcher/ 下即可。
仓库里已经包含固定 GUID 的 .meta 文件，导入不会每次产生新 GUID。
升级注意：如果装过旧版本，请先在 Project 窗口里删除
Assets/LilToNonToonSwitcher文件夹， 再导入新版本，避免新旧两套同名脚本同时存在。
- 在 Hierarchy 里选中 avatar 本体 / 衣服等对象（可以多选）。
- 右键 →
LilToNonToon→将选中对象转换为 NonToon（快捷键Ctrl+Shift+T，Tools 菜单里也有）。 - 自动完成下面这些事：
选中对象
├─ 找出其中的 lilToon 材质（含 Hidden/lilToon* 隐藏变体）
├─ 生成 NonToon 材质，保存到 Assets/NonToonConverted/<对象名>/
│ （同时烘焙 _MainTex×_Color、共享遮罩、阴影渐变）
└─ 创建 Modular Avatar 切换对象
└─ _NonToonSwitch
├─ MA Material Setter（默认；每条 = 对象 + 材质槽 + NonToon 材质）
└─ MA Menu Item （Toggle「NonToon」）
- 上传后 Expression Menu 里会多一个 NonToon 开关，勾一下就能在 lilToon / NonToon 之间切换。
重要：默认（Material Setter 模式）不会把 Renderer 上的材质换掉——Renderer 保持原来的 lilToon， NonToon 材质只出现在 Setter 的条目里，由开关负责切换。 这样开关才有效：如果槽里已经是 NonToon，开关就等于没有作用了。
默认输出到 Assets/NonToonConverted/<选中对象名>/，可在
Tools > LilToNonToon Switcher > 设置与转换窗口 里修改。
生成的材质命名为 <原材质名>_nontoon.mat，例如 衣服.mat → 衣服_nontoon.mat。
配套生成的贴图/渐变沿用同一前缀，便于对应：
Assets/NonToonConverted/衣服/
├─ 衣服_nontoon.mat ← 转换后的材质
├─ 衣服_nontoon_Base.png ← _MainTex × _Color 烘焙
├─ 衣服_nontoon_NTMask.png ← 汇总后的 _SharedMask
└─ 衣服_nontoon_Gradients.scgradients ← 阴影渐变
同名冲突时自动加序号（衣服_nontoon_2.mat）；原材质名已以 _nontoon 结尾时不会重复追加。
| 设置 | 转换后看到的效果 | 开关勾选时 |
|---|---|---|
| 将 NonToon 设为默认（默认开启） | NonToon | 变回 lilToon |
| 关闭 | lilToon | 变成 NonToon |
用的是 MA 组件上的 Inverted。若 MA 版本不支持，会自动退化成关闭时的行为并在日志里提示。
在设置窗口里可选：
| 模式 | 生成的组件 | Renderer 材质 | 说明 |
|---|---|---|---|
| MA Material Setter（默认） | ModularAvatarMaterialSetter |
保持 lilToon | 每条记录「对象 + 材质槽索引 + NonToon 材质」，能精确控制到某个 Renderer 的某一槽 |
| MA Material Swap | ModularAvatarMaterialSwap |
替换为 NonToon | 只按「原材质 → 新材质」成对替换，作用于 Root 下所有 Renderer |
两种模式都配合 MA Menu Item 生成开关。MA 在构建 avatar 时自动生成切换动画，
不需要手写动画与 Animator。
菜单 Tools > LilToNonToon Switcher > 转换方式 > 里三选一，设置窗口里也有同样的下拉：
| 方式 | 结果 | 说明 |
|---|---|---|
| 保留原材质 + 建切换开关（默认） | Renderer 上还是 lilToon，靠菜单开关切到 NonToon | 游戏里可以随时切，最灵活 |
| 直接替换成 NonToon（原地替换） | 选中对象上的材质原地换成 NonToon，不建开关 | 干脆，但想回退只能 Ctrl+Z 或版本管理 |
复制一份 _nontoon 后替换 |
复制出 <名字>_nontoon（材质是 NonToon），原对象保留 lilToon 但自动取消勾选 |
相当于"直接替换 + 留退路"：想回退就把原对象勾回来 |
「复制一份」的细节：
- 副本命名
<原对象名>_nontoon（例如avtr→avtr_nontoon），排在原对象后面，层级/组件/位置完全一致； - 副本里会自动删掉之前生成的
_NonToonSwitch（否则副本里既有 NonToon 材质、又有会切回 lilToon 的开关，互相打架）； - 重复转换会复用已有的同名副本，不会越转越多；
- 副本创建、原对象取消勾选都走 Undo，
Ctrl+Z可以撤销； - 场景里会同时存在两个 Avatar 描述符，上传时选
_nontoon那一份即可（原对象是取消勾选状态，不参与构建）； - 副本是普通对象（
Instantiate出来的），不会挂回 prefab。如果你的头像根是 prefab 实例，副本就与 prefab 脱钩了。
| 菜单 | 作用 |
|---|---|
GameObject > LilToNonToon > 将选中对象转换为 NonToon %#t |
按当前设置转换 + 建开关（Ctrl+Shift+T） |
GameObject > LilToNonToon > 转换并打开设置窗口 |
打开设置窗口 |
GameObject > LilToNonToon > 只转换材质（不建开关） |
只转材质，不需要 Modular Avatar |
GameObject > LilToNonToon > 查看转换日志 |
打开设置窗口并查看日志 |
Tools > LilToNonToon Switcher > 转换选中对象为 NonToon |
Tools 菜单入口 |
Tools > LilToNonToon Switcher > 设置与转换窗口 |
设置窗口 |
Tools > LilToNonToon Switcher > 转换时复用已有的 _NonToonSwitch |
✅ 打勾＝复用（默认）：同一 avatar 下已存在开关时把新材质追加进去 |
Tools > LilToNonToon Switcher > 转换时总是新建 _NonToonSwitch |
✅ 打勾＝每次转换都新建一个开关（会产生多个） |
Tools > LilToNonToon Switcher > 转换方式 > 保留原材质 + 建切换开关（默认） |
✅ 打勾＝默认方式：保留 lilToon 材质，另建切换开关 |
Tools > LilToNonToon Switcher > 转换方式 > 直接替换成 NonToon（原地替换） |
✅ 打勾＝原地换材质，不建开关（回退只能靠 Ctrl+Z） |
Tools > LilToNonToon Switcher > 转换方式 > 复制一份 _nontoon 后替换（原对象取消勾选） |
✅ 打勾＝复制一份 <名字>_nontoon 换成 NonToon，原对象取消勾选（可回退） |
Tools > LilToNonToon Switcher > 描边后移倍数 > 0 / 0.5 / 1 / 1.5 / 2 |
✅ 打勾＝当前倍数（默认 1）。只影响"源材质挂了描边宽度贴图"的材质，详见下面「描边宽度贴图」一节 |
Tools > LilToNonToon Switcher > 描边宽度倍数 > 0.25 / 0.5 / 0.75 / 1 / 1.5 |
✅ 打勾＝当前倍数（默认 1）。整体调描边粗细：原值 × 对象世界缩放 × 这个倍数，详见「描边宽度」一节 |
Tools > LilToNonToon Switcher > 环境检查 |
输出 lilToon / NonToon / MA 的安装情况到 Console |
Tools > LilToNonToon Switcher > 导出为 unitypackage |
源码放在 Assets/LilToNonToonSwitcher 时可重新打包 |
默认开启。同一个 avatar 下已经转换过一次时，再次转换不会新建 _NonToonSwitch，
而是把新的「对象 + 材质槽」条目追加到已有的 MA Material Setter 上，菜单项也不会重复创建。
所以你可以分几次转换同一个模型的不同部位（先转身体、再转头、再转衣服），最终只会有一个开关， 一次勾选就能整体切换。
菜单里的两项互斥打勾，也可以在设置窗口里用复选框切换。 只有在你确实想把不同部位分成独立开关控制时，才需要关掉它。
对照表在 Editor/NonToonPropertyMap.cs。分三步进行：
- 显式对照表：语义会变的（渲染模式、遮罩、渐变、描边等）
- 同名属性自动复制：
_Cull、_ZWrite、_Stencil*、_Cutoff等 - 归一化名称模糊匹配：改过名字但类型相同的属性
| lilToon | NonToon | 说明 |
|---|---|---|
_MainTex + 主色 / 色调校正 / 渐变映射 |
_BaseTexture |
按 lilToon 的处理顺序烘焙成 PNG：贴图 → 色调校正（HSV/Gamma，含 _MainColorAdjustMask）→ 渐变映射（_MainGradationTex / _MainGradationStrength）→ × _Color（含 Alpha、HDR）。值为全默认时直接沿用原贴图 |
_BumpMap / _BumpScale |
_NormalMap / _NormalScale |
直接复制 |
_Cutoff |
_Cutoff |
直接复制 |
渲染模式（_TransparentMode 或 shader 名） |
_RenderingMode + Blend / Queue / ZWrite |
先按 shader 名字判断（lilToon 选了模式后材质会换成 Hidden/lilToonCutout、Hidden/lilToonTransparentOutline、Hidden/lilToonTwoPassTransparent 这类隐藏变体，那些材质的 _TransparentMode 常常还是 0），再退回属性。_RenderingMode 只决定 NonToon 怎么处理 Alpha（不透明强制 1 / 镂空做剪切 / 透明保留）；混合方式、_ZWrite、_Cull、_AlphaToMask、渲染队列沿用原材质（lilToon 这些值都是材质驱动的，作者常故意调成「透明混合但写深度、待在几何队列」，例如 MANUKA 的脸和头发），原材质没有这些属性时才用 NonToon 自己的模式默认值 |
_OutlineColor / _OutlineWidth / _OutlineZBias |
_OutlineColor / _OutlineWidth / _OutlineZOffset |
近似复制；源材质挂了 _OutlineWidthMask 时另外把描边后移（见「描边宽度贴图」） |
_OutlineVertexR2Width |
_OutlineFromVertexColor |
用顶点色控制描边宽度 |
_AlphaMask（_AlphaMaskMode 1/2/3/4 + scale/value） |
_BaseTexture 的 Alpha |
烘焙进基础贴图的 Alpha（NonToon 的共享遮罩改不了 alpha）：按 lilToon 的顺序算「主色 → 透明遮罩 → …」。遮罩没挂贴图时按 shader 默认白贴图（= 1）算，也就是 _AlphaMaskValue 当整体透明度偏移用。详见下面「透明遮罩」 |
_RimColorTex / _BacklightColorTex / _MatCapBlendMask / _ReflectionColorTex |
_SharedMask |
读取各模块的 Mask Channel 设置，写进对应通道 |
_ShadowColor / _Shadow2ndColor / _Shadow3rdColor + Border / Blur |
_SharedGradients（.scgradients）+ _ShadeGradientIndex |
在 lilToon 的 x = dotNL × 0.5 + 0.5 空间里按 lilToon 的公式采样 24 个关键点：过渡窗口 [border ± blur/2]、阴影色的 alpha 当强度、alpha ≈ 0 的层跳过、受光端回白色 |
_RimColor / _RimBorder / _RimBlur |
_RimLightColor / _RimLightRange |
由边界与模糊近似出 Range |
_MatCapTex / _MatCapColor / _MatCapBlendMode |
_MatCapMultiply* / _MatCapAdd* |
按混合方式选择加算/乘算 |
_ReflectionColor |
_SpecularColor |
原样复制（不乘 _Reflectance，否则高光会被压黑） |
_Smoothness |
_Roughness |
roughness = 1 - smoothness；_UseReflection 关闭时保持 NonToon 默认值 |
_Stencil*、_OutlineStencil*、_Cull、_ZWrite、_SrcBlend、_DstBlend、_AlphaToMask |
同名 | 直接复制 |
NonToon 0.1.x 里没有对应项的功能，不会被悄悄丢掉，而是作为警告写进转换日志：
- Emission（自发光）/ Emission2nd、Glitter、AudioLink、Dissolve、Parallax、Tessellation
- Main 2nd / 3rd（贴花）、UV 动画
- MatCap 2nd、Reflection Cube、Metallic
- Fur 的细节设置、Gem、Refraction
- 描边的贴图（
_OutlineTex）；宽度遮罩（_OutlineWidthMask）见下面「描边宽度贴图」
lilToon 的透明遮罩是直接改 alpha 的（不是"裁掉"）：
alphaMask = saturate(_AlphaMask.r * _AlphaMaskScale + _AlphaMaskValue);
mode 1 替换 alpha / mode 2 相乘 / mode 3 相加 / mode 4 相减NonToon 没有这个功能（_SharedMask 只喂给各模块做范围遮罩，改不了 alpha），所以转换时把这条链
按同样的顺序烘进 _BaseTexture 的 Alpha（主色 → 透明遮罩 → …），遮罩按自己的 tiling/offset 采样，
并把烘焙出的 PNG 导入设置钉成 alphaSource = FromInput。
两种容易踩空的情况都处理了：
| 情况 | 说明 |
|---|---|
遮罩贴图没挂（fileID: 0） |
也算"用了遮罩"：lilToon 采样没设置过的贴图属性用的是 shader 默认白贴图（= 1），所以 _AlphaMaskValue 就是「整体透明度偏移」（例：−0.33 → alpha × 0.67），很多半透明薄片就靠这个值 |
主贴图没挂（_MainTex = fileID: 0） |
以白底贴图参与烘焙，把算好的 Alpha 带出来（以前会静默跳过，材质转完是实心的） |
遮罩贴图读不出来（没勾 Read/Write）时会警告，并按默认白遮罩（= 1）计算，而不是整段丢掉。
NonToon 没有"逐像素描边宽度"这个功能，它的描边是均匀的反向外扩壳，所以这里做了一次补偿：
lilToon 的作者常用宽度遮罩把嘴唇、眼睛附近的描边宽度压成 0（描边壳不该压在五官上）。到了 NonToon， 这些位置照样外扩，而且描边壳采样的是该处 UV 的基础贴图颜色 —— 看起来就像脸在嘴部被"撕破"。
转换时因此会把描边整体沿视线方向后移 描边宽度 × 0.01 × 倍数（写进 _OutlineZOffset）：
× 0.01是 NonToon 自己的换算（pos += N * _OutlineWidth * 0.01），所以后移量正好等于描边自身的外扩距离；- 描边壳上任何顶点都不会比原位更靠近相机 → 有表面挡着的地方必然被深度测试剔除；
- 剪影处法线垂直于视线，后移不改变屏幕位置，描边依旧保留。
倍数默认 1，可在 转换方式 同级的 描边后移倍数 菜单里选 0 / 0.5 / 1 / 1.5 / 2，
或在设置窗口「高级设置」里用滑条（0–3）微调：调小＝描边更明显但凹处风险回升，调大＝更保险但描边可能被邻近几何吃掉，
0 = 不做处理（回到会糊住嘴唇的旧行为）。
两个 shader 的描边偏移不在同一个空间：
lilToon ：positionOS += outlineN * (_OutlineWidth * 0.01 * 宽度贴图) → 之后过物体矩阵，会被对象缩放缩放
NonToon ：vertex.position（已是世界空间）+= outlineN * _OutlineWidth * 0.01 → 不受对象缩放影响
所以对象一旦被缩放，NonToon 的描边就会等比例偏粗/偏细。转换时按「使用该材质的渲染器」的世界缩放
折算 _OutlineWidth（缩放 ≈ 1 时等于不改；同一材质被不同缩放共用时会警告并取平均）：
描边宽度 = 原值 × 对象世界缩放 × 手动倍数
手动倍数在菜单 Tools > LilToNonToon Switcher > 描边宽度倍数 >（0.25 / 0.5 / 0.75 / 1（默认） / 1.5）
或窗口「高级设置」的滑条（0–2）里调，改完重新转换后生效。日志会写明实际数值：
· 描边宽度 -> 0.07 → 0.021（对象缩放 0.3 × 手动倍数 1）
已知限制：lilToon 的 _OutlineFixWidth 会在相机距离小于 1 米时把描边按 × saturate(距离) 收窄
（贴脸看最多细 20~30%），NonToon 的描边没有随距离变化的机制，所以极度贴近看时 NonToon 会略粗一点；
正常距离两者一致，需要的话用「描边宽度倍数」按材质补。
四个条件全满足才会写 _OutlineZOffset：
- 源材质的
_OutlineWidthMask真的挂了贴图 —— 空槽不算； shader 默认的内置贴图（white/black/gray/normal）也不算， 因为 Unity 对"没设置过"的贴图属性返回的就是这些内置贴图，而不是null； - 描边宽度
_OutlineWidth> 0（宽度为 0 时本来就没有描边可推）； - 后移倍数 > 0；
- 算出来的后移量大于材质原有的
_OutlineZOffset（不覆盖更大的值）。
所以 _OutlineZOffset 保持 0 只可能是上面四种情况之一。挂着宽度贴图的材质会在转换日志里
说明自己的结果（含没后移的原因）；没挂贴图的材质不打印这一行，也就是
「日志里没有这一行 = 没用宽度遮罩 = 不需要处理」。
- 设置里打开「输出日志到 Console」后，转换内容、近似处理、未支持功能都会打到 Console。
- 窗口下方的转换结果里也能看到同样的内容。
- 转换不会修改原来的 lilToon 材质，而是新建一份 NonToon 材质文件。
- 改设置后重新转换会覆盖同名的输出材质（同名但不同来源的材质会以
_2等后缀避让）。 - lilToon 与 NonToon 的反射、阴影模型不同，转换结果请务必在 Unity 里目视确认， 再调 Roughness、渐变和各模块设置。
- 上传前确认 MA Material Setter / Swap 的条目只覆盖了想替换的那些 Renderer。
LilToNonToonSwitcher/
├─ package.json
├─ README.md
├─ CHANGELOG.md
├─ LICENSE
└─ Editor/
├─ NonToonSwitcherMenu.cs … 右键 / Tools 菜单
├─ NonToonSwitcherWindow.cs … 设置与转换窗口
├─ NonToonSwitcherSettings.cs … 设置保存（ProjectSettings）
├─ NonToonConverter.cs … 转换主体（检测 → 转换 → 替换 → 建开关）
├─ NonToonPropertyMap.cs … lilToon → NonToon 对照表
├─ NonToonMaskBuilder.cs … 共享遮罩（_SharedMask）生成
├─ NonToonTextureBaker.cs … 基础贴图 / 阴影渐变生成
├─ NonToonSwitcherBuilder.cs … Modular Avatar 联动（Material Setter / Swap、Menu Item）
├─ NonToonPackager.cs … 重新打包 unitypackage
├─ ShaderUtility.cs … shader 判定与属性读写
└─ ConversionLog.cs … 日志
整型属性：Unity 对 Shader Core 这类 shader 的整型属性，Material.SetInt() 会静默失效——
调用不报错、内存里 GetInt() 也读得回来，但 AssetDatabase.SaveAssets() 写进 .mat 的仍是默认值 0；
反过来，文件里确实是 _RenderingMode: 2 的材质，GetInt() 也读成 0。
因此整型属性统一走 SerializedObject 的 m_SavedProperties.m_Ints 读写
（也就是 NonToon 自己 Inspector 落盘的形式），渲染模式、渐变色索引才能正确保存。
Modular Avatar 联动全部用反射实现，所以 MA 版本变化不会导致本工具编译报错 （联动失败时会在日志里给出警告）。
- 许可证：MIT（见 LICENSE）。
- 本项目的代码为独立实现，没有复制其他转换工具的源码。转换思路参考了社区同类工具 （例如 BOOTH 上的 lil to non toon converter）以及 lilToon / NonToon / Shader Core 公开的 shader 与编辑器脚本行为。
- 依赖的第三方项目均属其各自作者，本仓库不包含它们的代码： lilToon、NonToon、 Shader Core、 Modular Avatar。
- 转换是近似的：lilToon 与 NonToon 的光照/反射模型不同，转换后请目视确认并微调。
LilToNonToon Switcher is a Unity Editor extension that converts the lilToon materials of the
selected object(s) into NonToon, saves them as <name>_nontoon.mat, and builds a Modular Avatar
Material Setter + Menu Item so that a single Expression Menu toggle switches the avatar
between lilToon and NonToon.
Requirements: jp.lilxyzw.liltoon, jp.lilxyzw.nontoon (+ jp.lilxyzw.shadercore) and, for the
toggle, nadena.dev.modular-avatar plus the VRChat SDK3 Avatars package.
Usage: select the object in the Hierarchy → right click → LilToNonToon →
Convert Selection to NonToon (Ctrl+Shift+T).
License: MIT. The code is an independent implementation; no source code of other converters was copied. See the Chinese sections above for the full documentation.