Perfect Oils

A configurable BepInEx mod for SULFUR that removes selected negative effects from weapon oils while preserving their positive effects.

Removed effects remain visible in oil tooltips with a strikethrough, so players can still see the oil's original behavior and understand what the mod changed.

What This Mod Does

Perfect Oils can selectively prevent supported negative oil modifiers from affecting weapons.

The following low-impact quality-of-life removals are enabled by default:

• Disable Aiming
• Extra Ammo Consume Chance
• Decrease Accuracy When Moving
• Decrease Move Speed
• Decrease Jump Power
• Decrease Loot Chance Multiplier
• Disable Money Drops
• Disable Organ Drops

The following balance-sensitive removals are available but disabled by default:

• More Bullet Drop
• More Drag
• Negative Bullet Speed
• Negative Damage, including flat and percentage modifiers
• Negative Bullet Size
• Negative RPM
• Extra oil durability cost

Positive versions of signed modifiers are never removed. For example, positive Damage, Bullet Speed, Bullet Size, and RPM modifiers remain active.

Tooltip Integration

The original negative effect text is not hidden.

When an effect is disabled by Perfect Oils, its original tooltip line is displayed with a strikethrough. This allows players to understand both the original oil and the effect of the mod.

This works for:

• Oil items
• Oils already applied to weapons
• Localized game tooltip text

Configuration

The configuration file is created at:

BepInEx/config/com.ryuka.sulfur.perfectoils.cfg

General

• Enabled — Enable or disable the mod.
• RemoveExtraDurabilityCost — Remove additional weapon durability consumption caused by oils. Default: false.

Traits enabled by default

• RemoveDisableAiming
• RemoveExtraAmmoConsumeChance
• RemoveDecreaseAccuracyWhenMoving
• RemoveDecreaseMoveSpeed
• RemoveDecreaseJumpPower
• RemoveDecreaseLootChanceMultiplier
• RemoveDisableMoneyDrops
• RemoveDisableOrganDrops

Traits disabled by default

• RemoveMoreBulletDrop
• RemoveMoreDrag
• RemoveNegativeBulletSpeed
• RemoveNegativeDamage
• RemoveNegativeBulletSize
• RemoveNegativeRpm

Display and debug

• ShowRemovedTraitsWithStrikethrough — Show removed effects with a strikethrough. Default: true.
• DetailedLogging — Write detailed oil classification information to the BepInEx log. Default: false.

After changing a trait setting, re-equip or reload the affected weapon if its current stats do not refresh immediately.

SULFUR Config Support

Perfect Oils uses standard BepInEx configuration and does not require SULFUR Config.

When SULFUR Config is installed, the settings page supports localized names and descriptions in 14 languages:

• Arabic
• German
• English
• Spanish
• French
• Italian
• Japanese
• Korean
• Polish
• Portuguese
• Russian
• Swedish
• Turkish
• Simplified Chinese

These localization files affect the configuration interface only. They do not replace the game's item names or other game text.

Installation

Mod manager

Install Perfect Oils with a Thunderstore-compatible mod manager.

Manual installation

1. Install BepInExPack for SULFUR.
2. Extract this package into the SULFUR game directory.
3. Confirm that the files are located under:

BepInEx/plugins/PerfectOils/

1. Start the game.

Requirements

• SULFUR
• BepInExPack 5.4.2305 or later compatible BepInEx 5 build

Compatibility

• Does not modify the original game assemblies.
• Does not remove oil items.
• Does not remove positive oil modifiers.
• Does not require SULFUR Config.
• Designed for the current Mono/BepInEx 5 version of SULFUR.

Uninstallation

Delete:

BepInEx/plugins/PerfectOils/

Optionally delete the configuration file:

BepInEx/config/com.ryuka.sulfur.perfectoils.cfg

Weapons and oils are not permanently rewritten in save data by this mod.

Changelog

1.3.0

• Added configurable removal of negative RPM modifiers.
• Added separate configuration options for every supported negative trait.
• Changed defaults so only lower-impact quality-of-life removals are enabled.
• Kept balance-sensitive ballistic, damage, size, RPM, and durability changes disabled by default.
• Added 14-language SULFUR Config localization.

1.2.1

• Removed obsolete source-file references.
• Updated Unity object lookup for Unity 6.

1.2.0

• Added configurable removal of negative Bullet Speed, Damage, and Bullet Size modifiers.
• Added support for flat and percentage negative Damage modifiers.

1.1.1

• Fixed oil detection for the current SULFUR item database.
• Added reliable database retry and diagnostic logging.

1.1.0

• Preserved original tooltip lines and added strikethrough display for removed effects.
• Moved effect suppression to runtime stat application.

Credits

Created by ryuka.