Struct GameObject 

pub struct GameObject {
    pub id: u64,
    pub name: String,
    pub transform: Transform,
    pub mesh: MeshBinding,
    pub visible: bool,
    pub parent_id: Option<u64>,
    pub components: Vec<ComponentSlot>,
    pub property_tags: Vec<String>,
    pub topology_layer: u8,
}

A game object — empty container that gains visual and behavioral identity through MeshBinding and ComponentSlots.

• id: deterministic u64, no UUIDs or RNG.
• transform: inline hot data, accessed every frame.
• components: bounded Vec<ComponentSlot> (max 32).
• Fully serializable for scene save/load and network replication.

Fields

id: u64

name: String

transform: Transform

mesh: MeshBinding

visible: bool

parent_id: Option<u64>

components: Vec<ComponentSlot>

property_tags: Vec<String>

Property tags (e.g., “isFlammable”, “isDestructible”). Drive physics heuristics, DreamMatter behavior, and event emission at runtime.

topology_layer: u8

Topology layer index (0=Universe, 9=Point). Determines which gameplay channel this object belongs to. GPU quantum culling uses this to render only the active layer’s content.

Implementations

impl GameObject

pub fn new(id: u64, name: String) -> Self

Create a new empty game object with default transform and no mesh.

pub fn with_primitive(id: u64, name: String, kind: PrimitiveKind) -> Self

Create with a primitive mesh (default gray color).

pub fn add_component(&mut self, slot: ComponentSlot) -> Result<(), String>

Attach a component. Returns error if MAX_COMPONENTS_PER_OBJECT exceeded.

pub fn remove_component(&mut self, kind: ComponentKind) -> bool

Remove the first component matching kind. Returns true if found.

pub fn get_component(&self, kind: ComponentKind) -> Option<&ComponentSlot>

pub fn get_component_mut( &mut self, kind: ComponentKind, ) -> Option<&mut ComponentSlot>

pub fn has_component(&self, kind: ComponentKind) -> bool

Check whether this object has any component of the given kind.

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

Validate data integrity.

Trait Implementations

impl Clone for GameObject

fn clone(&self) -> GameObject

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GameObject

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GameObject

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GameObject

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

where __S: Serializer,

Serialize this value into the given Serde serializer.