Setup

Config = {}

-- Verbose console logging via Bridge.Debug(). Also enables the /pinboard <key> dev command,
-- which lets admins open a board from anywhere. Never ship a server with this on.
Config.Debug = false

-- Framework is auto-detected (VORP / RSG). Set to 'vorp' or 'rsg' to force it.
Config.Framework = nil

-- Language is set in config/language.lua (DDLanguage) or server-wide via `setr dd:language de`.

-- ---------------------------------------------------------------------------
-- Board locations
-- ---------------------------------------------------------------------------
-- One persistent board per entry. `key` is the database identifier of the board: keep it
-- stable once players have used the board, renaming it creates a fresh empty board.
--   key      unique id (letters, digits, underscore)
--   label    board title shown in the UI header
--   coords   world position of the interaction point
--   radius   interaction range in metres (default Config.interactRadius)
--   editJobs optional list of job names; only members may edit (everyone may still read).
--            Omit or leave nil for "everyone may edit".
--   bgStyle  optional fixed background: 'cork', 'parchment', 'dark', 'slate' or 'linen'. The
--            board always shows it, the Background selector is gone from the toolbar, and a
--            showcase preset's own background is ignored here. Omit to let the players choose.
--   size     optional { w = <px>, h = <px> }: the board is a sheet of that size (in board
--            pixels, at zoom 1) instead of endless, hung in a wooden frame with the game world
--            visible around it. Cards stay on the sheet and the view cannot be panned off it.
--            Omit for an endless board.
Config.boardLocations = {
    {
        key    = 'saint_denis_precinct',
        label  = 'Saint Denis Precinct Board',
        coords = vector3(2496.9163, -1300.8125, 48.9569),
        -- editJobs = { 'police' },
    },
    {
        key     = 'valentine_saloon',
        label   = 'Valentine Saloon Board',
        coords  = vector3(-299.33, 802.11, 118.46),
        -- A saloon notice board: always cork, and only so big.
        bgStyle = 'cork',
        size    = { w = 2400, h = 1600 },
    },
    -- Ready-made demonstration board. Fill it with `/pinboard_seed showcase_case_board`
    -- (see Config.showcasePresets in config/showcase.lua) or delete this entry.
    {
        key    = 'showcase_case_board',
        label  = 'Sheriff\u{2019}s Case Board',
        coords = vector3(-278.05, 803.63, 119.34),
    },
}

-- ---------------------------------------------------------------------------
-- Interaction
-- ---------------------------------------------------------------------------
Config.interactRadius = 2.0     -- metres, default per location
Config.interactKey    = 'E'     -- 'E', 'G', 'R', 'SPACE' or a raw RedM control hash
Config.interactHoldMs = nil     -- e.g. 500 for hold-to-open; nil = press

-- ---------------------------------------------------------------------------
-- Permissions (server-side)
-- ---------------------------------------------------------------------------
Config.Permissions = {
    -- May this player edit the given board location? Reading is always allowed.
    -- `location` is the entry from Config.boardLocations.
    edit = function(src, location)
        if not location.editJobs then return true end
        local job = Bridge.getCharacterJob(src)
        for _, allowed in ipairs(location.editJobs) do
            if job == allowed then return true end
        end
        return false
    end,

    -- Admin actions: the clear command and the /pinboard dev command.
    admin = function(src)
        return IsPlayerAceAllowed(src, 'dd_pinboard.admin')
    end,
}

-- ---------------------------------------------------------------------------
-- Commands
-- ---------------------------------------------------------------------------
Config.Commands = {
    clear = 'pinboard_clear',   -- /pinboard_clear <key>          wipes every card on a board (admin)
    seed  = 'pinboard_seed',    -- /pinboard_seed <key> [preset]  fills a board from a showcase preset (admin)
    open  = 'pinboard',         -- /pinboard <key>                opens a board from anywhere (Config.Debug and ace dd_pinboard.admin)
}

-- ---------------------------------------------------------------------------
-- Limits (server-enforced)
-- ---------------------------------------------------------------------------
Config.maxCardsPerBoard  = 200
Config.maxEdgesPerBoard  = 400
Config.maxCardPayloadLen = 32 * 1024   -- bytes of JSON per card (rich text, drawing strokes)
Config.maxCardSize       = 10000       -- px per side; a note stops growing and a resize stops here
Config.maxImageUrlLen    = 1024

-- Image cards load their picture straight from the URL a player pastes. Leave the list empty
-- to allow any host, or restrict it to hosts you trust (subdomains of a listed host are allowed).
Config.allowedImageHosts = {
    -- 'i.imgur.com',
    -- 'cdn.discordapp.com',
    -- 'media.discordapp.net',
}

-- ---------------------------------------------------------------------------
-- Live collaboration
-- ---------------------------------------------------------------------------
-- Everyone at a board who passes Config.Permissions.edit edits it at the same time. There is
-- no board-wide lock: while a player is dragging, typing in or drawing on ONE card, that card
-- is claimed for them and shows as busy to the others; every other card stays free.
Config.autosaveDebounceMs = 2000   -- an editor sends its changes this long after its last edit

-- A claim on a card is dropped this long after the last edit to it, so a player who wanders
-- off mid-note never leaves a card blocked for the rest of the session.
Config.cardClaimTimeoutSeconds = 30

-- Draw the other players' mouse pointers on the board. Purely cosmetic: turning it off stops
-- the position updates entirely, it does not change who may edit what.
Config.showRemoteCursors = true
Config.cursorUpdateHz    = 12      -- pointer updates per second (only while others are at the board)

-- Hide who is at the board. With `true` the other players are shown as numbered visitors
-- ("Visitor 2") instead of by character name — in the presence bar, on the card they hold, on
-- their cursor and in the "X is working on that card" message. The real names never leave the
-- server. Use it where players are not supposed to learn each other's names from a notice board.
Config.anonymizeCollaborators = false

-- Colours that identify the players at a board: presence bar, busy cards, cursors. Handed out
-- in order as players open the board; they wrap around when more players than colours are there.
Config.playerColors = {
    '#e6b422', '#5aa9e6', '#7ac74f', '#e8724c',
    '#b07de8', '#4fd1c5', '#f06292', '#d6c7a1',
}

-- Colours offered for notes, pins and threads ('#rrggbb').
Config.cardColors = {
    '#d4a017', '#c0392b', '#2980b9', '#27ae60', '#8e44ad', '#e67e22',
    '#f9e49a', '#f4a0a0', '#a8ccf0', '#a8e4b8', '#cda8e8', '#f4c8a0',
}