This build script is the recommended way to compile the game, including not only the DM code but also the JavaScript and any other dependencies.
- VSCode:
a) Press
Ctrl+Shift+B
to build. b) PressF5
to build and run with debugger attached. - Windows:
a) Double-click
BUILD.bat
in the repository root to build (will wait for a key press before it closes). b) Double-clicktools/build/build.bat
to build (will exit as soon as it finishes building). - Linux:
a) Run
tools/build/build
from the repository root.
The script will skip build steps whose inputs have not changed since the last run.
- On Windows,
BUILD.bat
will automatically install a private (vendored) copy of Node. - On Linux, install Node using your package manager or from https://nodejs.org/en/download/.
We used to include compiled versions of the tgui JavaScript code in the Git repository so that the project could be compiled using BYOND only. These pre-compiled files tended to have merge conflicts for no good reason. Using a build script lets us avoid this problem, while keeping builds convenient for people who are not modifying tgui.