weebowiz/riotbots-public

Riot Bots is a browser-based 3D robot combat game set in a collapsing Mars Colony. It runs entirely in a web browser without needing to install anything, using modern 3D web technology to deliver fast-paced arcade-style combat. The game has two playable modes. Multiplayer Challenge lets players join rooms to fight enemy waves, face boss phases, collect pickups, respawn, and compete on a daily ranking system. Dual Battle is a local bot-vs-bot mode where two AI-controlled robots fight each other on your device. A third mode (single player) is planned but not yet shipped. The multiplayer side is server-authoritative, meaning the server, not the players' browsers, handles combat outcomes, AI behavior, boss timing, and ranking submissions. This is a deliberate design choice that makes cheating harder in a competitive context. Rankings are stored in Postgres if a database is configured, otherwise they fall back to in-memory storage. The technical stack includes Next.js for the web frontend and server, three.js with react-three-fiber for 3D rendering, the Rapier physics engine for collision and hit feedback, and Colyseus for real-time multiplayer room management. The game is written in TypeScript. Built-in tools let developers tune bots, bosses, and maps without modifying core code. There is also a localization system for adding new languages, and a content model that allows adding new tanks, maps, and game modes in a structured way. The source code is MIT licensed. The full README is longer than what was provided.