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 toggleable katana stance, a cyber-ninja style dash strike, kill-based cooldown refresh, enemy-kill healing, and a bottom-right ability HUD.

Features

• Toggle katana stance instead of holding the melee key.
• Attack with the normal Fire input while the katana is drawn.
• Keep the original Aim / Block behavior.
• 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.

Installation

1. Install BepInEx 5 for SULFUR.
2. Extract this package into the game folder.
3. Make sure the files are placed like this:

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

Compatibility

Do not install Toggle Melee Stance together with The Dragonblade.

The Dragonblade already includes the toggle melee stance feature.

If you previously installed Toggle Melee Stance, remove it before using this mod, unless your installed Toggle Melee Stance version already auto-disables when kumo.sulfur.melee_expansion is present.

Configuration

The config file is generated after launching the game once.

Important options:

[KatanaDash]
Cooldown = 5
Distance = 8
Duration = 0.22
HitRadius = 1
DamageMultiplier = 1
RefreshCooldownOnPlayerKill = true
RefreshRequiresKatanaStance = true
RefreshCooldownOnNonNpcUnitKill = false
HealOnEnemyKill = true
HealAmountOnEnemyKill = 5
PostHangDuration = 0.12
PostHangMaxDownwardSpeed = 0.5

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

[Debug]
LogDash = false
LogStateChanges = false

Notes

• The Sprint key is not hardcoded. The mod reads the game's Sprint action, so remapped controls are supported.
• The mod does not simulate keyboard input.
• While the katana is drawn, 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.

Files

TheDragonblade.dll
dash_icon.png

Credits

Created by kumo.

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