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

[Luck Recovery]
RecoveryMultiplier = 1
RecoveryFlatBonus = 0
RecoveryOverridePerMinute = -1

[Luck Consumption]
ConsumptionMultiplier = 1

[Debug]
VerboseLogging = true

RecoveryMultiplier

Multiplier for positive Luck recovery.

Example:

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.

Example:

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.

Example:

RecoveryOverridePerMinute = 20

Your Luck recovery becomes:

20/min

Set it to -1 to disable override mode.

ConsumptionMultiplier

Multiplier for negative Luck changes when valuable loot consumes Luck.

Example:

ConsumptionMultiplier = 0.5

Luck consumption is halved.

Example:

ConsumptionMultiplier = 0

Valuable loot no longer consumes Luck.

Example:

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 Thunderstore-compatible 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 existing Luck economy:

Luck recovery -> stored Luck -> valuable loot consumes stored Luck

For enemy-death-based Luck gain, use the companion mod:

Luck On Kill

Changelog

1.0.0

• Initial release
• Added configurable Luck recovery multiplier
• Added configurable flat recovery bonus
• Added fixed recovery override
• Added configurable Luck consumption multiplier

1.0.1

• Fixed repeated multiplier application on the same Luck recovery event
• Improved compatibility with other mods that modify Status_Luck