Transport Fever Wiki - modding:developerinfo
http://www.transportfever.com/wiki/
2026-04-15T00:42:22+00:00Transport Fever Wiki
http://www.transportfever.com/wiki/
http://www.transportfever.com/wiki/lib/exe/fetch.php?media=wiki:dokuwiki.svgtext/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Base config
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:baseconfig&rev=1741076570&do=diff
Base config
Overview
All main aspects of the game world can be configured in the file base_config.lua, which can be found in the folder res\config\.
It is structured as follows:
game.config.costs = {
-- general cost configuration
}
game.config.cargotypes = {
-- table with cargo types
}
game.config.terrain = {
-- configuration of generator, shaders, textures, and vegetation
}
game.config.environment = {
-- lighting, fog, sky box and environment map
}
game.config.audio = {
-- co…text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Bridges
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:bridges&rev=1741076570&do=diff
Bridges
Overview
A bridge configuration files specifies a set of parameters to define the properties, dimension, features, and visuals of tracks.
They are stored in .lua files in the folder res\config\bridge\.
The file has the following format:text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Constructions
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:constructions&rev=1741076570&do=diff
Constructions
The concept of constructions, introduced with Transport Fever, is very powerful. It allows to configure and create a lot of different building types and assets in just one format. This includes stations, depots, industries, town buildings and different kinds of assets. They are stored intext/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Directory structure
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:directorystructure&rev=1741076570&do=diff
Directory structure
Important notice
All text files (models, meshes, scripts etc.) should be encoded in UTF-8. Also, it is recommended to use lower-case file names to avoid problems on case-sensitive OSes / file systems.
Mod layout
The game’s installation folder (usuallytext/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Maps
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:maps&rev=1741076570&do=diff
Maps
Overview
In addition to random maps, it's possible to create custom maps. The only thing you need is a heightmap in form of a greyscale image. In an accompanying map.lua file you can specify the height range of your heightmap and it's possible to add towns and industries.text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Missions / Campaigns
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:missionscripting&rev=1741076570&do=diff
Missions / Campaigns
Overview
A mission in Transport Fever is made up of an info file, a save game and a mission script. Every mission is part of a campaign, and the files and folders are structured accordingly. That is, every campaign is a directory intext/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Models
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:models&rev=1741076570&do=diff
Models
Models are stored in the .mdl format in the res\models\model\ folder.
Overview
The format consists of geometric information for different levels of detail (LODs) and meta-data. For each LOD, there are a separate hierarchy of meshes (optionally organized in groups), animations, events, and a material configuration.text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Multiple Unit
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:multipleunits&rev=1741076570&do=diff
Multiple Unit
Overview
A multiple unit configuration files specifies a set of parameters to define a specific locomotive and wagon configuration. They are stored in .lua files in the folder res\config\multiple_unit\.
The file has the following format:text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Reference
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:reference&rev=1741076570&do=diff
Reference
Overview
It is important to understand the file and directory structure of mods. Resources in the mods res folder mirror the structure of the games original ‘’res’’ folder, but a mod contains additional metadata.
Learn more about thetext/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Scripting
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:scripting&rev=1741076570&do=diff
Scripting
Overview
The main file of every mod is mod.lua. This file contains the mod's metadata as well as the functions that are executed when the game is initialized.
The file has the following format (also see Directory structure):
function data()
return {
-- metadata
info = {
-- as described in Directory structure
},
-- options to show in the advanced game settings menu (optional)
options = {
-- format: category = { list of key/name pairs }
terrain = { { "test1",…text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Script mods
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:scriptmod&rev=1741076570&do=diff
Script mods
Examples
The best way to learn is probably to study existing game content. Also, the following mods are part of the installation and serve as example:
* urbangames_no_costs_1: sets all cost related variables to zero (script-based)
*text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)modding:developerinfo:soundsets
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:soundsets&rev=1741076570&do=diff
Sound sets
Overview
A sound set specifies a set of audio files and how their gain/pitch should be modified when played, depending on some input values. They are stored in .lua files in the folder res\config\sound_set\.
The file has the following format:text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Mod development
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:start&rev=1741076570&do=diff
Mod development
Overview
Transport Fever can be modified and extended by mods. Mods overwrite, add, or manipulate existing resource files. These resource files are kept in a folder named res.
There are many different types of resources:
* Scripts (models, materials, constructions, configurations, …)text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Publish Mod on Steam Workshop
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:steamworkshop&rev=1741076570&do=diff
Publish Mod on Steam Workshop
If you would like to share your mod with others, you can upload it to Steam Workshop. Just consider following steps.
Add tags
Make sure you have included to mod.lua some tags describing your mod. They are used by Steams search engine.text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Streets
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:streets&rev=1741076570&do=diff
Streets
Overview
A street configuration files specifies a set of parameters to define the properties, dimension, features and visuals of streets. They are stored in .lua files in the folder res\config\street\.
The file has the following format:
function data()
return {
-- property and dimension definitions
-- ...
materials = {
-- material definitions
},
assets = {
-- asset definitions
},
bridges = {
-- bridge definitions
},
}
…text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Modding tools
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:tools&rev=1741076570&do=diff
Modding tools
Model Viewer
Overview
The Model Viewer can be used to view and test models.
The tool allows playing animations, changing the age (dirt and rust overlay) and the color of a vehicle as well as showing the different logos. Also, passenger load (seats) can be tested. Please note that it's currently not possible to test cargo load indicators.text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Town buildings
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:townbuilding&rev=1741076570&do=diff
Town buildings
Town buildings are a subcategory of construction files. Although town buildings can be configured in the same way as any other construction, they have certain restrictions and conditions.
Overview
Town buildings are stored as .con files in the foldertext/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Tracks
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:tracks&rev=1741076570&do=diff
Tracks
Overview
A track configuration files specifies a set of parameters to define the properties, dimension, features, and visuals of tracks. They are stored in .lua files in the folder res\config\track\.
The file has the following format:
function data()
return {
-- name, description, availability
-- shape configuration
-- ballast configuration
-- sleeper configuration
-- rail configuration
-- catenary configuration
-- track configuration
-- speed …text/html2025-03-04T08:22:50+00:00Anonymous (anonymous@undisclosed.example.com)Tunnels
http://www.transportfever.com/wiki/doku.php?id=modding:developerinfo:tunnels&rev=1741076570&do=diff
Tunnels
Overview
A bridge configuration files specifies a set of parameters to define the properties, dimension, features, and visuals of tracks. They are stored in .lua files in the folder res\config\tunnel\.
The file has the following format:
function data()
return {
name = _("Standard tunnel"),
carriers = { "ROAD" }, -- or { "RAIL" }
portals = {
{ "railroad/tunnel_old.mdl" },
{ "railroad/tunnel_double_old.mdl" },
{ "railroad/tunnel_large_start.mdl", "railroad/tunnel_large_rep.…