AOI Spatial Filtering, Move + Shoot Separation & Entity LERP

How Area of Interest (AOI) reduces bandwidth, how Move separates from Hitscan/Ballistic Shoot, and how clients interpolate discrete server snapshots.

AOI Spatial Filtering, Move + Shoot & Entity Interpolation

Spatial visibility and step validation live in Playna's replication layer rather than inside one hardcoded game loop, allowing AOI to protect bandwidth across shooters, MMORPGs, and physics arenas.

1. Area of Interest (`visibility: "aoi"`)

Marking a component with `visibility: "aoi"` filters outgoing delta snapshots per recipient by `aoi_radius`:

• Out-of-range entity states stay off the wire → **significantly lower bandwidth**.
• Remote enemy positions outside interest range never reach client memory → **blocks radar/map hacks**.
• Server-side `max_step_distance` bounds reject unauthorized teleportation deltas.

2. How Move and Shoot Compose

• **Move (Locomotion, Speed Bounds & AOI):** Handled by **`kinematic_ecs` (`0x64`)**.
• **Shoot — Hitscan (Instant Ray Weapons):** Resolved inside `kinematic_ecs` + `lag_compensation` by rewinding target spheres in the history ring buffer to `T - RTT/2` and testing 3D ray-sphere intersection.
• **Shoot — Projectiles (Gravity/Wind Arrows & Shells):** Movement stays on `kinematic_ecs` while fire commands dispatch to secondary **`ballistics` (`0x62`)**.

3. Smooth Scene Rendering: Entity LERP & SLERP

Because servers snapshot at 20–60 Hz while clients render at 60–240 Hz, client scenes render remote entities slightly behind live time inside an interpolation buffer:

• `t_render = t_client_now - t_interpolation_delay` (`1.5 ~ 2.0 * dt_tick + jitter_ms`)
• `alpha = clamp((t_render - t_prev) / (t_next - t_prev), 0.0, 1.0)`
• Position: `P(t) = lerp(P_prev, P_next, alpha)`
• Rotation: `R(t) = slerp(R_prev, R_next, alpha)`
• Brief packet loss triggers velocity-clamped Dead Reckoning (`<= 100 ms`) blended smoothly on arrival of the next authoritative snapshot.

Spatial Query, AOI Görünürlüğü, Move + Shoot ve LERP Enterpolasyon

Spatial Query, AOI ve Move + Shoot Mimarisi

Playna’da konum filtreleme (AOI) doğrudan fizik motorunun içine gömülmez; çoğaltma katmanında tüm fizik sağlayıcılarıyla birlikte çalışır.

1. Area of Interest (`visibility: "aoi"`)

Bileşen tanımında `visibility` alanını `"aoi"` seçtiğinizde veri düzlemi her alıcı için yalnızca tanımlı `aoi_radius` mesafesi içindeki varlıkların delta snapshot paketlerini oluşturur:

• Uzaktaki oyuncuların koordinatları ağa çıkmaz → **bant genişliği düşer**.
• İstemci belleğine görüş alanı dışındaki konumlar inmediği için **harita/wallhack hileleri önlenir**.
• `max_step_distance` denetimi tek adımda ışınlanma (teleport) hilesini engeller.

2. Move ve Shoot Nasıl Birleşir?

• **Move (Konum, Hız Koruması & AOI):** Oyuncu hareketi **`kinematic_ecs` (`0x64`)** üzerinde akar.
• **Shoot — Senaryo 1 (Hitscan FPS):** Anlık mermi atışları `kinematic_ecs` + `lag_compensation` yeteneği içinde çözülür; sunucu tarih halkasını `T - RTT/2` anına geri sarıp 3D ışın-küre kesişimini (`verify_ray_hit`) doğrular.
• **Shoot — Senaryo 2 (Balistik Ok / Mermi / Bomba):** Hareket `kinematic_ecs` üzerinde devam ederken atış komutu ikincil **`ballistics` (`0x62`)** sağlayıcısına yönlendirilir.

3. İstemci Sahnesinde Akıcı Render (Entity Interpolation / LERP)

Sunucu 20 Hz (`50 ms`) veya 60 Hz (`16.6 ms`) anlık görüntü gönderirken monitörler 60/144/240 Hz çalışır. Akıcı görüntü için istemci mevcut zamanın hemen gerisinden enterpolasyon oynatır:

• `t_render = t_client_now - t_interpolation_delay` (`1.5 ~ 2.0 * dt_tick + jitter_ms`)
• `alpha = clamp((t_render - t_prev) / (t_next - t_prev), 0.0, 1.0)`
• Pozisyon: `P(t) = lerp(P_prev, P_next, alpha)`
• Rotasyon (Quaternion): `R(t) = slerp(R_prev, R_next, alpha)`
• Paket kaybında kısa süreli Dead Reckoning (maks. ~100 ms hız tahmini) uygulanır ve yeni kare geldiğinde yumuşak karışım yapılır.