tpf2-multiplayer

KO | EN

gitlite — search

#git #web #gemini #anthropic #pdf #llm #monitoring #chatbot #command-line #mcp

tpf2-multiplayer

(★ 9)

Real multiplayer for Transport Fever 2

File Explorer

ZIP Download

- - draw_tfmp_network_logo.py
  - image_00_preview.png
  - tfmp.png
  - tfmp.svg
  - tfmp_transparent.png
- - COMMANDS.md
  - GAME_LOOP_AND_UI.md
  - PROPOSALS.md
  - README.md
  - SCRIPT_API.md
- ARCHITECTURE.md
- BUILD_PREVIEWS.md
- CONFIGURATION.md
- DEVELOPMENT.md
- KNOWN_ISSUES.md
- NETWORKING.md
- PLAYING.md
- REPLICATION.md
- SECURITY.md
- TESTING.md
- - build_ca.bat
  - tpf2ca.cpp
- - tpf2_slice.cfg
  - tpf2mp.cfg
- .gitignore
- build_msi.ps1
- License.rtf
- Package.wxs
- PluginHost.wxs
- README.md
- test_upgrade.ps1
- VERSION
- - image_00.tga
  - mod.lua
- - bridge_main.cpp
  - cgamesteprelay.asm
  - datadir.h
  - deferrelay_slice.asm
  - gameuirelay.asm
  - hook.cpp
  - hook.h
  - logarchive.h
  - menu_hook.cpp
  - net.cpp
  - net.h
  - preview_plugin.cpp
  - proxy_alut.cpp
  - setplayer_patch.cpp
  - setplayer_patch.h
  - slice_hook.cpp
  - speedhook.cpp
  - speedhook.h
- build.bat
- connect.py
- desynclogs.py
- lobby.py
- masterserver.py
- mesh.py
- modshare.py
- netpunch.spec
- observe.py
- punch.py
- README.md
- requirements.txt
- seal.py
- - analyze.ps1
  - extract.ps1
  - run.ps1
- - tpf2rig.ps1
- - asset_lua_test.py
  - asset_stroke_test.py
  - cmdmap.py
  - dumpprop_diff.py
  - dumpprop_vecs.py
  - extract.py
  - find_hooks.py
  - find_menu_ui.py
  - find_sym.py
  - func2src.py
  - funcsig.py
  - menu_ui_map.txt
  - profile_load.py
  - src_ranges.py
  - terrain_bin.py
  - terrain_test_steps.txt
  - tpfdis.py
  - trace_load.ps1
  - trace_summary.py
  - walk_up.py
  - whois.py
  - xq.py
- bridge_companion_test.py
- bulldoze_alive_test.py
- click_continue.ps1
- clone_buy_test.py
- collect_logs.cmd
- con_adopt_test.py
- crossing_replay_test.py
- cursor_sim.py
- delay_hold_test.py
- deploy_mod.ps1
- deploy_shipping.ps1
- edge_demolition_test.py
- input.ps1
- luacheck.py
- masterserver_deploy.sh
- mp_menu_launch.ps1
- pacing_sim.py
- preview_native_test.cpp
- preview_perf_test.py
- preview_test.py
- pscheck.ps1
- relay_deploy.sh
- relay_put_save.sh
- relay_selftest.py
- screenshot.ps1
- segment_heap.ps1
- snapshot_logs.ps1
- soak.ps1
- track_fresh_test.py
.gitignore
LICENSE
README.md
safe.txt
THIRD_PARTY_NOTICES.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

# Project Badges

