Configuration

The main configuration file is config.json in the mod data folder:

mods/Hexora_SpellbookPlus/config.json

Full Configuration

{
  "execution": {
    "maxNodesPerExecution": 50,
    "maxExecutionDepth": 10
  },
  "cooldown": {
    "globalCooldownMs": 500,
    "minimumCooldownMs": 100
  },
  "instability": {
    "safeThreshold": 50,
    "warningThreshold": 75,
    "dangerThreshold": 100,
    "catastrophicThreshold": 150
  },
  "mana": {
    "useNativeMana": false
  },
  "hud": {
    "manaBarEnabled": true,
    "showOnlyWithStaff": true
  },
  "storage": {
    "storagePath": "spellbook/spells"
  }
}

Execution Settings

maxNodesPerExecution

Maximum number of nodes that can be executed in a single spell graph.

Value	Range
Default	50
Min	1
Max	200

maxExecutionDepth

Maximum recursion depth for spell graph execution.

Value	Range
Default	10
Min	1
Max	50

Cooldown Settings

globalCooldownMs

Global cooldown between any spell casts in milliseconds.

Value	Range
Default	500
Min	0
Max	60000

minimumCooldownMs

Minimum per-spell cooldown in milliseconds.

Value	Range
Default	100
Min	0
Max	60000

Instability Settings

Instability is calculated based on spell complexity (node count and parameters).

safeThreshold

Instability level below which spells are safe to cast.

Value	Range
Default	50
Min	0
Max	1000

warningThreshold

Instability level that triggers minor negative effects.

Value	Range
Default	75
Min	0
Max	1000

dangerThreshold

Instability level that triggers significant penalties.

Value	Range
Default	100
Min	0
Max	1000

catastrophicThreshold

Instability level that triggers severe penalties.

Value	Range
Default	150
Min	0
Max	1000

Thresholds must be ordered: safe <= warning <= danger <= catastrophic

Mana Settings

useNativeMana

Use Hytale's native mana system (requires Hytalor mod).

Value	Description
false	Use custom SpellMana stat (default)
true	Use native Hytale mana via Hytalor

HUD Settings

manaBarEnabled

Show or hide the mana bar HUD.

Value	Description
true	Mana bar is visible (default)
false	Mana bar is hidden

showOnlyWithStaff

Only show mana bar when holding a spell staff.

Value	Description
true	Show only with staff (default)
false	Always show mana bar

Storage Settings

storagePath

Directory for spell storage files.

Value	Default
Default	spellbook/spells

Reloading Configuration

Use /sb reload to reload the configuration without restarting the server.

Note: Mana system changes require a server restart.