ds_mod_tools

This fork exists because I want to use Klei code instead of ktech, and I also want to have redistributable binaries independent of the libc running on the OS.

This is a fork from the source code for the 'Don't Starve Mod Tools' available on Steam Workshop.

It is a port from the original mod tools for Linux and Mac. In also improves on the original animation (i.e., SCML) compiler in mod tools primarily

properly calculating the bounding boxes of animation frames;
determining the correct frame to use in a timeline with variable images (i.e., proper correlation of animation frame elements to build symbol frames).

The Linux and Mac porting, as well as the improvements mentioned above, were done by @simplex. @DeathDisciple was responsible for getting the tools compiling once again under Windows, after the Unix port.

Compilation-time dependencies

This project uses Premake to generate the build files, so it must be installed.

Additionally, a C++ compiler is required. For Windows, either Visual Studio or MinGW may be used. For Mac, it is necessary to download and install the XCode package from Apple. For Linux, gcc and make (GNU make, also known as gmake) are required (you probably already have them).

Runtime dependencies

Under Windows, the tools have no runtime dependencies other than those bundled within the tools.

For Mac and Linux, a system wide installation of Python 3 is assumed, as well as the Python Imaging Library (PIL) or its backwards-compatible fork (Pillow).

Compilation instructions

The build is broken for Windows and Mac unless you change local ZAPPS = true to local ZAPPS = false in src/premake5.bat. This variable controls whether the build output runs regardless of which distro it is running on, but it is not compatible with non-Linux operating systems.

You need to compile the dependencies in src/external/freeimage & src/external/squish before you compile mod_tools. For Mac and Linux Running make inside the corresponding directories will do. I'm not sure about Windows.

Proprietary texture codecs supported by Klei (Qualcomm' Adreno ATC & Imagination Technologies' PVRTC) are disabled by default because they require their corresponding SDKs. These codecs are not used by default (DXT is used instead).

For Windows, run the src/premake5.bat script to generate a Visual Studio 2010 project in build/proj/. Then open this project in Visual Studio and build it. For MinGW, see the note below.

For Mac and Linux, enter src/ and run premake.sh, then enter the directory build/proj with a terminal and enter the command

$ make

(without the prefixing '$')

The output is built to build/win32, build/osx or build/linux.

To customize the build files placed in build/proj, instead of running src/premake.bat or src/premake.sh the premake5 program may be run directly from a terminal (cmd.exe, under Windows). For the full list of options, run premake5 --help, but the most significant scenario is generating GNU make files for compilation using MinGW, under Windows. This can be done via a

premake5 gmake

Usage

The tools were designed for being run by the autocompiler, which in turn was designed under the assumption the mod tools would be placed in a directory alongside Don't Starve's installation directory with the same structure as when installing them via Steam. In order to use the autocompiler, a folder structure such as this must be replicated (for example, under Windows, the folder placed at build/win32/mod_tools after compilation must be relocated in such a way that mod_tools/../../dont_starve is Don't Starve's installation directory).

Alternatively, the scml compiler may be used directly. I takes two arguments: the first one is the path of the scml file to build and the second one is the path to the directory of the mod in which to place the final product (an anim/ folder is created within the mod's if it doesn't exist).

Todo