DetailedLogs Configuration Reference

DetailedLogs is a lightweight, JSON-first logging plugin for DayZ servers. This page documents all configuration options with examples.

Configuration File: $profile:DetailedLogs/config.json

Value Format: All values are integers. 1 = enabled, 0 = disabled (except numeric intervals)

Master & Core Settings

Control global logging behavior and output format

detailedLogs

Master switch for all logging functionality. When disabled (0), no logs are written regardless of other settings.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogs": 1 }

detailedLogsJson

Enable JSON output format. When enabled (1), each log line is a JSON object. When disabled (0), plain text format is used.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsJson": 1 }

Example Output:

{"ts":"2025-10-05T11:30:34.750","event":"PLAYER_MANAGEMENT","sub_event":"connect","data":{}}

detailedLogsOverride

Enables extra hooks for damage/kill events, actions, placement. Required for PLAYER_DEATH, BASEBUILDING, ACTION_* events.

Without this, death events and many critical logs will not be captured.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsOverride": 1 }

detailedLogsNoPause

Disable auto-pause when no players are online. Default (0) pauses logging when server is empty.

Type Boolean (0 or 1)

Default 0

config.json:

{ "detailedLogsNoPause": 0 }

detailedLogsFilterAlert

Write FILTER_ALERT lines when a disabled event category would have logged. Useful for debugging configuration.

Type Boolean (0 or 1)

Default 0

config.json:

{ "detailedLogsFilterAlert": 1 }

Example Output:

{"ts":"2025-10-05T11:20:00.000","event":"FILTER_ALERT","data":{"event":"LOOT_SPAWN","message":"Suppressed by configuration"}}

detailedLogsNoWorld

Suppress world-only events (not associated with players). Reduces log volume on busy servers.

Type Boolean (0 or 1)

Default 0

config.json:

{ "detailedLogsNoWorld": 0 }

Player Lifecycle & Management

Track player connections, spawns, and character lifecycle

detailedLogsPlayerManagement

Log player lifecycle events: connect, disconnect, reconnect, selected, respawn, load, loaded. Includes disconnect reasons and full identity.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerManagement": 1 }

Example Output:

{"ts":"2025-10-05T11:30:34.750","event":"PLAYER_MANAGEMENT","sub_event":"connect","data":{},"player":{"id":"2999670","name":"Player","steamId":"76561198000000000"}}

detailedLogsFirstTimeCharacters

Log when a player creates their first character on the server. Useful for tracking new players.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsFirstTimeCharacters": 1 }

Example Output:

{"ts":"2025-10-05T11:30:35.000","event":"FIRST_TIME_CHARACTERS","data":{},"player":{"steamId":"76561198000000000","persistentId":[111,222,333,444]}}

detailedLogsPlayerMovement

Log player movement state changes (idle, walk, run, sprint, jump, fall). Debounced to ~2 seconds for basic states to reduce volume by 70-80%.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerMovement": 1 }

Example Output:

{"ts":"2025-10-05T11:32:10.000","event":"PLAYER_MOVEMENT","sub_event":"run","data":{"speed":3.5},"player":{"steamId":"76561198000000000"}}

detailedLogsPlayerPosition

Log player position periodically. Set to number of seconds between logs (e.g., 10). Set to 0 to disable. Includes stats and ping metrics.

Type Integer (seconds)

Default 10

config.json:

{ "detailedLogsPlayerPosition": 10 }

Example Output:

{"ts":"2025-10-05T11:32:15.000","event":"PLAYER_POSITION","data":{"dir":72},"player":{"steamId":"76561198000000000","position":{"x":5450.3,"y":7.5,"z":8231.9},"stats":{"health":100},"pingAct":32}}

detailedLogsPlayerVehicle

Log vehicle-related events: driver/passenger enter/exit, seat changes.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerVehicle": 1 }

Example Output:

{"ts":"2025-10-05T11:33:00.000","event":"PLAYER_VEHICLE","sub_event":"driver_enter","data":{},"player":{"steamId":"76561198000000000"}}

Player Health & Combat

Monitor player health, damage, and combat events

detailedLogsPlayerHealth

