Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
Agility
Passive stamina regeneration based on your Stamina, Crouch Rest, and Speed upgrade levels for R.E.P.O.
| Date uploaded | 3 weeks ago |
| Version | 1.2.1 |
| Download link | headclef-Agility-1.2.1.zip |
| Downloads | 2613 |
| Dependency string | headclef-Agility-1.2.1 |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100
headclef-CharacterStats
A read-only library that caches player character stats for other mods to use in R.E.P.O.
Preferred version: 1.2.1README
Agility
A BepInEx mod for R.E.P.O. that adds passive stamina regeneration based on your agility-related upgrade levels.
What This Mod Does
Your Stamina, Crouch Rest, and Sprint Speed upgrades now contribute to a passive stamina regeneration rate. The more you invest in these agility stats, the faster your stamina recovers — making high-mobility builds even more rewarding in longer runs.
How It Works
The combined level of your three agility stats determines your regen rate:
| Stamina | Crouch Rest | Speed | Combined | Regen/sec (default) |
|---|---|---|---|---|
| 1 | 0 | 0 | 1 | 0.3/sec |
| 2 | 1 | 1 | 4 | 1.2/sec |
| 3 | 2 | 2 | 7 | 2.1/sec |
| 5 | 3 | 3 | 11 | 3.3/sec |
The regeneration is subtle and designed to be useful over time — it won't make you invincible, but it rewards investing in agility stats.
Movement States
Regen now depends on what you're doing. The rate from the table above is your base rate; your current movement state multiplies it, so you recover fastest while resting and not at all while running:
| State | Multiplier (default) | Effect |
|---|---|---|
| Running (sprinting) | x0 |
No regen while sprinting |
| Walking (moving) | x0.5 |
Half regen on the move |
| Standing still | x1 |
Full base regen |
| Crouching + standing still | x2 |
Double regen while resting |
Example: with a 3.3/sec base rate, you regen 0/sec while sprinting, 1.65/sec while walking, 3.3/sec standing still, and 6.6/sec crouched and still. All four multipliers are configurable.
Configuration
Settings are in BepInEx/config/headclef.Agility.cfg:
[Stamina Regeneration]
| Key | Default | Description |
|---|---|---|
| Enable | true |
Toggle stamina regen on/off |
| Base Regen Per Second | 0 |
Flat regen regardless of stats (0 = none) |
| Regen Per Combined Level | 0.3 |
Extra regen per combined agility level |
| Max Regen Per Second | 0 |
Cap the base (standing-still) rate before the movement multiplier (0 = no cap) |
[Movement Multipliers]
| Key | Default | Description |
|---|---|---|
| Sprinting Multiplier | 0 |
Regen multiplier while running |
| Walking Multiplier | 0.5 |
Regen multiplier while walking |
| Standing Multiplier | 1 |
Regen multiplier while standing still |
| Crouching Still Multiplier | 2 |
Regen multiplier while crouching and still |
Requirements
- BepInEx 5.x installed for R.E.P.O.
- Character Stats — required dependency
Installation
- Install via Thunderstore (recommended) — Character Stats will be installed automatically.
- Or manually: place both
Character Stats.dllandAgility.dllinto yourBepInEx/pluginsfolder. - Launch the game — config file is generated on first run.
Multiplayer
- Stamina regeneration runs per-client — only players with the mod installed get the regen.
- Does not affect other players or enemies.
Changelog
v1.2.1
- Updated the Character Stats dependency to 1.2.0.
v1.2.0
- Movement-aware regen — stamina now recovers based on what you're doing: none while running, half while walking, full while standing still, and double while crouched and still.
- Added a [Movement Multipliers] config section so each state's multiplier can be tuned.
- The Max Regen Per Second cap now applies to the base (standing-still) rate before the movement multiplier.
v1.1.0
- Passive stamina regen scaling from the combined level of Stamina + Crouch Rest + Speed upgrades (via Character Stats).
Development
Project Structure
├── Agility.cs # Plugin entry point & config
├── Patches/
│ └── StaminaRegenPatch.cs # Harmony postfix — stamina regen
└── README.md
Building
This project is part of the Repo.slnx solution and references Character Stats at compile time. Build the whole solution so dependencies build in the correct order:
dotnet build ../Repo.slnx
License
This project is licensed under the MIT License — see the LICENSE file for details.
