skills.rest
Darth-Carrotpie
Darth-CarrotpieCOMMUNITY
Explore all skills by this author →
GitHub

unity-hybridclr

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

Updated Oct 13, 2025
Search Tags:#unity#editor automation#il2cpp#yooasset#hot update#hybridclr#dll compilation
One-click install
npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-hybridclr-darth-carrotpie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-hybridclr
Source: https://github.com/Darth-Carrotpie/ProxyCore/tree/main/.agents/skills/unity-skills/skills/hybridclr
Command: npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-hybridclr-darth-carrotpie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up and maintaining HybridCLR hot updates in Unity involves many error-prone manual steps: editing HybridCLRSettings, verifying the il2cpp_plus installation, 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 without any compile-time dependency on the HybridCLR package. ## Core Features & Use Cases - Settings and environment management: Read and write HybridCLRSettings, probe the il2cpp_plus install state, resolve all input/output paths, and run a pre-flight validation that separates blocking errors from advisory warnings. - 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. - YooAsset integration: Stage compiled DLLs into an Assets directory renamed to .bytes so a YooAsset collector can pack them, and inspect AOTGenericReferences.cs to keep patchAOTAssemblies in sync. - 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 trigger a YooAsset bundle build — all without opening HybridCLR menus. ## Quick Start Ask the agent to check the HybridCLR setup status and validate the current hot-update configuration for the active 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?▼

Use the hybridclr_compile_dlls skill with a build target such as Android to run CompileDllCommand.CompileDll, which outputs DLLs under HybridCLRData/HotUpdateDlls/<target>. It blocks the Editor main thread, so allow several minutes and verify results with hybridclr_get_hotupdate_dlls.

How to ship HybridCLR hot-update DLLs with YooAsset?▼

Stage compiled DLLs into an Assets directory using hybridclr_copy_hotupdate_dlls with extension .bytes 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 because it patches libil2cpp to load metadata for AOT assemblies. The hybridclr_validate_setup skill reports a blocking error when the project is not configured for IL2CPP.

Why does hybridclr_generate_all take so long and freeze Unity?▼

Generate/All compiles DLLs, strips AOT assemblies via a scripts-only BuildPlayer, and generates C++ bridges, all synchronously on the Editor main thread. Raise the client timeout to at least 10 minutes, or run the equivalent menu methods headless through unity-cli in batch mode.

When should I re-run HybridCLR Generate/All?▼

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

Can this skill install HybridCLR or il2cpp_plus automatically?▼

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; hybridclr_install_status only reports the current install state.

Related Skills

Explore More Software Engineering Skills→
XeldarAlzXeldarAlz
3

assembly-definitions

Create and manage Unity .asmdef files to isolate code into independent assemblies.

Community
Advanced
RayzerrekRayzerrek

unity-yooasset

Build and analyze YooAsset bundle workflows for Unity projects.

Community
Advanced
Besty0728Besty0728
1.7k

unity-cli

Automates Unity Editor cold starts, headless tests, batch runs, and builds via the Unity CLI.

Community
Advanced
Besty0728Besty0728
1.7k

unity-hybridclr

Automate HybridCLR C# hot-update prebuild pipelines in the Unity Editor.

Community
Advanced