Combat Configuration

Set instance-wide combat policy — the minimum readable telegraph window and the standard danger colors every AoE zone falls back to.

Unlike the other config files, combat-config declares no content. It sets the rules that every weapon, mob and AoE zone in the instance is held to — currently the telegraph vocabulary, the shared language attacks use to announce themselves before they land.

The idea is that a player learns one set of tells and it holds everywhere: a wind-up pose means a blow is coming, an amber outline means ground is about to become dangerous, and a tell is never so brief it can’t be read. Individual attacks choose whether to telegraph; this file sets the floor for what a telegraph has to be once one is declared.

Every field is optional — omit one and the engine default applies.

File Location

Register the file in your mod’s manifest (mods/<YourMod>/<YourMod>.yaml):

combat-config:

The bare key resolves to combat-config.yaml in the mod folder; give it a value to point at a different filename.

Because this is instance-wide policy rather than per-mod content, two mods declaring the same field is a genuine conflict — the mod later in load order wins, and the override is written to the log so it isn’t a silent clobber. Most mods should not declare this file at all.

Fields

All fields live under a single telegraph: block.

FieldTypeDefaultDescription
minimum-window-msinteger250Shortest a declared telegraph is allowed to be
danger-color{ r, g, b, a }amber {1.0, 0.5, 0.0, 0.8}Outline color an AoE zone uses while warning, when it names no color of its own
danger-color-active{ r, g, b, a }red {1.0, 0.0, 0.0, 1.0}Outline color while the zone is active

Colors are RGBA components in the range [0.0, 1.0], the same shape used by the light: block’s color everywhere else. a defaults to 1.0 if omitted.

minimum-window-ms

Applied at load time to both halves of the vocabulary:

  • a weapon’s wind-up — the leading damaging: false frames of its primary-use-animation (see item-config.md), scaled up in proportion until they sum to the floor
  • an AoE zone’s telegraph-duration-ms (see aoe-zone-config.md)

Anything raised is reported in the log, naming the item or zone, so tuning that fell below the floor is visible rather than mysterious.

A telegraph of zero is never raised. No wind-up frames, or telegraph-duration-ms: 0, declares an attack that deliberately has no tell — a fast dagger poke, an ordinary mob swing, a persistent traversal current. That is a different statement from a tell too short to read, and the floor leaves it alone. This is also why adding this file does not silently slow down every existing weapon.

The floor applies uniformly to players and mobs alike: a player’s attack has to be readable to the player being hit by it just as much as a boss’s does.

Example

telegraph:
  minimum-window-ms: 250

  danger-color:
    r: 1.0
    g: 0.5
    b: 0.0
    a: 0.8

  danger-color-active:
    r: 1.0
    g: 0.0
    b: 0.0
    a: 1.0

A mod aiming at faster, twitchier combat can lower the floor; one aiming at slower, more deliberate reads can raise it:

telegraph:
  minimum-window-ms: 400

Last updated