Skip to content

oJumpy/LiveSplit.TimerSync

Repository files navigation

LiveSplit Timer Sync

A dll LiveSplit component that syncs your timer, splits, and layout text components with off-host players using Peer-to-Peer (P2P) synchronization over VPN (such as Radmin VPN or Hamachi).

Why?

In many co-op games, auto splitters and game time scripts only work for the host player. This component links your LiveSplit timers together so the off-host player automatically matches the host's game time, splits, and text components in real-time.

Requirements

  1. Download LiveSplit
  2. Network Connection: Both players must be on the same virtual network room (e.g., Radmin VPN or Hamachi).
  3. Timing Method: Ensure both LiveSplit instances are comparing against Game Time (Right-click LiveSplit -> Compare Against -> Game Time).

Installation

  1. Download LiveSplit.TimerSync.dll from the Releases tab.
  2. Place the .dll file into your LiveSplit installation folder inside the Components directory.
  3. Restart LiveSplit.

Setup Instructions

1. Host Player (Server)

The host is the player whose timer will control the game time, splits and text components.

  1. Right-click LiveSplit -> Edit Layout... -> [Click the + button] -> Timer -> Timer Sync.
  2. Double-click on Timer Sync the component to open its settings.
  3. Under the Sync Timer with Host group:
    • Set Which Player Are You? to Host Player (Server).
    • Keep the Port as the default 16834.
  4. Click OK to save.
  5. Provide your Radmin VPN or Hamachi IP address to your co-op partner.

Warning

Note: The Host must allow LiveSplit through their Windows Defender Firewall (see the Troubleshooting section below).


2. Off-Host Player (Client)

The off-host player's timer will automatically match the Host's game timer, splits, and layout text components.

  1. Turn off or deactivate your local Auto Splitter script (Right-click LiveSplit -> Edit Splits... -> Click Deactivate next to the script).
  2. Right-click LiveSplit -> Edit Layout... -> [Click the + button] -> Timer -> Timer Sync.
  3. Double-click on Timer Sync the component to open its settings.
  4. Under the Sync Timer with Host group:
    • Set Which Player Are You? to Off-Host Player (Client).
    • In the VPN Host IP Address field, enter the Host's IP address (the Radmin/Hamachi IP they provided).
    • Keep the Port set to the default 16834.
  5. Click OK to save.

Note

Your connection status inside the component settings will show Connected to Host in green once connected.


Features

  • Synchronizes Game Timer, Start, Split, Undo, Skip, Pause, Resume, and Reset.
  • Automatically syncs custom layout text components from Host to Client.

Troubleshooting

Windows Firewall Configuration (Host Only)

Because the Host runs a local TCP server inside LiveSplit, Windows Defender Firewall will block incoming connections by default. The Host must add an exception:

  1. Open the Start menu, type "Allow an app through Windows Firewall", and press Enter.
  2. Click Change settings in the top right.
  3. Locate LiveSplit in the list. Ensure both the Private and Public checkboxes next to it are checked.
  4. If LiveSplit is not in the list:
    • Click Allow another app... -> Browse... -> select your LiveSplit.exe.
    • Click Add, then check both Private and Public boxes.
  5. Click OK to save and apply.

VirusScan

Note

Because this plugin is an unsigned custom .dll file, you can view the clean scan results showing the file is safe below:


About

A DLL component for LiveSplit that syncs your timer, splits, and layout text components using P2P synchronization.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages