Communities

SULFURLoading...Perfect_Oils1.3.0

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

6 days ago

Downloads

116

Size

108KB

Dependency string

ryuka_labs-Perfect_Oils-1.3.0

Download

Details Required (1)Versions

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

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

BepInEx/plugins/PerfectOils/

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.