unity-hybridclr

Automates HybridCLR C# hot-update prebuild tasks inside the Unity Editor.

2|Updated May 18, 2026
One-click install
npx skills add https://github.com/pcone-mm/NewFPG --skill unity-hybridclr-pcone-mm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-hybridclr
Source: https://github.com/pcone-mm/NewFPG/tree/main/.agents/skills/unity-skills/skills/hybridclr
Command: npx skills add https://github.com/pcone-mm/NewFPG --skill unity-hybridclr-pcone-mm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up and maintaining HybridCLR hot updates in Unity involves many error-prone manual steps: configuring HybridCLRSettings, verifying the il2cpp_plus install, compiling hot-update DLLs, running the Generate/All pipeline, keeping AOTGenericReferences in sync, and staging DLLs for YooAsset bundling. This Skill automates all of those Editor-side operations through reflection, so it works whether or not the HybridCLR package is installed. ## Core Features & Use Cases - Settings and environment management: Read and write HybridCLRSettings, probe the il2cpp_plus installation state, and resolve every input/output path for a build target. - Compile and generation pipeline: Compile hot-update DLLs per build target, run the full Generate/All pipeline or a single step (link.xml, AOT DLLs, method bridge, AOTGenericReferences), with backups for workflow undo. - Diagnostics and artifact staging: Validate the entire setup with categorized errors and warnings, inspect AOTGenericReferences for sync drift, and stage compiled DLLs as .bytes files into a YooAsset collector directory. - Use Case: After editing hot-update C# code, compile the DLLs for Android, verify none are missing, copy them into Assets/HotUpdateDlls as .bytes, and hand off to YooAsset for bundle packing — all without opening HybridCLR menus. ## Quick Start Ask the AI to run hybridclr_status first to check whether the HybridCLR package is installed and how the current project is configured.

Frequently Asked Questions about unity-hybridclr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compile HybridCLR hot-update DLLs in Unity?

Use hybridclr_compile_dlls with a buildTarget to run CompileDllCommand.CompileDll, which outputs DLLs to HybridCLRData/HotUpdateDlls/<target>. Then verify with hybridclr_get_hotupdate_dlls that no configured assemblies are missing.

How do I set up HybridCLR hot update with YooAsset in Unity?

Configure hotUpdateAssemblyDefinitions via hybridclr_settings_set, run hybridclr_generate_all once, then use hybridclr_copy_hotupdate_dlls to stage DLLs as .bytes files into a directory that a YooAsset collector packs into bundles.

Does HybridCLR work with the Mono scripting backend?

No, HybridCLR requires the IL2CPP scripting backend. The hybridclr_validate_setup skill reports a blocking error when the project is configured for Mono, since Mono builds cannot use HybridCLR hot update.

When should I re-run HybridCLR Generate/All?

Re-run generate_all only when AOT-side code changes, when you add or remove a hot-update assembly, or before shipping a new player build. Iterating on hot-update code alone only requires recompiling DLLs, not the full pipeline.

Why does HybridCLR hot update fail at runtime with generic instantiation errors?

This happens when patchAOTAssemblies is out of sync with the generated PatchedAOTAssemblyList. Run hybridclr_aot_generic_refs to check inSync, then copy missingFromSettings into hybridclr_settings_set patchAOTAssemblies.

Can I install HybridCLR il2cpp_plus automatically through a skill?

No, installation is deliberately not exposed because it clones two git repositories and copies the editor il2cpp tree with no cancellation. Use the HybridCLR/Installer menu window, and check state with hybridclr_install_status.