VV

Vivid Violence

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.

What’s In Here

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).

The Good Stuff

• 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?)

Known Issues

• 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

File Layout

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

Running This Thing

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

Quick Start

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

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

What The Script Does

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.py

How To Play

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.

Deployment Notes

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)

To-Do List

• Better mobile controls
• More maps (current one gets old)
• Spectator mode
• Maybe some kind of scoring system?
• Fix that weird bug where sometimes bullets don’t register

Contributing

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.

License

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