Expand description
Save and load entities from various formats with serde.
WorldSerialize / WorldDeserialize
This module provides two SystemData implementors:
SerializeComponentsandDeserializeComponents
Reading those makes it very easy to serialize or deserialize components.
SerializeComponents implements Serialize and DeserializeComponents implements
DeserializeOwned, so serializing / deserializing should be very easy.
Markers
Because you usually don’t want to serialize everything, we use
markers to say which entities we’re interested in. However, these markers
aren’t just boolean values; we also have id spaces which allow us
to identify entities even if local ids are different. The allocation
of these ids is what MarkerAllocators are responsible for. For an example,
see the docs for the Marker trait.
Structs
A struct used for deserializing entity data.
Basic marker implementation usable for saving and loading
Basic marker allocator
Traits
Converts a data type (usually a
Component) into its serializable form
and back to actual data from it’s deserialized form.A trait which allows to deserialize entities and their components.
A common trait for
EntityBuilder and LazyBuilder with a marker function, allowing either to be used.This trait should be implemented by a component which is going to be used as marker.
This marker should be set to entity that should be serialized.
If serialization strategy needs to set marker to some entity
then it should use newly allocated marker from
Marker::Allocator.This allocator is used with the
Marker trait.
It provides a method for allocating new Markers.
It should also provide a Marker -> Entity mapping.
The maintain method can be implemented for cleanup and actualization.
See docs for Marker for an example.A trait which allows to serialize entities and their components.