You are viewing a potentially older version of this package. View all versions.
ryuka_labs-BetterLuckControl-1.0.0 icon

BetterLuckControl

Configure Luck recovery and Luck consumption in SULFUR.

Date uploaded a month ago
Version 1.0.0
Download link ryuka_labs-BetterLuckControl-1.0.0.zip
Downloads 22
Dependency string ryuka_labs-BetterLuckControl-1.0.0

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

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.

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

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

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

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