UnofficialWIKI
Builder
Edit / Suggest changeSuggest deletion

Combat Settings

combatSettings

Numeric tuning for the combat system: combat XP, the cooldown and bonus given to abilities characters learn in play, NPC daily healing, and the list of valid damage types for your world.

In the editor

"Combat settings and their mechanics"

Editor location
Files → Mechanics → Advanced → Combat Settings
Editor type
Edit in Studio + View JSON
API endpoint
/sections/combatSettings.json/sections/combatSettings.md
Size limits
  • combatSettings.damageTypes (entry count) — 40 entries
  • combatSettings.damageTypes.* (each) — 60
Related

Schema

json
{
  "combatSettings": {
    "minCombatXP": "number",
    "baseCombatXP": "number",
    "abilityCooldown": "number",
    "abilityBonus": "number",
    "npcDailyHealingAmount": "number",
    "damageTypes": [
      "string"
    ],
    "damageTypePresentation": {
      "<key>": {
        "emoji": "string"
      }
    }
  }
}

Example

json
{
  "combatSettings": {
    "minCombatXP": 1,
    "baseCombatXP": 100,
    "abilityCooldown": 0,
    "abilityBonus": 10,
    "npcDailyHealingAmount": 999,
    "damageTypes": [
      "piercing", "slashing", "bludgeoning", "poisoning",
      "fire", "lightning", "wind", "water",
      "arcane", "light", "dark", "psychic"
    ],
    "damageTypePresentation": {
      "fire": { "emoji": "🔥" },
      "lightning": { "emoji": "⚡" }
    }
  }
}

Fields

abilityCooldown

Applies to abilities the AI generates for a character during play (learned abilities) in two ways: it is the cooldown they are given, and it is the minimum number of turns that must pass before a character can learn another new ability. Abilities defined in abilities use their own required cooldown and are unaffected. Default 20.

abilityBonus

The bonus given to abilities the AI generates for a character during play (learned abilities). Abilities defined in abilities use their own required bonus and are not scaled by this value. An ability's bonus (shown in-game as Power) is added to the check as a flat modifier alongside the acting skill and attribute contributions, and shares the skillSettings.maxSkillSuccessLevel cap with them. Default 10.

npcDailyHealingAmount

Health NPCs recover per in-game day. The default 999 heals NPCs fully each day.

damageTypes

The world's damage types. The vulnerabilities, resistances, and immunities of npcTypes, npcs, and traits must use values from this list; Voyage warns on any that don't.

Common mistake (matching is case-sensitive and unnormalized): Damage type matching against vulnerabilities, resistances, and immunities is exact and case-sensitive: "Fire" and "fire" are different types, and a mismatch fails silently (full damage, no warning). Use the same lowercase ASCII strings everywhere you reference a damage type, and avoid accented or non-ASCII characters, which break matching the same silent way.

damageTypePresentation

Controls how damage types are displayed. Each key is a damage type and its value takes an emoji string. Required; {} (the default) shows every damage type as a text label, and a type displays an emoji only where you configure one here.

baseCombatXP

Base XP awarded for a combat victory. Default 100.

minCombatXP

Minimum XP a combat victory awards. Default 1.