whatisgithub

What is riotbots-public?

weebowiz/riotbots-public — explained in plain English

Analysis updated 2026-05-18

4TypeScriptAudience · generalLicense

In one sentence

A browser-based 3D robot combat game on a collapsing Mars colony, with server-authoritative multiplayer battles and a local bot-vs-bot mode.

Mindmap

mindmap
  root((Riot Bots))
    What it does
      3D robot combat game
      Mars colony setting
      Runs in browser
    Tech stack
      TypeScript
      Next.js
      three.js
      Colyseus
    Use cases
      Multiplayer challenge mode
      Dual battle bot fights
      Daily rankings
    Audience
      Players
      Game developers
    License
      MIT

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play multiplayer robot combat against waves of enemies and bosses

USE CASE 2

Watch two AI-controlled robots fight in local Dual Battle mode

USE CASE 3

Climb a daily ranking leaderboard in multiplayer challenge mode

USE CASE 4

Study the codebase to learn server-authoritative multiplayer game design

What is it built with?

TypeScriptNext.jsthree.jsRapierColyseusPostgres

How does it compare?

weebowiz/riotbots-public0labs-in/vision-linkarviahq/arvia
Stars444
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderate
Complexity3/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

So what is it?

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.

Copy-paste prompts

Prompt 1
Help me set up Riot Bots locally including the Postgres ranking database
Prompt 2
Explain how server-authoritative combat prevents cheating in this game
Prompt 3
Walk me through the tools for tuning bots, bosses, and maps in this project
Prompt 4
Show me how the localization system works for adding new languages

Frequently asked questions

What is riotbots-public?

A browser-based 3D robot combat game on a collapsing Mars colony, with server-authoritative multiplayer battles and a local bot-vs-bot mode.

What language is riotbots-public written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, three.js.

Who is riotbots-public for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.