Relay

Relay

A BepInEx library mod for R.E.P.O. that carries the stats the game simulates on the host, so they finally work while you are a co-op client.

What This Mod Does

Some upgrades in R.E.P.O. are not read on your own machine. Grab Strength, Tumble Launch, Throw and Tumble Wings are computed by the host, from the host's own copy of your character — and that copy only ever knows the upgrades you actually bought. It never learns about levels a mod gave you, and the game's stat-writing network messages are host-only by design, so a client cannot send them either.

The result: as a co-op client, those four stats do nothing, no matter which mod grants them. Your Improve points, your trained Train levels, your Berserk boost — the numbers show up, and nothing happens.

Relay is the one piece that closes that gap. Mods tell Relay what they want you to have; Relay reports it to the host, and Relay on the host applies it to the host's copy of you — the copy the game actually reads.

• You do not install Relay for its own sake. It has no features. Improve and Berserk depend on it; if you use them, you have it.
• Off by default. Nothing is bridged until you turn the switch on — see below.
• One writer, on purpose. Relay sums every mod's contribution and applies the total once. Two mods writing the same stat independently would fight: these fields are additive, and each writer has to work out "your value without my bonus" from what it last wrote — so one mod removing its boost looks, to the other, exactly like the game resetting the stat, and it re-applies on top. That doubles. Relay makes the whole class of bug impossible.
• It never touches your save. Only live values and a Character Stats overlay are written, never the game's upgrade dictionaries — which are the only thing R.E.P.O. saves. Your bonus dies with the level and can never be baked into the host's save file.

Configuration

Settings are in BepInEx/config/headclef.Relay.cfg or in the in-game mod config menu:

| Key | Default | Description |

|-----|---------|-------------|

| Enabled | false | Turn the bridge on. Needed on both machines — yours and the host's. |

Both you and the host must run Relay with this on. This is the single most common reason it "doesn't work": the bridge is a conversation, and it takes two. Against a host without it, nothing happens and nothing breaks — you simply keep the vanilla behaviour for those four stats.

The switch takes effect immediately, but turn it on before you connect if you want to be sure it is not the cause of a connection problem — that is the path worth testing (see below).

Coming from Improve 1.1.9?

Improve 1.1.9 carried this bridge itself, with its own switch. That setting is gone and is not migrated. If you had it on, turn Relay's on instead:

| | Improve 1.1.9 | Relay 1.0.0 |

|---|---|---|

| File | headclef.Improve.cfg | headclef.Relay.cfg |

| Key | Host-Simulated Stat Bridge | Enabled |

Nothing warns you — a bridge you had switched on simply stops working until you switch this one on.

If it is not working

| Symptom | Cause |

|---|---|

| Nothing changes as a client | Switch off on your side, or the host's — check both |

| Berserk refuses to activate | Same thing; the log line says which half is missing |

| The force works, the damage does not scale | Character Stats is not installed — see Requirements |

| Nothing at all, no log lines | Host is not running Relay; nothing is listening |

Why it is off by default

An earlier version of this bridge, which lived inside Improve, broke multiplayer connect: the public server list would not populate, and picking a region hung the game on a loading screen forever — with no error anywhere in the log. That version subscribed to network events when the game loaded the mod and polled the network every frame, so it was live through connecting, region select and the lobby.

Relay only touches the network from inside a running level, twice a second, and stops the instant the level ends. That cha