SDK

What is it?

It’s a tool for you to preview and customize any 3rd-party content (trains, buildings or even trees) in the actual game’s environment.

Downloads

Download for Windows

Download for macOS

Tutorial

First, create a model in your favorite modeling software. We use Blender ❤

For the reference you can use models that came with the download.

After you’re done with the modeling, select a model to ensure nothing unwanted will be exported, and hit Export as OBJ:

Ensure that the Selection only, Include UVs and Triangulate Faces options are checked:

Set the filename — in this example we use MyModel.obj — and save file to VoxelTycoonSDK/Trains (if you are creating something related to trains) or VoxelTycoonSDK/Buildings (for enything else, like buildings or trees):

Now go to the VoxelTycoonSDK tool and choose Buildings or Trains from the second dropdown (based on where you’ve placed your model in the previous step). Then choose your model from the last dropdown:

The SDK will generate a palette texture called MyModel.png in the same folder where your OBJ file is stored. This palette will be used to to set the coloring for your model.

Go back into the modeling software and open UV editing mode:

Load the generated palette texture MyModel.png from the directory where you’ve placed your model (VoxelTycoonSDK/Buildings or VoxelTycoondSDK/Trains):

Unwrap the model using the colors from the palette. The colors in the palette are not important yet, we just need to map vertices’ UVs to the separate colors. You will set up the actual colors in the VoxelTycoonSDK tool later.

After unwrapping has finished, export the model as an OBJ again, rewriting your previous OBJ.

Go back to the VoxelTycoonSDK tool again. Click through different parts of the model and choose the colors in the color picker on the right bottom corner.

Pro Tip You can pick colors from other parts of the model by holding ALT.

You’re done! Feel free to share your work with us.

This site is hosted on GitHub, so feel free to open a Pull Request if you think something can be fixed, like a small typo or the whole sentences.