Setup

-- Master switch. When false the resource does nothing (map keeps default behavior).
Config.Enabled = true

-- Print debug output (client and server).
Config.Debug = false

-- 'character': every character has its own exploration progress.
-- 'account': all characters of a player share one exploration progress.
Config.PersistenceMode = 'character'

-- World-unit size of one exploration cell in meters. The in-game reveal radius per
-- cell is controlled by RevealScale; 100.0 with scale 1.0 gives gapless coverage.
Config.CellSize = 100.0

-- Scale of the engine's live reveal around the moving player, passed to
-- SetMinimapFowOverrideRevealScale. NEVER set this to 0.0: the engine FOW
-- bugs out and stops revealing.
Config.RevealScale = 1.0

-- How long restored reveal volumes stay alive (ms). FOW opacity accumulates
-- while a reveal writer is active; too short leaves a washed-out veil over
-- restored areas. Only relevant during login replay / admin reveals.
Config.RevealHoldMs = 8000

-- Maximum reveal volumes used to restore stored exploration. If the exact
-- rectangle decomposition needs more, cells are coarsened (2x, 4x, ...) until
-- the count fits; edges then snap to the coarser grid.
Config.MaxRevealVolumes = 768

-- Milliseconds between player position samples for exploration tracking.
Config.SampleInterval = 750

-- Cell radius recorded as explored around the player per sample. Should
-- roughly match the engine's own live reveal radius so the restored map
-- equals what the player actually saw.
Config.SampleRingRadius = 2

-- Milliseconds between automatic delta flushes to the server.
Config.FlushInterval = 20000

-- Server-side validation: maximum chunks accepted per flush payload.
Config.MaxChunksPerFlush = 32

-- Server-side validation: minimum milliseconds between flushes per player.
Config.MinFlushGap = 5000

-- Hide the fog overlay while the player is in Guarma (broken visuals otherwise).
Config.HandleGuarma = true

-- Hide map blips that sit in undiscovered areas, like singleplayer POIs.
-- Requires the free dd_blipmanager resource; ignored when it is not running.
-- This switch is authoritative: it overrides dd_blipmanager's own Fow.enabled.
Config.HideBlipsInFog = true

-- Zones revealed on every load without being persisted (towns, spawn points...).
-- Circle zones: name, coords, radius (meters).
Config.PreRevealedZones = {
    -- { name = 'valentine', coords = vector3(-275.0, 802.0, 119.0), radius = 400.0 },
}

-- World bounds of the playable map, used for zone scans and the explored-percent
-- calculation. Only change these when using a custom map.
Config.MapBounds = { minX = -8000.0, maxX = 4500.0, minY = -4500.0, maxY = 7000.0 }

Config.Discoveries = {
    enabled = true,
    notify = true,
    mode = 'zones',

    zones = {
        district = true,          -- discover districts (Heartlands, Big Valley, ...)
        town = true,              -- discover towns (Valentine, Rhodes, ...)
        -- Reveal the whole zone area on the map on first entry, per zone kind.
        -- Districts are large; by default only towns reveal their full shape
        -- and district discovery just notifies and rewards.
        revealZone = { district = false, town = true },
        persistReveal = true,     -- store the revealed zone as explored
        scanPointsPerFrame = 400, -- zone shape scan workload per frame
        -- Reward for every zone discovery; per-zone overrides win.
        -- Keys: 'district:<key>' / 'town:<key>' as defined in shared/zones.lua.
        defaultReward = nil,      -- e.g. { money = 0.25, item = nil, amount = 1 }
        rewards = {
            -- ['town:valentine'] = { money = 0.50 },
            -- ['district:Heartlands'] = { money = 1.00 },
        },
    },

    regions = {
        -- {
        --     name = 'valentine',
        --     label = 'Valentine',
        --     coords = vector3(-275.0, 802.0, 119.0),
        --     radius = 400.0,
        --     reward = { money = 0.50, item = nil, amount = 1 },
        -- },
    },
}

-- Ace permission required for the admin command, e.g.
-- add_ace group.admin dd_fogofwar.admin allow
Config.Permissions = {
    adminCommand = 'dd_fogofwar.admin',
}

-- Admin command name: /fow reveal|reset|stats [serverId]
Config.Command = 'fow'

/fow reveal [serverId]   Reveal the whole map for a player (persisted)
/fow peek   [serverId]   Session-only toggle: show the whole map, call again to restore
/fow reset  [serverId]   Wipe a player's exploration progress
/fow stats  [serverId]   Show stored chunks and explored percentage

Lang = {
    discovered_title = 'Region discovered',
    discovered_desc = 'You have discovered %s',
    admin_revealed = 'Map fully revealed for player %s',
    admin_reset = 'Fog of war reset for player %s',
    admin_stats = 'Player %s: %d chunks stored, %.1f%% explored',
    no_permission = 'You do not have permission to use this command',
    usage = 'Usage: /%s reveal|reset|stats [serverId]',
}