wave7-system-api-managed-api-query

Query managed ECS components and UnityEngine objects via SystemAPI.ManagedAPI.

6|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/dyCuong03/unity-agent-team --skill wave7-system-api-managed-api-query
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wave7-system-api-managed-api-query
Source: https://github.com/dyCuong03/unity-agent-team/tree/main/.claude/skills/unity-dots/wave7-system-api-managed-api-query
Command: npx skills add https://github.com/dyCuong03/unity-agent-team --skill wave7-system-api-managed-api-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you query managed ECS component data and UnityEngine objects using the correct non-Burst APIs, avoiding invalid patterns that won’t compile or will crash performance.

Core Features & Use Cases

  • Correct managed querying: Use SystemAPI.ManagedAPI.Query for managed components/UnityEngine types and SystemAPI.Query for mixed managed + blittable access in SystemBase.
  • Singleton managed access: Use SystemAPI.ManagedAPI.GetSingleton to retrieve managed singleton configuration per frame or per update.
  • Burst-safe guidance: Prevent illegal managed API usage inside [BurstCompile] systems and keep managed access on the intended (main-thread) execution path.
  • Practical placement rules: Place hybrid/managed sync systems in groups like PresentationSystemGroup or a dedicated HybridSyncGroup.

Quick Start

Ask the AI to provide a SystemBase snippet that reads a managed singleton with SystemAPI.ManagedAPI.GetSingleton and queries entities with a mixed managed + blittable SystemAPI.Query, ensuring the code is not Burst-compiled.

Frequently Asked Questions about wave7-system-api-managed-api-query

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

FAQPage Schema
How do I query managed components in Unity ECS without Burst compile errors?▼

To query managed components in Unity ECS without Burst compile errors, use SystemAPI.ManagedAPI.Query inside a SystemBase and ensure the system is not marked with [BurstCompile]. This keeps managed access on the main thread.

What is the correct way to access a managed singleton configuration in Unity DOTS?▼

The correct way to access a managed singleton configuration in Unity DOTS is using SystemAPI.ManagedAPI.GetSingleton. This retrieves managed IComponentData safely per frame without violating Burst safety restrictions.

Can I use SystemAPI.Query for mixed managed and blittable ECS components?▼

Yes, you can use SystemAPI.Query for mixed managed and blittable ECS components within a SystemBase. This allows reading and writing hybrid per-entity state while maintaining correct non-Burst execution paths.

Where should I place a hybrid sync system for GameObject-related behavior in ECS?▼

You should place a hybrid sync system for GameObject-related behavior in ECS within the PresentationSystemGroup or a dedicated HybridSyncGroup. This ensures managed UnityEngine components sync correctly on the main thread.

Why does my Unity DOTS system crash when accessing UnityEngine components?▼

Your Unity DOTS system crashes when accessing UnityEngine components because managed types cannot be used in Burst-compiled systems. You must use SystemAPI.ManagedAPI and disable Burst compilation for that specific system.