Anexo B. Tabla de compatibilidades entre Bevy 0.13 → 0.19

ANEXO B · Material de referencia

"Bevy cambia. El que dice 'no rompe nada' te está mintiendo o no ha leído el CHANGELOG."

— Frase tatuada en el brazo de todo mantenedor de crates que dependen de Bevy.

Este anexo es una tabla de referencia rápida para saber qué API existía en qué versión. No pretende ser exhaustiva (el CHANGELOG de Bevy tiene 1500+ entradas por minor), sino dar la respuesta a las preguntas del tipo "¿esto ya estaba en 0.16?" o "¿esto se rompió en 0.17?" sin tener que leer siete release notes.

**CHANGELOG**: archivo markdown en el repo de un proyecto donde se listan cambios por versión. Bevy lo mantiene escrupulosamente en `bevyengine/bevy/CHANGELOG.md`.
**Breaking change**: cambio que rompe código existente. En semver, requiere bump de MINOR (0.X.0) o MAJOR (X.0.0).
**Feature flag**: ver glosario principal. En este anexo verás `bevy_asset`, `bevy_sprite`, etc., que son las *feature collections* de 0.16+.

B.1 Leyenda

✅ Disponible: la API existe y funciona como se describe.
❌ No existe: la API no está todavía (o ya no está).
⚠️ Breaking change: existe, pero cambió la firma o el comportamiento entre esa versión y la siguiente.
🔄 Sustituido: existe algo equivalente pero con otro nombre (ver columna "Sustituto").

B.2 Tabla principal

