https://github.com/w84death/cortex-labs-assembly-game

Cortex Labs - Real-time, puzzle, strategy game for x86 processors made in assembly. MS-DOS.
https://github.com/w84death/cortex-labs-assembly-game

assembly-language assembly-x86 baremetal baremetal-programming floppy freedos game msdos msdos-game strategy-game

Last synced: about 2 months ago
JSON representation

Cortex Labs - Real-time, puzzle, strategy game for x86 processors made in assembly. MS-DOS.

• Host: GitHub
• URL: https://github.com/w84death/cortex-labs-assembly-game
• Owner: w84death
• License: mit
• Created: 2025-06-07T09:27:07.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-11-16T19:28:13.000Z (about 2 months ago)
• Last Synced: 2025-11-16T21:16:12.377Z (about 2 months ago)
• Topics: assembly-language, assembly-x86, baremetal, baremetal-programming, floppy, freedos, game, msdos, msdos-game, strategy-game
• Language: Assembly
• Homepage:
• Size: 13 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ![Cortex Labs](docs/logo.png)

Real-time strategy for x86 processors made in assembly.

![Game screen](docs/screenshot-4.png)

## Features

* VGA 320x200, 16 colors, 4 colors per tiles, 3 + transparency for sprites

* Arne 16 color palette

* 2D tile-based top-down view

* Procedural map generation

* Big, 128x128 tiles, map

* 16x16 sprites/tiles in 4 colors

* No framebuffer, redrawing only parts that changed

* RLE image compression for pre-rendered backgrounds

* Game state machine

* Windows and Menu system

* Sound effects (PC Speaker)

* Rails system with pods transporting goods

* Main base expansion + buildings

* 3 type of resources to extract, transport, and refine

* Development tools (vibe coded C):

  * png2asm - compress tileset to assembly db

  * rleimg2asm - compress 320x200 images to assembly RLE db

  * fnt2asm - compress font tileset to assemlby db

## Tileset

![Sprites](docs/sprites.png)

## Running

Boot from a floppy or run on MS-DOS (FreeDOS).

![Game Title screen](docs/screenshot-1.png)

![Menu screen](docs/screenshot-2.png)

## Building

Create floppy and binary:

```make```

Make just binary:

```make com```

Check statistics:

```make stats```

For more targets check help.

```make help```

## Tools

### png2asm

For converting .png tilemap into 2-bit compressed and palettes assembly code.

```./png2asm tileset.png palettes.png ../../src/tiles.asm```

### rleimg2asm

For converting .png image into RLE compressed assembly code.

```./rleimg2asm frames/p1x.png ../../src/img_p1x.asm -asm p1x_logo_image -stats```

### fnt2asm

For converting .png font charset into 1-bit compressed assembly code.

```./fnt2asm font.png ../../src/font.asm```

![P1X logo screen](docs/screenshot-0.png)