yooasset-design

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing YooAsset code in Unity often leads to subtle bugs: leaked handles, wrong PlayMode parameters, hallucinated legacy APIs, and broken build pipelines. This Skill provides source-verified reference documentation for YooAsset v2.3.18 so AI agents and developers emit correct initialization, loading, updating, building, and filesystem code. ## Core Features & Use Cases - Lifecycle & PlayMode guidance: Covers YooAssets.Initialize, ResourcePackage creation, and the five EPlayMode parameter classes with platform guards for WebGL and Editor. - Loading, handles, and refcounting: Documents the five load families, handle release rules, and AutoUnloadBundleWhenUnused semantics with anti-pattern examples. - Build & filesystem reference: Details AssetBundleBuilder, BuildParameters, IFilterRule (2.3.16 breaking change), FileSystemParameters constants, and IRemoteServices/IDecryptionServices contracts. - Pitfalls checklist: Lists 30 common AI-generated mistakes plus a legacy API migration table for pre-2.3.18 calls. - Use Case: When asked to write a YooAsset hot-update flow, consult this Skill to produce the correct RequestPackageVersionAsync → UpdatePackageManifestAsync → CreateResourceDownloader sequence instead of hallucinated APIs. ## Quick Start Use the yooasset-design skill to write a correct YooAsset HostPlayMode 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 Unity with HostPlayMode?

Call YooAssets.Initialize() once, create a package via YooAssets.CreatePackage, then call InitializeAsync with HostPlayModeParameters containing buildin and cache FileSystemParameters. Wait for the operation to reach Succeed status before any load calls.

How do I load assets with YooAsset LoadAssetAsync?

Call package.LoadAssetAsync<T>(location) on an initialized ResourcePackage, then yield return the handle, await handle.Task, or subscribe to handle.Completed. Always call handle.Release() after use so the bundle refcount drops.

Does YooAsset support WebGL builds?

Yes, but only WebPlayMode is permitted on WebGL; HostPlayMode, OfflinePlayMode, and EditorSimulateMode throw exceptions. Use WebPlayModeParameters with WebServerFileSystemParameters and optionally WebRemoteFileSystemParameters for a remote CDN.

Why does my YooAsset IFilterRule fail to compile in 2.3.18?

Since YooAsset 2.3.16, IFilterRule requires a FindAssetType property in addition to IsCollectAsset. Add something like public string FindAssetType => "t:Prefab"; to your implementation to fix compilation.

What is the correct YooAsset hot-update flow order?

Request the version with RequestPackageVersionAsync, then call UpdatePackageManifestAsync with that version, then CreateResourceDownloader and BeginDownload. Release all handles and call UnloadAllAssetsAsync before updating the manifest to avoid warnings.

Why does YooAsset LoadAssetAsync with a Behaviour type fail?

YooAsset rejects any type derived from UnityEngine.Behaviour because components cannot be standalone assets. Load the GameObject prefab instead and call GetComponent<T>() on the instantiated instance.