WhozScott-Heartbeat icon

Heartbeat

Prevents Steam lobbies from expiring during long sessions, fixing the "Couldn't connect to the lobby" error shown in-game.

Last updated 2 weeks ago
Total downloads 234
Total rating 0 
Categories Mods
Dependency string WhozScott-Heartbeat-1.1.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

Heartbeat

Prevents On‑Together lobbies from expiring during long sessions, fixing the in‑game "Couldn't connect to the lobby" error by sending a periodic heartbeat to Steam.

Features

  • Keeps your lobby joinable: Sends a small "heartbeat" update to your Steam lobby at a set interval so Steam doesn't time it out.
  • Refreshes lobby metadata: Automatically reads and re‑sets your lobby name and tags on every heartbeat so Steam doesn't drop the listing after 14+ hours.
  • Fires immediately on startup: First heartbeat is sent as soon as a lobby is detected, no waiting for the first interval.
  • Works for hosts and dedicated servers: Runs whenever there is an active lobby, whether you're hosting from the game client or running a server.
  • Configurable interval: Default is 2 minutes for reliable long sessions.
  • Tiny footprint: Does not touch gameplay or UI, only the lobby metadata.

Config options

Config file is generated at: BepInEx/config/com.ontogether.lobbyheartbeat.cfg

  • LobbyHeartbeatEnabled: true
    Turns the heartbeat on or off without uninstalling the mod.

  • LobbyHeartbeatIntervalMinutes: 2
    Minutes between each heartbeat. Use 1‑2 for 12+ hour runs. Max ~10.

Manual installation

  1. Install BepInEx 5 for On‑Together (from Thunderstore or manually).
  2. Download the latest WhozHeartbeat.zip release for this mod.
  3. Extract the zip into your On‑Together game folder so it merges into BepInEx\ (you should end up with BepInEx\plugins\Heartbeat\LobbyHeartbeat.dll).
  4. Launch the game and host / start your server as usual. The heartbeat will run automatically any time a lobby is active.

Thunderstore package layout

Inside the mod zip, the structure looks like this:

  • manifest.json
  • README.md
  • icon.png
  • BepInEx/plugins/Heartbeat/LobbyHeartbeat.dll

This is the layout used by r2modman and other Thunderstore‑compatible mod managers.