unity-ecs-patterns

Implement Unity ECS patterns with DOTS, Jobs, and Burst.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/leonardoteodoroo/amino-advanced --skill unity-ecs-patterns-leonardoteodoroo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-ecs-patterns
Source: https://github.com/leonardoteodoroo/amino-advanced/tree/main/.agent/skills/unity-ecs-patterns
Command: npx skills add https://github.com/leonardoteodoroo/amino-advanced --skill unity-ecs-patterns-leonardoteodoroo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unity developers often struggle to implement high-performance, data-oriented game logic without a clear pattern.

Core Features & Use Cases

  • Basic ECS Setup: establish pure data components and minimal systems to bootstrap ECS-driven gameplay.
  • Systems with ISystem (Recommended): leverage Burst-compiled, unmanaged systems for maximum performance.
  • Entity Queries: define efficient queries to iterate over relevant entities.
  • Entity Command Buffers (ECB): safely perform structural changes without stalling the main thread.
  • Aspect (Grouping Components): encapsulate related data for cleaner, more maintainable code.
  • Singleton Components: store global, game-wide state in a single, accessible component.
  • Baking (Converting GameObjects): convert traditional GameObjects to ECS entities via authoring components.
  • Jobs with Native Collections: employ Unity.Jobs and native containers for parallel data processing.

Quick Start

Open a new Unity project, enable DOTS packages, and start with the Basic ECS Setup pattern to bootstrap an ECS-based workflow.

Frequently Asked Questions about unity-ecs-patterns

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

FAQPage Schema
How do I convert my OOP GameObjects to ECS entities in Unity DOTS?

To convert GameObjects to ECS entities in Unity DOTS, use the baking workflow with authoring components. This pattern translates traditional object-oriented data into pure ECS entities, streamlining the transition for high-performance simulations.

What is the best way to handle structural changes in Unity ECS without stalling the main thread?

The best way to handle structural changes in Unity ECS without stalling the main thread is using Entity Command Buffers (ECB). ECB safely queues entity modifications, preventing performance bottlenecks during gameplay logic execution.

Can I use Unity Jobs and Native Collections for parallel processing with ECS?

Yes, you can use Unity Jobs and Native Collections for parallel data processing within ECS. This pattern leverages Unity.Jobs and native containers alongside Burst compilation to maximize CPU-bound logic throughput.

When should I use ISystem over traditional systems in Unity DOTS?

Use ISystem in Unity DOTS when you need maximum performance from Burst-compiled, unmanaged systems. This pattern is recommended for high-entity-count simulations to efficiently iterate over relevant data without managed memory overhead.

Does Unity ECS support global game state management?

Yes, Unity ECS supports global game state management through Singleton components. This pattern stores game-wide state in a single, accessible component, ensuring efficient data access across multiple systems and game genres.

How do I group related Unity ECS components for cleaner code?

To group related Unity ECS components for cleaner code, use the Aspect pattern. This approach encapsulates related data together, making your data-oriented game logic more maintainable and easier to query within your systems.