wave8-ijobchunk-use-enabled-mask-guard

What problem does it solve?

This Skill helps you correctly handle IEnableableComponent bitmasks in Unity ECS IJobChunk jobs so you never process disabled entities or accidentally skip enabled ones.

Core Features & Use Cases

• Correct enabled-entity iteration: Uses the useEnabledMask flag and ChunkEntityEnumerator to iterate only enabled entities within a chunk.
• Safe performance-aware fast path: Falls back to a simple for loop when useEnabledMask is false to avoid unnecessary mask overhead.
• Job-choice guidance: Recommends using IJobEntity when possible because it handles enableable masks automatically, and uses this guard only when IJobChunk is required.

Use Case Example: When building a state-machine style simulation where some entities (e.g., Active/Sleeping/Dead variants) are enableable, applying this guard ensures only active (enabled) entities get updated each frame.

Quick Start

Tell your AI assistant to review your IJobChunk implementation and ensure it iterates enabled entities using useEnabledMask and ChunkEntityEnumerator when the query includes any IEnableableComponent.