TruckLib is a C# library for the map format of Euro Truck Simulator 2 / American Truck Simulator. The primary focus is programmatic map creation, but the library also handles various other tasks needed for this purpose, such as reading prefab descriptor files.
The currently supported map format version is 900 (game version 1.48.5/1.49).
(This project is pretty much a perpetual alpha, so you'll probably run into a few issues sooner or later, and breaking changes will happen on occasion.)
TruckLib.ScsMap:
The main namespace of the library: classes for working with the map format.
TruckLib.Sii:
Parsers for .sii and .mat files.
TruckLib.Models:
Rudimentary support for binary model files (.pm*), prefab descriptors (.ppd), and binary .tobj files.
TruckLib.HashFs:
A reader for HashFS (.scs) files, the asset archive format of the game.
using System.Numerics;
using TruckLib.ScsMap;
var map = new Map("example");
Model.Add(map, new Vector3(10, 0, 10), "dlc_no_471", "brick", "default");
map.Save(@"<ETS2 folder>\mod\user_map\map");Documentation is available at https://sk-zk.github.io/trucklib/master/.
- The library does not calculate the bounding boxes of items, so you'll need to recalculate on load (Map > Recompute map).
- I've yet to figure out how the game calculates the length of roads etc. What I've come up with is accurate enough to not be too annoying, but you'll notice while editing one of these items that they will slightly change their path as the game recalculates its length.
- Anything to do with prefabs may or may not break in unexpected ways.
- The prefab object creator doesn't handle terrain points yet. Unless you need prefab terrain, this is also fixed by recalculating.
- When adding a camera path, the positions of the control points in the Keyframe objects are not set to any default values and therefore left at (0, 0, 0).
- Helper locators of curve items, if used by the model, are not placed automatically by the library because their coordinates are not known to it. Moving a locator node or a curve node which is tethered to a locator node will also cause issues. The editor will fix both of these once a curve node is moved or the properties dialog of the curve is closed.
- External map data (which is how the Winter Wonderland map was included in the game) is not yet supported.
- The HashFS v2 reader is able to extract, but not unpack, the packed .tobj format which .tobj/.dds pairs are converted to in this version of the format.
TruckLib is licensed under GPL v2 except for CityHash.cs.
Parts of TruckLib are based on ConverterPIX and SCS Blender Tools.