Struct World 

pub struct World {
    pub tick: u32,
    /* private fields */
}

Fields

tick: u32

Implementations

impl World

pub fn new() -> World

pub fn increment_tick(&mut self)

Increments the local tick counter, guaranteeing it skips 0 on wrap.

pub fn apply_commands(&mut self)

Ertelenmiş komut kuyruğunu (CommandQueue) işler. Entity ekleme/çıkarma işlemleri bu sayede kilitlenme (deadlock) yaşamadan batch halinde uygulanır.

impl World

pub fn register_component_type<T>(&mut self)

where T: Component,

Belirli bir component turunun runtime metadata’sini kaydeder. Archetype storage migration asamalarinda column olusturma icin kullanilir.

pub fn add_observer<T, F>(&mut self, system: F) -> &mut World

where T: Component, F: FnMut(On<Insert, T>) + Send + Sync + 'static,

Registers a Component hook (Observer) for OnInsert.

pub fn observe<E, F>(&mut self, entity: Entity, listener: F) -> &mut World

where E: EntityEvent, F: FnMut(On<E>) + Send + Sync + 'static,

Özel EntityEvent’ler için Entity bazlı Observer kaydı

pub fn trigger<E>(&mut self, event: E)

where E: EntityEvent,

Bir Event’i tetikler ve hiyerarşide yukarı doğru yayar (bubble-up)

pub fn is_component_registered<T>(&self) -> bool

where T: Component,

Belirli bir component turu kayitli mi?

pub fn registered_component_count(&self) -> usize

Kayitli component metadata sayisi.

pub fn register_on_add<T>( &mut self, hook: Box<dyn FnMut(&mut World, Entity) + Send + Sync>, )

where T: Component,

pub fn register_on_remove<T>( &mut self, hook: Box<dyn FnMut(&mut World, Entity) + Send + Sync>, )

where T: Component,

pub fn register_on_set<T>( &mut self, hook: Box<dyn FnMut(&mut World, Entity) + Send + Sync>, )

where T: Component,

pub fn spawn(&mut self) -> Entity

pub fn spawn_bundle<B>(&mut self, bundle: B) -> Entity

where B: Bundle,

Bir Bundle’ı tek seferde spawn eder — entity oluşturur ve tüm bileşenleri ekler.

let player = world.spawn_bundle(MeshBundle {
    mesh: renderer.create_cube(),
    material: Material::pbr(Color::BLUE, 0.5, 0.0),
    name: "Oyuncu",
    ..default()
});

pub fn flush_spawn(&mut self, entity: Entity)

pub fn get_entity(&self, id: u32) -> Option<Entity>

pub fn clone_entity( &mut self, source_id: u32, count: usize, ) -> Option<Vec<Entity>>

Derin kopyalama (O(1) Prefab Splicing) işlemi. Var olan bir Entity’nin bulunduğu archetype tablosunda tamamen bitişik olarak N adet yeni kopyasını çıkarır.

pub fn register_despawn_hook( &mut self, hook: Box<dyn FnMut(&mut World, Entity) + Send + Sync>, )

pub fn spawn_batch<I>(&mut self, iter: I) -> impl Iterator<Item = Entity>

where I: IntoIterator, <I as IntoIterator>::Item: Bundle,

pub fn clear_entities(&mut self)

Tüm entityleri temizler.

pub fn despawn(&mut self, entity: Entity)

pub fn compact(&mut self)

Hafızadaki boşlukları sıkıştırır ve kullanılmayan (boş) Archetype tablolarını silerek RAM’i ve sistem performansını ilk baştaki defregmante (temiz) haline getirir. Yükleme (Loading) ekranlarında veya düşük yoğunluklu anlarda çağrılması önerilir.

pub fn despawn_by_id(&mut self, id: u32)

pub fn iter_alive_entities(&self) -> Vec<Entity>

Yaşayan (despawn olmamış) tüm Entity’leri döndüren iterator. Uyarı: İterasyon boyunca Entities mutex kilidi tutulur!

pub fn is_alive(&self, entity: Entity) -> bool

pub fn add_bundle<B>(&mut self, entity: Entity, bundle: B)

where B: Bundle,

Sisteme component ekleme — Veriyi archetype sütununa taşır.

pub fn remove_bundle<B>(&mut self, entity: Entity)

where B: Bundle,

pub fn add_component<T>(&mut self, entity: Entity, component: T)

where T: Component,

pub fn get_entity_component_types(&self, entity: Entity) -> Vec<TypeId>

Entity üzerindeki tüm bileşenlerin TypeId’lerini döndürür.

pub fn get_component_ptr( &self, entity: Entity, type_id: TypeId, ) -> Option<*const u8>

Raw Component Pointer alma (Reflection/Editor için)

pub fn get_component_mut_ptr( &mut self, entity: Entity, type_id: TypeId, ) -> Option<*mut u8>

Mut mutable Component pointer alma (HierarchyExt vs için)

pub fn reconstruct_entity(&self, id: u32) -> Option<Entity>

Entity ID’sinden geçerli nesneyi tekrar yapılandırır

pub fn remove_component<T>(&mut self, entity: Entity)

where T: Component,

Sistemden component silme

pub fn query<'w, Q>(&'w self) -> Option<Query<'w, Q>>

where Q: WorldQuery,

pub fn borrow<'w, T>(&'w self) -> Query<'w, &'w T>

where T: Component,

