Introduction
While the vanilla game of Transport Fever 3 provides the player with a great number of models and content from different regions of the world, some people prefer to extend the variety further by adding more content. Others like to tweak some game mechanics or to alter some configurations to better suite their style of gameplay. The modding support of Transport Fever 3 reaches from the addition of new model content over the altering of existing contents to the scripting possibilities which reach deep into the game mechanics and user interface.
It is not recommended to adjust the files in the installation directory of Transport Fever 3! Instead, a mod should be created. From a file system perspective, a mod is simply a directory containing all the necessary data and script files. If you like to setup your own mod, look at the two examples at the bottom of this page or the mod components description. Read more for the syntax and the common resource types.
Mods are an essential part of the gaming experience with Transport Fever 3. Urban Games is very grateful to all modders who contribute to the game with their mods and share them with other users, thereby enrich the gameplay experience for the entire community.
Typical use cases
Below are some typical use cases for mods with varying degrees of difficulty. Please note, that mods are not restricted to one of these possibilities, but can be a combination of more than one or go beyond them in many ways.
Repaints of existing vehicle models
For many vehicles there are lots of color variations out there in the real world. As somebody who is not familiar with 3D modelling, this kind of mod might be a way to get into vehicle modding. Further information on this topic can be found in the manual for vehicle repaints.
New vehicle or asset models
Both vehicles as well as static models like decorative assets mainly focus on 3D modelling and texturing. The amount of coding needed to get those contents into the game are very limited, thus it's a good entry point for interested people with less coding affinity. People interested in vehicle modding can find some details in the vehicle modding section. For assets, a simple example can be found below.
Add new constructions with parameters
As single static models might not cover every needs for decoration, the possibility to add parameters is one step further into scripting. Models might get rotated or scaled, different models get added depending on the users choice, … the possibilities are almost endless, but the needed information can be found in the construction section.
Change config values by mod
A lot of basic configurations can be altered by simple mods. The amount of script code needed is very limited and the 3D models and textures do not need to be touched. An example for this type of mod can be found below.
Rebalance existing models
If desired, certain or all vehicles can be adapted in the same way, e.g. to increase the capacity equally without manually modifying the source files. The details for resource modifiers are located in the scripting section.
Hello Modding-World
Here are two exemplaric demo mods which show small examples of what can be modded for Transport Fever 3.
Demo Asset
This demo adds the Transport Fever logo as an asset to the game. It can be placed ingame.
The minimal setup for a static 3D model in Transport Fever consist of three parts:
mod.jsonandmetadata/modinfo.jsonfor the setup of the mod itself- 3D model with
.msh,.mdland textures for the content .con.luaand.script.luafor the scripting as a placeable asset.
You can download the mod for further investigation. This mod includes a simplified asset construction based on the assetbuilderutil, too.
Demo Config Change
This example is not yet adapted for Transport Fever 3. The content may be outdated.
This demo overrides a config value from the base config to force trains to start breaking earlier.
The minimal setup for a mod that changes a base config value consists just of the first part:
mod.luaandimage00.tgafor the setup of the mod itself
You can download the mod for further investigation.