AgentSkillsCN

game-engine-patterns

Bevy ECS、bevy_ecs_tiled瓦片地图,以及Avian2d物理引擎的最佳实践。在处理组件、资源、查询、系统、事件、观察者、触发器、状态管理、UI节点、精灵、纹理图集、动画、资产加载、插件、Bundle、Tiled地图、瓦片属性、物理碰撞体、刚体、碰撞层、传感器,或空间查询时使用。

SKILL.md
--- frontmatter
name: game-engine-patterns
description: Best practices for Bevy ECS, bevy_ecs_tiled tilemaps, and Avian2d physics. Use when working with components, resources, queries, systems, events, observers, triggers, state management, UI nodes, sprites, texture atlases, animations, asset loading, plugins, bundles, Tiled maps, tile properties, physics colliders, rigid bodies, collision layers, sensors, or spatial queries.

Game Engine Patterns

Best practices for Bevy 0.18, bevy_ecs_tiled, and Avian2d based on patterns in this codebase.

Bevy

ECS Core

Components, resources, queries, systems, commands, SystemParam. See references/bevy-ecs-core.md

Events & Communication

Events, observers, triggers. See references/bevy-events.md

Scheduling

Run conditions, system ordering. See references/bevy-scheduling.md

State Management

States, state transitions. See references/bevy-state.md

UI

Nodes & layout, flexbox, text, images. See references/bevy-ui.md

Rendering 2D

Sprites, texture atlases, cameras, transforms, z-ordering. See references/bevy-rendering.md

Animation

Sprite animation, timers. See references/bevy-animation.md

Assets

Asset loading, handles, custom loaders. See references/bevy-assets.md

Input

Keyboard input. See references/bevy-input.md

Plugins

Plugin structure, configuration. See references/bevy-plugins.md

Bundles

Custom bundles, required components. See references/bevy-bundles.md

Tiled (bevy_ecs_tiled)

Main Book | API Docs

Map Loading & Events

TiledMapAsset, spawning maps, MapCreated, ColliderCreated. See references/tiled-loading.md

Tile Properties & Data

Custom properties, property-to-component mapping, tilemap components, coordinate conversion. See references/tiled-properties.md

Physics Integration

TiledPhysicsPlugin setup. See references/tiled-physics.md

Avian Physics (avian2d)

API Docs

Rigid Bodies

RigidBody types, locked axes. See references/avian-rigid-bodies.md

Colliders

Collider shapes, compound colliders. See references/avian-colliders.md

Collision Detection

Collision layers, collision events, sensors. See references/avian-collision.md

Spatial Queries

Point queries. See references/avian-queries.md

Movement

Linear velocity. See references/avian-movement.md

Configuration

Physics plugins setup, gravity, length units, debug plugin. See references/avian-config.md