5.5 KiB
5.5 KiB
🍬 Numex Candy
Candy Crush tarzı, 20 bölümlük, profesyonel şeker eşleştirme (match-3) oyunu. Tarayıcıda çalışır; oyun mantığı sunucu tarafında test edilebilir saf modüllere ayrılmıştır.
Numex Codex tarafından oluşturulmuştur.
Özellikler
| Özellik | Açıklama |
|---|---|
| 🎯 20 bölüm | Kademeli zorluk eğrisi, her bölümde farklı tahta düzeni |
| 🎨 Saf CSS şekerler | Emoji yok; 6 tip, 3 şekil, gradyanlı gövde |
| ✨ Özel şekerler | 4'lü → çizgili, 5'li → renkli, L/T → bomba |
| 🔗 Zincirleme | Art arda patlamalar x1.5 → x2 → x2.5 çarpanla ödüllenir |
| 🔨 Güçlendiriciler | Çekiç, Karıştır, Bomba — bölüm zorluğuna göre sayı artar |
| 🧊 Jel hedefleri | Bazı bölümlerde zemin temizleme görevi |
| ⭐ Yıldız sistemi | Her bölümde 3 yıldız eşiği |
| 🏆 Skor tablosu | Bölüm başına en iyi 10 skor (sunucu tarafı) |
| 💾 İlerleme kaydı | localStorage ile bölüm kilidi ve yıldızlar saklanır |
| 🔊 Ses | WebAudio ile sentezlenmiş efektler (harici dosya yok) |
| 📱 Responsive | Mobil öncelikli; dokunma ve sürükleme desteği |
Kurulum
npm install
npm start
Ardından tarayıcıda: http://localhost:4321
Geliştirme (dosya değişince otomatik yeniden başlatma):
npm run dev
Testler:
npm test
Mimari
┌──────────────────────────────────────────────────────────┐
│ Tarayıcı │
│ public/index.html → public/css/style.css │
│ public/js/oyun.js → arayüz denetleyicisi │
│ │ │
│ └── src/engine/* (motoru doğrudan import eder) │
└────────────────────────┬─────────────────────────────────┘
│ fetch /api/...
┌────────────────────────▼─────────────────────────────────┐
│ Node + Express │
│ server/index.js → uçlar + statik servis │
│ server/levels.js → 20 bölüm tanımı │
│ server/leaderboard.js → skor tablosu (bellek içi) │
└──────────────────────────────────────────────────────────┘
Motor DOM'dan tamamen bağımsızdır — bu sayede hem tarayıcıda hem
node --test altında aynı kod doğrulanabilir.
Klasör yapısı
numex-candy/
├── package.json
├── README.md
├── server/
│ ├── index.js Express sunucusu ve API uçları
│ ├── levels.js 20 bölüm tanımı + tahta üreticileri
│ └── leaderboard.js skor tablosu deposu
├── src/
│ └── engine/
│ ├── board.js tahta temsili, dolum, takas, hamle kontrolü
│ ├── match.js eşleşme bulma, özel şeker kararı, yayılım
│ ├── cascade.js yerçekimi, zincirleme döngüsü
│ └── score.js puanlama, yıldız, booster, hedef durumu
├── public/
│ ├── index.html arayüz iskeleti
│ ├── css/style.css tema ve şeker çizimleri
│ └── js/oyun.js oyun denetleyicisi
└── test/
└── engine.test.js motor testleri (20 test)
API
| Metot | Uç | Açıklama |
|---|---|---|
GET |
/api/saglik |
Sunucu sağlık kontrolü |
GET |
/api/sekerler |
Şeker tipi listesi |
GET |
/api/levels |
Tüm bölümlerin meta bilgisi |
GET |
/api/levels/:id |
Tek bölüm (meta + tahta düzeni) |
GET |
/api/levels/:id/board |
Bölümün başlangıç tahtası |
GET |
/api/leaderboard/:id |
Bölüm skor tablosu |
POST |
/api/leaderboard |
Skor kaydet |
POST /api/leaderboard gövdesi:
{ "levelId": 1, "isim": "Oyuncu", "skor": 4250, "yildiz": 2 }
Oyun kuralları
- 3'lü eşleşme → şekerler patlar, temel puan
- 4'lü eşleşme → çizgili şeker doğar (satır veya sütun temizler)
- 5'li eşleşme → renkli şeker doğar (tahtadaki tüm aynı renkleri siler)
- L / T şekli → bomba doğar (3x3 alanı temizler)
- Zincirleme patlama → ardışık turlar çarpanla çarpılır
- Geçersiz takas hamle harcamaz (takas geri alınır)
Bölüm hedef tipleri
| Tip | Anlamı |
|---|---|
score |
Belirtilen puana ulaş |
collect |
Belirtilen renkten N adet topla |
jel |
Tahtadaki tüm jelleri kır |
Kontroller
| Girdi | İşlev |
|---|---|
| Tıkla → tıkla | İki komşu şekeri takas et |
| Sürükle | Şekeri yönüne doğru takas et |
Esc |
Seçimi / aktif güçlendiriciyi iptal et |
Ctrl + R |
Bölümü yeniden başlat |
Teknolojiler
- Node.js ≥ 18 (ES Modules)
- Express 4 — sunucu ve API
- Saf JavaScript — oyun motoru (bağımlılık yok)
- Saf CSS — şeker çizimleri, animasyonlar (harici kütüphane yok)
- WebAudio API — sentezlenmiş ses efektleri
- node:test — birim testleri
Lisans
MIT — Numex AI Bilişim Teknolojileri