g4borg
8988b16bee
- Fix `ref` keyword used as variable name in code examples - Fix "retries next tick" → systems continue on normal schedule - Fix `State::set()` → `NextState::set()` in upgrade skill - Fix `SceneRoot` → `WorldAssetRoot` for 0.19 consistency - Fix Replace lifecycle event description (overwritten, not removed) - Fix grep patterns (quoting, trailing spaces) - Remove third-party physics/networking content (not Bevy built-ins)
bevy
Skills for developing with the Bevy game engine in Rust.
Bevy's rapid release cycle (0.16 through 0.19 in ~18 months) introduces fundamental API renames and semantic shifts between versions. LLMs confidently generate code against outdated patterns — Parent instead of ChildOf, Event instead of Message, use_state idioms that no longer exist. These skills exist to correct that.
Skills
- bevy-0.19 — Implementation helper for writing correct, idiomatic Bevy 0.19 code. Covers plugins, ECS, hierarchy, events/observers, input, camera, and production gotchas. Triggers on Bevy 0.19 Rust code. Contains a compact always-loaded cheat sheet plus a
references/folder for deeper topic dives. - bevy-upgrade — Version migration guide for upgrading between Bevy releases. Covers the breaking-change chain (0.16 through 0.19+) with rename tables, semantic shifts, and step-by-step migration patterns. Invoked by the
bevy-0.19skill when an upgrade task is detected, or directly when the user asks to migrate.
Research
The research that informed this plugin's design lives in docs/workpad/research/bevy-skill-research/. Key reports:
| Report | Topic |
|---|---|
| 01-plugins | Plugin trait lifecycle, dependencies, states, schedules |
| 02-ecs-core | Components, resources, systems, queries, commands |
| 03-hierarchy | ChildOf relationships, spawning/querying children |
| 04-events-observers | Message/Event split (0.18), observers, lifecycle triggers |
| 05-input | Keyboard, mouse, gamepad, touch input patterns |
| 06-camera-gotchas | Camera setup, rendering, coordinates |
| 07-lessons-from-production | 15 gotchas from a production Bevy 0.18 multiplayer game |
| 08-landscape-and-design-sketch | Ecosystem survey, architecture options |
Architecture
This plugin follows Approach A from the design research: a compact always-loaded skill (~500 lines) for the critical patterns agents get wrong, with a references/ folder for deeper topic material. Skills are versioned by Bevy minor version (like dioxus-0.7). The bevy-upgrade skill is a companion that handles version migration specifically.
Install
/plugin marketplace add git@git.g4b.org:dirigence/reliquary.git
/plugin install bevy@reliquary
Or in .claude/settings.json:
{
"extraKnownMarketplaces": {
"reliquary": {
"source": { "source": "git", "url": "git@git.g4b.org:dirigence/reliquary.git" }
}
},
"enabledPlugins": { "bevy@reliquary": true }
}