Full source code game web Spam Click Boss realtime
Spam Click Boss là game web clicker/raid boss nhiều người chơi, xây dựng bằng JavaScript ES Modules, Node.js và Firebase Realtime Database. Người chơi tạo hoặc tham gia phòng bằng mã, cùng tấn công boss, sử dụng kỹ năng và cạnh tranh damage theo thời gian thực.
Chức năng nổi bật
-
Tạo phòng, tham gia bằng mã và chia sẻ link phòng.
-
Host quản lý phòng, bắt đầu trận, rời phòng, chuyển host và loại người chơi.
-
Hỗ trợ tối đa 28 người chơi với nhân vật và kỹ năng tương ứng.
-
21 ải boss, mỗi boss có ảnh, màn giới thiệu, kỹ năng, âm thanh và hiệu ứng riêng.
-
Click attack, Big Hit, cooldown, damage realtime và thanh máu boss.
-
Boss countdown, bảng kết quả và ready check trước khi sang ải mới.
-
Bảng xếp hạng trong phòng, toàn server và riêng từng ải.
-
Nhạc nền, âm thanh skill, hiệu ứng boss và tùy chỉnh âm lượng.
-
Usage Guard, chế độ bảo trì và cảnh báo giới hạn tải Firebase.
-
Giao diện responsive cho desktop và thiết bị di động.
Công nghệ
-
HTML5, CSS3, JavaScript ES Modules.
-
Node.js 20+ và static development server.
-
Firebase Hosting, Firebase Realtime Database và Firebase Web SDK 10.12.5.
-
Node Test Runner với 36 bài kiểm thử gameplay.
Tài nguyên đi kèm
-
28 ảnh nhân vật và 28 skill tương ứng.
-
21 bộ ảnh boss/preview cùng icon kỹ năng boss.
-
Nhạc nền, âm thanh skill và các file license âm thanh.
-
Firebase Database Rules, tài liệu kiến trúc và hướng dẫn triển khai.
Bảo mật và cấu hình
Gói source đã được làm sạch, không chứa Firebase config thật, .firebaserc, cache triển khai, firebase-debug.log, node_modules, service account, mật khẩu hoặc secret. Người mua tạo Firebase project riêng và sao chép file cấu hình mẫu theo hướng dẫn.
Lưu ý kiến trúc
Phiên bản hiện tại là prototype realtime dùng Firebase transaction trực tiếp trên clientState. Khi triển khai production hoặc có giá trị kinh tế, nên chuyển damage/cooldown sang backend authoritative, siết chặt Security Rules và bật Budget Alert.
Kiểm thử
Đã chạy thành công 36/36 bài kiểm thử cho game engine, phòng chơi, boss, skill, leaderboard, maintenance và usage guard.
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
HƯỚNG DẪN CÀI ĐẶT
Hướng dẫn cài đặt Spam Click Boss
1. Yêu cầu môi trường
-
Node.js 20 trở lên và npm.
-
Firebase CLI.
-
Tài khoản Google và Firebase project riêng.
node --version
npm --version
firebase --version
2. Cài thư viện và chạy kiểm thử
npm install
npm test
Source có 36 bài kiểm thử cho game engine, phòng, boss, skill, leaderboard và maintenance.
3. Tạo Firebase project
-
Tạo project mới tại Firebase Console.
-
Bật Realtime Database và chọn region gần người dùng, ví dụ asia-southeast1.
-
Trong Project settings, tạo một Web App và lấy object firebaseConfig.
4. Tạo file cấu hình riêng
Copy-Item public/client/firebase-config.example.mjs public/client/firebase-config.mjs
Mở public/client/firebase-config.mjs và thay các giá trị YOUR_... bằng thông tin Web App của người mua. Không commit file này lên Git công khai.
5. Chạy local
npm run dev
Mở http://localhost:4173, tạo phòng rồi dùng tab thứ hai để kiểm tra chế độ nhiều người chơi.
6. Kết nối Firebase CLI
firebase login
firebase use --add
Chọn project vừa tạo. File .firebaserc sinh ra chỉ dùng cục bộ.
7. Deploy
firebase deploy --only database
firebase deploy --only hosting
Hoặc deploy cùng lúc:
firebase deploy --only hosting,database
8. Thay tài nguyên game
-
Nhân vật: public/assets/characters/.
-
Skill: public/assets/skills/.
-
Boss và preview: public/assets/boss/.
-
Icon skill boss: public/assets/boss_skill/.
-
Âm thanh: public/assets/sounds/.
Sau khi thay asset, chạy:
npm run assets:manifest
9. Kiểm tra trước khi public
-
Chạy npm test và đảm bảo 36/36 bài kiểm thử đạt.
-
Không công khai Firebase config thật, service account, mật khẩu hoặc secret.
-
Kiểm tra Security Rules, RTDB Downloads và bật Budget Alert.
-
Với production, chuyển gameplay sang backend authoritative và khóa clientState.
Tài liệu đầy đủ: xem README.md và HUONG_DAN_CAI_DAT.md trong gói source.
Nguồn: Topcode.vn
