Stark Brawl is a fast-paced, browser-based multiplayer shooter powered by React, WebGL, and Starknet.
This repository contains the frontend code, enabling players to connect their wallets, battle in real-time, and interact with the Web3 economy.
- 🎮 Real-Time Multiplayer – Engage in intense PvP battles.
- 🌍 WebGL Graphics – Stunning visuals with PixiJS / Three.js.
- 🔗 Web3 Wallet Integration – Connect using Argent X & Braavos.
- 🛒 NFT Inventory & Marketplace – Trade Brawlers, skins, and weapons.
- 📊 Battle UI – Display player stats, health, and match progress.
- ⚡ Optimized Performance – Built with React + Vite for speed.
| Component | Technology |
|---|---|
| Frontend | React + Vite |
| Graphics | PixiJS / Three.js |
| Networking | WebSockets (Node.js Backend) |
| State Management | Zustand / Redux |
| Blockchain | Starknet.js for smart contract interactions |
1️⃣ Clone the Repository**
git clone https://github.com/SunsetLabs/stark-brawl-web.git
cd stark-brawl-web
2️⃣ Install Dependencies
pnpm install # or yarn install
3️⃣ Run the Development Server
pnpm dev # Starts the local dev server
🔹 Open http://localhost:3000 to see the game running in your browser.
🎮 How to Play
1️⃣ Connect Your Wallet – Use Argent X or Braavos.
2️⃣ Choose Your Brawler – Each character is an NFT with unique abilities.
3️⃣ Enter a Battle – Match up in 3v3 combat or Battle Royale mode.
4️⃣ Win & Earn – Earn tokens & NFTs as rewards.
🌐 Web3 Integration
Stark Brawl utilizes Starknet for decentralized asset ownership. Players can:
✅ Own their Brawlers & Skins as NFTs.
✅ Buy, sell, and trade items in the marketplace.
✅ Participate in governance through the Stark Brawl DAO.
📌 Roadmap
✅ Implement WebGL game rendering
✅ Integrate Starknet.js wallet connections
🔄 Enable real-time matchmaking
🔄 Deploy NFT-based inventory & trading
🔄 Optimize for mobile UI & controls
🤝 Contributing
We welcome contributions from the Web3 developer community! 🚀
📌 Steps to Contribute
1️⃣ Fork the repository
2️⃣ Create a new branch
git checkout -b feature/your-feature
3️⃣ Make your changes & commit
git commit -m "✨ Added new feature"
4️⃣ Push to GitHub and create a Pull Request