LilToNonToon Switcher

lilToon → NonToon 一键转换 + 切换开关（Unity 编辑器扩展）

选中对象右键即可：把对象里的 lilToon 材质转换成 NonToon、保存到指定文件夹，并自动创建 Modular Avatar 的 MA Material Setter + 菜单开关（一键切换 shader 的开关）。

English summary ↓

一、环境要求

包	用途	是否必需
`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 等）。本工具全部识别。

二、安装

方式 1：VCC / ALCOM（推荐）

打开 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 亮度控制），按需勾选安装即可。

方式 2：unitypackage

从 Releases 下载 LilToNonToonSwitcher.unitypackage。
拖进 Unity 项目 → Import。
菜单里出现 Tools > LilToNonToon Switcher 就装好了。

方式 3：直接放进项目

把 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）见下面「描边宽度贴图」

透明遮罩（`_AlphaMask`）

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）计算，而不是整段丢掉。

描边宽度贴图（`_OutlineWidthMask`）

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 会略粗一点；正常距离两者一致，需要的话用「描边宽度倍数」按材质补。

什么时候会写这个值（什么时候保持 0）

四个条件全满足才会写 _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 的光照/反射模型不同，转换后请目视确认并微调。

English summary

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.

LilToNonToon Switcher

一、环境要求

二、安装

方式 1：VCC / ALCOM（推荐）

方式 2：unitypackage

方式 3：直接放进项目

三、用法（右键一键转换）

输出文件夹与命名

开关的默认状态

切换组件类型

转换方式（三选一）

全部菜单项

复用已有的切换对象

四、转换了哪些东西

无法转换的功能

透明遮罩（`_AlphaMask`）

描边宽度贴图（`_OutlineWidthMask`）

描边宽度（缩放折算 + 手动倍数）

什么时候会写这个值（什么时候保持 0）

五、转换日志

六、注意

七、文件结构

八、实现备注

九、开源说明

English summary

Package Name

Documentation

Repositories

Version

Unity version

Dependencies

VPM Dependencies

Legacy Packages

License

Author

LilToNonToon Switcher

一、环境要求

二、安装

方式 1：VCC / ALCOM（推荐）

方式 2：unitypackage

方式 3：直接放进项目

三、用法（右键一键转换）

输出文件夹与命名

开关的默认状态

切换组件类型

转换方式（三选一）

全部菜单项

复用已有的切换对象

四、转换了哪些东西

无法转换的功能

透明遮罩（_AlphaMask）

描边宽度贴图（_OutlineWidthMask）

描边宽度（缩放折算 + 手动倍数）

什么时候会写这个值（什么时候保持 0）

五、转换日志

六、注意

七、文件结构

八、实现备注

九、开源说明

English summary

Package Name

Documentation

Repositories

Version

Unity version

Dependencies

VPM Dependencies

Legacy Packages

License

Author

透明遮罩（`_AlphaMask`）

描边宽度贴图（`_OutlineWidthMask`）