The Dragonblade

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

• Install BepInEx 5 for SULFUR.
• Install Toggle Melee Stance 1.2.0 or newer.
• Extract this package into the game folder.
• 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

RefreshRequ