API / Concepto	0.13	0.14	0.15	0.16	0.17	0.18	0.19
`Component` derive	✅	✅	✅	✅	✅	✅	✅
`Resource` derive	✅	✅	✅	✅	✅	✅	✅
`Bundle` derive	✅	✅	✅	✅	✅	✅	✅
`Plugin` trait	✅	✅	✅	✅	✅	✅	✅
`PluginGroup` trait	✅	✅	✅	✅	✅	✅	✅
`Required Components`	❌	❌	✅	✅	✅	✅	✅
`#[require(T)]` macro	❌	❌	✅	✅	✅	✅	✅
`Component Hooks` (`on_add`, `on_insert`, `on_discard`, `on_remove`)	❌	❌	✅	✅	✅	✅	✅
`HookContext`	❌	❌	✅	✅	✅	✅	✅
`Observers`	❌	❌	⚠️ parcial	✅	✅	✅	✅
`Observer` derive	❌	❌	❌	✅	✅	✅	✅
`On<T>` trigger event	❌	❌	❌	✅	✅	✅	✅
`EntityWorldMut::trigger`	❌	❌	❌	✅	✅	✅	✅
`Relations` (`bevy_ecs::Relationship`)	❌	❌	❌	❌	✅	✅	✅
`Relationship` derive	❌	❌	❌	❌	✅	✅	✅
`RelationshipTarget` derive	❌	❌	❌	❌	✅	✅	✅
`Pair(From, To)` shorthand	❌	❌	❌	❌	✅	✅	✅
`Linked` filter en Query	❌	❌	❌	❌	❌	✅	✅
`Resources-as-Components` (`#[derive(Component)] impl Resource`)	❌	❌	⚠️ exp.	✅	✅	✅	✅
`Render-Graph-as-Systems`	❌	❌	❌	❌	✅	✅	✅
`Render` schedule expuesto como sistemas	❌	❌	❌	❌	⚠️ parcial	✅	✅
`RenderTarget` separado de Window	❌	❌	❌	❌	✅	✅	✅
`bevy_render::RenderTarget::Image`	❌	❌	❌	❌	✅	✅	✅
`Anchor` como required component	❌	❌	❌	❌	✅	✅	✅
`Text2d` y `Text3d` separados	❌	❌	❌	❌	✅	✅	✅
`TextBundle` reemplazado por `Text + Node + TextFont + TextColor`	❌	⚠️ deprec.	✅	✅	✅	✅	✅
`SpriteBundle` → `Sprite + Transform + Image` (required comps)	❌	❌	❌	✅	✅	✅	✅
`Camera2dBundle` → `Camera2d` solo	❌	⚠️	✅	✅	✅	✅	✅
`Mesh2d` + `MeshMaterial2d` (en lugar de bundle)	❌	❌	⚠️	✅	✅	✅	✅
`Time::delta_secs()`	❌	✅	✅	✅	✅	✅	✅
`Time::delta()` (devuelve Duration)	✅	✅	✅	✅	✅	✅	✅
`FixedUpdate` schedule	✅	✅	✅	✅	✅	✅	✅
`Fixed::delta()` configurable	❌	❌	❌	✅	✅	✅	✅
`Fixed` schedule graph	❌	❌	❌	❌	✅	✅	✅
`Time<()>` vs `Time<Virtual>`	❌	❌	❌	✅	✅	✅	✅
`Input<KeyCode>` → `ButtonInput<KeyCode>`	❌	⚠️ deprec.	✅	✅	✅	✅	✅
`MouseButton` input	✅	✅	✅	✅	✅	✅	✅
`Gamepad` input	✅	✅	✅	✅	✅	✅	✅
`TouchInput` event	✅	✅	✅	✅	✅	✅	✅
`EventReader<T>` / `EventWriter<T>`	✅	✅	✅	✅	✅	✅	✅
`Events<T>` recurso	✅	✅	✅	✅	✅	✅	✅
`EventRegistry` (auto-register)	❌	❌	❌	✅	✅	✅	✅
`app.add_event::<T>()`	✅	✅	✅	✅	✅	✅	✅
`States` derive	✅	✅	✅	✅	✅	✅	✅
`OnEnter` / `OnExit` / `OnTransition` schedules	✅	✅	✅	✅	✅	✅	✅
`NextState<T>` recurso	✅	✅	✅	✅	✅	✅	✅
`SubStates` / `ComputedStates` derive	❌	❌	✅	✅	✅	✅	✅
`run_if(in_state)`	✅	✅	✅	✅	✅	✅	✅
`SystemSet` derive	✅	✅	✅	✅	✅	✅	✅
`SystemSet::chain()`	✅	✅	✅	✅	✅	✅	✅
`in_set(S)` chaining	✅	✅	✅	✅	✅	✅	✅
`apply_deferred` automático	❌	❌	✅	✅	✅	✅	✅
`Commands::entity(e).insert(T)`	✅	✅	✅	✅	✅	✅	✅
`Commands::entity(e).remove::<T>()`	✅	✅	✅	✅	✅	✅	✅
`EntityWorldMut` API robusta	❌	⚠️	✅	✅	✅	✅	✅
`World::entity(e)`	✅	✅	✅	✅	✅	✅	✅
`World::spawn_empty()`	✅	✅	✅	✅	✅	✅	✅
`Query::get_single` / `get_single_mut`	✅	✅	✅	✅	✅	✅	✅
`Query::iter()` y `iter_mut()`	✅	✅	✅	✅	✅	✅	✅
`Query::par_iter()`	✅	✅	✅	✅	✅	✅	✅
`With<T>` / `Without<T>` filters	✅	✅	✅	✅	✅	✅	✅
`Added<T>` / `Changed<T>` filters	✅	✅	✅	✅	✅	✅	✅
`Or<(A, B)>` filter	❌	❌	✅	✅	✅	✅	✅
`Optional<T>` access en Query	❌	❌	❌	✅	✅	✅	✅
`Local<T>` en sistemas	✅	✅	✅	✅	✅	✅	✅
`Res<T>` / `ResMut<T>`	✅	✅	✅	✅	✅	✅	✅
`NonSend<T>` / `NonSendMut<T>`	✅	✅	✅	✅	✅	✅	✅
`Deref` / `DerefMut` en `Query`	✅	✅	✅	✅	✅	✅	✅
`Children` / `Parent` componentes	✅	✅	⚠️ → `ChildOf`	✅	✅	✅	✅
`ChildOf` componente (oficial)	❌	❌	❌	✅	✅	✅	✅
`Propagate` trait para transformaciones	✅	✅	✅	✅	✅	✅	✅
`Transform` y `GlobalTransform`	✅	✅	✅	✅	✅	✅	✅
`Transform::from_xyz()`	✅	✅	✅	✅	✅	✅	✅
`Transform::with_scale()`	✅	✅	✅	✅	✅	✅	✅
`glam::Vec2` / `Vec3` / `Vec4`	✅	✅	✅	✅	✅	✅	✅
`Color::srgb()` / `linear()`	✅	✅	✅	✅	✅	✅	✅
`Color::hsla()`	✅	✅	✅	✅	✅	✅	✅
`Text` componente (separado de estilo)	❌	⚠️	✅	✅	✅	✅	✅
`TextFont` componente	❌	❌	✅	✅	✅	✅	✅
`TextColor` componente	❌	❌	✅	✅	✅	✅	✅
`TextSection` (deprecado)	✅	⚠️ deprec.	❌	❌	❌	❌	❌
`JustifyText` y `LineBreak`	❌	❌	❌	✅	✅	✅	✅
`Node` componente UI	✅	✅	✅	✅	✅	✅	✅
`Style` componente UI	✅	✅	⚠️ → `Node`	✅	✅	✅	✅
`Flex` layout automático	✅	✅	✅	✅	✅	✅	✅
`Grid` layout (experimental)	❌	❌	❌	❌	⚠️ exp.	✅	✅
`bevy_ui` separado	✅	✅	✅	✅	✅	✅	✅
`bevy_picking` crate oficial	❌	❌	❌	❌	✅	✅	✅
`OnPointer` trigger	❌	❌	❌	❌	✅	✅	✅
`AssetServer`	✅	✅	✅	✅	✅	✅	✅
`Assets<T>` storage	✅	✅	✅	✅	✅	✅	✅
`Handle<T>`	✅	✅	✅	✅	✅	✅	✅
`AssetEvent` (Modified, Added, Removed)	✅	✅	✅	✅	✅	✅	✅
`LoadState<T>` para assets	✅	✅	✅	✅	✅	✅	✅
`AssetLoader` trait	✅	✅	✅	✅	✅	✅	✅
`bevy_asset` feature collection	❌	❌	❌	✅	✅	✅	✅
`bevy_audio` feature collection	❌	❌	❌	✅	✅	✅	✅
`bevy_render` feature collection	❌	❌	❌	✅	✅	✅	✅
`bevy_sprite` feature collection	❌	❌	❌	✅	✅	✅	✅
`bevy_text` feature collection	❌	❌	❌	✅	✅	✅	✅
`bevy_pbr` (3D)	✅	✅	✅	✅	✅	✅	✅
`bevy_winit` separado	❌	⚠️	✅	✅	✅	✅	✅
`bevy_window` separado	❌	❌	✅	✅	✅	✅	✅
`Window` component	✅	✅	✅	✅	✅	✅	✅
`Cursor` component	❌	❌	❌	✅	✅	✅	✅
`WindowMode` enum	✅	✅	✅	✅	✅	✅	✅
`Msaa` configurable	✅	✅	✅	✅	✅	✅	✅
`Camera::clear_color`	✅	✅	✅	✅	✅	✅	✅
`Tonemapping`	❌	❌	❌	✅	✅	✅	✅
`ColorGrading` global	❌	❌	❌	❌	❌	✅	✅
`DACGamut` / `OutputColorSpace`	❌	❌	❌	❌	✅	✅	✅
`bevy_gizmos` crate	✅	✅	✅	✅	✅	✅	✅
`Gizmos` resource	✅	✅	✅	✅	✅	✅	✅
`bevy_log` separado	❌	❌	✅	✅	✅	✅	✅
`tracing` integration	✅	✅	✅	✅	✅	✅	✅
`bevy_diagnostic`	✅	✅	✅	✅	✅	✅	✅
`Diagnostics` recurso	✅	✅	✅	✅	✅	✅	✅
`bevy_scene` crate	✅	✅	✅	✅	✅	✅	✅
`DynamicScene` / `Scene`	✅	✅	✅	✅	✅	✅	✅
`DynamicSceneBuilder`	❌	❌	✅	✅	✅	✅	✅
`SceneSpawner`	✅	✅	✅	✅	✅	✅	✅
`Component` derive con `#[reflect(Component)]`	❌	❌	❌	✅	✅	✅	✅
`Reflect` derive	✅	✅	✅	✅	✅	✅	✅
`TypeRegistry`	✅	✅	✅	✅	✅	✅	✅
`bevy_reflect` mejor ergonomics	❌	⚠️	✅	✅	✅	✅	✅
`FromReflect`	✅	✅	✅	✅	✅	✅	✅
`AppTypeRegistry` recurso	✅	✅	✅	✅	✅	✅	✅
`bevy_utils`	✅	✅	✅	✅	✅	✅	✅
`HashSet` / `HashMap` re-exports	✅	✅	✅	✅	✅	✅	✅
`Duration` re-export	✅	✅	✅	✅	✅	✅	✅
`Instant` re-export	✅	✅	✅	✅	✅	✅	✅
`ParallelCommands`	❌	❌	✅	✅	✅	✅	✅
`World::try_run_schedule`	❌	❌	❌	✅	✅	✅	✅
`ScheduleLabel` trait	✅	✅	✅	✅	✅	✅	✅
`IntoScheduleConfigs` (ergonómico)	❌	❌	❌	✅	✅	✅	✅
`SystemBuilder` chaining	❌	❌	❌	✅	✅	✅	✅
`Resource::from_arc` (compartir entre worlds)	❌	❌	❌	❌	✅	✅	✅
`World::send_event`	❌	❌	❌	✅	✅	✅	✅
`Bevy ui render world separado`	❌	❌	❌	❌	✅	✅	✅
`Mesh::insert_attribute`	✅	✅	✅	✅	✅	✅	✅
`Mesh::with_inserted_attribute`	❌	❌	❌	✅	✅	✅	✅
`StandardMaterial`	✅	✅	✅	✅	✅	✅	✅
`MaterialExtension` trait	❌	❌	❌	✅	✅	✅	✅
`Material2d` / `Material3d` plugins	❌	⚠️	✅	✅	✅	✅	✅
`bevy_sprite::Material2d`	❌	❌	✅	✅	✅	✅	✅
`Aabb` component	✅	✅	✅	✅	✅	✅	✅
`Visibility` / `InheritedVisibility`	✅	✅	✅	✅	✅	✅	✅
`ViewVisibility`	✅	✅	✅	✅	✅	✅	✅
`ComputedVisibility` (deprecado)	✅	⚠️	❌	❌	❌	❌	❌
`SpatialBundle`	✅	✅	✅	✅	✅	✅	✅
`bevy_hierarchy` crate	✅	✅	✅	✅	✅	✅	✅
`bevy_state` (oficial)	❌	❌	❌	✅	✅	✅	✅
`StateMachine` (build into Bevy)	❌	❌	❌	❌	❌	❌	❌ (use crate externo)
`bevy_dev_console`	❌	❌	❌	❌	✅	✅	✅
`bevy_ecs_schedule_graphs`	❌	❌	❌	❌	❌	⚠️ exp.	⚠️ exp.
`Mobile` (iOS/Android) support	✅	✅	✅	✅	✅	✅	✅
`Web` (WASM) support	✅	✅	✅	✅	✅	✅	✅
`Pipelined rendering`	❌	❌	❌	❌	⚠️	✅	✅
`Parallel rendering`	❌	❌	❌	❌	✅	✅	✅
`Multi-threaded asset loading`	❌	❌	❌	❌	✅	✅	✅
`Async asset loading` (Tokio)	❌	❌	❌	⚠️	✅	✅	✅
`bevy_remote` (BRP - Bevy Remote Protocol)	❌	❌	❌	✅	✅	✅	✅
`BRP` HTTP y WebSocket	❌	❌	❌	✅	✅	✅	✅
`Component` schema reflection	❌	❌	❌	❌	❌	✅	✅
`Resource schema reflection`	❌	❌	❌	❌	❌	✅	✅
`Bevy Editor (oficial)`	❌	❌	❌	❌	❌	❌	❌ (aún no)
`bevy_editor_pls` (community)	✅	✅	✅	✅	✅	✅	✅
`bevy_inspector_egui`	✅	✅	✅	✅	✅	✅	✅
`bevy_rapier` (3D/2D physics)	✅	✅	✅	✅	✅	✅	✅
`bevy_avian` (alternativa física)	❌	❌	❌	❌	✅	✅	✅
`bevy_renet` (networking)	✅	✅	✅	✅	✅	✅	✅
`bevy_replicon` (networking replicación)	❌	❌	❌	✅	✅	✅	✅
`bevy_tweening` (animaciones)	✅	✅	✅	✅	✅	✅	✅
`bevy_hanabi` (partículas)	✅	✅	✅	✅	✅	✅	✅
`leafwing-input-manager`	✅	✅	✅	✅	✅	✅	✅
`bevy_kira_audio`	✅	✅	✅	✅	✅	✅	✅

