Better Luck Control

Better Luck Control

A configurable Luck system tweak for SULFUR.

This mod lets you adjust how fast Luck builds up and how much Luck is consumed when valuable loot drops.

Compatibility

Better Luck Control is fully compatible with Luck On Kill.

When both mods are installed:

• []Luck On Kill adds Luck when enemies die.[/]

  []Better Luck Control can further modify that added Luck through its recovery multiplier, flat bonus, or override settings.[/]

  []Both mods can be used together safely.[/]

Example:

Luck On Kill adds +5 Luck

Better Luck Control has RecoveryMultiplier = 2

Final Luck gain becomes +10

If you want Luck On Kill to ignore Better Luck Control, change Luck On Kill's compatibility setting:

ApplyThroughModifyStatus = false

What it does

SULFUR has two internal Luck values:

• []Stat_LuckGain: Luck recovery amount per minute[/]

  []Status_Luck: current stored Luck value[/]

By default, the player recovers Luck once per minute.

Equipment such as the Four-leaf Clover and Santa Hat increases Luck recovery, not the current stored Luck value directly.

Better Luck Control lets you configure this system.

Features

• []Configure Luck recovery multiplier[/]

  []Add a flat bonus to each Luck recovery tick[/]

  []Override Luck recovery to a fixed value per minute[/]

  []Configure Luck consumption multiplier[/]

  []Optional debug logging[/]

  []Fully compatible with Luck On Kill[/]

Configuration

After launching the game once with the mod installed, a config file will be generated:

BepInEx/config/ryukalabs.sulfur.lucktweaks.cfg

Settings

RecoveryMultiplier = 1

RecoveryFlatBonus = 0

RecoveryOverridePerMinute = -1

ConsumptionMultiplier = 1

VerboseLogging = true

RecoveryMultiplier

Multiplier for positive Luck recovery.

RecoveryMultiplier = 2

If your current Luck recovery is 5/min, it becomes:

5 2 = 10/min

This also affects Luck gained from Luck On Kill when Luck On Kill uses:

ApplyThroughModifyStatus = true

RecoveryFlatBonus

Flat bonus added to every positive Luck recovery tick after multiplier.

RecoveryMultiplier = 2

RecoveryFlatBonus = 3

If your current Luck recovery is 5/min, it becomes:

5 2 + 3 = 13/min

RecoveryOverridePerMinute

If set to 0 or higher, this replaces the positive Luck recovery amount.

RecoveryOverridePerMinute = 20

Your Luck recovery becomes:

Set it to -1 to disable override mode.

ConsumptionMultiplier

Multiplier for negative Luck changes when valuable loot consumes Luck.

ConsumptionMultiplier = 0. 5

Luck consumption is halved.

ConsumptionMultiplier = 0

Valuable loot no longer consumes Luck.

ConsumptionMultiplier = 0. 01

Luck consumption becomes 1% of the original value.

Recommended settings

Light boost

RecoveryMultiplier = 2

RecoveryFlatBonus = 0

RecoveryOverridePerMinute = -1

ConsumptionMultiplier = 1

Easier Luck economy

RecoveryMultiplier = 2

RecoveryFlatBonus = 0

RecoveryOverridePerMinute = -1

ConsumptionMultiplier = 0. 5

Strong boost

RecoveryMultiplier = 10

RecoveryFlatBonus = 0

RecoveryOverridePerMinute = -1

ConsumptionMultiplier = 0. 1

Installation

Install with a mod manager, or manually place the DLL into:

BepInEx/plugins/BetterLuckControl/

Notes

This mod does not directly force enemies to drop items.

Instead, it changes the game's existi