Silkroad Tactics: Ürün ve Teknik Dokümanı

Tarayıcıda oynanan, 8 oyunculu, sunucu otoriter otomatik savaş (auto-battler) oyunu
1. Özet

Silkroad Tactics, oyuncuların ortak birim havuzundan takım kurduğu, birimleri birleştirip güçlendirdiği, sinerjileri ve bağları etkinleştirdiği ve son ayakta kalan komutan olmaya çalıştığı bir strateji oyunudur. Kurulum gerektirmez: tarayıcıdan açılır ve misafir olarak hemen oynanır.
Ürünün en güçlü yanı, tam oyun döngüsünün tek bir sade kod tabanında çalışıyor olmasıdır: deterministik savaş motoru, sunucu otoriter çok oyunculu altyapı, sıralı lig, sezon, hesap sistemi ve 3B sahne.
Öne çıkanlar
  • Kurulumsuz, WebGL 2 ile tarayıcıda çalışan 3B oyun
  • 38 birim, 22 sinerji ve bağ, 175 eşya tanımı
  • Antrenman, Normal, Dereceli ve özel lobi modları
  • Hile yüzeyini azaltan sunucu otoriter mimari
  • Aynı girdiyle aynı sonucu veren deterministik savaş motoru
  • Maç sırasında tüm rakipleri izleme, savaşların ortasına katılma
  • 5 dilde arayüz, KVKK metinleri, veri indirme ve hesap silme
2. Oyun Tasarımı

2.1 Temel döngü


Bir maçta 8 oyuncu aynı lobide yarışır. Boş yuvalar botlarla dolar.
  1. Kervan: oyuncular sırayla bir birim ve eşya seçer.
  2. Hazırlık: altınla birim alınır, dükkân yenilenir, tecrübe satın alınır, dizilim kurulur.
  3. Savaş: birimler kendiliğinden dövüşür.
  4. Sonuç: kaybeden komutan can kaybeder, ekonomi işlenir, yeni tur başlar.
Tur akışı: 1-1 kervan, 1-2 ile 1-4 arası PvE. 2. aşamadan itibaren PvP turları, 4. turda kervan ve 7. turda PvE ile bölünür. Tek sayıda oyuncu kaldığında biri başka oyuncunun kopyasına karşı (hayalet) savaşır.
Evre
Süre
Hazırlık
20 sn (1. aşama), sonra 30 sn
Savaş
33 sn
Kervan
25 sn

2.2 Ekonomi


Kural
Değer
Komutan canı
100
Tur geliri
5 altın
Faiz
Her 10 altına 1, en fazla 5
Seri bonusu
2 seride +1, 4 seride +2, 5 seride +3
Dükkân yenileme
2 altın
Tecrübe satın alma
4 altın karşılığı 4 XP
Tur başı XP
2
Yedek kulübesi
9 yuva
Birim başına eşya
En fazla 3
Havuz (1-5 gold)
29 / 22 / 18 / 12 / 10 kopya
Dükkân olasılıkları oyuncu seviyesine göre 9 kademede değişir. Üç aynı birim yıldız atlatır.

2.3 Birimler ve kademe sistemi


Gold
Birim sayısı
Zırh ve silah derecesi
Yetenek gücü çarpanı
1
8
DG1
×0,6
2
9
DG3
×0,8
3
9
DG5
×0,9
4
7
DG8
×1,0
5
5
DG11
×1,2
  • 38 birim: 19 Çin, 19 Avrupa
  • 7 sınıf: Muhafız, Savaşçı, Nişancı, Destek, Suikastçı, Arkanist, Lanetçi
  • 4 element: Soğuk, Ateş, Şimşek, Force
  • 15 silah ailesi. Her ailenin 5 derecede ayrı karakter modeli vardır (toplam 75 model)

2.4 Sinerjiler ve bağlar


22 özellik bulunur:
  • 2 ırk (3 / 5 / 7 birim)
  • 7 sınıf (2 / 4 birim)
  • 13 bağ (2 ila 4 birim): Holy Wall, Rangers, Shadow, Curse, Sorcery, Brothers, Choir, Fire, Cold, Storm, Force ve diğerleri

2.5 Eşyalar

  • 7 bileşen ve 28 birleşik eşya, her biri 5 tier: toplam 175 tanım
  • Tier, oyun ilerledikçe yükselir ve birimin cost'una göre kilitlenir
  • Silaha SoX ve +N yükseltmeleri uygulanır
  • Bazı eşyalar kostüm görünümü verir
  • 12 ganimet türü PvE turlarında düşer ve pet ile toplanır
  • Takas Tılsımı gibi araç eşyalar bulunur

