Expand description

Save and load entities from various formats with serde.

WorldSerialize / WorldDeserialize

This module provides two SystemData implementors:

  • SerializeComponents and
  • DeserializeComponents

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, uses u64 as identifier

Basic marker allocator, uses u64 as identifier

Basic marker uuid implementation usable for saving and loading.

Basic marker allocator for uuid.

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.