🎮 Kaboom

Kaboom is a Web3-powered multiplayer battle game inspired by Mini Militia, designed to make blockchain adoption seamless and fun. Players enjoy thrilling gameplay first, then gradually unlock NFTs, tokens, and wallets as part of their journey.

---

🚀 Introduction

Kaboom is a fun multiplayer battle game inspired by Mini Militia, built on Web3 to make onboarding seamless. Players earn NFTs and tokens while playing, learning blockchain invisibly.

---

📝 Description

Kaboom delivers fast-paced multiplayer combat where players battle in arenas and climb leaderboards. At its core, Kaboom is about fun gameplay first — Web3 features are introduced later so players are not overwhelmed.

• Gameplay First: Players start by playing without Web3 barriers.
• Progressive Web3 Onboarding: Unlock character NFTs, earn tokens, and record victories on-chain.
• Invisible Learning Curve: Players experience wallets, NFTs, and tokens as part of their progression.

Built on Sui, Kaboom leverages:

• Move for secure smart contracts (NFTs, rewards, arena registry).
• Node.js backend for matchmaking, game logic, and API communication.
• JavaScript frontend for smooth user interaction and game interface.

---

🎯 Problem Statement

Web3 adoption is slowed by complex jargon and steep onboarding steps. Many people shy away from wallets, tokens, and NFTs because they feel overwhelming.
Kaboom solves this by creating a sneaky, fun pathway into Web3 — using gameplay as the bridge to blockchain.

---

🛠️ Features

• 🔫 Multiplayer battles with real-time action.
• 🧑‍🚀 Character NFTs minted at first login.
• 🪙 Reward tokens earned from victories and milestones.
• 🏟️ Arena Registry smart contract to record results.
• 📈 Progressive Web3 onboarding without overwhelming players.

---

🧩 Tech Stack

• Frontend: JavaScript
• Backend: Node.js
• Blockchain: Sui
• Smart Contracts: Move Language

---

📜 Smart Contract Modules

1. CharacterNFT.move – Mint unique player characters at first login.
2. RewardToken.move – Distribute tokens as battle rewards.
3. ArenaRegistry.move – Record and verify match results on-chain.

---

⚡ Getting Started

1. Clone the repo:

   git clone https://github.com/Talent-Index/Kaboom.git
   cd Kaboom

2. Install dependencies and run the project:

   # Install Node dependencies (use npm, yarn or pnpm depending on your preference)
   npm install

   # Create environment file
   cp .env.example .env
   # Edit .env and set:
   #  - SUI_RPC_URL (your Sui RPC endpoint)
   #  - SUI_PRIVATE_KEY (dev key for local testing)
   #  - DATABASE_URL (if using a DB for matchmaking/leaderboards)
   #  - Any other values in .env.example

   # Build Move smart contracts (requires Sui toolchain)
   cd contracts
   sui move build
   cd ..

   # Start backend and frontend (adjust paths if your repo uses different folders)
   # Option A: if services are in root package.json
   npm run dev
   
   # Option B: explicit services
   # cd server && npm run dev   # backend: matchmaking, game logic, APIs
   # cd web    && npm run dev   # frontend: game UI

3. Deploy contracts (optional)

   • For testnet or a local Sui node, use the Sui CLI to publish the built package. See contracts/README.md for deployment scripts and recommended gas budgets.

4. Run tests & linters

   npm test
   npm run lint
   npm run format
   # For Move unit tests:
   cd contracts
   sui move test

5. Requirements & notes

   • Node.js 18+ recommended.
   • Install Sui CLI and a local Sui node or point SUI_RPC_URL to a reachable endpoint.
   • Keep your private keys secure; do not commit .env or keys to Git.

6. Contributing

   • Read CONTRIBUTING.md for development guidelines, branch naming, and PR process.
   • Open issues and PRs on the repository; maintainers will review and provide feedback.

7. Helpful commands

   • Clean build: rm -rf node_modules && npm install
   • Build production frontend: npm run build --prefix web
   • Start production server: npm start --prefix server

You're ready — enjoy building and playing Kaboom!

Progressing