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.
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.
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.
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.
BepInEx/
└─plugins/
├─ToggleMeleeStance.dll
└─TheDragonblade/
├─TheDragonblade.dll
└─dash_icon.png
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.
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
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
TheDragonblade.dll
dash_icon.png
Created by kumo.
This mod is an unofficial fan-made gameplay mod for SULFUR.
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: