bakervm 0.9.0

A virtual machine for building and running retro games
Documentation

bakerVM Crates.io Build Status Docs.rs

A virtual machine for building and running retro games

The logo of the bakerVM

Introduction

The bakerVM is a virtual machine that executes bakerVM bytecode.

A builder-like compiler backend for the vm can be found in definitions/image_builder.rs.

The executable images of the vm are encoded and decoded using MessagePack

NOTE THAT THIS SOFTWARE IS STILL UNDER HEAVY DEVELOPMENT AND IN NO WAY STABLE OR COMPLETE.

A screenshot of the bakerVM

Installation

Install sdl2

On Ubuntu:

sudo apt install libsdl2-dev

On macOS:

brew install sdl2

The toolchain doesn't support Windows yet

Install the toolchain

To get the newest version of the bakerVM toolchain, first you have to install Rust. The Project is currently tracking stable Rust. After you installed Rust and Cargo correctly, install the toolchain using the following command:

cargo install bakervm

If you already installed an older version you have to force the installation:

cargo install bakervm -f

After the installation, you should have the following binaries installed: bakervm and hudson.

hudson is the bakervm toolkit. It is currently only able to compile *.basm files.

hudson compile --basm path/to/main.basm

bakervm is the VM itself. On startup it loads the stock image by default. But you can specify any bakerVM image:

bakervm path/to/my/image/game.img