Log player health state changes: unconscious start/stop, broken legs, restrained/free, bleeding, consumption of food/drinks.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerHealth": 1 }

Example Output:

{"ts":"2025-10-05T11:34:00.000","event":"PLAYER_HEALTH","sub_event":"unconscious_start","data":{},"player":{"steamId":"76561198000000000"}}

detailedLogsPlayerDamage

Log when players receive damage. Includes source, ammo type, hit zone, damage amounts, hitter identity, and distance.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerDamage": 1 }

Example Output:

{"ts":"2025-10-05T11:36:00.100","event":"PLAYER_DAMAGE","sub_event":"hit","data":{"source":{"type":"Mosin9130"},"ammo":"Bullet_762x54","zone":"Head","dmgZone":55.2,"distance":142.7}}

detailedLogsPlayerLethalDamage

Log lethal damage that results in player death. Same format as PLAYER_DAMAGE but only when damage is fatal.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerLethalDamage": 1 }

Example Output:

{"ts":"2025-10-05T11:36:00.120","event":"PLAYER_LETHAL_DAMAGE","sub_event":"hit","data":{"ammo":"Bullet_762x54","zone":"Head","dmgZone":12.0,"distance":142.7}}

detailedLogsPlayerDeath

Log player deaths with killer information and distance. Requires detailedLogsOverride=1.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerDeath": 1 }

Example Output:

{"ts":"2025-10-05T11:36:00.200","event":"PLAYER_DEATH","sub_event":"death","data":{"source":{"type":"Mosin9130"},"killer":{"steamId":"76561198000009999"},"distance":142.7}}

detailedLogsPlayerDeathDetails

Log additional death details added by other scripts.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerDeathDetails": 1 }

detailedLogsPlayerCleanup

Log when player entities are cleaned up (corpse removal, logout cleanup). Not a death event.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerCleanup": 1 }

detailedLogsPlayerWeapon

Log weapon fire events with weapon details, direction, and full weapon tree (attachments and cargo).

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerWeapon": 1 }

Example Output:

{"ts":"2025-10-05T11:35:12.008","event":"PLAYER_WEAPON","sub_event":"fire","data":{"weapon":{"type":"M4A1"},"dir":72,"weaponTree":{"item":{"type":"M4A1"},"atts":[],"cargo":[]}}}

detailedLogsHeadshots

Log headshot kills (lethal head/brain/neck damage). Works on players, zombies, and animals.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsHeadshots": 1 }

Example Output:

{"ts":"2025-10-05T11:37:00.000","event":"HEADSHOTS","sub_event":"headshot","data":{"targetType":"zombie","weapon":{"type":"Mosin9130"},"distance":45.2}}

Player Gear & Equipment

Track player inventory, gear changes, and equipment

detailedLogsPlayerGear

Log gear attached/detached on player (clothing, backpack, vest, etc.). May be suppressed if redundant with ITEM_LOCATION.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerGear": 1 }

Example Output:

{"ts":"2025-10-05T11:32:44.010","event":"PLAYER_GEAR","sub_event":"wear","data":{"item":{"type":"BallisticHelmet"},"slot":"Headgear"},"player":{"steamId":"76561198000000000"}}

detailedLogsPlayerHands

Log item moved in/out of player hands. May be suppressed if redundant with ITEM_LOCATION.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayerHands": 1 }

Example Output:

{"ts":"2025-10-05T11:32:45.222","event":"PLAYER_HANDS","sub_event":"in","data":{"item":{"type":"FNX45"}},"player":{"steamId":"76561198000000000"}}

detailedLogsNvg

Log night vision goggles on/off events.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsNvg": 1 }

Example Output:

{"ts":"2025-10-05T11:40:00.000","event":"NVG","sub_event":"on","data":{},"player":{"steamId":"76561198000000000"}}

detailedLogsSuppressRedundantGear

Suppress immediate PLAYER_HANDS/PLAYER_GEAR lines if equivalent ITEM_LOCATION just logged (≈400ms window). Reduces duplicate entries.

Set to 0 to keep original verbose behavior. ITEM_LOCATION remains canonical.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsSuppressRedundantGear": 1 }