License: MIT Visit

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Website: [silver2127.github.io/tpf2-multiplayer](https://silver2127.github.io/tpf2-multiplayer/)** ·
[Download](https://github.com/silver2127/tpf2-multiplayer/releases/latest) ·
[Privacy policy](https://silver2127.github.io/tpf2-multiplayer/privacy.html)

**Multiplayer for Transport Fever 2** (Steam, Windows, build 35924). Several players build in one
world at the same time: the roads, track, stations, depots, vehicles and lines one player makes
appear for everyone, applied at the same moment of the simulation on every machine. Play one shared
company together, or separate companies with their own money on the same map.

It is unofficial, reverse-engineered without the engine's source, and **experimental**. Sessions of up to
four players have been run, on one PC and between PCs on different networks. Read
[docs/KNOWN_ISSUES.md](docs/KNOWN_ISSUES.md) before relying on it.

## How it works

The game has no network code, so this adds lockstep multiplayer from outside. A forwarding `alut.dll`
loads a few DLLs into the game at start-up: one captures each command a player issues and cancels it
before it applies, one carries commands between the game and a separate lobby process, and one draws the
Multiplayer panel on the title menu. A Lua game-script mod stamps every command with a future simulation
step, sends it to everyone, and replays it through the game's scripting API on every machine at that step,
including the player's own. Everyone starts from the same save, so the worlds stay identical; a detector
compares them continuously. The lobby handles NAT traversal, encryption and sending the save.
[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) has the details.

## Install

**Download `TpF2Multiplayer.msi` from the [latest release](https://github.com/silver2127/tpf2-multiplayer/releases),
close the game, and run it.** Everyone in a session needs the same version.

The installer finds the game folder through Steam, keeps the game's `alut.dll` as `alut_real.dll` and puts
the proxy in its place, adds the DLLs, the lobby (`netpunch\netpunch.exe`) and the **Transport Fever 2 Multiplayer** mod, and
switches the game to the Windows Segment Heap, which makes very large maps load far faster. Runtime files go
to `%LOCALAPPDATA%\tpf2mp\data\`. It installs alongside
[TpF2 Big Maps](https://github.com/silver2127/tpf2-bigmap) in either order. Details:
[installer/README.md](installer/README.md).

To uninstall, use **Apps → TpF2 Multiplayer → Uninstall**, or run the MSI again and choose **Remove**; the
game's own `alut.dll` is put back. Steam's "Verify integrity of game files" also restores it, which removes the
Multiplayer entry until you run the MSI's **Repair**.

## Play

1. Title menu → **Multiplayer** → **HOST GAME**. The code is copied to your clipboard: send it to your friends,
   or tick **PUBLIC** to list the game. A password locks the code.
2. Friends open **Multiplayer**, paste the code and press **JOIN GAME**, or click your game in **PUBLIC GAMES**.
3. Press **START GAME**. Your newest save is sent to everyone; when it is ready, everyone opens **LOAD GAME**
   and picks **mp_shared**.

The host needs UDP port 29471 reachable from the internet (the lobby tries UPnP). If that is not possible, use a
dedicated relay from the PUBLIC GAMES list, where nobody needs an open port. New games have the multiplayer mod enabled
automatically; for an existing save, enable it once in the save's Mods panel. The full guide, including the
in-game window, companies and troubleshooting, is [docs/PLAYING.md](docs/PLAYING.md).

## Documentation

| document | covers |
|---|---|
| [docs/PLAYING.md](docs/PLAYING.md) | hosting, joining, relays, the in-game window, speed, companies, troubleshooting |
| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | the components, a command's path, time and pacing, sessions, files |
| [docs/REPLICATION.md](docs/REPLICATION.md) | what replicates and how, per action, and how divergence is detected |
| [docs/NETWORKING.md](docs/NETWORKING.md) | lobby protocol, join codes, save transfer, dedicated relay, master server |
| [docs/SECURITY.md](docs/SECURITY.md) | the threat model: what is protected and what is not |
| [docs/CONFIGURATION.md](docs/CONFIGURATION.md) | every setting |
| [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) | building, deploying, the multi-instance rig, logs, tests, releases |
| [docs/KNOWN_ISSUES.md](docs/KNOWN_ISSUES.md) | open bugs, replication gaps, plans that were not built |
| [docs/TESTING.md](docs/TESTING.md) | the manual test plan: what to check before pushing, and before a release |
| [docs/re/](docs/re/README.md) | the engine reference for build 35924 that the hooks rest on |
| [installer/README.md](installer/README.md) | the MSI: what it changes, upgrades, building it |
| [netpunch/README.md](netpunch/README.md) | the lobby's source |

## Repository layout

| path | contents |
|---|---|
| `native/` | the DLLs (`build.bat <target>`); `src/plugin/` is the plugin host shared with TpF2 Big Maps |
| `mod/mp_lockstep_1/` | the game-script mod |
| `netpunch/` | the lobby, dedicated relay and master server (Python) |
| `installer/` | the WiX package |
| `tools/` | deploy, rig, soak-test and check scripts; `tools/ghidra/` and `tools/re/` for reverse engineering |
| `docs/` | the documentation |

## Contributing and credits

Issues and pull requests are welcome, especially reproductions with logs from every player
([what to collect](docs/PLAYING.md#when-something-goes-wrong)). Please keep the project's conventions
([docs/DEVELOPMENT.md](docs/DEVELOPMENT.md#conventions)): destructive replication channels are validated on
the rig before they merge, and a field identification counts only when a differential capture confirms it.

- Companies mode is inspired by, and reuses engine mechanisms proven in, Swiss's **Multiplayer Companies**
  Workshop mod (item 3710243057): runtime `addPlayer`, `setPlayer`, `bookJournalEntry` to a specific player,
  `setBulldozeable`.
- [TpF2 Big Maps](https://github.com/silver2127/tpf2-bigmap) grew out of this project.
- Licensed under the [MIT License](LICENSE). Third-party material is listed in
  [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

**Disclaimer.** This project is not affiliated with or endorsed by Urban Games. It replaces a file inside your
Transport Fever 2 installation (`alut.dll`, kept as `alut_real.dll`) and patches game code in memory while the
game runs. Use it at your own risk and keep backups of your saves. Multiplayer saves are ordinary `.sav` files;
the mod adds its company assignment to the save's script state.

tpf2-multiplayer

File Explorer

# Use via CDN

# Project Badges

Was this content helpful?

Recent Feedback

Download README