﻿TMVFANMP v0.0.4 - EARLY ACCESS
Multiplayer for TM5 (the Twisted Metal fan game by Angel, used with permission). Mod by Dew (dewsmoke).
EARLY ACCESS: TMVFANMP is still being worked on - please be patient while things get fixed and added!
====================================================================================================

SETUP
1. Put TMVFANMP.exe anywhere (or right in your TM5 folder, next to "Twisted Metal.exe").
2. Run it. If it asks, go to SETTINGS and pick your TM5 folder.
   It installs itself into the game the first time you play (BepInEx + the TMVFANMP plugin).
3. Everyone needs the same version of TM5 and of TMVFANMP.

LOCAL CO-OP (2 players on one PC) - the main mode
- Each player plays on the keyboard or a controller (Xbox, PS4, PS5, Switch Pro or generic). Plug controllers in first.
- LOCAL CO-OP page: names and cars for both players, the mode, then START LOCAL CO-OP.
- Player 1 is the left window, player 2 the right window.
  Click either window - both keep working.
- Modes:
    Co-op Battle  fight the level's enemies together; when you're both out, on to a new level together
    Story Co-op   play the game's story together (new from the intro, or continue your saved story).
                  Player 1 is the host: they get the victory screens and cutscenes and pick the next map.
                  Player 2 follows automatically. Both wasted = retry the level.
    Deathmatch    no AI cars, everyone gets the same lives - last car standing wins
- The first time, the launcher makes a "TM5_Player2" folder next to your game (links, no extra space).

BETA - ONLINE, HOST ONLINE, SINGLE PLAYER
These are still being worked on. Use them at your own risk! Expect bugs, desyncs and crashes.
- ONLINE: double-click a server in the list (or type IP:port under Direct connect).
- HOST ONLINE: Co-op Battle or Story Co-op, up to 100 players (a home connection is good for about 20 -
  big servers need a strong upload or a hosted box). Forward UDP port 7777 on your router to
  your PC and allow TMVFANMP_Server.exe in Windows Firewall. No port forwarding? Use Radmin VPN,
  ZeroTier or Tailscale and give friends that IP.
- SINGLE PLAYER: any car, any level, and "unlock everything".

IN GAME
  F8   player list (with health), switch car
  F9   spectate the next player when you're out of lives / teleport to a teammate
  T    chat

CONTROLLERS
- Xbox, PS4 (DualShock 4), PS5 (DualSense), Switch Pro and generic USB/Bluetooth gamepads work.
  Plug in and play: the game drives, aims, fires and runs its menus on a controller.
- Launcher: Settings > Controls in game = Auto (keyboard/mouse and any controller), Keyboard & mouse only,
  any controller, or your kind (Xbox, PS4, PS5, Switch Pro, Other) so prompts use its button names.
- Local co-op: "Player 1 plays on" / "Player 2 plays on" pick keyboard or a controller (any, or a kind).
  Two controllers: player 1 gets the first one, player 2 the next.
- Cars: click your car (or press A) for the 3D car select - < > picks, drag / right stick turns it.
- Hold Back (View / Share / Create / Minus)  multiplayer menu: d-pad moves, A/Cross picks,
                                             left/right changes, B/Circle closes. Quick chat is in there.
- A/Cross or RB/R1                           spectate the next player when you're out of lives
- The launcher works on a controller too: LB/RB = pages, d-pad = move, A = select, Start = the big button.

TIPS
- Game lagging? Lower the game's graphics settings (Options) and resolution. Local co-op runs TWO
  copies of the game at once, so it needs about twice the PC - lower settings help a lot.
- Close other heavy programs (browsers with lots of tabs, recording software you're not using).
- Online: a wired connection beats Wi-Fi. In the server list, green ping (under 100 ms) plays best.
- Out of lives? You spectate your teammate until the round ends - press F9 to switch who you watch.
- Spawned on top of each other? Drive apart first - cars become solid once you're apart.
- Story Co-op: player 2 waits on a "choosing the next level" screen while player 1 picks - that's normal.
- Controller not working? Plug it in before pressing START LOCAL CO-OP. PS controller not seen? Close
  DS4Windows or similar tools (they can hide the controller), or let them run in Xbox mode.
- Something broke? SETTINGS > Install / repair. Still broken? Send the log:
  <TM5 folder>\BepInEx\TMVFANMP-<your name>.log

KNOWN LIMITS
- Switching car in the middle of a level can leave the camera off.

BUGS AND NEWS
- Found a bug? Report it on Discord (with your log file): https://discord.gg/SwmcZcGrdw
- The NEWS page in the launcher shows what's new and every tweak.

LICENSE
Copyright (c) 2026 Dew (dewsmoke). All rights reserved. TMVFANMP is proprietary software - see LICENSE.txt.
Reverse engineering, decompiling, disassembling, modifying, extracting the source code, reuploading or
redistributing TMVFANMP is strictly prohibited without written permission. Download it only from the
official pages.
