NuageRoles

v4.0.0·Updated 2026-06-07

Maintained R.E.P.O. role mod with recreated redistributable asset bundle sources.

About this mod Author’s original text

NuageRoles

NuageRoles is a maintained fork of REPO Roles Classic (source repository: Jettcodey/REPO-Roles-CE), which is itself based on REPO Roles by KingRobin72 / BobisMods.

NuageRoles keeps that role-based gameplay foundation, updates the mod for the current R.E.P.O. modding stack, expands configuration, fixes Engineer item charging, and ships a recreated NuageRoles_assets bundle built from redistributable source assets.

Quick Info

  • Select your role in Mods > NuageRoles, or leave it on Random.
  • When a game begins, each player receives a role automatically.
  • Press R by default to show or hide your current role info.
  • NuageRoles keybinds and important role settings are configurable in-game.
  • Advanced role balance values are available in the config file.

Available Roles

  • Runner - Moves faster and has more stamina.
  • Tank - Has more health and passive regeneration, but reduced speed.
  • Gambler - Receives one random buff and one random debuff each game.
  • Strongman - Has much stronger grab/melee strength.
  • Ranged Looter - Has increased grab range and slightly more strength.
  • Athletic - Gains more stamina, strength, and jump force.
  • Mage - Uses mana to cast healing, stamina, speed, jump, and overcharge spells.
  • Reaper - Grows stronger when enemies are defeated.
  • Scout - Uses less stamina and can temporarily see enemies through walls.
  • Regular - Just a regular Semibot.
  • Engineer - Uses stamina to recharge held items.

Upgrades

  • Mana Regeneration - Reduces Mage mana regeneration time. Max level: 5.
  • Scout Cooldown - Reduces Scout ability cooldown time. Max level: 5.

Role upgrades are registered through REPOLib and can be disabled separately from role selection.

Assets

The included NuageRoles_assets bundle was recreated for NuageRoles with a Unity source project in this repository. The old closed asset bundle from the upstream forks is not used.

The Unity asset rebuild project lives under:

mods/NuageRoles/assets/unity/NuageRolesAssetBundle

Development

From the monorepo root:./scripts/verify.ps1 -Mod NuageRoles./scripts/package.ps1 -Mod NuageRoles

The packaged zip is written to:

dist/NuageRoles-.zip

Credits

  • KingRobin72 / BobisMods - Original REPO Roles creator and core role design.
  • R3Labs / Jettcodey - REPO Roles Classic and its REPO-Roles-CE source repository this project builds on.
  • Navrim - Assets rework (icons and upgrades)

License

This project uses a mixed continuation license. See LICENSE.

Inherited code remains under the original REPORoles / REPO-Classic-CE terms.

New code by Théo Hay is licensed under MIT.

Replacement assets by Navrim are licensed under CC BY 4.0.

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

BepInEx-BepInExPackZehs-REPOLibnickklmao-MenuLibnickklmao-REPOConfig

File & checksum

Filename
NuageRoles-4.0.0.zip
File size
586.7 KiB