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.