ComputerCraft emulator written in Urn.
Designed to be able to run on multiple Lua platforms (ComputerCraft, POSIX + Lua 5.1/5.2/5.3/JIT).
Compiling is done with the Urn compiler.
There is a Makefile for easy building and running. It can also download supplementary files you will need to run CCBox.
The CCBox build environment uses a directory, buildenv, to store the output
Lua executable and all the required files for compilation.
If this is the first time you're building CCBox, you should run make buildenv
to fetch the required files.
To build CCBox in the normal configuration, run make or make build.
To build CCBox with an embedded filesystem and libraries, run make build-embed.
The output Lua executable will be located at buildenv/ccbox.lua.
To run CCBox with Urn stack traces, run make run.
To profile CCBox with a function time graph, run make run-profile.
The simplest way to run CCBox in the terminal is to run make run.
To run CCBox inside of CC, get a boot file (bios.lua):
wget https://raw.githubusercontent.com/dan200/ComputerCraft/master/src/main/resources/assets/computercraft/lua/bios.lua bios.lua
And then simply run ccbox.
You can exit a VM by running shutdown.
There are many different options available:
usage: buildenv/ccbox.lua [--help] [--bios BIOS-PATH] [--log LOG-PATH] [--command STARTUP-COMMAND] [--features FEATURES] [VFS-MOUNTS...]
VFS-MOUNTS The virtual file system mounts.
`<attrs>:<mount>:[dir]`
attr: attributes. w (write), t (tmpfs), c (ccfs)
Temp doesn't require a dir argument.
mount: mount point (has to start with /)
dir: host file system directory
Can be relative to the current directory.
Default on CC platform: cw:/:. c:/rom:/rom
Default on PUC platform: tw:/:@embed
--help, -h Show this help message
--bios, -b The bios.lua file path.
--log, -l The log file path.
--command, -c The startup command.
--features Enabled features, space separated.
Possible values: "advanced network redstone peripheral disk mount"
Default values: "advanced network"
It is recommended you build this program yourself (see Building), as this download can be outdated.
wget https://i.crzd.me/ccbox.lua
This was originally my entry for CCJam 2017, but has since been updated.
You can find the original code for the CCJam 2017 in the ccjam-2017 tag.
This program was made with and tested for the ComputerCraft 1.80 Nightly builds, but could run on older versions too.