skills.rest
pcone-mm
pcone-mmCOMMUNITY
Explore all skills by this author →
GitHub

unity-yooasset

Automates YooAsset bundle builds, collector configuration, and build report analysis in Unity Editor.

2|Updated May 18, 2026
Search Tags:#unity#build pipeline#editor automation#build report#yooasset#hot update#asset bundle
One-click install
npx skills add https://github.com/pcone-mm/NewFPG --skill unity-yooasset-pcone-mm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-yooasset
Source: https://github.com/pcone-mm/NewFPG/tree/main/.agents/skills/unity-skills/skills/yooasset
Command: npx skills add https://github.com/pcone-mm/NewFPG --skill unity-yooasset-pcone-mm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing YooAsset hot-update workflows in Unity involves repetitive Editor operations: configuring Collector packages and groups, running bundle builds, parsing BuildReport files, and validating runtime behavior in PlayMode. This Skill automates those Editor-side tasks through a consistent set of API-backed operations validated against YooAsset 2.3.18. ## Core Features & Use Cases - Bundle Build & Simulation: Build asset bundles via ScriptableBuildPipeline or RawFileBuildPipeline, or run fast EditorSimulateMode virtual builds with no file I/O. - Collector Configuration CRUD: Create and modify Collector packages, groups, and collectors with validated rule class names, then persist the AssetBundleCollectorSetting asset. - BuildReport Analysis: Load .report files to list bundles and assets, inspect dependency graphs, compare two reports, and find unreferenced assets for cleanup. - Runtime Validation: Launch async PlayMode jobs that initialize EditorSimulateMode, test asset loading and downloader status, and poll results. - Use Case: A developer says "打AB包" — the Skill configures collectors for Assets/GameRes/UI, runs a simulate build to verify, executes the real LZ4-compressed build, then analyzes the resulting .report for oversized bundles and orphan assets. ## Quick Start Ask the AI to check whether YooAsset is installed, then build bundles for the DefaultPackage and analyze the generated build report for the largest bundles.

Frequently Asked Questions about unity-yooasset

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

FAQPage Schema
How do I build YooAsset bundles in Unity Editor?▼

Use yooasset_build_bundles with a packageName, packageVersion, and pipeline such as ScriptableBuildPipeline. It writes output to <projectPath>/Bundles/<PackageName>/<Version> and supports options like LZ4 compression, HashName file naming, and incremental builds via clearBuildCache.

How to configure YooAsset AssetBundle Collector packages and groups?▼

Create a package with yooasset_create_collector_package, add groups with yooasset_create_collector_group, then attach collectors via yooasset_add_collector using rule class names like AddressByFileName and PackDirectory. Finish with yooasset_save_collector_config to persist the settings asset.

Which YooAsset versions are supported?▼

The Skill targets YooAsset 2.3.18 and requires a minimum of 2.3.15, enforced by an asmdef versionDefines entry. Earlier versions use an incompatible manifest format, and users on 2.3.15 or 2.3.16 should upgrade before relying on verifyBuildingResult due to a CRC bug fixed in 2.3.17.

Why does every YooAsset skill return a NoYooAsset error?▼

All skills except yooasset_check_installed require the YOO_ASSET compile define, which only exists when the com.tuyoogame.yooasset package is installed. Install or upgrade the package through Package Manager, let Unity recompile, then retry the operation.

How do I analyze a YooAsset BuildReport file?▼

Load the .report file with yooasset_load_build_report, then list bundles or assets with pagination and sorting, inspect dependency graphs, or compare two reports for size changes. The report lives next to the bundles as <PackageName>_<PackageVersion>.report, not the .json manifest.

Can I validate YooAsset assets at runtime without a real build?▼

Yes, yooasset_runtime_validate_package starts an async PlayMode job using EditorSimulateMode that initializes the package, optionally loads and releases one asset, and checks downloader status. Poll the result with yooasset_runtime_get_validation_result and clean up with yooasset_runtime_cleanup.

Related Skills

Explore More Software Engineering Skills→
yuse168yuse168

unity-yooasset

Automates YooAsset bundle builds, collector configuration, and build report analysis in Unity Editor.

Community
Advanced
Besty0728Besty0728
1.7k

yooasset-design

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

Community
Advanced
krl76krl76

unity-yooasset-design

Define YooAsset v2.3.18 design constraints for initialization, asset loading, and patch flows.

Community
Advanced
usesofiausesofia

git-merge

Fetch origin/main, merge it into the current branch, resolve conflicts, run tests, and push.

Official
Intermediate