0.8 Experimental - Weapon Roulette - Custom Archetype-based Firearms

Description

Weapon Roulette adds a chance-based archetype system to every firearm you loot in SurrounDead. When a new weapon enters your inventory, it has a chance to be re-rolled into one of several distinct archetypes, each with its own dramatic strengths and matching weaknesses — turning ordinary loot runs into a gamble for that one devastating "legendary" pickup.

Archetypes are visible at a glance: the weapon's name is prefixed in the hover tooltip (for example " M9"), so you always know what you're carrying without digging through stat screens.

This is a pure UE4SS Lua mod — no game asset (.uasset/.pak) files are modified or replaced.

Installation instructions

1. Make sure UE4SS is installed and working (see Requirements below).

2. Locate your game's UE4SS mods folder, typically:

<SurrounDead install folder>\SurrounDead\Binaries\Win64\ue4ss\Mods

3. Extract this archive so the WeaponRoulette folder sits directly inside that Mods folder. The final structure should look like:

ue4ss\Mods\WeaponRoulette\enabled.txt

ue4ss\Mods\WeaponRoulette\Scripts\main.lua

ue4ss\Mods\WeaponRoulette\Scripts\archetypes.lua

4. Make sure enabled.txt is present (included in the archive). Its presence is what tells UE4SS to load the mod.

5. Launch the game normally. No further configuration is required.

To uninstall: delete the WeaponRoulette folder from ue4ss\Mods, or remove/rename enabled.txt inside it to disable without deleting.

Main features

- 6 built-in archetypes with real risk/reward trade-offs. No archetype is a free upgrade, every strength comes with a matching weakness (One Shot One Kill, Glass Cannon, Jackpot, Berserker, Minigun, Normal).

- Weighted random roll on every newly looted weapon, fully configurable odds.

- Each weapon instance rolls independently and only once. Moving an item between containers and your inventory never re-rolls or stacks bonuses.

- Archetype name shown directly in the item tooltip on hover.

- Weapons already in your inventory when the mod loads are left untouched (startup grace period). No retroactive changes to your existing save.

- Fully configurable: edit archetypes.lua to add, remove, or rebalance archetypes and their odds. No coding experience required for basic tweaks.

Requirements

- SurrounDead

- UE4SS (RE-UE4SS)  installed and working. This is a pure UE4SS Lua mod and will not function without it.

Shout outs

Thanks to the UE4SS development team for the modding framework that makes mods like this possible, and to the SurrounDead developers for building a game worth modding.