Skip to main content

Warudo

This page is for people using a MingToon character in WARUDO. It covers installing the depth supply plugin and checking the mod build.

Reference versions​

ItemValue
Unity2021.3.45f2
WARUDO Mod SDK0.14.3.10
Render pipelineBuilt-in (BRP)
It cannot share a project with VRChat

VRChat uses Unity 2022.3.22f1 and WARUDO uses 2021.3.45f2. Split the projects by target.

Installing camera depth — WARUDO Depth Bridge​

Depth rim light, depth shadow, the inner outline and SSAO need the WARUDO camera's depth texture.

The package includes the source of a standalone plugin that supplies that depth.

This installs into WARUDO itself, not into the character​

It is not a component you attach to a prefab

This file is a global plugin that runs in the WARUDO application's Playground. Do not put it in the character mod folder or add it to a prefab as a component.

Installation​

  1. In the Unity project, find Assets/StudioRaming/MingToon/Docs/Warudo/MingToonWarudoDepthBridge.cs.txt.
  2. Copy this file into Warudo_Data/StreamingAssets/Playground in the WARUDO install folder.
  3. Remove the trailing .txt from the file name so it becomes MingToonWarudoDepthBridge.cs.
  4. Restart WARUDO and confirm the [MingToon Warudo Depth Bridge] installed log in the Console.

If MingToon Warudo Depth Bridge shows in the plugin list, it worked.

File Explorer with MingToonWarudoDepthBridge.cs inside Warudo_Data/StreamingAssets/Playground in the WARUDO install folder

What it supplies​

The plugin checks the active Game camera right before every render.

  • It requests a depth texture on each camera.
  • It passes the center, left-eye and right-eye view matrices as shader globals.
  • It handles not only the main screen but also active Spout, NDI and transition cameras, per camera.
  • Even when cameras change, it does not cache one and uses the camera actually rendering.

The plugin does not depend on the MingToon runtime assembly. That is why it ships as a standalone file.

Checking by symptom​

SymptomWhat to check
All depth effects are emptyThe Playground path, the .cs extension, the installed log
The main screen is fine but Spout and NDI differThe depth enabled for camera= log for that output camera
Only the normal outline shows and there are no inner linesThe normal outline does not need depth. Start from whether the Bridge loaded

→ Troubleshooting — WARUDO

WARUDO mod build​

Running Warudo > Build Mod makes MingToon's build hook apply automatic optimization.

It uses UMod's processor path, not Unity's general build callbacks.

Scope​

  • It finds the build root among the GameObjects UMod exports and optimizes only that character.
  • It adds the generated shaders and textures to the UMod build asset list.
  • It restores the authoring materials when the build finishes or fails.
  • If it cannot determine the export root, it falls back to the MingToon materials in the loaded scenes and leaves a warning.

Logs to check​

LogMeaning
[MingToon] Warudo mod build processor enteredThe hook ran
[MingToon] Applied auto optimize and registered N generated assets.The optimization was applied
[MingToon] Restored authored materials.It returned to the authoring state
[MingToon] Could not restore authored materials.Restore failed. Do not use this build
A manual Bake is not the standard procedure

WARUDO export also uses automatic optimization on build. Use a manual Bake only when you need the baked material assets themselves.

→ Manual Bake and Restore

Depth light​

A WARUDO build also carries the depth light when it uses depth effects.

You can force it out with Remove depth light on build in the MingToon Manager. → VRChat depth light

Lighting differences​

  • VRC Light Volumes (Test) is for VRChat worlds. Turn it off in WARUDO and use Unity Light Probes.
  • Built-in point and spot additional lights come in through the ForwardAdd pass.
  • If additional lights are strong, adjust with Additional Light Receive and Additional Light Intensity.
  • If you use several cameras, check depth effects and transparency sorting per output.
ForwardAdd does not get the shadow filter

In WARUDO Built-in, the in-shadow reflection created by additional lights is not filtered. For the detailed conditions, see the Rim reference.

Export checklist​

  1. Use Unity 2021.3.45f2 and the Built-in shaders.
  2. MingToonWarudoDepthBridge.cs is installed in Playground.
  3. The Warudo > Build Mod Console has no optimization or restore errors.
  4. Check depth effects on the main screen and on the actual output camera.
  5. If the scene lighting is hard to control, adjust Preserve Base Map Color and Minimum Final Brightness.

Next​

Automatic Optimization On Build · Depth Effects · Light and Shadow