🌃 NEON SURVIVORS

Một game survivor / bullet-heaven hoàn chỉnh (lấy cảm hứng từ Vampire Survivors), viết thuần bằng HTML5 Canvas + JavaScript — không cần cài đặt, không asset ngoài, không internet, mọi thứ từ đồ họa đến âm thanh đều được sinh tự động bằng code.

---

▶️ Cách chạy

Cách 1 — mở thẳng file: nhấp đúp vào index.html (Chrome / Edge / Firefox).

Cách 2 — qua local server (khuyến nghị cho mobile LAN):

cd 2dsurvivor
python3 -m http.server 8080     # hoặc: npx serve .
# mở http://localhost:8080

🎮 Điều khiển

Hành động	Desktop	Mobile
Di chuyển	WASD / Phím mũi tên	Kéo ngón tay trên màn hình (joystick ảo)
Tấn công	Tự động — cứ việc né!	Tự động
Tạm dừng	Esc / P	Nút hệ thống
Chọn nâng cấp	Chuột / 1–4	Chạm

✨ Tính năng

Gameplay

• 11 vũ khí riêng biệt (đũa phép, roi, phi đao, quả cầu quay, rìu, hào quang, thiên lôi, cầu lửa, băng tinh, thánh giá, 🧨 mìn hẹn giờ) — mỗi vũ khí 8 cấp với bảng nâng cấp riêng.
• 11 dạng tiến hóa: (mìn → 💣 Vườn Pháo Hoa) vũ khí đầy cấp + sở hữu passive tương ứng → mở Rương Báu Vật (rơi từ quái Tinh Anh & Trùm) để tiến hóa (VD: Đũa Phép + Siêu Dẫn ⇒ 🌟 Bão Thần Tín).
• 13 vật phẩm bị động (sát thương, giáp, HP, hồi máu, hồi chiêu, diện tích, tốc đạn, thời gian, di chuyển, nam châm, may mắn, tham lam, tuệ tăng).
• 10 nhân vật mở khóa dần (thêm 🏹 Hana chí-mạng & 🧱 Bram diện-tích), kèm 🎨 skin màu mua bằng vàng.
• Đạo quái theo phút: 8 loại quái thường (đuổi, bắn, bay lượn, húc, chia màn…), quái Tinh Anh định kỳ, và 4 Trùm lớn ở phút 5/10/19: 🐺 Sói Đầu Lớn → 💀 Pháp Sư Xương → 👹 Quái Vật Địa Ngục → ⚰ Tử Thần. Hạ Tử Thần ở phút 19 để chiến thắng.
• Hiệu ứng trạng thái: cháy, làm chậm, đóng băng (kèm sát thương vỡ băng), choáng, đẩy lùi, hút máu.
• Chí mạng, số sát thương nổi, hạt hiệu ứng, rung màn hình, mũi tên chỉ trùm ngoài màn hình.

Tiến trình & tùy chọn

• Meta-progression: vàng tích lũy vĩnh viễn, cửa hàng 12 nâng cấp vĩnh viễn (có hồi sinh, bốc lại…).
• Lưu tự động bằng localStorage (khóa neon_survivors_v1), kèm nút xóa dữ liệu.
• Tùy chọn đầy đủ: âm lượng chung/nhạc/SFX, rung màn hình, số sát thương, chất lượng hạt (Thấp/Vừa/Cao), hiện FPS, tự tạm dừng khi mất tiêu điểm, ngôn ngữ Việt/Anh chuyển tức thì, fullscreen, remap phím di chuyển.
• Bách khoa toàn thư (Codex): xem toàn bộ vũ khí/passive/quái/trùm/nhân vật + điều kiện mở khóa.
• Màn hình tổng kết: thời gian, kills, vàng, cấp độ, kỷ lục cá nhân.
• Chơi được trên desktop lẫn mobile (joystick ảo), responsive theo DPR; cài được như app (PWA).

🆕 Phase 1 — thương mại hóa

• 3 biome: 🪦 Nghĩa Địa Neon → ❄️ Hang Băng (mở ở mốc 10 phút) → 🌋 Vực Magma (mở sau 1 thắng); mỗi biome có bảng quái, kế hoạch trùm, palette và hệ số HP/vàng riêng.
• Chế độ Vô tận (∞) + 4 bậc độ khó (I → 💀): HP/sát thương tăng, vàng thưởng tăng.
• ⚡ Thử thách hôm nay: seed theo ngày UTC — cả thế giới chơi cùng 1 màn (nhân vật/stage cố định), lưu kỷ lục ngày.
• 🏆 23 thành tựu gắn tiến trình thật, popup vàng + tab riêng trong Codex.
• 💎 Đèn pha lê phá được rơi quanh bản đồ → xu + gà.
• 📜 Lịch sử 20 ván gần nhất + tổng hợp (tỉ lệ thắng, nhân vật chủ lực).
• 💾 Xuất/Nhập save dạng mã base64 (chuyển máy).
• Tutorial tương tác lần đầu chơi + mẹo trùm.
• Gamepad (stick trái/D-pad/A/Start), perf: viewport culling + object pool particle.
• 🥇 Bảng xếp hạng: scaffold Cloudflare Worker KV (server/lb-worker.js + wrangler.toml) — điền URL vào Tuỳ chọn là tự submit/top; chữ ký checksum chống sửa tay (client↔worker khớp 100%).

🔓 Gợi ý mở khóa

Nhân vật	Điều kiện
Mira	Diệt tổng cộng 500 quái
Bolt	Sống sót đến phút 10
Luna	Kiếm tổng cộng 2.000 vàng
Rook	Hạ trùm đầu tiên (phút 5)
Nyx	Sống sót đến phút 15
Sera	Thắng 1 ván
Vane	Diệt tổng cộng 5.000 quái

🧪 Kiểm thử (dành cho dev)

node test/integrity.js

Bộ test headless kiểm tra tính toàn vẹn dữ liệu (tiến hóa, bảng spawn, song ngữ VN/EN, bảng stat) và mô phỏng 2.5 phút chiến đấu thật trong sandbox VM: bắn, chết, rớt đồ, lên cấp, mở rương tiến hóa, não AI của cả 4 trùm, i-frame và dòng chết.

📁 Cấu trúc

index.html          entry point
css/style.css       theme neon tối
js/
  util.js           toán học, RNG, spatial grid broadphase
  i18n.js           từ điển VI/EN
  save.js           localStorage meta-progression
  audio.js          tổng hợp SFX + nhạc nền generative (WebAudio)
  data.js           TOÀN BỘ nội dung: vũ khí/passive/quái/trùm/cửa hàng
  entities.js       Player / Enemy / Proj / Pickup / Particle…
  systems.js        spawn director, AI, combat, pickups, level-up, chest
  render.js         vẽ canvas (nhân vật vector, hiệu ứng, vignette)
  ui.js             menu / HUD / modal DOM
  game.js           vòng lặp, trạng thái, input, camera
test/integrity.js   bộ test headless

Chúc bạn sống sót qua phút thứ 19! ⚰️🔥