Building TIC-80

So you want to build TIC-80 yourself

• Clone the TIC-80 repository to your code folder with
  • git clone --recursive https://github.com/nesbox/TIC-80.git
• Note: If you forgot to clone recursively, you have to run:
  • git submodule update --init --recursive

The building process

• Building TIC-80, like most software, is a two-part process.
• First, we generate the Makefile: "building instructions" for the hardware we want to build for.
• Then, we build an executable with the generated instructions
  • After making changes to code, only this part has to be done again.

Building on Windows with MinGW

Prerequisites

• Git (See Git setup)
• Cmake
  • Download Windows x64 Installer
• Ruby
  • Install newest version with Devkit
• MinGW-w64 (see next slide!)
  • Good luck finding anything on the official website
  • You have two options, described below
  • WIP: Both will fail lol. No idea how to do this

MinGW Option 1. MinGW bundled with Ruby

• Ruby comes with MinGW, so you don't even need to install anything extra
• <ruby-installation-folder>\msys64\ucrt64\bin
  • For me it was C:\Program Files (x64)\Ruby31-x64\msys64\ucrt64\bin
• Add this folder to system path environment variables (see instructions here)
• If this method fails, remove the folder from System Path, and follow MinGW option 2 (described below).

MinGW option 2. Winlibs

• Go to winlibs.com and download the latest Win64 UCRT runtime as a zip archive

  

• Unzip the archive.

• Move the mingw64 folder to C:\ (or whatever you'd like)

• Add the C:\mingw64 folder to system path environment variables (see instructions here)

Check that MinGW works

• To check MinGW works for you, open a new command prompt and run gcc --version
  • It should output gcc (Rev6, Built by MSYS2 project) 12.2.0 or some other version
  • If the version is 4.8, building won't be successful and you need to update your MinGW

Actually building

• Open the command line in the TIC-80 project folder (see help for Windows here)
• Use cd build to navigate to the build folder
• Run CMake:
  • cmake -G "MinGW Makefiles" ..
  • Note: To build the pro version, include the handle -DBUILD_PRO=ON
  • This takes some time!
  • If you see Configuring done and Generating done messages, it was successful.
• Run mingw32-make -j4
  • The built executable should appear under build/bin

Build errors

• If Cmake fails, see the build/CMakeFiles/CMakeError.log for clues
• Before trying CMake again, clear the cache: Remove build/CMakeCache.txt and the CMakeFiles folder.

Mruby

[ 17%] Built target mruby_vendor
mingw32-make: *** [Makefile:135: all] Error 2

• If mruby fails, you have most likely cloned your repo before mruby was added to the TIC-80 codebase.
• Detonate the repo and start from scratch.

Note about cmake

• -- Looking for strlcat - not found
• Don't worry about these "not found" messages

Creating a fork of the TIC-80 repository

• So, you want to make TIC-80 better.
• TIC-80 GitHub page: Fork > Create a new fork
• Clone your TIC-80 repo
• Add the original repo as a new remote:
  • git remote add nesbox https://github.com/nesbox/TIC-80.git

Reading

• Exporting a game from a custom build