Skip to content

Latest commit

 

History

History
49 lines (34 loc) · 1.67 KB

windows.md

File metadata and controls

49 lines (34 loc) · 1.67 KB

TS3D on Windows

TS3D was designed to run on Unix platforms. However, using PDCurses and MinGW, I have gotten it to work on the Windows console. Note that it still must be built on Unix using MinGW and that the tests cannot run on Windows.

Build Requirements

MinGW is required as well as the source repository of PDCurses. The repository can be found here.

Building

Run this:

CC=... PDCURSES_DIR=... ./make-windows

CC should be set to the C compiler to use. The default is x86_64-w64-mingw32-gcc if CC is left unspecified.

PDCURSES_DIR should be set to the root directory of the PDCurses repository.

You can specify other parameters, e.g. CFLAGS, alongside the two above. These will work as normal.

The script will create a statically-linked executable ts3d.exe which you can run on Windows. Build $PDCURSES_DIR/wincon/pdcurses.a before running the script, and make sure it is built for Windows, not the native platform.

ts3d.exe statically linked to PDCurses and compiled with CFLAGS='-O3 -flto -Wl,--strip-all,--gc-sections' on my computer is a bit over 150KB in size.

Installation

The default data path for TS3D on Windows is %AppData%\ts3d rather than $HOME/.ts3d. You may manually install the game data to %AppData%\ts3d\data. To bundle the executable and the data for transport, run this:

CC=... PDCURSES_DIR=... ./make-windows ts3d.zip

On Windows, extract the zip. It will create a folder ts3d. Run install.bat that is inside the folder. This will install the game data. After the game data is installed using whatever method, the executable should work. Launch it from the command prompt.