yooasset-design

Guides correct usage of YooAsset 2.3.18 APIs for Unity asset bundle management.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing YooAsset code from memory leads to hallucinated APIs, missed breaking changes (like the 2.3.16 IFilterRule.FindAssetType requirement), and lifecycle bugs such as leaked handles or mismatched PlayMode parameters. This Skill grounds every YooAsset decision in the actual v2.3.18 source with file-and-line citations. ## Core Features & Use Cases - Source-verified API references: Covers initialization, PlayModes, FileSystem parameters, loading, handles, build pipeline, and downloader operations with exact signatures and line anchors. - Pitfall checklist: 30 common mistakes plus a legacy-API migration table listing pre-2.3.18 calls that must not be emitted. - Canonical templates: Ready-to-adapt boot, build, load, and teardown code patterns for EditorSimulate, Offline, Host, Web, and Custom play modes. - Use Case: When asked to write a YooAsset hot-update flow, consult the update and downloader references to produce the correct RequestPackageVersionAsync → UpdatePackageManifestAsync → CreateResourceDownloader sequence instead of hallucinating removed APIs. ## Quick Start Use the yooasset-design skill to write a correct YooAsset 2.3.18 initialization and asset loading flow for my Unity project.

Frequently Asked Questions about yooasset-design

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

FAQPage Schema
How do I initialize YooAsset in a Unity project?

Call YooAssets.Initialize() once per process, then create a package with YooAssets.CreatePackage and await package.InitializeAsync with the parameters subclass matching your play mode. Loading calls throw until InitializeStatus reaches Succeed.

How do I implement hot update with YooAsset HostPlayMode?

Use HostPlayModeParameters with buildin and cache FileSystemParameters, then run RequestPackageVersionAsync, UpdatePackageManifestAsync, and CreateResourceDownloader in that order. Release all handles and call UnloadAllAssetsAsync before updating the manifest.

Does YooAsset 2.3.18 support WebGL builds?

Only WebPlayMode is permitted on WebGL; HostPlayMode, OfflinePlayMode, and EditorSimulateMode all throw exceptions on that platform. Use WebServerFileSystemParameters plus optionally WebRemoteFileSystemParameters for a remote CDN.

Why does my YooAsset IFilterRule fail to compile?

Since version 2.3.16, IFilterRule requires a FindAssetType property in addition to IsCollectAsset. Add a string property returning a Unity type filter such as "t:Prefab" to fix the compilation error.

Why is my YooAsset bundle never unloaded from memory?

Bundles stay resident while any handle referencing them is unreleased. Call Release() on every load handle, then UnloadUnusedAssetsAsync, or enable AutoUnloadBundleWhenUnused so bundles drop when their refcount hits zero.

Can I load a MonoBehaviour directly with YooAsset LoadAssetAsync?

No, the type guard rejects any type derived from UnityEngine.Behaviour and any non-UnityEngine.Object type. Load the GameObject prefab instead and call GetComponent on the instantiated instance.