🎤 VOICE RUNNER 🏃

Endless Runner HTML5 — lari otomatis, lompat pakai suara, isi lubang dengan voice challenge, dan main bareng 4 pemain via multiplayer real-time!

🎮 MAIN SEKARANG

⚡ Coba cepat: Buka index.html di browser (Chrome/Edge rekomendasi)

---

✨ FITUR UTAMA

Fitur	Deskripsi
🏃 Endless Runner	Lari otomatis, lompati rintangan dengan suara
🗣️ Voice Jump	Keras = lompat tinggi, pelan = lompat rendah
🎤 Voice Challenge	TERIAK keras untuk memecahkan balon & mengisi lubang
👥 Multiplayer 4P	Online real-time via Firebase
📍 Checkpoint	Auto-save tiap 500m, respawn kalau mati
🏆 Leaderboard	Lokal + Global (Firebase, anonymous auth)
📱 PWA	Installable, offline shell via service worker

---

🎮 CARA BERMAIN

Lompat dengan Suara!

🔇 Pelan → Lompat rendah → Hindari SPIKE
🗣️ Normal → Lompat sedang → Hindari BOX 📢 KERAS → Lompat tinggi → Hindari TIANG

Voice Challenge (TERIAK!)

🕳️ Lubang muncul + balon & kotak di atasnya
🎤 TERIAK KERAS (volume di atas threshold) beberapa frame
💥 Balon pecah → kotak jatuh → lubang ketutup + bonus 50 poin
❌ Diam saja → balon tidak pecah → jatuh ke lubang (-1 nyawa)

Tanpa mikrofon (ditolak/unsupported): lubang terisi otomatis setelah ±2.5 detik.

Scoring

Aksi	Poin
Lewati rintangan	+10
Voice challenge	+50
Jarak (per meter)	+2

---

🖼️ MAIN DI ITCH.IO

Embed game di website-mu:

<iframeframeborder="0" src="https://itch.io/embed/4845636?bg_color=efefef&amp;border_color=070707" width="552" height="167"><ahref="https://mardev1.itch.io/voice-runner">Voice Runner by TheCats</a></iframe>

---

🤝 KOMUNITAS

Bergabung dengan komunitas Voice Runner — diskusi, lapor bug, request fitur, atau sekadar nongkrong:

Platform	Link
💬 Discord	discord.gg/HbW8kJTJxf
🐙 GitHub	BoneFishStudio/VoiceRunners — issues & discussions
🎮 Itch.io	mardev1.itch.io/voice-runner
🌐 Main Online	voicerunners.vercel.app

---

🛠 TEKNOLOGI

Teknologi	Untuk
HTML5 Canvas	Semua rendering game
Vanilla JS	Framework-free
Web Audio API	Voice volume (lompat & isi lubang) + SFX + musik
Firebase RTDB	Multiplayer sync + leaderboard global
Firebase Auth	Anonymous auth (identitas pemain)
Service Worker	PWA offline shell
localStorage	Save data + cache skor

Browser Support

Voice pakai Web Audio API (AnalyserNode) — jalan di semua browser modern yang mendukung getUserMedia (bukan lagi SpeechRecognition yang cuma Chrome). Kalau izin mic ditolak, ada fallback otomatis.

Browser	Game	Voice	Multiplayer
Chrome ✅	✅	✅	✅
Edge ✅	✅	✅	✅
Firefox ✅	✅	✅	✅
Safari ✅	✅	✅	✅

---

📁 STRUKTUR FILE

📦 VoiceRunner
├── 📄 index.html → Entry point + semua UI
├── 📄 manifest.json → PWA manifest
├── 📄 sw.js → Service worker (offline shell)
├── 📄 vercel.json → Config Vercel
├── 📁 js/
│ ├── 📄 game.js → Core engine (game loop, physics, voice)
│ ├── 📄 audio.js → Web Audio API (musik + SFX)
│ └── 📄 multiplayer.js → Firebase multiplayer + auth + leaderboard global
├── 📁 css/
│ └── 📄 style.css → Styling
├── 📁 Music/ → File musik MP3
├── 📁 assets/ → Sprite, ikon PWA & aset
└── 📁 .github/workflows/ → ZIP Itch.io + Release + build Electron (desktop) → GitHub Release

---

📄 LISENSI

• Kode: Open source — bebas pakai & modifikasi
• Musik: Music/Moavii - Foreign (freetouse.com).mp3 — bebas royalti dari freetouse.com, atribusi: "Music: Moavii - Foreign (freetouse.com)"
• Sprite: Buatan sendiri

---

🐛 Ada bug? Mau nambah fitur? Tinggal bilang aja!