unity-hybridclr
Automate HybridCLR C# hot-update prebuild
How do I install this agent skill?
npx skills add https://github.com/besty0728/unity-skills --skill unity-hybridclrIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides Unity Editor automation for the HybridCLR hot-update package. It manages project settings, compiles hot-update DLLs, and triggers the prebuild pipeline using reflection for cross-version compatibility. No malicious behaviors, obfuscation, or unauthorized exfiltration patterns were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Unity HybridCLR Skills
Editor-side automation for HybridCLR, the native C# hot-update solution for IL2CPP: settings, install probing, hot-update DLL compilation, the prebuild generation pipeline and artifact staging for a YooAsset build. Parameters come from the schema (GET /skills/schema?category=HybridCLR&wire=v2); execution and dryRun rules: root SKILL.md.
This module has no ### skill sections on purpose; long prose lives in the topic files under reference/.
When to use
- Configuring hot-update assemblies and HybridCLR settings
- Compiling hot-update DLLs or running the generation pipeline
- Generating
AOTGenericReferences.cs/link.xml - Diagnosing the HybridCLR setup
- Staging hot-update output for a YooAsset bundle build
Rules
- Requires
com.code-philosophy.hybridclr>=8.12.0 <10.0.0and the IL2CPP backend. Unity support follows the installed release: see version scope. - Only
hybridclr_statusworks without the package; every other skill returnsMISSING_PACKAGEwith install instructions. Detection is pure reflection, so no recompile is needed after installing. - An out-of-range package version makes every skill, status included, return
SKILL_ERRORwithreason: "unsupported_package_version". Changing the package version is the user's decision. hybridclr_compile_dlls,hybridclr_generate_allandhybridclr_generate_stepare NeverInSemi and block the Editor main thread for minutes:/healthand/jobsstall too. Raise the client timeout to at least 10 minutes; a socket timeout does not cancel them. They are synchronous, with nojobId.- Hot-update code must live in an asmdef listed in
hotUpdateAssemblyDefinitions(or a name inhotUpdateAssemblies). Code outside those assemblies is AOT and needs a new player build. - Array parameters replace, they do not merge: read
hybridclr_settings_getfirst and pass the full intended array. - Run
hybridclr_validate_setupbefore generating:errorsblock hot update;warningsare normal early in setup. - Workflow undo is partial for generation:
hybridclr_settings_setrestores fully, the generation steps restore only the Assets-side artifacts and the hot-update DLL directory. Re-run the pipeline instead of relying on undo. - Read the critical rules before the first generation or settings write.
Pitfalls
hybridclr_installandhybridclr_initdo not exist.hybridclr_install_statusonly reports. Install from the HybridCLR/Installer window or through unity-cli (limitations).hybridclr_build_playeris not in this module: usebuild_playeror unity-cli.hybridclr_load_metadataandhybridclr_load_assemblydo not exist: write the runtime loading in game code.- Do not run
hybridclr_generate_allbefore every bundle rebuild; it is a pre-player-build step (workflow). - Do not pass
extension=".dll"tohybridclr_copy_hotupdate_dlls; the skill rejects it, because Unity would load staged DLLs as managed plugins. - On 9.x, do not pass
patchAOTAssemblies,hotUpdateDllCompileOutputRootDirorstrippedAOTDllOutputRootDirtohybridclr_settings_set, and do not runclean_il2cpp_cache; on 8.x, do not runmethod_bridge_empty. The call returnsSEMANTIC_INVALIDand writes nothing.
Skills Overview
| Skill | Purpose |
|---|---|
hybridclr_status | Reflection probe and apiLine (8.x / 9.x); call first |
hybridclr_install_status | Local il2cpp_plus install state and supported Unity versions |
hybridclr_get_paths | Resolve input and output paths for a build target |
hybridclr_settings_get | Read HybridCLRSettings and the resolved assembly lists |
hybridclr_settings_set | Write settings (only the passed parameters change) |
hybridclr_validate_setup | Pre-flight check: errors (blocking) and warnings (advisory) |
hybridclr_compile_dlls | Compile hot-update assemblies into the target's DLL directory (blocking) |
hybridclr_generate_all | Full prebuild pipeline for the active build target (blocking) |
hybridclr_generate_step | One pipeline step (step names as parameter values: il2cpp def, link xml, AOT DLLs, method bridge, AOT generic reference, plus clean IL2CPP cache on 8.x or method bridge empty on 9.0.2+) |
hybridclr_get_hotupdate_dlls | List compiled DLLs, reconciled with the configured list (missing, unexpected) |
hybridclr_copy_hotupdate_dlls | Stage DLLs (optionally AOT DLLs) into Assets/ with a .bytes extension |
hybridclr_aot_generic_refs | Read generated AOTGenericReferences.cs and its AOT list |
Topics
- workflow: one-time setup, the hot-update loop, the YooAsset boundary
- critical rules: settings, paths, array semantics, main-thread blocking
- version scope: 8.x vs 9.x differences, reflection anchors, upstream AI skills
- limitations: no install skill, undo scope, unity-cli fallback menu table
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-hybridclr">View unity-hybridclr on skillZs</a>