git404hub

what is blueblack fr?

artan0/blueblack — explained in plain English

Analysis updated 2026-05-18

2TypeScriptAudience · developerComplexity · 3/5Setup · easy

tl;dr

A browser based territory control FPS prototype with LAN multiplayer, built using Babylon.js and TypeScript.

vibe map

mindmap
  root((blueblack))
    What it does
      Browser based FPS prototype
      Territory control matches
      LAN multiplayer lobby
    Tech stack
      TypeScript
      Babylon js
      Vite
      Rapier physics
    Use cases
      Play a LAN FPS match
      Study multiplayer networking code
      Reuse CC0 game assets
    Audience
      Game developers
      Prototype builders
    Features
      Three original operators
      Synced remote players
      Fixed 60Hz physics

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 make with this?

VIBE 1

Play a browser based territory control FPS prototype with friends over LAN.

VIBE 2

Host a local network match and let players choose from three original operators.

VIBE 3

Study how Babylon.js, Rapier physics and a WebSocket relay combine for LAN multiplayer.

VIBE 4

Use the bundled CC0 Quaternius and Kenney assets as a starting point for your own game.

what's the stack?

TypeScriptBabylon.jsViteRapierWebSocket

how it stacks up fr

artan0/blueblack4ssh1/mine-sweeperachawla19/intuitcode-extension
Stars222
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-01-31
MaintenanceMaintained
Setup difficultyeasymoderatemoderate
Complexity3/52/54/5
Audiencedevelopervibe coderdeveloper

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

how do i run it?

Difficulty · easy time til it works · 5min

Needs Node.js and npm, LAN hosting also requires opening two ports through your firewall.

The bundled game assets are CC0 and free to use for any purpose, the code's own license is not stated in the README.

in plain english

blueblack is a playable prototype for a competitive first person shooter that runs directly in a web browser and focuses on capturing and holding territory. The current build centers on a LAN playtest mode, where players on the same local network join a shared lobby, pick one of three original characters called operators, and drop into a compact sci-fi arena named Nexus-9. Matches last five minutes and end either when the timer runs out or when a player reaches 300 points by holding the map's central capture zone. Running it locally only needs a recent version of Node.js and npm, after which a single install and dev command starts a Vite powered development server. To host a match for multiple players, everyone connects to the same router, one machine runs the host command, and the others open the network address it prints in their browser. The first person to connect becomes the host and starts the match once everyone has picked a callsign and an operator, the game uses one network port for the browser app and a second for the LAN multiplayer connection. Under the hood the game is built with the Babylon.js 3D engine, using models and animations from Quaternius and Kenney, all released under a permissive CC0 license that allows personal and commercial use. Implemented features include full first person movement with sprinting, crouching and jumping, three weapons with independent damage, ammo and reload behavior, remote players whose movement, animations and weapons are synced across the network, and a physics engine running at a fixed sixty updates per second. Right now territory scoring and match results are calculated locally in each player's own browser rather than by the server, and the project has no accounts, internet based matchmaking, saved progression, leaderboards or anti-cheat systems yet. The README describes this clearly as an early stage project: the next planned step is moving scoring and hit detection onto the server itself along with compensating for network delay, with account systems and ranked play planned only after that more reliable foundation is in place.

prompts (copy fr)

prompt 1
Explain how blueblack's LAN hosting works, including the two network ports it uses.
prompt 2
Walk me through running blueblack locally with npm install and npm run dev.
prompt 3
Show me how the rifle, pistol and knife weapons are implemented in the gameplay code.
prompt 4
Help me understand blueblack's current network scope and what still runs locally per browser.

Frequently asked questions

what is blueblack fr?

A browser based territory control FPS prototype with LAN multiplayer, built using Babylon.js and TypeScript.

What language is blueblack written in?

Mainly TypeScript. The stack also includes TypeScript, Babylon.js, Vite.

What license does blueblack use?

The bundled game assets are CC0 and free to use for any purpose, the code's own license is not stated in the README.

How hard is blueblack to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is blueblack for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.