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-<version>.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.

4.0.0

• NuageRoles is now a maintained fork of REPO Roles Classic.
• Updated the packaged assets with a recreated NuageRoles_assets bundle.
• Fixed Engineer item charging so stamina cost and stamina regeneration work correctly.
• Added new config options for role balancing, Mage spells, Engineer stamina behavior, role selection, enabled roles, and NuageRoles keybinds.

3.1.2

• Bound custom upgrade activation events on spawned runtime instances instead of the loaded prefab asset.
• Re-enabled custom upgrade toggles once purchased in the shop and marked upgrade items as physical shop items.

3.1.1

• Rewired role upgrades through REPOLib callbacks while preserving the Classic saved stat keys.
• Created a runtime placeholder for missing upgrade Particle Effects children so clean prefabs can still register in the shop.

3.1.0

• Integrated the successful REPO Roles CE fork as NuageRoles.
• Added the recreated NuageRoles_assets bundle and Unity source project.
• Removed the failed previous rewrite/runtime asset generation approach.