Items & Inventory

Track item movements, attachments, and inventory changes

detailedLogsItemLocation

Log item movements between ground/hands/cargo/attachments. The canonical detailed record of item movements.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsItemLocation": 1 }

Example Output:

{"ts":"2025-10-05T11:33:10.000","event":"ITEM_LOCATION","sub_event":"located","from":"ground","to":"hands","item":{"type":"BandageDressing","hp100":100}}

detailedLogsItemAttach

Log when items are attached to other items (e.g., suppressor to weapon, optic to rifle).

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsItemAttach": 1 }

Example Output:

{"ts":"2025-10-05T11:31:50.010","event":"ITEM_ATTACH","data":{"item":{"type":"AK_Suppressor"},"to":{"type":"AK74"},"slotId":17}}

detailedLogsItemDetach

Log when items are detached from other items.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsItemDetach": 1 }

Example Output:

{"ts":"2025-10-05T11:31:52.110","event":"ITEM_DETACH","data":{"item":{"type":"AK_Suppressor"},"from":{"type":"AK74"},"slotId":17}}

detailedLogsItemQuantity

Log when item quantity changes (stackable items like ammo, bandages).

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsItemQuantity": 1 }

Example Output:

{"ts":"2025-10-05T11:40:01.005","event":"ITEM_QUANTITY","sub_event":"set","data":{"item":{"type":"Rags"},"quantity":3}}

detailedLogsItemDestroy

Log when items are destroyed (ruined, consumed, deleted).

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsItemDestroy": 1 }

Example Output:

{"ts":"2025-10-05T11:40:12.220","event":"ITEM_DESTROY","sub_event":"quantity","data":{"item":{"type":"Rags","hp100":100}}}

detailedLogsItemDamage

Log when items receive damage (not fatal).

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsItemDamage": 1 }

detailedLogsItemLethalDamage

Log lethal damage to items that results in destruction.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsItemLethalDamage": 1 }

detailedLogsItemDeath

Log when items are destroyed/ruined.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsItemDeath": 1 }

detailedLogsItemPlaced

Log when item placement finishes (tents, barrels, etc.). Requires detailedLogsOverride=1.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsItemPlaced": 1 }

detailedLogsLooting

Consolidated looting summaries: pickup (from ground), take (from container), store (into container), transfer (between containers).

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsLooting": 1 }

Example Output:

{"ts":"2025-10-05T11:33:10.010","event":"LOOTING","sub_event":"pickup","data":{"item":{"type":"BandageDressing"},"container":null,"containerType":"ground"}}

Containers & Cargo

Monitor container inventories and cargo movements

detailedLogsContainerInventory

Include compact container snapshots in ITEM_LOCATION events. Keep with low depth/cargo caps for inline snippets.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsContainerInventory": 1 }

detailedLogsCargo

Log full container trees via CARGO events when items move to/from containers. Supports chunking.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsCargo": 1 }

Example Output:

{"ts":"2025-10-05T11:34:04.002","event":"CARGO","data":{"id":"E#C100","name":"Barrel_Green","persistentId":[9,9,9,9],"cargo":{"item":{"type":"Barrel_Green"},"atts":[],"cargo":[]}}}

detailedLogsContainerSnapshotDepth

Maximum depth for recursive container snapshots. Set to 1-2 for manageable sizes.

Type Integer

Default 1

config.json:

{ "detailedLogsContainerSnapshotDepth": 1 }

detailedLogsContainerSnapshotCargoMax

Maximum number of cargo items to include in container snapshots. Set to 8-12 for balance.

Type Integer

Default 12

config.json:

{ "detailedLogsContainerSnapshotCargoMax": 12 }

detailedLogsCargoChunked

Enable chunking for large container cargo to split across multiple log lines.

Type Boolean (0 or 1)

Default 0

config.json:

{ "detailedLogsCargoChunked": 0 }

detailedLogsCargoChunkSize

Number of items per chunk when cargo chunking is enabled.

Type Integer

Default 10

config.json:

{ "detailedLogsCargoChunkSize": 10 }

detailedLogsCargoChunkMinIntervalSec

Minimum seconds between cargo chunk logs.

