Character Stats

Description

Character Stats is a lightweight library mod for R. E. P. O. It does nothing visible on its own — instead, it reads and caches every player's character upgrade levels and exposes them through a simple API, so other mods can reliably access that data without fighting each other over it.

If you're here because another mod listed Character Stats as a requirement, that's all you need to know: install it and you're done — there's nothing to configure and nothing to see in-game. If you're a mod author, read on for the API.

It never writes to the game's stats — it reads straight from the game's live StatsManager data, so the values it hands out always match what the game (and stat-applying mods like Improve) actually use. As of 1. 2. 0 it also offers an optional temporary bonus overlay: mods can layer a transient stat boost (say, +5 Strength while an ability is active) that every consumer reads — but which is never written into the game's StatsManager or baked into your save.

Installation Instructions

Character Stats is usually installed automatically as a dependency when you install a mod that needs it (via Thunderstore or a mod manager). To install it manually:

• []Install BepInEx 5.x for R. E. P. O. if you don't already have it.[/]

  []Download the latest Character Stats file from the Files tab.[/]

  []Extract the archive into your R. E. P. O. game folder (the one containing REPO.exe) so that Character Stats.dll ends up in BepInEx/plugins/.[/]

  []Launch the game — it loads and starts reading stats automatically. No configuration needed.[/]

  ---

  Main Features

  • []Reads all 13 upgrade stats from the game's StatsManager and caches them for other mods to use.[/]

    []Always current — refreshes after level generation, every second during a level, and after each network sync.[/]

    []Live data — reads straight from the game's StatsManager dictionaries, so values match what the game and stat-applying mods (like Improve) actually use.[/]

    []Never writes to the game — it reports your stats, it never modifies them or your save.[/]

    []Temporary bonus overlay (1. 2. 0) — mods can register a transient stat boost that every consumer reads at read time, kept entirely out of the game's StatsManager and your save file (so it can't be absorbed by mods like Improve or persisted).[/]

    []Zero footprint — no in-game UI, no config, no performance cost worth mentioning.[/]

    For mod developers — reference Character Stats.dll and call the static API:

    using static Character_Stats. Character_Stats;

    // Read levels (includes any temporary bonus, see below)

    int launch = GetUpgradeLevel(steamId, "Launch");  // 0 if unknown

    Dictionary<string, int> all = GetAllUpgrades(steamId);

    if (AreStatsReady) { / cache is populated this level / }

    string? me = GetLocalSteamId();

    // Temporary bonus overlay (1. 2. 0+): layer a transient boost other mods can read,

    // without ever touching the game's StatsManager or the save.

    SetTemporaryBonus(me, "Strength", 5);  // +5 while your effect is active

    ClearTemporaryBonus(me, "Strength");    // remove it when the effect endsAvailable keys: Health, Speed, Map Player Count, Stamina, Extra Jump, Range, Strength, Throw, Launch, Crouch Rest, Tumble Wings, Tumble Climb, Death Head Battery.

    Thunderstore dependency string: headclef-CharacterStats-1. 2. 0.

    ---

    Requirements

    • []R. E. P. O.[/]

      []BepInEx 5.x — the BepInExPack for R. E. P. O.[/]

      []No other mods are required — Character Stats is completely standalone.[/]

      ---

      Shout Outs

      • []The BepInEx and HarmonyX teams — for the framework that makes all of this possible.[/]

        []semiwork and the R. E. P. O. dev team — for a game that's an absolute joy to mod.[/]

        []The R. E. P. O. modding community on Thunderstore and Discord — for sharing knowledge and tools.[/]

        []Everyone building mods on top of Character Stats — this library exists to make your stat reads painless.[/]

        ---

        All Of My Mods

        More R. E. P. O. mods by headclef:

        [*]Improve — A haul-based leveling system: earn stat points from your lifetime haul and spend them on any of the 13 character stats, ev