unity-addressables
/unity-addressables
Unity Addressables — AssetReference, async loading, labels, groups, build profiles, remote content, Cloud Content Delivery integration, content catalogs and updates. USE WHEN: replacing `Resources.Load`, async asset loading, scene streaming, remote content, DLC delivery, runtime asset hot-swap, splitting builds for size. DO NOT USE FOR: editor-time asset queries (use AssetDatabase); legacy Asset Bundles workflows (Addressables wraps them).
- Author
- claude-dev-suite ↗
- Repository
- claude-dev-suite ↗
- Licence
- MIT
- Last repository change
- 21.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 21.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Unity Addressables — AssetReference, async loading, labels, groups, build profiles, remote content, Cloud Content Delivery integration, content catalogs and updates. USE WHEN: replacing `Resources.Load`, async asset loading, scene streaming, remote content, DLC delivery, runtime asset hot-swap, splitting builds for size. DO NOT USE FOR: editor-time asset queries (use AssetDatabase); legacy Asset Bundles workflows (Addressables wraps them).
Original author description
Unity Addressables — AssetReference, async loading, labels, groups, build profiles, remote content, Cloud Content Delivery integration, content catalogs and updates. USE WHEN: replacing `Resources.Load`, async asset loading, scene streaming, remote content, DLC delivery, runtime asset hot-swap, splitting builds for size. DO NOT USE FOR: editor-time asset queries (use AssetDatabase); legacy Asset Bundles workflows (Addressables wraps them).
How it works
- Why Addressables (vs Resources / direct refs)
- AssetReference
- Loading by label
- Build profiles
- Content updates (without rebuilding the player)
- Cloud Content Delivery (Unity Gaming Services)
- Anti-patterns
- Production checklist
SKILL.md preview
---
name: unity-addressables
description: |
Unity Addressables — AssetReference, async loading, labels, groups, build
profiles, remote content, Cloud Content Delivery integration, content
catalogs and updates.
USE WHEN: replacing `Resources.Load`, async asset loading, scene streaming,
remote content, DLC delivery, runtime asset hot-swap, splitting builds for
size.
DO NOT USE FOR: editor-time asset queries (use AssetDatabase); legacy Asset
Bundles workflows (Addressables wraps them).
allowed-tools: Read, Grep, Glob, Write, Edit
---
# Unity Addressables
## Why Addressables (vs Resources / direct refs)
- `Resources/` includes everything in build → forces every asset in memory.
- Direct prefab references → load immediately with the scene.
- Addressables: lazy, async, remote-capable, content-update-friendly.
## AssetReference
```csharp
public class EnemySpawner : MonoBehaviour {
[SerializeField] private AssetReferenceGameObject enemyPrefab;
[SerializeField] private Transform spawnPoint;
public async void Spawn() {
AsyncOperationHandle<GameObject> handle =
enemyPrefab.InstantiateAsync(spawnPoint.position, Quaternion.identity);
var enemy = await handle.Task;
// listen for destroy → release
enemy.GetComponent<Enemy>().Killed += () => Addressables.ReleaseInstance(enemy);
}
}
```
`InstantiateAsync` reference-counts; release with `ReleaseInstance` to free memory.
## Loading by label
```csharp
var handle = Addressables.LoadAssetsAsync<AudioClip>("music", null);
var clips = await handle.Task; // all assets with label 'music'
// later
Addressables.Release(handle);
```
## Build profiles
- **Development** — local groups, fast iteration.
- **Release** — remote groups (CDN URL), packed bundles.
Set in `Window > Asset Management > Addressables > Profiles`. CI builds invoke `Addressables.BuildPlayerContent()` or `AddressablesPlayerBuildResult`.
## Content updates (without rebuilding the player)
1. Mark a group as **Content Update Restriction = Can Change Post Release**.
2. Build content → produces `addressables_content_state.bin` (commit).
3. Later, `Build > Update a Previous Build` → produces incremental bundles → upload to CDN. Player downloads the new catalog on launch.
## Cloud Content Delivery (Unity Gaming Services)
- Bucket per environment (dev/staging/prod).
- Badge tags ("release-1.2") to pin clients to specific releases.
- Authentication via UGS for entitled content.
## Anti-patterns
| Anti-pattern | Fix |
|---|---|
| `Resources.Load` for big asset graphs | Migrate to Addressables |
| Forgetting to `Release` | Reference-count leaks → run Profiler memory snapshot regularly |
| Massive single group | Split by usage (per-level, per-language, music vs SFX) |
| Sync `WaitForCompletion` on remote loads | Always async; show loading UI |
| Different bundle compression per platform forgotten | Default LZ4 for all desktop/mobile; Uncompressed for WebGL on tiny assets |
## Production checklist
- [ ] No `Resources/` folders left in production code paths
- [ ] Groups split by load pattern
- [ ] Labels used for batch loads (music, vfx-rare, boss-only)
- [ ] CDN URL profile-driven, not hardcoded
- [ ] `addressables_content_state.bin` checked into git
- [ ] CI builds Addressables before player build
- [ ] Memory profiler shows expected residency after scene load
Versions
The database has no other skills named unity-addressables.
Database snapshot: 13.11.2026 · package version dac20100cd58 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90unity-addressables-design
Use when the task is to plan Addressables groups, labels, profiles, and dependency boundaries. - 100unity-platforms
Unity 6 platform targeting and build guide. Use when building for specific platforms, configuring build profiles, using platform scripting defines (#if UNITY_IOS, #if UNITY_ANDROID), optimizing for mobile, WebGL, or consoles, working with Addressables/asset bundles, or choosing… - 100unity-build-platforms
Unity builds — IL2CPP vs Mono, build profiles, addressables-aware builds, Android (Gradle, AAB, Play Asset Delivery), iOS (Xcode post-processing, capabilities), WebGL, console NDA paths (high-level only). USE WHEN: configuring build settings, fixing platform-specific issues,… - 100unity
Unity is a cross-platform game engine for 2D, 3D, AR and VR games, scripted in C# with a component system, Universal Render Pipeline, UI Toolkit, Addressables and DOTS. Use when a user asks to write Unity C# scripts, build a player controller, use ScriptableObjects or… - 100scenario-unity-pipeline-automation
Use when automating a Unity 6.3 content pipeline or build: importing an art drop (FBX, PNG) with AssetPostprocessor rules and naming conventions, generating prefabs or editing scenes from script with correct Undo and SetDirty, Addressables groups, labels and content builds,… - 95unity-development
Unity 6 reference patterns: an architecture decision tree, render pipeline and Addressables migration recipes, Input System patterns, a DOTS quick reference, a common mistakes catalog, component and ScriptableObject event channel patterns, and a generic object pool. Use when…