Type Integer (seconds)

Default 5

config.json:

{ "detailedLogsCargoChunkMinIntervalSec": 5 }

detailedLogsGearChunked

Enable chunking for large player gear inventories.

Type Boolean (0 or 1)

Default 0

config.json:

{ "detailedLogsGearChunked": 0 }

detailedLogsGearChunkSize

Number of items per chunk when gear chunking is enabled.

Type Integer

Default 10

config.json:

{ "detailedLogsGearChunkSize": 10 }

detailedLogsGearChunkMinIntervalSec

Minimum seconds between gear chunk logs.

Type Integer (seconds)

Default 5

config.json:

{ "detailedLogsGearChunkMinIntervalSec": 5 }

World & Dynamic Events

Track loot spawns, dynamic events, and world changes

detailedLogsLootSpawn

Log when loot items spawn in the world. Can be high volume.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsLootSpawn": 1 }

detailedLogsLootCleanup

Log when loot items are cleaned up/despawned.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsLootCleanup": 1 }

detailedLogsHeliCrash

Log helicopter crash events with position and loot.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsHeliCrash": 1 }

detailedLogsPoliceMedicWrecks

Log police car and medical wreck spawns.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPoliceMedicWrecks": 1 }

detailedLogsThrownItems

Log thrown item events (grenades, flares, etc.) and explosions.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsThrownItems": 1 }

Example Output:

{"ts":"2025-10-05T11:45:09.000","event":"THROWN_ITEM","data":{"item":{"type":"RGD5Grenade"},"player":{"steamId":"76561198000000000"}}}

detailedLogsArtillery

Log artillery strikes with impact and source positions.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsArtillery": 1 }

Example Output:

{"ts":"2025-10-05T11:50:00.000","event":"ARTILLERY","sub_event":"impact","data":{"impactPos":{"x":5500,"y":10,"z":8200},"sourcePos":{"x":0,"y":0,"z":0}}}

Basebuilding & Environment

Monitor basebuilding, stashes, doors, and structures

detailedLogsBasebuilding

Log basebuilding events: build, dismantle, destroy. Requires detailedLogsOverride=1.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsBasebuilding": 1 }

Example Output:

{"ts":"2025-10-05T12:05:44.000","event":"BASEBUILDING","sub_event":"build","data":{"id":"BB#001","type":"Fence","part":"wall"}}

detailedLogsStash

Log when players bury/unbury stashes with positions.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsStash": 1 }

Example Output:

{"ts":"2025-10-05T11:50:05.500","event":"STASH","sub_event":"bury","data":{"item":{"type":"WoodenCrate"},"position":{"x":4321.1,"y":5.1,"z":6500.2}}}

detailedLogsDoors

Log door interactions: open, close, lock, unlock. Works with building doors, gates, vehicle doors.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsDoors": 1 }

Example Output:

{"ts":"2025-10-05T11:37:13.000","event":"DOORS","sub_event":"open","data":{"door":{"type":"HouseBlock_1F3","persistentId":[10,20,30,40]},"type":"building"}}

detailedLogsCodelockAttempts

Log codelock/combination lock attempts.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsCodelockAttempts": 1 }

Server Monitoring

Track server performance and online player statistics

detailedLogsPlayersOnline

Log periodic player count and individual player stats with positions and ping metrics.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPlayersOnline": 1 }

Example Output:

{"ts":"2025-10-05T11:31:00.000","event":"PLAYERS_ONLINE","sub_event":"player_count","data":{"count":23}}

detailedLogsLiveJson

Write live.json file with current online players (minimal schema, no ping). Updated in place.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsLiveJson": 1 }

detailedLogsOnlineLiveIntervalSec

Seconds between PLAYERS_ONLINE logs and live.json updates.

Type Integer (seconds)

Default 120

config.json:

{ "detailedLogsOnlineLiveIntervalSec": 120 }

detailedLogsServerPerf

Log server performance metrics: FPS, uptime.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsServerPerf": 1 }

Example Output:

{"ts":"2025-10-05T11:40:00.000","event":"SERVER_PERF","data":{"fps":218.3,"uptimeSec":5400.2}}