Geriye uyumluluk için StorageView alternatifi

pub fn borrow_mut<'w, T>(&'w self) -> Query<'w, Mut<'w, T>>

where T: Component,

Geriye uyumluluk için StorageViewMut alternatifi

pub fn query_cached<'w, Q>(&'w mut self) -> Option<Query<'w, Q>>

where Q: WorldQuery,

Cache’li query — archetype indeks cache’ini kullanır. &mut self gerektirdiği için sadece World sahibiyken çağrılabilir.

pub fn insert_batch<T>(&mut self, entities: &[Entity], component: T)

where T: Component + Clone,

Tek bir entity üzerinde Query çalıştırıp anında sonuç almanızı sağlar.

Örnek

if let Some((mut t, mut v)) = world.query_entity_mut::<(Mut<Transform>, Mut<Velocity>)>(id) {
    t.position += v.linear * dt;
}

Toplu (Batch) component ekleme. O(N) archetype lookup maliyetini O(1)’e düşürür.

pub fn remove_batch<T>(&mut self, entities: &[Entity])

where T: Component,

Toplu (Batch) component çıkarma

pub fn query_entity_mut<'w, Q>( &'w mut self, entity_id: u32, ) -> Option<<Q as WorldQuery>::Item<'w>>

where Q: WorldQuery,

pub fn query_entity<'w, Q>( &'w self, entity_id: u32, ) -> Option<<Q as WorldQuery>::Item<'w>>

where Q: WorldQuery,

Tek bir entity üzerinde read-only Query çalıştırıp anında sonuç almanızı sağlar.

pub fn entity_location(&self, entity_id: u32) -> EntityLocation

Entity’nin archetype konumunu döndürür — O(1) lookup.

pub fn entity_count(&self) -> u32

Toplam yaşayan entity sayısı

pub fn insert_resource<T>(&mut self, resource: T)

where T: Send + Sync + 'static,

Sisteme global bir Resource ekler veya üzerine yazar.

pub fn get_resource<T>(&self) -> Option<ResourceReadGuard<'_, T>>

where T: 'static,

Global bir Resource’u okumak için çağrılır (Immutable Borrow)

pub fn get_resource_mut<T>(&self) -> Option<ResourceWriteGuard<'_, T>>

where T: 'static,

Global bir Resource’u değiştirmek için çağrılır (Mutable Borrow)

pub fn try_get_resource<T>( &self, ) -> Result<ResourceReadGuard<'_, T>, ResourceFetchError>

where T: 'static,

get_resource ile aynı işlev, ama hata sebebini Result ile taşır.

pub fn try_get_resource_mut<T>( &self, ) -> Result<ResourceWriteGuard<'_, T>, ResourceFetchError>

where T: 'static,

get_resource_mut ile aynı işlev, ama hata sebebini Result ile taşır.

pub fn get_resource_mut_or_default<T>(&mut self) -> ResourceWriteGuard<'_, T>

where T: Default + Send + Sync + 'static,

Global bir Resource yoksa Default olarak oluşturur, ardından Mutable Borrow döndürür. World mutable borrow gerektirir, böylece hashmap’e güvenle kayıt yapılabilir.

pub fn remove_resource<T>(&mut self) -> Option<T>

where T: 'static,

Global bir Resource’u ECS’ten tamamen çıkartır ve sahipliğini döndürür

pub fn resource_scope<T, U, F>(&mut self, f: F) -> Option<U>

where T: Send + Sync + 'static, F: FnOnce(&mut World, &mut T) -> U,

Bir resource’u geçici olarak world’den çıkarıp closure’a geçirir ve sonra geri koyar. Bu, resource’un içindeyken &mut World kullanmanız gerektiğinde borrow checker’ı mutlu etmenin en temiz yoludur (Bevy’deki resource_scope benzeri).

Örnek

world.resource_scope::<PoolManager, ()>(|world, pool| {
    pool.instantiate(world, "enemy");
});

pub fn swap_archetype_rows(&mut self, arch_id: u32, row_a: usize, row_b: usize)

Belirli bir Archetype içindeki iki satırı güvenli bir şekilde takaslar ve entity lokasyonlarını günceller.

pub fn sort_archetype_hierarchy(&mut self)

Aynı archetype’da bulunan ebeveyn ve çocuk düğümleri bellekte sırt sırta verecek şekilde kümelendirir. O(N) cache swap.

Trait Implementations

impl Default for World

fn default() -> World

Returns the “default value” for a type.

impl HierarchyExt for World

fn despawn_recursive(&mut self, entity: Entity)

Despawns an entity and all of its descendants recursively.

fn add_child(&mut self, parent: Entity, child: Entity)

Adds a child to a parent entity, updating both Parent and Children components.

fn remove_child(&mut self, parent: Entity, child: Entity)

Removes a child from a parent entity.

impl WorldExt for World

fn entity_named(&self, name: &str) -> Option<u32>

İsme göre Entity ID’sini (u32) bul.

fn move_entity_named<F: FnMut(&mut Transform)>(&mut self, name: &str, f: F)

İsme göre entity’nin Transform’unu değiştir. Transform matrisi otomatik güncellenir.

fn position_of(&self, name: &str) -> Option<Vec3>

İsme göre entity’nin dünya pozisyonunu al.

fn modify<T: Component + 'static, F: FnMut(&mut T)>(&mut self, name: &str, f: F)

İsme göre herhangi bir bileşeni değiştir.