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

Install

Date Uploaded

4 weeks ago

Downloads

320

Size

66KB

Dependency string

ryuka_labs-Toggle_Melee_Stance-1.0.0

Download

Details Required (1)Versions

Toggle Melee Stance

A quality-of-life mod for SULFUR that changes melee from hold-to-use into a toggle stance.

Press the melee action once to keep your melee weapon drawn. Press it again to sheathe it. While melee stance is toggled on, press the normal Fire action to perform a melee attack. Hold the normal Aim / Alt Fire action to use the game's vanilla alternative melee stance or block behavior.

What This Mod Does

Press the game's melee action once to keep your melee weapon drawn.
Press the melee action again to sheathe it and return to your previous weapon.
While melee stance is toggled on, press the normal Fire action to perform one melee attack.
While melee stance is toggled on, hold Aim / Alt Fire to use the vanilla alternative melee stance or block.
Uses SULFUR's own input actions instead of hardcoded mouse buttons, so it should work with rebinding, controller, and Steam Deck layouts.
Keeps the original melee attack, parry, alternative stance, and weapon-specific behavior.
Fixes a visual issue where some melee weapons could briefly flash an attack animation on repeated draw by resetting the melee Animator to a safe cached equip state before sheathing.

What This Mod Does NOT Do

Does not change melee damage.
Does not change weapon durability.
Does not change enemy AI.
Does not edit save files.
Does not replace or rebalance melee weapons.
Does not add new melee moves such as dashes or thrust attacks.

Configuration

Config file:

BepInEx/config/kumo.sulfur.toggle_melee_stance.cfg

Default options:

[General]
EnableMod = true

[Melee]
FirePerformsMeleeAttack = true
ReChargeRetryInterval = 0.08

[Visual]
ResetMeleeAnimatorBeforeSheathe = true

[Compatibility]
DisableWhenMeleeExpansionDetected = true

[Debug]
LogStateChanges = false

Option Details

EnableMod

Enables or disables the mod.

FirePerformsMeleeAttack

When enabled, pressing the normal Fire action while melee is toggled on performs one melee attack.

ReChargeRetryInterval

Controls how often the mod retries re-entering melee stance after the game clears the melee charge state.

ResetMeleeAnimatorBeforeSheathe

Keeps repeated melee draws visually stable by resetting the melee Animator to a cached safe equip state before sheathing.

DisableWhenMeleeExpansionDetected

If a future expanded melee mod with the plugin GUID kumo.sulfur.melee_expansion is installed, this standalone mod disables itself to avoid duplicate melee input patches.

LogStateChanges

Enables debug logging. Keep this disabled for normal gameplay.

Installation

With a Mod Manager

Install through Thunderstore / r2modman if available.

Manual Installation

Install BepInEx for SULFUR.
Extract this package into your SULFUR game folder.
Make sure the DLL ends up here:

SULFUR/BepInEx/plugins/ToggleMeleeStance.dll

Start the game once to generate the config file.

Compatibility

This mod does not edit original game files.

It should be compatible with most mods. Compatibility issues are most likely with mods that also patch:

EquipmentManager.HandleMeleeInput
EquipmentManager.HandleAimInput
EquipmentManager.PullTrigger
Weapon.ReportMeleeDone
melee weapon Animator behavior

If kumo.sulfur.melee_expansion is installed, this standalone mod disables itself by default.

Uninstallation

Remove the DLL from:

BepInEx/plugins/

Optional: remove the config file:

BepInEx/config/kumo.sulfur.toggle_melee_stance.cfg

Changelog

1.0.0

Initial release.
Added toggle melee stance.
Added Fire action melee attack while toggled.
Preserved vanilla Aim / alternative stance / block behavior.
Added safe sheathe behavior so pressing melee again does not trigger an extra attack.
Added melee Animator safe-state reset to prevent repeated draw animation flashes.
Added compatibility auto-disable for future Melee Expansion mod.