Expansion Gameplay & Integrations

Requires the Expansion mod. These flags have no effect without Expansion.

detailedLogsChat

Log Expansion chat messages and related events.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsChat": 1 }

detailedLogsMarket

Log Expansion Market transactions (buy/sell) with item class, price, stock, and trader/zone context.

Type Boolean (0 or 1)

Default 1

Example Output:

{"ts":"2025-10-05T12:10:00.000","event":"MARKET","sub_event":"buy","player":{"steamId":"76561198000000000"},"data":{"class":"M4A1","amount":1,"price":5500,"stock":3,"static":false,"trader":{"name":"Green Mountain Trader","file":"TraderNPC_1"},"zone":{"name":"Green Mountain","pos":{"x":3726.0,"y":402.0,"z":6000.0}}}}

config.json:

{ "detailedLogsMarket": 1 }

detailedLogsAtm

Log ATM deposits/withdrawals and balances.

Type Boolean (0 or 1)

Default 1

Example Output:

{"ts":"2025-10-05T12:12:33.333","event":"ATM","sub_event":"withdraw","player":{"steamId":"76561198000000000"},"data":{"amount":5000,"balance":12000}}

config.json:

{ "detailedLogsAtm": 1 }

detailedLogsSafezone

Log safezone enter/exit events with positions.

Type Boolean (0 or 1)

Default 1

Example Output:

{"ts":"2025-10-05T12:00:00.000","event":"SAFEZONE","sub_event":"enter","player":{"steamId":"76561198000000000"},"data":{"position":{"x":3700.0,"y":400.0,"z":6000.0}}}

config.json:

{ "detailedLogsSafezone": 1 }

detailedLogsTraderZone

Log trader zone enter/exit with trader metadata (if present).

Type Boolean (0 or 1)

Default 1

Example Output:

{"ts":"2025-10-05T12:00:05.000","event":"TRADER_ZONE","sub_event":"enter","player":{"steamId":"76561198000000000"},"data":{"trader":{"name":"Green Mountain Trader","file":"TraderNPC_1"},"zone":{"name":"Green Mountain","pos":{"x":3726.0,"y":402.0,"z":6000.0}}}}

config.json:

{ "detailedLogsTraderZone": 1 }

detailedLogsParty

Log Expansion party-related actions (create/join/leave/invite) where supported.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsParty": 1 }

detailedLogsTerritory

Log Expansion territory events.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsTerritory": 1 }

detailedLogsPersonalStorage

Log personal storage actions where supported.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsPersonalStorage": 1 }

detailedLogsAirdrop

Log airdrop events (if enabled in Expansion).

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsAirdrop": 1 }

Expansion AI & Telemetry

Requires Expansion AI. Provides rich AI movement/health/combat/targeting telemetry.

detailedLogsAi

Master enable for Expansion AI telemetry. Other AI flags respect this.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsAi": 1 }

detailedLogsAiPosition

Log periodic AI positions and heading.

Type Boolean (0 or 1)

Default 1

Example Output:

{"ts":"2025-10-05T12:15:00.000","event":"AI_POSITION","data":{"id":"AI#1001","faction":"Raiders","pos":{"x":6200.2,"y":5.3,"z":7800.9},"dir":135}}

config.json:

{ "detailedLogsAiPosition": 1 }

detailedLogsAiMovement

Log AI movement states (idle/walk/run/sprint) and speed.

Type Boolean (0 or 1)

Default 1

config.json:

{ "detailedLogsAiMovement": 1 }

detailedLogsAiHealth

Log AI health and bleed states.

Type Boolean (0 or 1)

Default 1

Example Output:

{"ts":"2025-10-05T12:15:05.500","event":"AI_HEALTH","data":{"id":"AI#1001","health":87.5,"bleeds":0}}

config.json:

{ "detailedLogsAiHealth": 1 }

detailedLogsAiWeaponFire

Log AI weapon fire with weapon type and direction.

Type Boolean (0 or 1)

Default 1

Example Output:

{"ts":"2025-10-05T12:15:08.000","event":"AI_WEAPON","sub_event":"fire","data":{"id":"AI#1001","weapon":{"type":"AK74","hp100":92.0},"dir":180}}