2.6 Özgün mekanikler

  • Gazap (Berserk): verilen hasarla dolan 5 yuvalık gösterge. Dolunca bir tur takıma %15 saldırı gücü verir.
  • Pet: 17 seçilebilir pet oyuncunun avatarıdır, ganimet toplar ve tur sonunda rakibe saldırır.
  • Kervan: oyuncular sırayla, her biri eşyalı olan ortak birim tekliflerinden birini seçer.

2.7 Rakip izleme

  • Oyuncu listesinden herhangi bir rakibe tıklanır veya Q / W ile geçilir
  • Hazırlıkta: rakibin tahtası ve yedeği karşı yarıda görünür. Oyuncu kendi dizilimini aynı anda düzenleyebilir.
  • Savaşta: başka bir eşleşme o anki saniyesinden açılır. Oyuncunun kendi savaşı arka planda sürer.
  • Tek arena kullanıldığı için performans maliyeti düşüktür
3. Oyun Modları ve Çevre Özellikler

Özellik
Durum
Antrenman maçı (misafir, botlarla)
Var
Normal kuyruk
Var
Dereceli kuyruk
Var
Özel lobi (davet kodu, derecesiz)
Var
Sezon sistemi
Var
Sıralama sayfası ve oyuncu profilleri
Var
Karakter ve hesap ilerlemesi (XP, seviye)
Var
Prolog, keşif sayfası, oyun merkezi
Var
Yönetim paneli ve oyuncu yasaklama
Var
Yeni bölgeler
Arayüzde "yakında" olarak kilitli
Dereceli sistem
  • Gizli puan: OpenSkill (Weng-Lin, Plackett-Luce)
  • Görünen lig: Demir, Bronz, Gümüş, Altın, Platin, Zümrüt, Elmas (her biri 4 kademe, kademe başına 100 LP)
  • Üst ligler: Usta, Büyük Usta, Efsane
  • Giriş şartı: 10. seviye veya 10 Normal maç
  • Eşleştirme penceresi bekledikçe genişler, 2 dakikada serbest kalır
Adil oyun
  • Maçtan ayrılma ve AFK cezası: 5 dakika, 15 dakika, 24 saat (son 30 gün sayılır)
  • 5 tur işlem yapmayan oyuncu AFK sayılır
  • Kopan oyuncu 3 dakika içinde maçına dönebilir
4. Teknik Mimari

Tarayıcı (Next.js + React Three Fiber) │ HTTPS │ WebSocket (/game-ws) ▼ ▼ Caddy ──► Web (Next.js) ┐ Oyun sunucusu (sunucu otoriter) auth, API │ oda, kuyruk, ceza, sonuç ▼ │ SQL Server ◄──┘

4.1 Teknoloji yığını


Katman
Teknoloji
İstemci
Next.js 16, React 19, TypeScript 5.9
3B
Three.js 0.186, React Three Fiber 9, drei 10
Oyun sunucusu
Node.js 24, ws
Veritabanı
SQL Server, Kysely, tedious
Kimlik
Better Auth (e-posta/şifre, isteğe bağlı Google)
Doğrulama
Zod
Test
Vitest 5
Yayın
Caddy, Cloudflare, Windows zamanlanmış görevler
CI
GitHub Actions: typecheck, test, build

4.2 Kod yapısı


Modül
Görev
packages/sim
Saf oyun motoru: savaş, ekonomi, lobi, MMR, lig
packages/content
Veri odaklı içerik: birim, eşya, bağ, denge araçları
packages/protocol
İstemci ve sunucu mesaj sözleşmesi
packages/db
Veritabanı erişimi, 10 migration
apps/game-server
Oda, eşleştirme, ceza, sonuç kaydı
apps/web
Oyun istemcisi, hesap sayfaları, yönetim paneli
Yaklaşık 22.000 satır TypeScript. 219 test geçiyor, veritabanı isteyen 9 test ayrı ortamda çalışıyor.

4.3 Savaş motoru

  • 50 ms sabit tick, seed'li RNG, Math.random ve saat kullanımı yok
  • Aynı girdi her makinede aynı sonucu verir, 1000 seed ile test edilir
  • Sunucu sonucu hesaplar, istemci aynı savaşı yerelde oynatır. Sürekli durum akışı gerekmez, bant genişliği çok düşüktür
  • Kod hedefi: tam 8v8 savaş 5 ms altında
  • Savaş grafik katmanından tamamen bağımsızdır, başka bir arayüzle de çalışır

