unity-hybridclr

Automates HybridCLR C# hot-update prebuild tasks in Unity Editor via reflection.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-hybridclr-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-hybridclr
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/hybridclr
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-hybridclr-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Configuring HybridCLR hot-update assemblies, compiling hot-update DLLs, and generating AOTGenericReferences/link.xml in Unity involves many error-prone manual Editor steps. This Skill automates the entire HybridCLR prebuild pipeline through reflection-based Editor calls, so it works whether or not the package is installed. ## Core Features & Use Cases - Settings and diagnostics: Read and write HybridCLRSettings, probe il2cpp_plus install state, and run pre-flight validation that separates blocking errors from advisory warnings. - Compile and generation pipeline: Compile hot-update DLLs per build target, run the full GenerateAll pipeline or individual steps (link.xml, AOT DLLs, method bridge, AOT generic references). - YooAsset integration: Stage compiled DLLs as .bytes TextAssets into a collector directory so YooAsset can pack them into bundles for the iterative hot-update loop. - Use Case: After editing hot-update C# code, compile the DLLs for Android, stage them into Assets/HotUpdateDlls, and hand off to YooAsset bundle building without opening any HybridCLR Editor menus. ## Quick Start Ask the AI to run hybridclr_status first to check the HybridCLR installation and settings, then follow the validate, compile, and copy workflow for your build target.

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 a buildTarget such as Android to run CompileDllCommand.CompileDll, which outputs DLLs under HybridCLRData/HotUpdateDlls/<target>. Verify results with hybridclr_get_hotupdate_dlls and confirm the missing list is empty.

How do I ship HybridCLR hot-update DLLs with YooAsset?

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

Does HybridCLR work with the Mono scripting backend?

No, HybridCLR requires the IL2CPP scripting backend. The hybridclr_validate_setup skill reports Mono configurations as a blocking error, and Unity 2019.4 or later is required, with 2022.3 recommended.

When should I re-run HybridCLR GenerateAll?

Re-run hybridclr_generate_all only when AOT-side code changes, when you add or remove a hot-update assembly, or before a new player build. The iterative hot-update loop only needs compile_dlls and copy_hotupdate_dlls, not a full regeneration.

Why does hybridclr_compile_dlls block the Unity Editor?

HybridCLR compile and generate commands are synchronous main-thread Unity APIs with no async job boundaries, so the Editor and the skill queue stall for minutes. Raise the client timeout to at least 10 minutes, or run the equivalent menu methods headless via unity-cli batch mode.

Can I install HybridCLR through this skill module?

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.