跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
其他技能

bevy-adapt-2d-to-3d

Docs-first stub for moving a Bevy game from 2D to 3D. Godot counterpart: godot-adapt-2d-to-3d. Keywords: Bevy, 2D, 3D, adapt, camera, sprite.

thedivergentai · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add thedivergentai/Game-Design-Agentic-Skills --skill bevy-adapt-2d-to-3d

技能说明


name: bevy-adapt-2d-to-3d description: "Docs-first stub for moving a Bevy game from 2D to 3D. Godot counterpart: godot-adapt-2d-to-3d. Keywords: Bevy, 2D, 3D, adapt, camera, sprite."

Bevy adapt 2D to 3D (docs-first stub)

Not a full port. Docs-first stub. Godot counterpart: godot-adapt-2d-to-3d.

When to use

Load this when a 2D design should gain a 3D camera and meshes. Keep gameplay components. Swap render and motion representations.

ECS shape

  • Cameras: Camera2d and Camera3d are already documented on bevy-camera-systems. An entity should not keep both as if they were one camera mode unless that skill says so.
  • Draw: Sprite is 2D. Meshes and StandardMaterial are 3D (bevy-3d-materials).
  • Features: the crate page separates 2d and 3d profiles. Enabling 3D does not delete 2D types.
  • Motion: bevy-character-movement stays the locomotion skill. A 3D velocity is still your component until a solver exists.

Godot idea to Bevy idiom

IdeaBevy idiom (idea only)
Sprite actorA mesh entity plus the same gameplay components.
2D cameraCamera3d via bevy-camera-systems.
Tile worldNo tilemap type. See bevy-tilemap and bevy-3d-world-building.

Gaps

  • A conversion helper that rewrites entities from 2D to 3D was not opened.
  • Physics solver choice is still open on both physics skills.

Expert Knowledge Delta

Library target in prose: Bevy 0.20.0. Lattice URLs stay unversioned.

Opened canon only: Component, Resource, Query, Commands, Startup, Update, Fixed / FixedMain (bevy::time), .chain(), Plugin, DefaultPlugins, MinimalPlugins. Messages and observers are an ownership slot. This file does not invent their struct APIs. Systems run in parallel unless .chain() orders the ones that conflict.

Who owns state

PieceOwnerWho may mutateSchedule
Data on one entityComponentOne system via QueryUpdate or FixedMain
One value for the whole appResourceOne systemStartup to insert, then the schedule that reads it
SpawnCommandsThe spawning systemStartup for the initial world; later schedules for runtime spawn
Order that must not race.chain()The chained systems onlySame schedule
Plugin boundaryPluginbuild registers systems and resourcesBefore the app runs

Borrow rule: two systems that both mutably query the same component must be ordered (.chain()) or split so only one writes. Unrelated systems stay parallel. That is the ECS page rule, not a guess at a system-set API.

Decision

If you needDo thisDo not
Per-entity dataComponent + QueryA Godot node script
App-wide config or clockResourceCopy the value onto every entity
Stable simulation stepFixedMain and the Fixed clockTie simulation to raw frame Update
Startup spawnCommands in StartupSpawn from a render system
Cross-system notice that is not shared stateMessage or observer slot in bevy-events-messagingA new event type invented in this file
An API this skill did not openA Gaps rowA fabricated crate (solver, navmesh module, net, XR)

Load references/a-gate-notes.md for the same table plus the gap rule.

NEVER

  • Do not put /0.20.0/ in lattice URLs. WHY: permalinks stay on latest. The 0.20.0 pin belongs in prose once.

  • Do not mutably query the same component from two unordered systems. WHY: the schedule runs systems in parallel unless .chain() orders them.

  • Do not invent a physics, navigation, networking, or XR crate here. WHY: those rows are gaps, blocked, or revisit.

  • No Godot node convert-to-3D operations. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

  • No Godot types in Bevy code. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

  • No invented APIs or unnamed third-party crates as the chosen solver. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

  • No Creation Station content. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

  • No umbrella skill over Godot and Bevy. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

  • Do not mark this row ported. It is docs_mapped. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

Reference

docs.rs links use the unversioned latest permalink. The library pin on bevy-master stays 0.20.0.

Official Documentation

  • Migration guides - Unversioned hop index.
  • bevy crate - Unversioned API index. Feature list opened for 0.20.0.
  • Assets - Official asset catalog. No third-party crate was selected.
  • Examples - Example tree on the latest branch.
  • ECS - Component, systems, Query, Startup, Update, and .chain().
  • Plugins - Plugin, DefaultPlugins, MinimalPlugins, and add_plugins.

Related Skills

Prerequisites

Complements

阅读完整来源 ↗