A 2D Nintendo-styled multiplayer shooting game that I built because honestly, I got tired of all the overly complex modern games. Sometimes you just want to shoot things in colorful pixels, right?

This thing runs in your browser and lets you duke it out with friends (or strangers) in real-time. It's got bouncy green walls, solid gray ones, and enough chaos to keep you entertained for way longer than it should.

The game's split into two parts - a Python backend that handles all the multiplayer magic and a frontend that's just vanilla HTML/CSS/JS (no fancy frameworks needed).

• Real-time multiplayer that actually works
• Physics that feel surprisingly decent for something I cobbled together
• Sound effects (turn your volume down first, trust me)
• Mobile support because why shouldn't you be able to shoot people on your phone?
• AI-generated quotes on the home page (because why not?)

• Sometimes the server gets cranky and you'll need to refresh
• The mobile controls could be better but they work
• Color picker might not sync perfectly between devices

server/               # Backend stuff
├── api.py           # Main game server (WebSocket magic happens here)
├── user.py          # User management & quote API
├── launcher.py      # Starts both servers
├── create_db.py     # Sets up the user database
└── run.sh           # Quick start script

web/                 # Frontend files
├── index.html       # Main menu/lobby
├── game.html        # Where the actual game happens
├── js/              # All the game logic
│   ├── game.js      # Main game loop
│   ├── multiplayer.js # WebSocket handling
│   ├── physics.js   # Movement and collision detection
│   └── ...more stuff
├── css/style.css    # Makes it look pretty
└── sound/           # Pew pew sounds
nds
 Pew pew sounds

You'll need Python 3.11+ (I tested it on 3.13, older versions might work but no promises).

cd server
pip install -r requirements.txt
./run.shsh

Then open web/index.html in your browser. The default server runs on localhost:7895 for the game and :4765 for user stuff.

The run.sh script fires up two servers:

• Game server on port 7895 (WebSocket + HTTP)
• User API on port 4765 (just HTTP)

If you want to run them separately:

# Terminal 1
python api.py



# Terminal 2  
python user.pyy

Open the game in two different browser windows (or devices). Use WASD or arrow keys to move around, click to shoot, space to shoot up, and R to reload.

Gray walls are solid, green walls are bouncy (because physics should be fun). Try not to die.

I've got this running at https://vv.bbarni.hackclub.app if you want to see it in action. The user API is on a separate subdomain because that's just how I set it up.

If you're deploying your own:

• Make sure both servers are accessible
• Update the server URLs in the frontend
• The game expects CORS to be enabled (it is by default)

If you want to add something or fix my terrible code, go for it. Just don't judge me too harshly for the JavaScript - it started as a quick experiment and spiraled out of control.

Do whatever you want with this. If it breaks, you get to keep both pieces.