whatisgithub

What is system-foundry?

ai-guy404/system-foundry — explained in plain English

Analysis updated 2026-05-18

1JavaScriptAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A browser-based sandbox game where you build spaceships out of physics-simulated blocks, including engines, wiring, and logic circuits, then fly and fight with them.

Mindmap

mindmap
  root((System Foundry))
    What it does
      Block based ship builder
      2D physics sandbox
      Build and combat modes
    Tech stack
      JavaScript
      Python server
      No build step
    Use cases
      Design ships from blocks
      Simulate realistic combat
      Build logic circuits
      Save and share blueprints
    Audience
      Game hobbyists
      Sandbox game fans
    Setup
      Clone the repo
      Run local Python server
      Open in browser

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

Design a spaceship by placing structural, fuel, and engine blocks on a grid.

USE CASE 2

Fly and crash ships in combat mode to see realistic physics-based damage and breakup.

USE CASE 3

Build simple logic circuits using wire-based components like diodes and timers.

USE CASE 4

Save and load ship designs as JSON blueprint files to share or reuse.

What is it built with?

JavaScriptPythonHTML5 Canvas

How does it compare?

ai-guy404/system-foundry0xmukesh/docusaurus-tutorial1tsmejp/palworld-docker-wine
Stars111
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-12-27
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencegeneraldeveloperops devops

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Python 3 to run the local server, no other dependencies.

So what is it?

System Foundry is a browser based sandbox game where you build spaceships out of blocks, similar in spirit to placing blocks in Minecraft, and then fly them in a world with real physics. It has two modes. In build mode you place blocks on a grid to design your ship. In combat mode, ships become physical objects that can collide with each other, take damage based on the force of impact, and break apart at their weak points, piece by piece, exactly the way the physics engine calculates. The blocks are not just hull pieces. There are metal blocks for structure and hit points, fuel blocks for storing and moving fuel, engines that burn fuel to create real thrust, electrical blocks like wires and buttons that power everything else, and logic blocks like diodes and timers that let you wire together simple computation without dedicated AND or OR gate blocks, since the game lets you build that behavior out of simpler pieces. There are also sensors that detect things around the ship, wireless radio signaling, explosives, and docking ports that let separate ships join together or split apart while the simulation is running. The game is single player only right now, with multiplayer listed as a long term goal that has not been started. It runs entirely in the browser with plain JavaScript and no build tools, backed by a small Python server you run locally to host the files. To try it, you clone the project, run a Python script to start a local server, and open the given address in your browser. The README describes the core physics, electricity, fuel, and collision systems as already well tested with ships made of thousands of blocks. It is released under the MIT license and the author is actively looking for outside contributors.

Copy-paste prompts

Prompt 1
Walk me through cloning and running System Foundry locally on my computer.
Prompt 2
Explain how the wire-based logic system works without dedicated AND or OR gates.
Prompt 3
Show me the controls for switching between build mode and combat mode.
Prompt 4
Help me understand the block families available for building a ship.
Prompt 5
What should I read before contributing changes to the physics engine?

Frequently asked questions

What is system-foundry?

A browser-based sandbox game where you build spaceships out of physics-simulated blocks, including engines, wiring, and logic circuits, then fly and fight with them.

What language is system-foundry written in?

Mainly JavaScript. The stack also includes JavaScript, Python, HTML5 Canvas.

How hard is system-foundry to set up?

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

Who is system-foundry for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.