bevy-migration-0-17-to-0-18
Use when upgrading from Bevy 0.17 to Bevy 0.18, when an LLM writes `EventReader`/`EventWriter`/`Trigger<E>` instead of `MessageReader`/`MessageWriter`/`On<E>`, when `mesh.insert_attribute` fails to compile, when `AmbientLight` no longer works as a resource, or when `Camera { target: ... }` errors on the `target` field. Index of every breaking 0.17→0.18 change.
How do I install this agent skill?
npx skills add https://github.com/chrisgliddon/bevy-skills --skill bevy-migration-0-17-to-0-18Is this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a technical migration guide for the Bevy game engine, providing instructions for upgrading from version 0.17 to 0.18. It covers ECS, rendering, assets, and cargo feature renames. The skill consists of instructional text and code snippets with no evidence of malicious behavior or security vulnerabilities.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Bevy 0.17 → 0.18 — Migration cheat sheet
Released 2026-01-13. Apply top-down — earlier items break later builds if skipped.
When to use this skill
- Compiler errors after a
bevy = "0.17"→bevy = "0.18"bump. - LLM emits 0.17-era API names from training data.
- Auditing a PR for hidden 0.18-incompatible patterns.
- Hot-fixing a downstream crate that hasn't shipped 0.18 yet.
The renames you'll hit first
Observers: Trigger<E> → On<E>
// 0.18 (also 0.17)
fn on_hit(on: On<Damage>) { let _e = on.event(); }
Buffered events: Event → Message
// 0.18
#[derive(Message)] struct Tick;
// app.add_message::<Tick>();
fn read(mut reader: MessageReader<Tick>) { for _ in reader.read() {} }
fn write(mut w: MessageWriter<Tick>) { w.write(Tick); }
Event is now reserved for observed, entity-targeted events (#[derive(EntityEvent)]).
Camera { target: ... } → RenderTarget component
// 0.18
commands.spawn((Camera3d::default(), RenderTarget::Image(handle.into())));
AmbientLight is no longer a resource
// 0.18: global default
app.insert_resource(GlobalAmbientLight { brightness: 2000.0, ..default() });
// Per-camera override:
commands.spawn((Camera3d::default(), AmbientLight { brightness: 5000.0, ..default() }));
MaterialPlugin<M> config moved to trait methods
// 0.18
impl Material for M {
fn enable_prepass() -> bool { false }
fn enable_shadows() -> bool { false }
}
app.add_plugins(MaterialPlugin::<M>::default());
AsBindGroup::label() is now required
impl AsBindGroup for MyMaterial {
fn label() -> &'static str { "MyMaterial" }
}
AssetLoader must #[derive(TypePath)]
#[derive(TypePath)]
struct MyLoader;
impl AssetLoader for MyLoader { /* ... */ }
Mesh::insert_attribute is panicky — prefer try_insert_attribute
// 0.18 safe form — returns Result<(), MeshAccessError>
mesh.try_insert_attribute(Mesh::ATTRIBUTE_POSITION, positions)?;
State::set always triggers a transition
// 0.18: always fires OnExit + OnEnter. Guard with:
next_state.set_if_neq(GameState::Playing);
glTF coordinate conversion replaced
// 0.18
GltfPlugin {
convert_coordinates: GltfConvertCoordinates {
rotate_scene_entity: true,
rotate_meshes: true,
},
..default()
}
Schedule executor
SimpleExecutor was removed. Add .before(), .after(), or .chain() when a
later system must observe commands from an earlier one in the same schedule. The
remaining executors use those dependencies to place ApplyDeferred; ambiguity
detection remains separately configurable. See
references/schedule-renames.md.
Topics
| Topic | Reference |
|---|---|
On<E>, MessageReader/MessageWriter, Entity::index, tick moves, Resource 'static, reflect syntax, hierarchy helpers | references/ecs-renames.md |
RenderTarget component, GlobalAmbientLight, MaterialPlugin, AsBindGroup::label, gizmos, bevy_gizmos_render split | references/render-renames.md |
AssetLoader + TypePath, LoadContext::asset_path, asset_bytes reader pattern, AssetSource channel, try_insert_attribute | references/asset-renames.md |
SimpleExecutor removal, ScheduleBuildError variants, State::set always-fires, or combinator, glTF coordinates | references/schedule-renames.md |
animation → gltf_animation, picking-backend renames, documentation → reflect_documentation, input opt-in | references/cargo-feature-renames.md |
Gotchas
bevy_gizmoswas split. Render-side code now lives inbevy_gizmos_render. Update import paths if you used internals.Resourceno longer allows non-'staticlifetimes. AResourcewith a borrowed field will fail to compile.- Reflect attribute syntax tightened. Only
#[reflect(...)](parens) is accepted; brace/bracket forms are rejected. AnimationTargetsplit into two components. Use(AnimationTargetId(id), AnimatedBy(player)).Atmospherenow references aHandle<ScatteringMedium>— what was a flat struct is now indirect.
See also
bevy-migration-0-18-to-0-19— the next release's rename catalogue.bevy-core-concepts— schedule executor change in detail.bevy-cargo-features— feature rename table.bevy-ecs-systems—Message/MessageReader/MessageWriterergonomics.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/chrisgliddon/bevy-skills/bevy-migration-0-17-to-0-18">View bevy-migration-0-17-to-0-18 on skillZs</a>