unity-hybridclr

Automates HybridCLR C# hot-update compilation, generation, and artifact staging in Unity.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-hybridclr-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-hybridclr
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/hybridclr
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-hybridclr-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up and maintaining HybridCLR hot-update pipelines in Unity involves many error-prone manual steps: configuring settings, compiling hot-update DLLs, running the prebuild generation pipeline, and staging artifacts for bundle builds. This Skill automates the entire editor-side workflow through reflection-based calls that work whether or not the package is installed. ## Core Features & Use Cases - Settings & Diagnostics: Read and write HybridCLRSettings, probe installation state, and run pre-flight validation that returns categorized errors and warnings with concrete fixes. - Compile & Generate Pipeline: Compile hot-update DLLs per build target and run the full prebuild pipeline (link.xml, AOT DLLs, method bridges, AOTGenericReferences.cs) or individual steps. - YooAsset Integration: Stage compiled DLLs as .bytes TextAssets into a collector directory so YooAsset can pack them into bundles for shipping. - Use Case: After editing hot-update C# code, compile the DLLs for Android, verify no assemblies are missing, copy them into Assets/HotUpdateDlls, and trigger a YooAsset bundle build — all without touching the Unity menus. ## Quick Start Ask the AI to run hybridclr_status first to check the HybridCLR installation state, then validate the setup and compile hot-update DLLs for your target platform.

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?

Call hybridclr_compile_dlls with your build target to run CompileDllCommand.CompileDll, which outputs DLLs to HybridCLRData/HotUpdateDlls/<target>. Verify results with hybridclr_get_hotupdate_dlls to confirm no assemblies are missing.

How to ship HybridCLR hot-update DLLs with YooAsset?

Use hybridclr_copy_hotupdate_dlls to stage compiled DLLs into a directory under Assets/ renamed to .bytes so Unity imports them as TextAssets. Then configure a YooAsset collector on that directory and build bundles with the yooasset module.

Does HybridCLR work without the IL2CPP scripting backend?

No, HybridCLR requires the IL2CPP scripting backend; Mono builds cannot use it. The hybridclr_validate_setup skill reports a missing IL2CPP backend as a blocking error during pre-flight checks.

When should I re-run HybridCLR Generate All?

Re-run hybridclr_generate_all only when AOT-side code changes, when you add or remove a hot-update assembly, or before shipping a new player build. Iterative hot-update changes only need hybridclr_compile_dlls, not a full regeneration.

Why does hybridclr_compile_dlls block the Unity Editor?

HybridCLR commands are synchronous main-thread Unity APIs with no async job boundaries, so compilation and generation block the editor for minutes. Raise client timeouts to at least 10 minutes, or run the equivalent menu methods via unity-cli in batch mode.

Can I install HybridCLR through this skill?

No, installation is deliberately not exposed because it clones two git repositories and copies the editor il2cpp tree with no progress or cancellation. Use the HybridCLR/Installer window in the Editor; hybridclr_install_status only reports the install state.