Skip to content

Configuration

Jump to bottom
AzureDoom edited this page Aug 29, 2026 · 1 revision

Configuration

AzureCortex has its own standalone, dependency-free configuration, loaded once per platform module during initialization (you never call this yourself, each loader's entrypoint does it via AzureCortex.init(configDir)).

File location

config/azurecortex.json

Created automatically with defaults on first run if it doesn't exist.

Options

Key Default Effect
enablePathfindingDebug false Particle-based visualization of pathfinding searches and node classifications (see Navigation and Pathfinding). Dev/debug only, no effect on AI decisions.
enableAiDiagnostics false Periodic one-line diagnostic logging of each agent's current target/plan/action/path state (rate-limited to once per 40 ticks per agent).
enableIncrementalPathfinding true Spreads pathfinding search cost across ticks via incremental/phased sessions instead of paying for it synchronously (see Navigation and Pathfinding).
incrementalPathfindingNodeBudget 300 Per-tick node-expansion budget used by incremental pathfinding sessions when the above is enabled.

Example file:

{
  "enablePathfindingDebug": false,
  "enableAiDiagnostics": true,
  "enableIncrementalPathfinding": true,
  "incrementalPathfindingNodeBudget": 300
}

Reading the config from your own mod's code

if (CortexConfig.get().enableAiDiagnostics) {
    // ...
}

CortexConfig.get() is safe to call before load() has run, it returns default values until a config directory is actually loaded (which happens automatically during mod init).

Diagnostic output

With enableAiDiagnostics on, you'll see log lines like:

[a1b2c3d4-...] TARGET=Villager, PLAN=HUNT_TARGET, ACTION=MoveToDestinationAction, PATH=OK

or, when the last action reported a failure reason:

[a1b2c3d4-...] TARGET=NONE, PLAN=WANDER, ACTION=WanderAction, PATH=BLOCKED(FAILED_NO_PATH@120,64,-30)

This one line puts the GOAP layer, behavior tree, and pathfinder state together, since a misbehaving agent can be failing at any one of them and the failure often only shows up one or two layers away from its actual cause. It's a read-only formatter (CortexDiagnostics), it never gates or influences an AI decision, only describes it.

Next

Clone this wiki locally