Kervan
Nimble Quest tarzı snake + otomatik savaş roguelite. Kahraman kafileni ızgarada yönet, kahramanlar kendiliğinden saldırsın, dalgalara dayan, kazandığın altınla kafileni güçlendir.
Web (tarayıcı) ve masaüstü (macOS, Windows, Linux) aynı koddan çıkar. Tasarım dokümanı: docs/GDD.md.
Kontroller
| Klavye | Gamepad | Dokunmatik |
|---|
| Yön | Ok tuşları / WASD | D-pad / sol çubuk | Kaydır |
| Onay, tekrar | Boşluk / Enter / R | A | Butonlar |
| Duraklat | Esc / P | Start / B | Sağ üstteki II |
| Tam ekran | F11 | — | Ayarlar |
Geliştirme
npm install
npm run dev # http://localhost:5190
npm test # birim testleri + denge bekçisi
npm run balance # bot ile senaryo başına 40 tur, denge tablosu
npm run build # dist/ içine web sürümü
Masaüstü (Tauri 2)
Yerelde derlemek için Rust gerekir (macOS'ta Xcode Command Line Tools da).
npm run desktop:dev # pencerede geliştirme
npm run desktop:build # src-tauri/target/release/bundle/ altına kurulum dosyaları
İkon kaynağı src-tauri/app-icon.svg; değiştirirsen npx tauri icon src-tauri/app-icon.svg ile yeniden üret.
Sürüm çıkarma
package.json ve src-tauri/tauri.conf.json içindeki version alanını artır.- Etiket at ve gönder:
git tag v0.1.0 && git push origin v0.1.0
- Release iş akışı macOS (Apple Silicon + Intel), Windows ve Linux kurulum dosyalarını ve itch.io için web zip'ini derleyip taslak bir GitHub Release'e koyar. Kontrol edip yayınla.
macOS ve Windows sürümleri şimdilik imzasız: kullanıcı ilk açılışta güvenlik uyarısını onaylamalı. İmzalama için Apple Developer hesabı ve Windows kod imzalama sertifikası gerekir.
Web yayını
Web iş akışı main'e her push'ta testleri çalıştırıp siteyi GitHub Pages'e yükler. Bir kez repo ayarlarından Settings → Pages → Source: GitHub Actions seçilmeli. (Private repolarda Pages ücretli plan ister.)
itch.io için: sürümdeki kervan-web-vX.Y.Z.zip dosyasını HTML5 oyun olarak yükle; dosya yolları göreli olduğu için alt dizinde de çalışır.
Yapı
src/sim/ Saf oyun mantığı (Phaser'dan bağımsız, test edilir)
src/data/ Denge tabloları
src/meta/ Kayıt, dükkan, ekonomi
src/scenes/ Phaser sahneleri
src/render/ Sprite'lar, efektler
src/audio/ WebAudio ses efektleri ve müzik (dosyasız)
tools/ Denge botu ve simülatörü
src-tauri/ Masaüstü paketleme
