Struct MapProject 

pub struct MapProject {
    pub version: u32,
    pub level: Level,
    pub tilesets: HashMap<Uuid, Tileset>,
    pub sprite_sheets: HashMap<Uuid, SpriteData>,
    pub dialogues: HashMap<String, DialogueTree>,
    pub entity_type_configs: HashMap<String, EntityTypeConfig>,
}

A self-contained map project that includes level data and tileset metadata

This format is designed for the editor-to-runtime workflow, embedding all tileset information needed to load and render a level.

Example JSON

{
  "version": 1,
  "level": { ... },
  "tilesets": { "uuid": { ... } }
}

Fields

version: u32

Format version for future compatibility

level: Level

The level data

tilesets: HashMap<Uuid, Tileset>

Tilesets used by this level, keyed by their UUID

sprite_sheets: HashMap<Uuid, SpriteData>

Sprite sheets used by this level, keyed by their UUID

dialogues: HashMap<String, DialogueTree>

Dialogue trees used by this level, keyed by their ID

entity_type_configs: HashMap<String, EntityTypeConfig>

Entity type component configurations (physics, input, sprite per type)

Implementations

impl MapProject

pub fn new(level: Level, tilesets: Vec<Tileset>) -> MapProject

Create a new map project from a level and its tilesets

pub fn new_with_sprite_sheets( level: Level, tilesets: Vec<Tileset>, sprite_sheets: Vec<SpriteData>, ) -> MapProject

Create a new map project with sprite sheets

pub fn get_entity_type_config( &self, type_name: &str, ) -> Option<&EntityTypeConfig>

Get entity type config by type name

pub fn get_sprite_sheet(&self, id: Uuid) -> Option<&SpriteData>

Get a sprite sheet by ID

pub fn sprite_sheet_by_name(&self, name: &str) -> Option<&SpriteData>

Get a sprite sheet by name

pub fn sprite_sheet_paths(&self) -> Vec<(Uuid, &str)>

Get all sprite sheet image paths

pub fn get_dialogue(&self, id: &str) -> Option<&DialogueTree>

Get a dialogue tree by ID

pub fn dialogue_ids(&self) -> impl Iterator<Item = &str>

Get all dialogue IDs

pub fn dialogue_by_name(&self, name: &str) -> Option<&DialogueTree>

Get a dialogue by name (searches by DialogueTree.name field)

pub fn get_tileset(&self, id: Uuid) -> Option<&Tileset>

Get a tileset by ID

pub fn used_tileset_ids(&self) -> Vec<Uuid>

Get all unique tileset IDs used by tile layers in this level

pub fn image_paths(&self) -> Vec<(Uuid, usize, &str)>

Get all image paths needed to render this level

Returns a list of (tileset_id, image_index, path) tuples for each tileset image that needs to be loaded.

pub fn validate(&self) -> Result<(), String>

Validate that all tileset references in the level are satisfied

Trait Implementations

impl Clone for MapProject

fn clone(&self) -> MapProject

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MapProject

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MapProject

fn deserialize<__D>( __deserializer: __D, ) -> Result<MapProject, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MapProject

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TypePath for MapProject

fn type_path() -> &'static str

Returns the fully qualified path of the underlying type.

fn short_type_path() -> &'static str

Returns a short, pretty-print enabled path to the type.

fn type_ident() -> Option<&'static str>

Returns the name of the type, or None if it is anonymous.

fn crate_name() -> Option<&'static str>

Returns the name of the crate the type is in, or None if it is anonymous.

fn module_path() -> Option<&'static str>

Returns the path to the module the type is in, or None if it is anonymous.

impl VisitAssetDependencies for MapProject

fn visit_dependencies(&self, visit: &mut impl FnMut(UntypedAssetId))

impl Asset for MapProject