config.json:

{ "detailedLogsAiWeaponFire": 1 }

detailedLogsAiDamage

Log AI damage and AI lethal damage when it results in death.

Type Boolean (0 or 1)

Default 1

Example Output:

{"ts":"2025-10-05T12:15:08.120","event":"AI_DAMAGE","sub_event":"hit","data":{"target":{"steamId":"76561198000000000"},"ammo":"Bullet_545x39","zone":"Torso","dmgZone":12.0,"dmgHealth":12.0,"distance":35.4}}

config.json:

{ "detailedLogsAiDamage": 1, "detailedLogsAiLethalDamage": 1 }

detailedLogsAiDeath

Log AI deaths with source and distance when applicable.

Type Boolean (0 or 1)

Default 1

Example Output:

{"ts":"2025-10-05T12:16:00.000","event":"AI_DEATH","sub_event":"death","data":{"id":"AI#1001","source":{"steamId":"76561198000000000"},"distance":41.2}}

config.json:

{ "detailedLogsAiDeath": 1 }

detailedLogsAiTarget

Log AI current target and reason for aggro.

Type Boolean (0 or 1)

Default 1

Example Output:

{"ts":"2025-10-05T12:15:10.000","event":"AI_TARGET","data":{"id":"AI#1001","target":{"steamId":"76561198000000000"},"reason":"aggro"}}

config.json:

{ "detailedLogsAiTarget": 1 }

detailedLogsAiLos

Log AI line-of-sight (LOS) checks against current targets.

Type Boolean (0 or 1)

Default 1

Example Output:

{"ts":"2025-10-05T12:15:22.000","event":"AI_LOS","data":{"id":"AI#1001","target":{"steamId":"76561198000000000"},"los":true}}

config.json:

{ "detailedLogsAiLos": 1 }

detailedLogsAiThreat

Log AI threat values and changes; rate limited by min delta and interval settings.

Type Boolean (0 or 1)

Min Delta (ms) Integer

Min Interval (ms) Integer

Defaults 1, 0, 0

Keys detailedLogsAiThreat, detailedLogsAiThreatMinDeltaMilli, detailedLogsAiThreatMinIntervalMs

Example Output:

{"ts":"2025-10-05T12:15:12.000","event":"AI_THREAT","data":{"id":"AI#1001","threat":0.62,"delta":0.07}}

config.json:

{
  "detailedLogsAiThreat": 1,
  "detailedLogsAiThreatMinDeltaMilli": 0,
  "detailedLogsAiThreatMinIntervalMs": 0
}

Other AI Flags

Enable additional AI details as needed:

detailedLogsAiGearOnSpawn, detailedLogsAiSkillsOnSpawn
detailedLogsAiGear, detailedLogsAiHands, detailedLogsAiWeapon, detailedLogsAiActions
detailedLogsAiCover

config.json (enable as needed):

{
  "detailedLogsAiGearOnSpawn": 1,
  "detailedLogsAiSkillsOnSpawn": 1,
  "detailedLogsAiGear": 1,
  "detailedLogsAiHands": 1,
  "detailedLogsAiWeapon": 1,
  "detailedLogsAiActions": 1,
  "detailedLogsAiCover": 1
}

Quick Reference: Recommended Configuration

{
  "detailedLogs": 1,
  "detailedLogsJson": 1,
  "detailedLogsOverride": 1,
  "detailedLogsNoPause": 0,
  "detailedLogsPlayerManagement": 1,
  "detailedLogsPlayerPosition": 10,
  "detailedLogsPlayerDeath": 1,
  "detailedLogsPlayerDamage": 1,
  "detailedLogsPlayerWeapon": 1,
  "detailedLogsPlayerGear": 1,
  "detailedLogsContainerInventory": 1,
  "detailedLogsCargo": 1,
  "detailedLogsContainerSnapshotDepth": 1,
  "detailedLogsContainerSnapshotCargoMax": 12,
  "detailedLogsSuppressRedundantGear": 1
}

This configuration provides comprehensive logging for player actions, combat, inventory management while keeping log volume manageable.