🎲 NJ Play — Ultimate 16-in-1 Online & Local Multiplayer Gaming Platform
A modern, full-stack, real-time multiplayer gaming hub featuring 16 classic arcade and strategy games, dual-mode architecture (Local WebSockets & Google Firebase Realtime), custom virtual economy, 3D cosmetics shop, and mobile-ready PWA support.
📑 Table of Contents
- 🎮 16 Included Games (Rules & Mechanics)
- ✨ Key Platform & Multiplayer Features
- 🛠️ Full Tech Stack Architecture
- ⚡ Dual Backend: Local WebSockets vs Google Firebase
- 🚀 Step-by-Step Installation & Setup Guide
- 📦 Build & Production Deployment
- 🌐 Public Global Sharing via Cloudflare Tunnel
- 📤 How to Upload to GitHub
- 📥 Download & Source Code Links
🎮 16 Included Games (Full Breakdown)
NJ Play includes 16 completely built, highly polished games categorized into Classic Board, Strategy & Duo, and Speed & Brain Games.
🎲 1. Classic Board Games
👑 1. Ludo Kings (2–4 Players)
Full classic Ludo with pawn capture mechanics, safe star zones, double blockades, and custom room rules (Require 6 to Open, Require Kill to Enter Home, One Coin Outside).
🐍 2. Snakes & Ladders (2–4 Players)
Exciting board race with slippery snakes, climbing ladders, and bonus turn mechanics on rolling a 6.
🎯 3. Bingo (2–4 Players)
Party bingo grid race! Complete horizontal, vertical, or diagonal number lines to trigger an instant BINGO victory.
🧠 2. Strategy & Duo Duel Games
♟️ 4. Chess (2 Players)
Complete standard chess engine with legal move validation, checks, checkmates, stalemate detection, and draw offers.
🏁 5. Checkers / Draughts (2 Players)
Classic diagonal capture rules, mandatory jump chains, multi-captures, and king promotion logic.
🧱 6. Quoridor (2 Players)
Tactical maze duel! Place wooden walls to block your opponent's path while advancing your pawn to the opposite baseline.
⚪ 7. Go / Weiqi (2 Players)
Ancient territory capture strategy game with stone placements, surrounded group captures, and liberties.
🔄 8. Othello / Reversi (2 Players)
Trap opposing discs between your pieces horizontally, vertically, or diagonally to flip them to your color.
⭐ 9. Gomoku (2 Players)
Five-in-a-row tactical grid duel. The first player to align 5 consecutive stones wins the match.
🔴 10. Connect 4 (2 Players)
Vertical gravity chip dropping battle. Align 4 of your colored chips before your rival blocks you.
❌ 11. Tic-Tac-Toe / XOX (2 Players)
Fast-paced 3x3 grid alignment duel with real-time turn countdown and instant rematches.
⚡ 3. Speed & Brain Games
🔢 12. Find Number (2–4 Players)
Reflex battle! Race against competitors to spot and tap target numbers on a randomized animated grid.
🔤 13. Word Finder (2–4 Players)
Vocabulary challenge! Search for hidden words in random letter matrix boards under time pressure.
🃏 14. Memory Match (2–4 Players)
Memory card flip competition. Memorize card pairs and match them to score points and streak bonuses.
📦 15. Dots & Boxes (2–4 Players)
Classic graph strategy! Draw lines between dots to close square boxes and claim consecutive extra turns.
🔠 16. SOS Game (2–4 Players)
Grid tactical battle! Place 'S' or 'O' tiles to form continuous S-O-S patterns in any direction.
✨ Key Platform & Multiplayer Features
🌐 Advanced Game Architecture
- ⚡ Real-Time Multiplayer Engine: Dual-mode synchronization via local WebSockets (
ws) or Google Firebase Realtime Database. - 👥 Online Matchmaking & Spectating: Host public or private 4-letter room codes (e.g.
ABCD), invite friends, or spectate ongoing matches. - 🎮 Pass & Play / Solo vs Bots: Full offline support on a single shared device or against intelligent AI bots when offline.
- 💰 Stakes & Casino Economy: 3D Casino Chips stake selector (500, 1K, 5K, 10K, 100K, 1M, 10M, 100M) with winner-takes-all prize pools.
- 🔥 7-Day Victory Streak: Daily milestone rewards, progressive coin payouts, EXP rank multipliers, and spin wheel prizes.
- 🎨 3D Cosmetics & Skins Store: Unlock custom 3D dice skins, coin animations, custom boards, badges, and VIP titles.
- 📱 PWA Ready: Fully responsive and installable as a Progressive Web App on Android, iOS, Windows, and macOS with cyber-dock navigation.
🛠️ Full Tech Stack Architecture
| Layer | Technologies & Libraries | Role in Platform |
|---|---|---|
| Frontend | React 19, TypeScript, Vite, Tailwind CSS v4 | Modern reactive UI, ultra-fast compilation, component-driven design. |
| Animations & SFX | Motion (Framer Motion), Canvas-Confetti, Howler.js | Fluid 60 FPS piece transitions, winning confetti, immersive sound effects. |
| Cloud Backend | Google Firebase (Auth, Firestore, Realtime DB) | Serverless cloud sync, global rooms, user profiles, cross-device accounts. |
| Self-Hosted Backend | Node.js, Express.js, WebSocket Server (ws) |
Zero-config local multiplayer, low-latency room updates. |
| Notifications | Web Push (VAPID) | Native push alerts for player turns, game invitations, and daily rewards. |
| Local Storage | High-Speed Local Storage Engine | Automatic state persistence, inventory, and atomic balance updates. |
⚡ Choose Your Backend: Local WebSockets vs Google Firebase
NJ Play is uniquely built to support two flexible backend architectures depending on your deployment preferences:
🔹 Mode 1: Zero-Config Local WebSockets (Default)
- Setup Time: 0 seconds (Works instantly straight out of the box).
- Technology: Built-in Express backend + High-speed WebSocket server (
ws). - Best for: Self-hosting, local LAN multiplayer, or instant global sharing via Cloudflare Tunnel.
- Configuration: Set
VITE_BACKEND_MODE=localin.env(or leave as default).
🔹 Mode 2: Cloud Google Firebase Realtime Backend
- Setup Time: ~2 minutes.
- Technology: Google Firebase Authentication + Cloud Firestore & Realtime Database.
- Best for: Serverless hosting on Vercel, Netlify, or Firebase Hosting without running a custom Node.js server!
- Configuration: Set
VITE_BACKEND_MODE=firebasein your.envfile and provide your Firebase credentials:
VITE_BACKEND_MODE=firebase
VITE_FIREBASE_API_KEY="AIzaSy..."
VITE_FIREBASE_AUTH_DOMAIN="your-app.firebaseapp.com"
VITE_FIREBASE_PROJECT_ID="your-app"
VITE_FIREBASE_STORAGE_BUCKET="your-app.appspot.com"
VITE_FIREBASE_MESSAGING_SENDER_ID="123456789"
VITE_FIREBASE_APP_ID="1:123456789:web:abcdef"
VITE_FIREBASE_DATABASE_URL="https://your-app-default-rtdb.firebaseio.com"🚀 Step-by-Step Installation & Setup Guide
-
Step 1: Check Prerequisites
Ensure you have Node.js 18+ (LTS) installed on your machine. Open your terminal and verify:
node -v npm -v -
Step 2: Clone Repository & Install Dependencies
Clone the project repository to your local machine and install packages:
git clone https://github.com/anpvin/NJ-Play-16-in-1-Online-Local-Multiplayer-Gaming-Platform.git cd NJ-Play-16-in-1-Online-Local-Multiplayer-Gaming-Platform npm install -
Step 3: Environment Setup (Choose Local or Firebase)
Copy the sample environment file to create your local config:
cp .env.example .envSelect your preferred mode: leave default for Local WebSockets, or enter your Firebase credentials for Google Firebase Realtime mode.
-
Step 4: Launch Development Server
Start the live development server with hot module replacement (HMR):
npm run devOpen your browser and navigate to
http://localhost:3000!
📦 Build & Production Deployment
To compile the client bundle and run the high-performance production server:
# 1. Compile optimized client bundle
npm run build
# 2. Launch production server
npm start🌐 Public Global Sharing via Cloudflare Tunnel
Want to play with friends across the world without opening router ports or paying for servers? You can expose your local instance securely using Cloudflare Tunnel:
cloudflared tunnel --url http://127.0.0.1:3000This immediately gives you a secure global https://*.trycloudflare.com link that your friends can open on any mobile phone, tablet, or PC to join your rooms instantly!
Ready to Play or Deploy NJ Play?
Download the complete open-source source code or star the repository on GitHub!
