Unity Yooasset Design

Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

• Writing or reviewing YooAsset code
• Initializing packages
• Loading assets via handles
• Setting up hot-update/download
• Choosing a play mode
• 编写或审查 YooAsset 代码、初始化 package、用句柄加载资源、配置热更/下载、选择运行模式

YooAsset - Design Rules

Advisory module. Every rule is distilled from YooAsset v2.3.18 (2025-12-04) source at Assets/YooAsset/. Each rule cites a concrete file/line so the reasoning is auditable and the AI does not improvise against stale memory.

Mode: Documentation only — no REST skills to gate; load freely under any operating mode (Approval / Auto / Bypass).

When to Load This Module

Load before writing or reviewing any of:

• YooAssets.Initialize() / CreatePackage() / Destroy() bootstrap code
• default package shortcuts: YooAssets.SetDefaultPackage(...), YooAssets.LoadAssetAsync(...), YooAssets.CreateResourceDownloader(...)
• ResourcePackage.InitializeAsync(...) with any of the 5 EPlayMode variants
• LoadAssetSync/Async, LoadSubAssetsAsync, LoadAllAssetsAsync, LoadRawFileAsync, LoadSceneAsync and their matching Handle usage / release
• Patch flow: RequestPackageVersionAsync → UpdatePackageManifestAsync → CreateResourceDownloader → BeginDownload
• FileSystemParameters construction (Buildin / Cache / Editor / WebServer / WebRemote / custom)
• IDecryptionServices / IRemoteServices / IWebDecryptionServices implementations
• Editor-side AssetBundleBuilder.Run(...) and AssetBundleCollector configuration
• Any code branching on EOperationStatus / EFileClearMode / PackageDetails

Critical Rule Summary (memorize even if you skip the sub-docs)

Sub-doc Routing

Routing to Other Modules

• Asmdef & assembly layout for YooAsset consumers → load asmdef (unity-scripting plugin)
• Async orchestration across multiple YooAsset operations → load async (unity-scripting plugin)
• Architecture-level decisions (Addressables vs YooAsset, single-package vs multi-package) → load architecture (unity-architecture-advisory plugin)
• Performance review of load/release hot paths → load performance (unity-architecture-advisory plugin)

Version Scope

This document targets YooAsset 2.3.18 (2025-12-04). Key recent history:

• 2.3.18 — added UNPACK_FILE_SYSTEM_ROOT file-system parameter, EFileClearMode.ClearBundleFilesByLocations, RawFileBuildParameters.IncludePathInHash.
• 2.3.17 — [CRITICAL] fixed a CRC-validation bug that let corrupted downloads pass verification on 2.3.15/2.3.16. Also fixed a Package-destroy race where an in-flight AssetBundle load could block unload.
• 2.3.16 — removed the downloader timeout parameter (use DOWNLOAD_WATCH_DOG_TIME on the cache file system instead). IFilterRule gained a required FindAssetType property.
• 2.3.15 — bumped the manifest binary format; installers built with 2.3.15+ are not readable by 2.3.14 or earlier clients and vice versa. Added FILE_VERIFY_MAX_CONCURRENCY, StripUnityVersion, preview UseWeakReferenceHandle (under YOOASSET_EXPERIMENTAL).

Source: Assets/YooAsset/CHANGELOG.md:5-275.

Migration Notes (hallucination shield)

When in doubt, read the cited source — not your memory.