← All tasks

MODS / DOWNLOADS AND DEPENDENCIES

Download and activate a TF3 mod

Release documentation and stable 40423 notes checked October 22, 2026. Source-based steps, not our own playtest; verify the store build and every active dependency.

Download in Mod Hub, then check the world's active mod list

Open the main-menu Mod Hub and subscribe to a TF3 listing. Wait for the mod and its dependencies to download. For a new free game, select Add Mods and activate it before starting; a subscription badge does not mean every existing save now uses that mod.

A red cargo tram beside freight loading platforms and industry buildings in Transport Fever 3
A base-game cargo tram scene, not a downloadable mod. The video covers the announced Mod Hub; follow the current FAQ for Workshop policy. Official press image · © Urban Games ↗

What to do

  1. Read the listing's supported build, platform and dependencies. TF3 uses mod.io rather than Steam Workshop. A similarly named TF2 mod is not a substitute for the required TF3 listing.
  2. Subscribe and wait for downloads to finish. Check each required mod, using its ID rather than only its title. Follow the creator's version and compatibility instructions.
  3. For a new world, open New Game, choose its settings and select Add Mods. Activate the downloaded mod and inspect the final list before starting.
  4. For an existing save, first back it up. Open Load Game, select the save and inspect the card's details and mod list. Where editing is available, change the list deliberately; scripts and assets may not be safe to add or remove from an established world.
  5. If Load is disabled because a required mod is missing, restore the indicated dependency and finish its download. Test the expected asset or behavior in a copy before overwriting a valued save.
WATCH THIS SYSTEM

Highlights

Line tools, vehicle comparisons, rail reservations and Mod Hub.

Watch on YouTube ↗

Official pre-release overview. Use the written checks for this task; older videos may describe plans that later changed.

How to tell it worked

The correct TF3 listing and dependencies are downloaded, the intended world has the mod active and its expected content appears. A loaded save alone does not establish that every mod feature works.

If you are still stuck

Missing dependency: match its ID and supported platform. Crash after changing mods: return to the preserved copy and compare the previous mod list. Disabling a mod does not undo all changes already saved. PC Mod Hub saves are not currently available on consoles; the known-issues page gives no firm delivery date.

Related tasks: Save file location · Diagnose an internal-error crash · Choose Campaign or configure your free game · Check platforms and handheld support

Find downloaded Mod Hub files

October updates: verify the build, then check activation

Stable 40420 fixed non-builtin mod activation and staging-area dependency crashes. Stable 40423 adds fixes for CSS-based mod crashes, invalid aircraft metadata, moving the topmost mod in the list and missing Mod Hub ratings, plus performance improvements when several mods are active. It does not certify every listing or repair every existing save. Verify the installed build, completed dependencies and the active list in a backed-up world. If the fault persists, preserve the crash evidence and exact mod IDs. Stable release notes.

Mod Hub asks for an email code

For the email-login flow, mod.io sends a one-time 5-digit code. Enter it in the game's prompt; do not reply to the email. The service's support instructions give a 15-minute validity period and allow one request per 15 minutes. These are mod.io account instructions, not a TF3-specific server repair.

  1. Check the exact email address, spam folder and a manual inbox refresh.
  2. If the code expired, wait at least 15 minutes, close and reopen the game normally, then enter the address again to request a fresh code.
  3. Use that code in the same login flow and check that the intended account's subscriptions appear. Do not share the code or repeatedly request replacements while waiting.

If the service is unavailable or the account cannot access a private listing, a new local folder name will not grant permission. Preserve the error and use mod.io support; do not delete unrelated account or game data as a generic fix.

Sources: mod.io's code explanation, expired or rejected codes and missing email checks, read October 22, 2026.

Installing a creator's local TF3 package

  1. Use a package intended for TF3 and follow its author's dependency and compatibility instructions. Keep a backup before changing an existing save.
  2. Use Settings, Advanced, Open User Data to locate the documented user-data folder, then its mods directory. Preserve the package structure: its root contains mod.json, _metadata/modinfo.json and content. A TF2-style folder-name suffix alone does not convert a mod.
  3. Check for an older copy with the same modId. The official priority is staging_area, then manual mods, then subscribed mods; a local older copy can therefore hide the subscribed update.
  4. Return to the game's active mod list, check the revision and dependencies, and test the expected behavior in a copy of the save. Merely copying files or successfully loading the world does not prove activation.

This concerns a package the creator has supplied. Access to a private mod.io preview is a separate author-controlled permission; this procedure does not unlock private downloads. Official mod definition and load priority and game file locations were checked October 22, 2026.