yooasset-design

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

1.7k|162|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/Besty0728/Unity-Skills --skill yooasset-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yooasset-design
Source: https://github.com/Besty0728/Unity-Skills/tree/main/SkillsForUnity/unity-skills~/skills/yooasset-design
Command: npx skills add https://github.com/Besty0728/Unity-Skills --skill yooasset-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

AI agents frequently hallucinate outdated or incorrect YooAsset API calls, producing Unity code that fails to compile, leaks asset bundles, or breaks at runtime. This Skill grounds every recommendation in the actual YooAsset v2.3.18 source code with file and line citations.

Core Features & Use Cases

  • Lifecycle Guidance: Covers the full YooAsset workflow — initialization, PlayMode selection, asset/scene/raw-file loading, handle release, patch updates, and build pipeline configuration.
  • Pitfall Checklist: Ships a 30-item checklist of the mistakes AI agents most often introduce, plus a legacy-API migration table of pre-2.3.18 calls that must not be emitted.
  • Use Case: When asked to write a hot-update boot sequence for a Unity game, the Skill produces the correct YooAssets.InitializeCreatePackageInitializeAsync(HostPlayModeParameters)RequestPackageVersionAsyncUpdatePackageManifestAsync → downloader sequence with proper handle release.

Quick Start

Use the yooasset-design skill to write a YooAsset host-play-mode 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. Gate all load calls on InitializeStatus equaling Succeed.

How do I load assets with YooAsset in Unity?

Use package.LoadAssetAsync<T>(location) to get an AssetHandle, then yield return it, await handle.Task, or subscribe to handle.Completed. Always call handle.Release() when finished so the bundle refcount drops.

Which YooAsset PlayMode works on WebGL?

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

Why does my YooAsset bundle never unload?

Bundles stay resident because a handle was never released, keeping the refcount above zero. Pair every load call with handle.Release(), then call UnloadUnusedAssetsAsync or enable AutoUnloadBundleWhenUnused.

What YooAsset APIs were removed in version 2.3.16 and later?

The downloader timeout parameter was removed in 2.3.16, replaced by the DOWNLOAD_WATCH_DOG_TIME file system parameter. IFilterRule implementations must now expose a FindAssetType property, and UpdatePackageVersionAsync never existed — use RequestPackageVersionAsync.