gitwtfhub

wtf is fi-shipkit?

savannah-i-g/fi-shipkit — explained in plain English

Analysis updated 2026-05-18

6PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A Blender toolkit that procedurally generates sci-fi spaceships, space stations, and city buildings from adjustable sliders instead of hand modeling.

Mindmap

mindmap
  root((FI ShipKit))
    What it does
      Procedural sci-fi ships
      Orbital stations
      City buildings
    Tech stack
      Blender
      Geometry Nodes
      Python
    Use cases
      Game asset generation
      Film and render scenes
      Headless pipeline builds
    Audience
      Blender artists
      Technical developers
    Setup
      Requires Blender 4.5 plus
      Run headless build scripts
      Export via glTF

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

Why would anyone build with this?

REASON 1

Generate detailed sci-fi spaceships in Blender by adjusting sliders instead of manually modeling meshes.

REASON 2

Build orbital stations or planetside city buildings for a game or film scene procedurally.

REASON 3

Rebuild and quality-check any kit headlessly from the command line as part of a pipeline.

REASON 4

Export finished models with textures to .glb for use in a game engine.

What's in the stack?

PythonBlenderGeometry NodesglTF

How it stacks up

savannah-i-g/fi-shipkitaclark4life/home-depot-crawlashishdevasia/ha-proton-drive-backup
Stars666
LanguagePythonPythonPython
Last pushed2014-08-10
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/5
Audiencedeveloperdeveloperops devops

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Blender 4.5 or newer, headless scripts need Blender's Python environment.

The code is copyleft (GPL-3.0-or-later, derivatives must stay open source), the kit assets and art are CC-BY-4.0, reusable with credit, anything you create with the kit is entirely yours.

Wtf does this do

FI ShipKit is a toolkit for the 3D program Blender that builds detailed science-fiction spaceships, orbital stations, and city buildings entirely out of adjustable sliders, instead of a person modeling every shape by hand. It works through Blender's geometry nodes feature, and every part of every generator was built with Python code, with no extra add-ons or premade node packs needed. There are five kits included: a stealthy frame ship, a war ship with sharp naval lines, a bright fleet ship, an orbital station generator with several building styles like spires and gantry yards, and a planetside building generator for things like tower blocks and industrial buildings. In each case, you open a ready-made file, drop a generator onto a shape, and then move sliders to change details like faction color scheme, hull style, or how much visual detail to include. Because it needs Blender 4.5 or newer, this is squarely a tool for people already comfortable inside Blender. Everything can also run headless, meaning from a command line with no graphical window open, which lets someone rebuild any kit from scratch, run automatic quality checks, and export finished models to the common .glb file format complete with textures. The project includes scripts for each of these steps, plus design notes explaining the underlying rules the kits follow, and a list of hard-won technical quirks the author ran into while building it, covering things like how Blender's randomness nodes behave and the order operations need to happen in in. The code itself is released under the GPL-3.0-or-later license, which requires that people releasing derivative code keep it open source too. The ready-made kit files, images, and textures are separately licensed under CC-BY-4.0, meaning they can be reused freely as long as credit is given. Ships, renders, or games someone makes using the kit belong entirely to that person, with attribution only required when redistributing the kit assets themselves.

Yoink these prompts

Prompt 1
Walk me through opening FI_ShipKit.blend and generating my first ship using the sliders.
Prompt 2
Explain what geometry nodes are and how this project uses Python to build them.
Prompt 3
Show me how to run the headless build and selftest scripts for the StationKit generator.
Prompt 4
Help me understand the socket contract convention so I don't break the pipeline when customizing a kit.
Prompt 5
How would I export a generated ship to .glb with textures using ship_export.py and bake_ship.py?

Frequently asked questions

wtf is fi-shipkit?

A Blender toolkit that procedurally generates sci-fi spaceships, space stations, and city buildings from adjustable sliders instead of hand modeling.

What language is fi-shipkit written in?

Mainly Python. The stack also includes Python, Blender, Geometry Nodes.

What license does fi-shipkit use?

The code is copyleft (GPL-3.0-or-later, derivatives must stay open source), the kit assets and art are CC-BY-4.0, reusable with credit, anything you create with the kit is entirely yours.

How hard is fi-shipkit to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is fi-shipkit for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.