JSON Interactions

Zephyr exposes interaction types that other weapon mods can reference directly in their JSON interaction chains. This allows your mod to use Zephyr's dodge system without writing any Java code.

Zephyr_Dodge

The core dodge interaction. Runs the full dodge chain including iFrames, effects, stamina, directional dash forces, and animations. The dash distance and animation style are determined by the server config.

Usage

"Next": "Zephyr_Dodge"

Zephyr_Dodge_Config

Sets animation style and preset overrides before chaining into the dodge. Place this before Zephyr_Dodge in your interaction chain.

Fields

Field	Type	Default	Description
AnimationStyle	string	server config	Override animation style: roll, twirl, flip, or dash
Preset	int	server config	Override dodge preset (1 = short, 2 = mid, 3 = far)

Both fields are optional. Omitting a field uses the server's configured default.

Usage

{
  "Type": "Zephyr_Dodge_Config",
  "AnimationStyle": "roll",    // "roll", "twirl", "flip", or "dash"
  "Preset": 3,                 // 1 (short), 2 (mid), or 3 (far)
  "Next": "Zephyr_Dodge"
}

Examples

Override animation style only:

{
  "Type": "Zephyr_Dodge_Config",
  "AnimationStyle": "flip",
  "Next": "Zephyr_Dodge"
}

Override preset only:

{
  "Type": "Zephyr_Dodge_Config",
  "Preset": 1,
  "Next": "Zephyr_Dodge"
}

info

Zephyr_Dodge_Config requires "Next": "Zephyr_Dodge" because Zephyr's full dodge chain (effects, stamina, directional forces, animations) is defined in JSON interaction files. The config interaction sets overrides on the player, then the chain reads them.