Configuration
Use /dodgemodsettings in-game to adjust most settings live through the admin UI. Configuration is also stored in mods/Perfect_Dodges/dodge_config.json if you prefer to edit the file directly (requires server restart).
Config Options
Timing & Cooldown
| Option | Default | Description |
|---|---|---|
dodgeCooldownMs | 500 | minimum time between dodges (ms) |
iFrameDurationMs | 200 | invincibility frame duration (ms) |
Movement
| Option | Default | Description |
|---|---|---|
horizontalVelocity | 20.0 | dash movement speed |
verticalVelocity | 0.1 | small upward force during dodge |
dodgePreset | 2 | distance preset: 1=Short, 2=Standard, 3=Far |
useVelocity | false | maintain velocity during interaction chain |
Stamina
| Option | Default | Description |
|---|---|---|
staminaCost | 1.5 | stamina consumed per dodge |
Air Dodge
| Option | Default | Description |
|---|---|---|
allowAirDash | false | allow mid-air dodging (1 per airborne period) |
Ability Key Bindings
| Option | Default | Description |
|---|---|---|
useSprintKey | true | bind dodge to the Sprint key |
useAbility2 | false | bind dodge to Ability 2 key |
useAbility3 | false | bind dodge to Ability 3 key |
overwriteAllAbilities | false | replace existing native abilities on items |
Changes to useSprintKey, useAbility2, useAbility3, overwriteAllAbilities, and dodgePreset require a server restart to take effect. All other settings can be hot-reloaded via the admin UI.
Sprint-Walk Mode
These options only apply when useSprintKey, useAbility2, and useAbility3 are all disabled, activating the sprint-walk mode.
| Option | Default | Description |
|---|---|---|
sprintTapThresholdMs | 0 | sprint tap-and-release threshold (0 = instant) |
walk | true | walk key triggers dodge |
sprint | true | sprint key triggers dodge |
Animation Style
| Option | Default | Description |
|---|---|---|
roll | false | enable Roll animation style |
twirl | false | enable Twirl animation style |
flip | false | enable Flip animation style |
When all three are false (the default), the mod uses reactive animations that change based on where incoming hits land. See Dodging Mechanics for details. When multiple styles are enabled, the mod randomly picks one each dodge.
Creative Mode
| Option | Default | Description |
|---|---|---|
disableCreativeDash | false | disable dodging in Creative mode |
Live Editing
The /dodgemodsettings command opens an interactive settings UI where admins can change most settings without restarting the server. See Commands for details.