hzchet/blockade

Blockade is a browser-based multiplayer first-person shooter with a blocky, Minecraft-style look. Players are split into red and blue teams and fight each other in a voxel world where you can also place blocks. The game runs entirely in a web browser, so no installation is needed for players beyond opening a link. The server is a small Node.js program that handles the game logic: tracking how much health each player has, recording kills, managing team scores, handling player respawns, and keeping track of which blocks have been placed in the world. It communicates with all connected browsers in real time using WebSockets, a technology that keeps a continuous two-way connection open so the game state stays synchronized across everyone playing. The browser side uses Three.js, a library for displaying 3D graphics on a webpage. Textures are generated by the code itself rather than loaded from image files, which keeps the project simple. The game includes three weapons (rifle, shotgun, and sniper rifle) plus a block-placement mode, and controls are the standard FPS layout: WASD to move, left-click to shoot or place, right-click to zoom with the sniper scope. To host your own game, you need Node.js installed on a machine. You start the server with one command and can optionally expose it to the internet using a free tunneling tool called cloudflared, which gives you a public URL others can visit. Players just open that URL, type a nickname, and are automatically placed on the smaller team to keep sides balanced.