bevy_serialization_extras

Crates.iobevy_serialization_extras
lib.rsbevy_serialization_extras
version0.7.0
sourcesrc
created_at2023-10-26 17:37:04.702458
updated_at2024-11-20 19:40:43.551117
descriptionA crate for managing serialization with moonshine_save + wrappers.
homepage
repositoryhttps://github.com/rydb/bevy_serialization_extras
max_upload_size
id1014795
size971,607
(rydb)

documentation

README

bevy_serialization_extras

A library that allows the editing of non-reflect components via wrapper components, and serialization of these components via moonshine-save:

demo_gif.webm

Features

  • Out of the box serialization Through [plugins] for components
// Component <-> WrapperComponent
.add_plugins(SerializeComponentFor::<AsyncCollider, ColliderFlag>::default())

// AssetHandle <-> WrapperComponent
.add_plugins(SerializeAssetFor::<StandardMaterial, MaterialFlag>::default())

// WrapperComponent -> AssetHandle
.add_plugins(DeserializeAssetFrom::<GeometryFlag, Mesh>::default())

// Query -> Component, 
.add_plugins(SerializeQueryFor::<Linkage, ImpulseJoint, JointFlag>::default())
  • Serialization of groups of enities that compose an asset into their singular asset equivillent, and vice-versa

See: https://github.com/rydb/bevy_serialization_urdf

//Query <-> Asset
.add_plugins(SerializeManyAsOneFor::<LinkQuery, Urdf>::default())
  • Allows edititing unserializable(non-reflect) implementing components through the wrappers that convert to them

    E.G: Edit Rapier's ImpulseJoint through JointFlag

edit_example.png

  • type registration for wrappers through ManagedTypeRegistration trait

  • A visualization util to list serializable/unserializable components(W.I.P)

Usage

For implementations of plugin trait bounds, see /Wrappers

TODO

  • Add a mechanism for updating from old save versions to new save versions as to not break old save files.
Commit count: 123

cargo fmt