4.4 Sunucu ve güvenlik

  • İstemci yalnızca niyet gönderir; altın, havuz, RNG ve sonuç sunucudadır
  • Mesajlar Zod ile doğrulanır: 2 KB sınırı, saniyede 20 mesaj
  • Oyun bileti imzalıdır
  • RNG tohumları, rakip dükkânı ve birim havuzu istemciye gönderilmez
  • Kimlik isteklerinde hız sınırı, sayfalarda nonce tabanlı CSP vardır

4.5 Grafik ve performans

  • Yüksek, Orta ve Düşük kalite kademeleri; GPU'ya göre otomatik seçim
  • Kare süresi kötüyse kademe kendiliğinden düşer
  • Piksel bütçesi ile yüksek çözünürlükte GPU yükü sınırlanır
  • Dokunmatik giriş ve ekran yönüne göre arayüz
  • Birim modelleri ihtiyaç anında yüklenir, portreler önceden üretilmiş 81 WebP dosyasıdır (1,4 MB)

4.6 İçerik üretim hattı


Betikler karakter, harita, efekt, ses ve yetenek verisini kaynak istemciden üretir. Denetim aracı 75 karakter modelinin zırh, silah ve kalkanını doğrular. npm run balance denge ölçümü yapar. İçerik veri odaklı olduğundan yeni birim ve sezon kod değişikliği gerektirmeden eklenebilir.

4.7 Yerelleştirme ve uyum

  • Arayüz: Türkçe, İngilizce, Almanca, Fransızca, Arapça
  • Birim ve eşya içerikleri Türkçe ve İngilizce; diğer dillerde İngilizce gösterilir
  • KVKK aydınlatma metni, kullanım şartları, çerez politikası
  • Yalnızca zorunlu çerezler; reklam ve takip yok
  • Oyuncu verisini JSON olarak indirme ve hesap silme
  • Renk körü modu
5. Görsel ve Ses
  • 106 karakter modeli (75 derece modeli, 30 kostüm çeşidi, 1 yaratık)
  • Gerçek zamanlı 3B arena, gölgeler, parlama ve son işlem efektleri
  • Yeteneğe özel efektler ve animasyonlar, silah parlamaları
  • 64 ses dosyası
Bu varlıkların tamamı üçüncü taraf kaynaklıdır. Ayrıntı için Bölüm 9'a bakın.
6. Bugünkü Durum

Alan
Olgunluk
Not
Oyun döngüsü
Çalışıyor
Tam maç oynanabiliyor
Çok oyunculu altyapı
Çalışıyor
Gerçek oyuncu yükü altında ölçülmedi
Denge
Erken
Sayılar ilk eğri, oyuncu verisiyle ayarlanmadı
Sezon içeriği
1 set
S1 Jangan
Mobil
Kısmi
Dokunmatik destek var, cihaz testi kapsamlı değil
Ödeme sistemi
Yok
Gelir modeli uygulanmadı
Analitik
Yok
Oyuncu ve tutundurma verisi toplanmıyor
Destek ve moderasyon
Temel
Yasaklama var, şikâyet akışı yok
Henüz ölçülmemiş: eşzamanlı oyuncu kapasitesi, gerçek FPS dağılımı, oyuncu tutundurma, gelir. Bu dokümanda bu konularda rakam verilmemiştir.
7. Alıcıya Teslim Paketi
  • Kaynak kod ve tam git geçmişi
  • Kurulum, yayın ve yedekleme betikleri (DEPLOY.md, ops/)
  • Veritabanı migration'ları
  • İçerik üretim hattı ve denetim araçları
  • Bu doküman, varlık envanteri, lisans listesi
8. Sık Sorulan Sorular

Hazır mı? Oynanabilir bir MVP'dir.
Neden tarayıcı? Kurulum yoktur, bağlantıyla oyuna girilir, misafir oyuncu saniyeler içinde maç açar.
Hile riski nedir? Oyun kararları sunucuda verilir. Kalan risk, rakip bilgisini otomatik okuyan yardımcı araçlardır; bu bilgiler izleme özelliğiyle zaten herkese açıktır.
Görseller değişince ne olur? Motor ve kurallar görsellerden ayrıdır. Model adları, içerik verisi ve üretim hattı yenilenir; oyun mantığı değişmez.
Kaç oyuncu kaldırır? Ölçülmedi. Savaşlar ucuz ve bant genişliği düşük olduğundan mimari elverişlidir, ancak yük testi yapılmalıdır.









Oyunu İncelemek için : Srotft.pixorasoft.com

Full Kaynak kod dahil teslim fiyatı : 50k dır herkese hayırlısı olsun.