SULFUR Perfect_Oils1.3.5

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

Install

Date Uploaded

2 days ago

Downloads

117

Size

109KB

Dependency string

ryuka_labs-Perfect_Oils-1.3.5

Download

Details Required (1)Versions

Perfect Oils 1.3.5

A BepInEx 5 mod for SULFUR that selectively removes undesirable weapon-oil traits while preserving positive effects and the original localized descriptions.

Removed traits

Every supported trait has its own config switch.

The default profile only removes effects that have relatively little impact on weapon balance:

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 stronger stat-changing removals are available but default to disabled:

More Bullet Drop
More Drag
Negative Bullet Speed
Negative Damage
Negative Bullet Size
Negative RPM
Extra Oil Durability Cost

The signed-value rules only suppress modifiers that reduce the stat:

ProjectileTimeScale < 0: negative bullet speed;
Damage or DamageModifier < 0: negative damage, for both Flat and percentage modifier types;
ProjectileScale < 0: negative bullet size;
RPM < 0: negative fire rate.

Positive bullet-speed, damage, bullet-size, and RPM modifiers remain active.

More Bullet Drop also suppresses its same-oil reduced-speed or increased-mass companion modifiers. Because reduced projectile speed belongs to both categories, it is removed when either RemoveMoreBulletDrop or RemoveNegativeBulletSpeed is enabled.

Tooltip behavior

The game still shows the original oil effects. Lines for traits currently disabled by Perfect Oils are wrapped in TextMeshPro's strikethrough tag.

This works for:

hovering an oil item;
hovering an oil listed on an enchanted weapon;
randomly selected oil enchantments.

The tooltip and runtime suppression use the same trait classifier and the same config values, so their states remain consistent.

Implementation

Perfect Oils keeps EnchantmentDefinition.modifiersApplied intact. At database load it indexes exact modifier signatures by:

enchantment source ID;
ItemAttributes value;
StatModType;
modifier value;
classified negative-trait flags.

A targeted prefix on ItemStats.AddModifier(ItemAttributes, StatModifier) ignores only a matching oil modifier whose corresponding config option is enabled. No weapon, loot, movement, aiming, projectile, or damage consumer is replaced.

The index contains every known negative signature regardless of the current settings, so config changes do not require rebuilding the asset database. Existing weapon stats may need the game to rebuild/resync the item, or a restart, before a changed modifier setting is reflected. Tooltip changes are evaluated whenever the tooltip is rebuilt. The durability-cost setting updates the shared oil definitions immediately.

Requirements

SULFUR
BepInExPack 5.4.2305

Build

Copy LocalPaths.props.example to LocalPaths.props.
Set SulfurManagedDir and BepInExCoreDir.
Build PerfectOils.csproj in Release mode.
Copy PerfectOils.dll to BepInEx/plugins/PerfectOils/.

No game DLLs, Unity assemblies, or BepInEx binaries are included in this source package.

Config

Generated at:

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

General

Enabled = true
RemoveExtraDurabilityCost = false

Traits

Enabled by default:

RemoveDisableAiming = true
RemoveExtraAmmoConsumeChance = true
RemoveDecreaseAccuracyWhenMoving = true
RemoveDecreaseMoveSpeed = true
RemoveDecreaseJumpPower = true
RemoveDecreaseLootChanceMultiplier = true
RemoveDisableMoneyDrops = true
RemoveDisableOrganDrops = true

Disabled by default:

RemoveMoreBulletDrop = false
RemoveMoreDrag = false
RemoveNegativeBulletSpeed = false
RemoveNegativeDamage = false
RemoveNegativeBulletSize = false
RemoveNegativeRpm = false

Display / Debug

ShowRemovedTraitsWithStrikethrough = true
DetailedLogging = false

The existing General.RemoveExtraDurabilityCost key is retained for compatibility with v1.1.x configuration files.

Runtime verification

The initialization log reports separate counts for:

negative bullet speed;
flat negative damage;
percentage negative damage;
negative bullet size;
negative RPM.

This verifies the actual Addressables data loaded by the current game build, which is not stored in the managed DLLs.

Author

ryuka