gitwtfhub

wtf is voxelspace?

anton-petrov/voxelspace — explained in plain English

Analysis updated 2026-08-11 · repo last pushed 2020-01-03

Audience · developerComplexity · 2/5DormantLicenseSetup · easy

TL;DR

Voxel Space recreates a classic 1990s 2.5D terrain-rendering technique in minimal code, letting you draw flight-simulator-style landscapes from two simple 2D images without a modern 3D engine.

Mindmap

mindmap
  root((repo))
    What it does
      Renders 2.5D terrain
      Uses height and color maps
      Draws scene column by column
    Tech stack
      JavaScript
      Web demo
      2D images
    Use cases
      Learning retro graphics
      Prototyping landscapes
      Demoscene coding
    Limitations
      No full 3D
      No overhangs or buildings
      Possible patent issues
    Audience
      Retro graphics fans
      Beginners and students
      Demoscene coders

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

Learn how 1990s terrain rendering worked by reading and running the minimal code.

REASON 2

Prototype a retro flight-simulator style landscape using just two 2D images.

REASON 3

Teach or demonstrate demoscene-style graphics tricks using the included live web demo.

REASON 4

Appreciate how classic games like Comanche achieved realistic terrain on very limited hardware.

What's in the stack?

JavaScriptHTML5 CanvasWeb Demo

How it stacks up

anton-petrov/voxelspace000madz000/rfid-attendance00kaku/gallery-slider-block
LanguageTypeScriptJavaScript
Last pushed2020-01-032024-07-222021-05-19
MaintenanceDormantDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedeveloperdevelopergeneral

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Just open the included web demo in a browser or clone and run locally, no dependencies or external services required.

No license file is included, the README warns the Voxel Space technique may be patented in some countries, so treat this as an educational reference only.

Wtf does this do

Voxel Space is a project that recreates a classic 1990s terrain-rendering technique in just a few lines of code. It lets you build a 2.5D landscape, like flying over mountains and valleys in an old flight simulator, without needing a modern 3D graphics engine. The repo includes a live web demo so you can see the effect immediately, along with the code and map files to run it yourself. The method works by reading two simple 2D images: a height map (which says how tall the terrain is at every point) and a color map (which says what color to draw). The algorithm then draws the scene column by column across the screen, from back to front, painting vertical lines whose length depends on the terrain height and distance. Because the color map already includes shading and shadows, the engine doesn't have to calculate lighting, it just draws what the map says. This approach was made famous by NovaLogic's 1992 helicopter game Comanche, which looked years ahead of its time despite running on hardware far weaker than any phone today. Anyone curious about retro game graphics, demoscene-style coding, or how to make a convincing landscape with minimal code would find this instructive. It's a teaching tool more than a production library, useful for learning, prototyping, or just appreciating an elegant hack. The key tradeoff is that it's a 2.5D engine, not full 3D. You can't represent overhangs, buildings, or anything requiring more than one height per map position. It also can't show geometry above the terrain, only the ground itself. The terrain maps included are reverse-engineered from the original Comanche game, and the README notes the Voxel Space technique may still be patented in some countries, so it's best treated as an educational reference rather than something to ship in a commercial product.

Yoink these prompts

Prompt 1
Show me how to render a 2.5D voxel terrain landscape from a height map and color map using JavaScript and HTML5 Canvas, drawing columns back to front.
Prompt 2
Explain the Voxel Space algorithm used in 1990s games like Comanche and help me implement it in minimal JavaScript code.
Prompt 3
Build a simple web page that loads a height map image and a color map image, then renders a flyable 2.5D voxel terrain scene on a canvas.
Prompt 4
Help me understand the limitations of voxel space terrain rendering versus full 3D, and what types of geometry it cannot represent.

Frequently asked questions

wtf is voxelspace?

Voxel Space recreates a classic 1990s 2.5D terrain-rendering technique in minimal code, letting you draw flight-simulator-style landscapes from two simple 2D images without a modern 3D engine.

Is voxelspace actively maintained?

Dormant — no commits in 2+ years (last push 2020-01-03).

What license does voxelspace use?

No license file is included, the README warns the Voxel Space technique may be patented in some countries, so treat this as an educational reference only.

How hard is voxelspace to set up?

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

Who is voxelspace for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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