LCGUdonSharp Troubleshooting
Documentation version: 0.3.12
| Problem | Fix |
|---|---|
| "The associated script cannot be loaded" | The .cs is missing its same-named UdonSharpProgramAsset. Use Assets > Create > U# Script so Unity generates both files together, or copy the .asset with the .cs. |
| Script compiles in Unity but UdonSharp ignores it | Its assembly is not registered. Assembly-CSharp is always scanned; scripts in an .asmdef need a UdonSharpAssemblyDefinition pointing to that .asmdef. |
| Fresh install has no compiler payload | Update from the incorrectly packaged 0.3.2 release to 0.3.12, then let Unity refresh or run Install or Repair. |
| Installing a release ZIP fails | Use the named com.logiccuteguy.lcgudonsharp-0.3.12.zip release asset, not GitHub's automatic Source code (zip) archive. |
| Worlds SDK version differs from 3.10.5 | Since 0.3.11 the installer warns instead of blocking: the payload (built from SDK 3.10.5) installs anyway. Run Tools > LCGUdonSharp > Restore to revert to the backed-up original UdonSharp. |
Duplicate UdonSharp.* assemblies | Run Tools > LCGUdonSharp > Install or Repair — the SDK's bundled copy may have been restored. |
| Packet fields not syncing after upgrade | Protocol is versioned (v2): recompile all UdonSharp programs and rebuild the world. |
Build fails around LCGNetworkZone | Zones fail closed on native [UdonSynced] fields unless Allow Native Sync Passthrough is enabled, plus Udon Graph behaviours, overlapping parent/child zones, and PlayerObject templates sharing a hierarchy. Continuous behaviours without synced fields are safe. Zones in separate hierarchies may overlap. |
| Need to uninstall | Run Tools > LCGUdonSharp > Restore VRChat UdonSharp and Disable Auto Setup first, then remove the package. |
Reporting compiler issues
Bug reports, feature requests, and pull requests are welcome in the project repository. When reporting a compiler diagnostic, include:
- Unity version
- Worlds SDK version
- The smallest snippet that reproduces the issue
See also
- Installation & Setup — menu commands and diagnostics toggles
- Manual Packet Networking — zone rules and protocol versioning
Localization in 0.3.9
LCGUdonSharp 0.3.9 adds text and asset localization: Unity String/Asset Tables baked into Udon, local language selection and fallbacks, dropdowns/callbacks, validated Smart Strings, and sprite/texture/audio/prefab variants. It also adds EN/TH/JA samples, legacy JSON tools, Unity Localization 1.4.5 and Scriptable Build Pipeline 1.21.25 dependencies, and build/worker-thread compatibility fixes. Rebuild the world after editing tables or updating.
SDK/SBP compilation collision in 0.3.10
LCGUdonSharp 0.3.10 installs an embedded SBP compatibility 1.21.26 dependency through VPM before Unity compiles, preventing the VRChat SDK ExtensionMethods collision on fresh installs and upgrades. It is based on Unity SBP 1.21.25, preserves upstream source/GUIDs and the Unity Companion License, and survives Library regeneration. Unity Localization 1.4.5 remains supported. See installation; manual installs require both release ZIPs.
For manual installation, close Unity first. Download the named LCGUdonSharp 0.3.10 ZIP and SBP compatibility 1.21.26 ZIP. Extract their contents to Packages/com.logiccuteguy.lcgudonsharp and Packages/com.unity.scriptablebuildpipeline respectively, with each package.json directly inside its package folder, before reopening Unity. A file: reference to LCGUdonSharp still requires SBP embedded in the project. Do not use GitHub's automatic Source code (zip) archive. Do not rely on a PackageCache edit or a post-compilation hook: cache regeneration can remove that fix.
Untested SDK warning in 0.3.11
Since 0.3.11 the installer warns instead of blocking when the installed VRChat Worlds SDK differs from the supported 3.10.5. The payload is built from SDK 3.10.5 and installs anyway, with a Console reminder that Tools > LCGUdonSharp > Restore reverts to the backed-up original UdonSharp. The same release declares the LCGUdonSharp Examples sample in package.json, so Package Manager lists it — import it after automatic compiler installation completes.
For manual installation, close Unity first. Download the named LCGUdonSharp 0.3.12 ZIP and SBP compatibility 1.21.26 ZIP. Extract their contents to Packages/com.logiccuteguy.lcgudonsharp and Packages/com.unity.scriptablebuildpipeline respectively, with each package.json directly inside its package folder, before reopening Unity. A file: reference to LCGUdonSharp still requires SBP embedded in the project.