GridWars

Problem

Travian/Tribal Wars ruhunu kısa maçlara indiren bir düello oyunu. İki oyuncu simetrik bir tahtada tur tur asker üretir, hareket eder ve savaşır. Rakibin kalesini düşüren ya da tur sınırında daha çok kare tutan kazanır.

Rolüm

Ürün sahibi, mimar ve geliştirici: ürün yönünü ve kararları belirledim, oyunu (motor, sunucu, istemci, denge) geliştirdim. Kararlar ADR kaydında tutuldu.

Dil, çatı ve kütüphaneler

Dil ve depo

• TypeScript ^5.9.2
• Node.js >=20
• pnpm workspaces (pnpm@12.5.1)
• Turborepo ^2.5.5

İstemci

• React ^18.3.1
• Vite ^6.0.7
• three.js ^0.186.1
• postprocessing ^6.39.5
• @colyseus/sdk 0.18.4
• Web Audio API
• Web Worker

Sunucu

• @colyseus/core 0.18.17
• @colyseus/ws-transport 0.18.4
• @colyseus/schema 5.0.34
• tsx ^4.19.2
• node:crypto (HMAC-SHA256)

Test ve araçlar

• Vitest ^2.1.9
• node:test
• puppeteer-core ^25.12.0 (e2e)

Mimari

• Monorepo dört paket: shared (tipler, denge config'i, ağ protokolü), engine (saf kural motoru), server (Colyseus oda), client (React + three.js).
• Kural yalnız engine'de yaşar; sunucu ve istemci aynı fonksiyonları (produce, resolveMove, endTurn) çağırır, kuralı yeniden yazmaz.
• Sunucu otoriteli DuelRoom: istemci yalnız emir gönderir; oda doğrular, motoru çalıştırır, her koltuğa sis filtreli snapshot yollar.
• Sahne tek yönlü: oyun durumu three.js sahnesine yansıtılır, sahnede oyun kuralı yoktur. HUD ve menüler React'te.
• Denge sayıları packages/shared/src/config.ts içinde veri olarak tutulur; self-play simülasyon betikleriyle taranır.

Veri yapıları

• GameState: hücre dizisi (Cell), oyuncular (PlayerState: altın), tur, faz, takım başına sis hafızası (explored), rngState, olay listesi (GameEvent).
• Cell, originalOwner alanını tutar; ev toprağı savunma bonusu yalnız sahip = başlangıç sahibi iken uygulanır, geri alınan karede uygulanmaz.
• Order birleşim tipi: ProduceOrder, MoveOrder, DeployOrder. Ağda team alanı istemciden alınmaz, koltuktan yazılır (ClientOrder).
• Ağ protokolü Colyseus'tan bağımsız tiplerdir: OrderMsg, EndTurnMsg, SnapshotMsg, MatchEndMsg, RejectMsg; PROTOCOL_VERSION uyuşmazsa katılım reddedilir.
• CombatReport: taraflar, ham güçler, uygulanan bonuslar, şans zarları, kayıplar ve kazanan; istemcideki savaş sinematiği bu rapordan oynatılır.

Yöntem ve desenler

Zorluklar ve çözümler

1. Zorluk Sisli oyunda istemci tam durumu tutarsa rakip bilgisi devtools ile okunabilir.

   Çözüm Sunucu tam durumu tutar, her koltuğa yalnız redactForTeam görünümünü yollar; tohum her durumda 0'lanır, sis altındaki kale HP'si son görülen değerle gösterilir.

2. Zorluk Şans faktörü istendi, ama replay, test ve sunucu otoritesi için determinizm gerekiyordu.

   Çözüm Tohumlu PRNG ile şans; luckRange config'te (0 verilirse tamamen deterministik). Determinizm testi aynı tohum ve emirlerde aynı durum ve raporu doğrular.

3. Zorluk three.js sahnesi ilk yüklemeyi ağırlaştırıyor ve boştayken bile her karede çiziyordu.

   Çözüm three ayrı chunk'a alındı ve tembel yüklendi; istek üzerine çizim eklendi; ortam animasyonu yüksek kalitede 30 fps, düşükte durağan.

4. Zorluk AI hesabı ana iş parçacığında çalışıyordu; Worker'a taşırken kararların aynı kalması gerekiyordu.

   Çözüm AI Web Worker'a taşındı, hata veya 5 sn zaman aşımında ana iş parçacığına düşer. Structured clone sınırında kararların birebir aynı olduğu testle sabitlendi.

Ölçülebilir sonuçlar

• İlk yüklenen JS (brotli) 403,3 KB'tan 71,5 KB'a indi (-%82).
• Maç boştayken ana iş parçacığı yükü 72'den 43 ms/sn'ye indi (-%40, 1x CPU).
• Maç sonu çizim çağrısı 167'den 78'e indi (-%53); maç başında 103'ten 61'e.
• 60 turluk otomatik oyun ölçümü: 60 fps, p95 kare süresi 16,7 ms (headless Chrome, Apple Silicon GPU).

Sık sorulanlar