Rename scene module and feature into world_serialization

Author: Shatur

CHANGELOG.md

@@ -10,6 +10,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 - `Replicated` is no longer automatically inserted on clients, only `Remote`. `scene::replicate_into` will serialize all entities that have either `Remote` or `Replicated`.
+- Rename `scene` module and feature into `world_serialization`.
 
 ## [0.39.3] - 2026-04-01
 

Cargo.toml

@@ -71,7 +71,7 @@ criterion = { version = "0.8", default-features = false, features = [
 
 
 [features]
-default = ["scene", "client", "server"]
+default = ["world_serialization", "client", "server"]
 
 # Client-related logic.
 client = []
@@ -82,6 +82,9 @@ server = []
 # Integration with Bevy diagnostics for client.
 client_diagnostics = ["client"]
 
+# State serialization based on replication rules.
+world_serialization = ["bevy/bevy_world_serialization"]
+
 # Replication into a scene.
 scene = ["bevy/bevy_world_serialization"]
 
@@ -126,8 +129,8 @@ name = "removal"
 required-features = ["client", "server"]
 
 [[test]]
-name = "scene"
-required-features = ["scene", "client"]
+name = "world_serialization"
+required-features = ["world_serialization", "client"]
 
 [[test]]
 name = "server_message"

README.md

@@ -17,7 +17,7 @@ If you are new to networking, see [glossary](https://gist.github.com/maniwani/f9
 - Authorization support.
 - Control over client visibility of entities and components.
 - Specify which entities should be replicated in sync using ECS relationships.
-- Replication into scene to save server state.
+- State serialization based on replication rules.
 - Customizable serialization and deserialization even for types that don't implement `serde` traits (like `Box<dyn Reflect>`).
 - Abstracts game logic to support singleplayer, client, dedicated server, and listen server configurations simultaneously.
 - No builtin I/O, can be used with any messaging library. See [messaging backends](#messaging-backends) for already available integrations.

src/lib.rs

@@ -679,13 +679,16 @@ extern crate alloc;
 pub mod client;
 pub mod compact_entity;
 pub mod postcard_utils;
-#[cfg(feature = "scene")]
-pub mod scene;
 #[cfg(feature = "server")]
 pub mod server;
 pub mod shared;
 #[cfg(all(feature = "server", feature = "client"))]
 pub mod test_app;
+#[cfg(any(feature = "scene", feature = "world_serialization"))]
+pub mod world_serialization;
+
+#[cfg(feature = "scene")]
+compile_warning!("The `scene` feature is deprecated. Use `world_serialization` instead.");
 
 pub mod prelude {
     pub use super::{

src/scene.rs src/world_serialization.rssrc/scene.rs renamed to src/world_serialization.rs

@@ -19,7 +19,7 @@ start replicating them again.
 
 ```
 use bevy::{prelude::*, state::app::StatesPlugin, world_serialization::serde::WorldDeserializer};
-use bevy_replicon::{prelude::*, scene};
+use bevy_replicon::{prelude::*, world_serialization};
 use serde::de::DeserializeSeed;
 # let mut app = App::new();
 # app.add_plugins((StatesPlugin, AssetPlugin::default(), RepliconPlugins));
@@ -28,19 +28,14 @@ use serde::de::DeserializeSeed;
 let registry = app.world().resource::<AppTypeRegistry>();
 let type_registry = &*registry.read();
 let mut dyn_world = DynamicWorld::default();
-scene::replicate_into(&mut dyn_world, &app.world());
-let world_ron = dyn_world
-    .serialize(type_registry)
-    .expect("scene should be serialized");
+world_serialization::replicate_into(&mut dyn_world, &app.world());
+let world_ron = dyn_world.serialize(type_registry).unwrap();
 
 // Deserialization
 let mut asset_server = app.world().resource::<AssetServer>().clone();
-let scene_deserializer = WorldDeserializer { type_registry, load_from_path: &mut asset_server };
-let mut deserializer =
-    ron::Deserializer::from_str(&world_ron).expect("scene should be serialized as valid ron");
-let mut dyn_world = scene_deserializer
-    .deserialize(&mut deserializer)
-    .expect("ron should be convertible to scene");
+let world_deserializer = WorldDeserializer { type_registry, load_from_path: &mut asset_server };
+let mut deserializer = ron::Deserializer::from_str(&world_ron).unwrap();
+let mut dyn_world = world_deserializer.deserialize(&mut deserializer).unwrap();
 
 // Re-insert `Replicated` component if you want to replicate them.
 for entity in &mut dyn_world.entities {

tests/scene.rs tests/world_serialization.rstests/scene.rs renamed to tests/world_serialization.rs

@@ -1,5 +1,5 @@
 use bevy::{prelude::*, state::app::StatesPlugin};
-use bevy_replicon::{prelude::*, scene};
+use bevy_replicon::{prelude::*, world_serialization};
 use serde::{Deserialize, Serialize};
 use test_log::test;
 
@@ -27,7 +27,7 @@ fn replicated() {
     let remote = app.world_mut().spawn((Remote, TestComponent)).id();
 
     let mut dyn_world = DynamicWorld::default();
-    scene::replicate_into(&mut dyn_world, app.world());
+    world_serialization::replicate_into(&mut dyn_world, app.world());
 
     let replicated_dyn = dyn_world
         .entities
@@ -61,7 +61,7 @@ fn empty() {
 
     // Extend with replicated components.
     let mut dyn_world = DynamicWorld::default();
-    scene::replicate_into(&mut dyn_world, app.world());
+    world_serialization::replicate_into(&mut dyn_world, app.world());
 
     assert!(dyn_world.resources.is_empty());
     assert_eq!(dyn_world.entities.len(), 1);
@@ -82,7 +82,7 @@ fn not_replicated() {
     app.world_mut().spawn(TestComponent);
 
     let mut dyn_world = DynamicWorld::default();
-    scene::replicate_into(&mut dyn_world, app.world());
+    world_serialization::replicate_into(&mut dyn_world, app.world());
 
     assert!(dyn_world.resources.is_empty());
     assert!(dyn_world.entities.is_empty());
@@ -110,7 +110,7 @@ fn update_existing() {
         .build();
 
     // Update already extracted entity with replicated components.
-    scene::replicate_into(&mut dyn_world, app.world());
+    world_serialization::replicate_into(&mut dyn_world, app.world());
 
     assert!(dyn_world.resources.is_empty());
     assert_eq!(dyn_world.entities.len(), 1);