The Dragonblade

You found a katana with the words “Ryu-Ichimonji” carved into its blade.

You are not him.
But for a moment, a fragment of his power answers your hand.

Overview

The Dragonblade is a katana-focused melee expansion mod for SULFUR.

It adds a cyber-ninja style dash strike, kill-based cooldown refresh, enemy-kill healing, and a bottom-right ability HUD for katana stance gameplay.

Starting from 0.3.0, The Dragonblade uses Toggle Melee Stance as its prerequisite melee stance module.

Required Dependency

The Dragonblade requires:

Toggle Melee Stance 1.2.0 or newer

Toggle Melee Stance provides:

Tap melee key
→ Toggle melee stance

Hold melee key
→ Use original melee behavior

Fire while toggled
→ Perform melee attack

Aim / Alt Fire while toggled
→ Keep vanilla alternative stance / block behavior

The Dragonblade no longer duplicates those toggle melee patches internally.

This reduces conflicts and prevents both mods from fighting over the same melee input state.

Features

• Uses Toggle Melee Stance as the shared stance foundation.
• While holding a katana, Sprint becomes Dash Strike.
• Dash Strike moves in the direction you are looking.
• Dash Strike uses the current katana as the damage source.
• Killing an enemy refreshes Dash Strike.
• Killing an enemy heals the player.
• Breakable objects do not heal the player.
• Optional config allows non-NPC units, such as breakable obstacles, to refresh cooldown.
• Includes an ability icon HUD with cooldown display, refresh feedback, and healing feedback.
• Includes a small post-dash hang window to make aerial dash movement feel smoother.

Basic controls

While holding a katana-like melee weapon and Toggle Melee Stance is active:

Tap Melee key
→ Toggle melee stance on / off

Hold Melee key
→ Use the original melee behavior
→ Release to perform the original melee attack
→ Return to the previous weapon

Fire
→ Perform one melee attack while melee stance is active

Aim
→ Keep original aim / block behavior

Sprint
→ Dash Strike

The Dragonblade does not hardcode F, LeftShift, mouse buttons, or controller buttons.

It relies on Toggle Melee Stance and the game's own input actions, so it should respect key rebinding and controller input better than raw key checks.

Installation

1. Install BepInEx 5 for SULFUR.
2. Install Toggle Melee Stance 1.2.0 or newer.
3. Extract this package into the game folder.
4. Make sure the files are placed like this:

BepInEx/
└─plugins/
  ├─ToggleMeleeStance.dll
  └─TheDragonblade/
    ├─TheDragonblade.dll
    └─dash_icon.png

Compatibility

Do not install old standalone melee toggle mods together with The Dragonblade unless they are Toggle Melee Stance 1.2.0 or newer.

The Dragonblade now depends on Toggle Melee Stance for the stance system.

The Dragonblade no longer patches these toggle melee methods directly:

EquipmentManager.HandleMeleeInput(bool)
EquipmentManager.HandleAimInput(bool)
EquipmentManager.PullTrigger()
EquipmentManager.ReleaseTrigger()
Weapon.ReportMeleeDone()
Weapon.ChargeMelee(bool)

Those are handled by Toggle Melee Stance.

The Dragonblade still patches systems needed for dash, movement, HUD, and kill rewards.

Compatibility with Random Weapon Per Level

External weapon-switch handling is now owned by Toggle Melee Stance.

Default behavior:

Kill enemy
→ Another mod switches your weapon
→ You try to fire
→ Toggle Melee Stance exits melee stance
→ The gun fires normally

This prevents a broken state where the player appears to be holding a gun, but melee stance still intercepts the fire input.

Recommended Toggle Melee Stance config:

[Compatibility]
KeepMeleeStanceAfterExternalWeaponSwitch = false

Configuration

The Dragonblade config file is generated after launching the game once.

Important options:

[KatanaDash]
EnableKatanaDash = true
KatanaNameKeywords = Katana,Wakizashi,BiggerKatana
Cooldown = 5
Distance = 8
Duration = 0.22
HitRadius = 1
DamageMultiplier = 1
HitEachUnitOnce = true
RefreshCooldownOnPlayerKill = true
RefreshRequiresKatanaStance = true
RefreshCooldownOnNonNpcUnitKill = false
HealOnEnemyKill = true
HealAmountOnEnemyKill = 5
PostHangDuration = 0.12
PostHangMaxDownwardSpeed = 0.5
SuppressFallingAnimationDuringPostHang = true

[UI]
EnableDashHud = true
DashIconFileName = dash_icon.png
DashHudIconSize = 76
DashHudUseActualSprintBinding = true
DashHudFallbackKeyLabel = SHIFT
DashKillRefreshFeedbackDuration = 0.45
DashHealFeedbackDuration = 0.85

[Debug]
LogDash = false
LogStateChanges = false

Toggle melee behavior is configured in Toggle Melee Stance, not in The Dragonblade.

For example:

BepInEx/config/kumo.sulfur.toggle_melee_stance.cfg

[Melee]
EnableTapHoldMeleeKey = true
MeleeToggleTapThreshold = 0.13

[Compatibility]
KeepMeleeStanceAfterExternalWeaponSwitch = false

Notes

• The Sprint key is not hardcoded. The mod reads the game's Sprint action, so remapped controls are supported.
• The Melee key behavior is provided by Toggle Melee Stance.
• The Dragonblade does not simulate keyboard input.
• While katana stance is active, the mod keeps the game's own sprint state active through the internal sprint system.
• Dash movement is applied through the game's movement pipeline rather than directly teleporting the player.
• Enemy-kill healing only works on NPC/enemy kills. Obstacles can optionally refresh cooldown, but they never heal the player.

Version notes

v0.3.0

• Changed The Dragonblade to require Toggle Melee Stance as a prerequisite.
• Removed duplicated toggle melee input patches from The Dragonblade.
• Dragonblade now reads melee stance state from Toggle Melee Stance public API.
• Moved tap / hold melee key behavior and external weapon switch handling to Toggle Melee Stance.
• Reduced risk of double-patching melee input when both mods are installed.

Files

TheDragonblade.dll
dash_icon.png

Credits

Created by kumo.

This mod is an unofficial fan-made gameplay mod for SULFUR.

SULFUR Config Localization Support

This mod includes localization files for SULFUR Config.

This localization support is only for the in-game configuration page provided by SULFUR Config. It localizes the mod name, config sections, setting names, and setting descriptions shown in the config UI.

It does not change the game’s own text, item names, dialogue, or gameplay content.

Supported SULFUR Config languages:

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