B.3 Notas por categoría

B.3.1 Required Components (cap. 8)

Introducidos en 0.15. Reemplazan muchos Bundles. Marcador #[require(T)] en un componente añade T automáticamente cuando se inserta el primero.

#[derive(Component)]
#[require(Sprite)]
struct Player; // Al spawnear Player, también spawnas Sprite (vacío).

B.3.2 Component Hooks (cap. 9)

Lanzados en 0.14 como RFC, estables en 0.15. Permiten ejecutar lógica cuando un componente se añade (on_add), se inserta (on_insert), se descarta (on_discard, renombrado de on_replace en 0.19 vía PR #22789) o se quita (on_remove). Imprescindible para mantener índices sincronizados.

B.3.3 Observers (cap. 10)

Introducidos experimentalmente en 0.14, estables en 0.15, mejorados en 0.16. Son sistemas que escuchan triggers sobre una entidad específica. Complementan (no sustituyen) a EventWriter/EventReader.

#[derive(Event)]
struct Click;

commands.spawn(Player).observe(|trigger: Trigger<Click>, ...| {
    // Reacciona a Click sobre ESTA entidad.
});

B.3.4 Relations (cap. 11)

Lanzadas en 0.17. Permiten definir relaciones tipadas entre entidades. Parent/Children se reescribieron sobre Relations internamente.

#[derive(Component)]
#[relationship(relationship_target = OwnedBy)]
struct Owned(Entity);

#[derive(Component)]
#[relationship_target(relationship = Owned)]
struct OwnedBy(Vec<Entity>);

B.3.5 Resources-as-Components

RFC experimental en 0.15, estabilizado en 0.16. Un Resource puede derivar Component para ser usado como dato de entidad en sistemas específicos (e.g. datos globales que también necesitan query por componente).

B.3.6 Render-Graph-as-Systems

Antes de 0.17, el render era una caja negra. Ahora los render passes son sistemas que puedes añadir a Render schedule. Más flexible, más depurable.

B.3.7 RenderTarget separado

En 0.17 se introdujo RenderTarget::Image para dibujar a una textura en lugar de a la ventana. Habilita post-procesado, minimapas, y render-to-texture.

B.3.8 Anchor como required component

Anchor (pivote de sprites/texto) pasó de ser un campo de Sprite/Text a ser un componente independiente y required component en 0.17. Permite pivotar entidades sin sprite (e.g. texto UI) sin duplicar el campo.

B.3.9 FixedUpdate schedule

FixedUpdate siempre estuvo, pero en 0.16 se volvió configurable el delta (Time<Fixed>::set_duration). En 0.17 el schedule graph permite sistemas con dependencias explícitas en fixed timestep.

B.3.10 Cargo feature collections

Desde 0.16, las features de Bevy se reorganizaron en feature collections: bevy_asset, bevy_audio, bevy_render, bevy_sprite, bevy_text, etc. Activar default-features = false y luego features = ["bevy_asset"] te da binarios más pequeños. Era imposible en 0.13-0.15.

# 0.13
bevy = "0.13"

# 0.19
bevy = { version = "0.19", default-features = false, features = ["bevy_asset", "bevy_sprite"] }

B.4 Resumen de cambios incompatibles (lo que rompe tu código)

Si vienes de 0.13 y subes a 0.19, esta es tu lista de la compra de breaking changes:

Versión	Cambio	Acción
0.14	`Input<KeyCode>` → `ButtonInput<KeyCode>`	Reemplazar todas las ocurrencias
0.14	`TextSection` deprecated	Migrar a `Text` + `TextFont` + `TextColor`
0.15	Bundles reemplazados por required components en muchos casos	Reemplazar `SpriteBundle` por `Sprite + Transform + Image`
0.15	`Children`/`Parent` separados → unificados en jerarquía `ChildOf`	Revisar código de jerarquías
0.15	`apply_deferred` se vuelve automático en muchos puntos	Quitar llamadas manuales donde ya no hacen falta
0.16	Features reorganizadas	Actualizar `Cargo.toml`
0.16	`Time<()>` y `Time<Virtual>` diferenciados	Revisar uso de `Time` en sistemas
0.17	`RenderTarget` separado	Si dibujabas a textura, usar la nueva API
0.17	`Anchor` es required component	Quitar `anchor` de struct literals
0.18	Pipelined rendering activado por defecto	Si tenías workarounds para el single-thread render, revisa
0.15	`SubStates` / `ComputedStates` oficiales	Si tenías jerarquías de estado custom, evalúa migrar
0.19	`#[reflect(Resource)]` también refleja `Component`; `ReflectResource` es ZST	Si usabas BRP o `bevy_world_serialization` con `ReflectResource`, migra a `ReflectComponent`
0.19	`bsn!` macro para escenas next-gen	Si usabas `DynamicScene` exclusivamente, considera migrar para escenas declarativas (cap 12)

**Metedura de pata del anexo**: hacer `cargo update` y esperar que todo siga funcionando. Cada minor de Bevy ha tenido al menos 1 breaking change. Lee el CHANGELOG. Léelo otra vez. Léelo en voz alta si hace falta. El compilador te lo agradecerá.

B.5 Cómo migrar: receta rápida

Lee el CHANGELOG de la versión destino antes de subir.
Fija versión con @: bevy = "0.19.1" en Cargo.toml para evitar sorpresas.
Migra de minor en minor (0.13 → 0.14 → 0.15 → ...). Saltarse versiones multiplica los conflictos.
Usa cargo fix --edition para sugerencias automáticas, pero revísalas: a veces el fix propuesto no es el más limpio.
Tests como red de seguridad: si tienes tests, son tu guía. Si no tienes, este es el momento.
Benchmarks antes y después: algunas "mejoras" de rendimiento en realidad empeoran tu caso concreto.

**¿Sabías que…?** Bevy publica un *migration guide* oficial en `https://bevy.org/learn/migration-guides/0-18-to-0-19/` (un *path* por cada par de versiones) que lista cada cambio con ejemplos de "antes/después". Es una mina de oro y pocos lo leen. Ahora tú ya sabes que existe.

B.6 ¿Qué viene después del 0.19?

No somos videntes, pero la hoja de ruta pública menciona:

Editor oficial (planificado desde 0.6, aún no).
Mejoras en bevy_picking para UI 3D.
Soporte oficial de Linux Wayland más pulido.
Más audio mixer nodes (efectos DSP).

Hasta entonces, este anexo cubre lo que necesitas para moverte entre 0.13 y 0.19 sin tirarte de los pelos. ¡Suerte!