User Tools

Site Tools

Urban Games

modding:publishing

Publish a Mod

Once a mod is finished, you may consider to upload the mod to a place where other users may download it to use. Beside the Steam Workshop, which is the major mod ressource for most TF2 players, be sure you make use of our partner mod.io (especially if you want to make your mod available for PS5 and Xbox Series S as well) as well as other hosters where mods for Transport Fever 2 can be distributed. Depending on your preference, you may decide if you use one or more of these.

Do not upload contents for which you do not have copyrights or permission to distribute yourself!

Urban Games allows the use of game files from Transport Fever 2 to create mods for Transport Fever 2 where neccessary.
Please be aware that without explicit permission it is not allowed to use the game files for other games or projects.

Steam Workshop

The Steam Workshop is a platform provided by Valve. Users of the Steam version of Transport Fever 2 can use it to subscribe to mods. The download and occasional mod updates are processed automatically by the Steam client. By uploading mods to the Steam Workshop, users accept the Steam user agreement on user generated contents. Please be aware, that users of non-Steam versions of Transport Fever 2 do not have access to mods hosted on the Steam Workshop.

mod.io

mod.io is our partner for providing mods to mainly all non-Steam and PS5 & Xbox Series S users. The downloads and mod updates are automatically processed by the built in mod.io client.

Preparation

Before uploading the mod, several steps are required to prepare it:

Add tags

Make sure you have included some tags describing your mod. They are used by Steams search engine and the categorization.
List of supported tags.

This example shows how to add tags in the mod.lua:

function data()
return {
  info = {
    tags = { "building", "depot" }  -- or similar
    -- other infos...
  },
  -- options = ..
  -- runFn = ..
  -- checkActiveFn = ..
}
end

Add a preview image

For Steam Workshop include a preview image(modname_preview.jpg) for Steam Workshop in the root directory of your mod. Its size should be below 1 MB and it should have a square format. The usual display size in the Steam Workshop is 200×200 pixels.

For mod.io include a preview image (modname_preview.jpg) for mod.io in the root directory of your mod. Its size should be below 8 MB and it must be in 16:9 format. The usual display size in the Steam Workshop is 512×288 pixels.

Copy your mod to the staging area

If not yet done, copy your mod to the staging_area subdirectory in the userdata directory. Usually it's located here:
C:\Program Files (x86)\Steam\userdata\<your Steam ID>\1066780\local\staging_area\

Publish

Start the game and select the “Mod Browser” in the menu. In the top menubar you should now see a PUBLISH tab 1 (be aware that this tab is only visible if you curently do have at least one file in your game's staging area).

You can now see the mod-publishing interface and and overview of all mod files from your staging area. Select the mod that you would like to publish in order to see mod overview and to add your final adjustments2.

If so needed you can also change your release notes by doing so in the “Change note” field 3.

Choose the platform you wild like to upload to and view the terms and conditions for uploading mods to the distribution service if you have not done so before 4. If you are publishing to mod.io and do not have a separate console file prepared you can upload a console version by ticking the CONSOLE COMPATIBLE option 5.

When updating a mod an additional checkbox can be selected to control whether the description, summary and image should be updated as well or not 6.

Also for mod.io only type in a summary text that will then be displayed when a player hovers over the preview image before clicking on your mod. If you do not provide a specific summary text, the beginning of your mod description will be used.

Once you are ready publish your mod by clicking PUBLISH at the bottomn right 7.

Customizing

Once the upload of the mod is complete, a new window of the Steam Overlay should pop up. There you can edit the workshop entry as you like. Several edit functions are available in the right column:

  • The title and the mod description may be edited to add further information. Press Edit title & description to open the editor dialog. You can edit these information independently for every language that is supported by the Steam Workshop. The markup language for editor is described here.
  • It is possible to add further preview images and/or videos to an entry. Simply press Add/edit images & videos to open the upload dialog. There you can influence the sorting order as well. If you uploaded the 3D model to Sketchfab, you can add a reference to it. Then a 3D preview is available directly in the workshop.
  • If your mod is a collaboration of several modders, it's fair to give proper credit. You can add them as contributors by clicking on Add/remove Contributors.
  • It is possible to add links to profiles on various other online services by clicking on Edit Links .
  • Should your mod need another mod as dependency, it is useful to add the other mod to the dependency list. Click on Add/Remove Required Items to add such a reference. Whenever a user subscribes to your mod, it is checked if he is subscribed to the dependency mod as well.

Finally click on Change Visibility to set the Workshop entry to Public. Congratulations, your mod should now be available on Steam Workshop!

Update

To update an existing Steam Workshop Entry, simply open the “Publish Mod” menu in Transport Fever 2 again. Then select the mod to update. If you can read The existing Steam Workshop item will be updated below the Publish button, the Steam Workshop Entry that should be updated is properly recognized. Otherwise, the reference might be missing.

Once a mod is uploaded to the Steam Workshop, a workshop_fileid.txt file is generated in the folder of the mod. This file is required to find the right existing Steam Workshop entry to update. If you lost the file, you may add it manually. The content is just the workshop id that you may read from the Steam Workshop Entry URL.

If you modified title or description texts in the Steam Workshop editor, these changes will be overridden by the content from the mods name and description that is used in the mod.lua! Thus you're advised to manually backup them elsewhere to restore them after the update.

Publish on other Platforms

In difference to the Steam Workshop, the upload to other mod hosters works manually and not through the game. Thus, the workflow may vary depending on the hoster. In most cases, the hosters have some terms of service which have to be accepted before uploading content.

For example, the german community website has a download section. The filebase on transportfever.net can be accessed by everyone, so GOG, Mac AppStore and Epic Games Store users may install mods from there as well.

It is recommended to include the url in the mod.lua to point to the download possibility. This helps other users to locate the source of missing mods.


modding/publishing.txt · Last modified: 2024/09/26 08:25 by nico