Lobby contract

TriggerServerEvent('engine:lobbyOpen')                                -- first contact + an immediate snapshot push
TriggerServerEvent('engine:requestLeave')                             -- leave to the lobby (an arena wait OR a live match)
TriggerServerEvent('engine:lobbyClose')                               -- menu closed (informational)

-- client -> server
TriggerServerEvent('engine:arena:create',   { modeId, name, access = 'public'|'private',
                                              password, spectators, rounds, map, loadout, stamina })
TriggerServerEvent('engine:arena:join',      { arenaId, password })
TriggerServerEvent('engine:arena:leave')                     -- drop MY slot (the arena persists)
TriggerServerEvent('engine:arena:spectate',  { arenaId })    -- watch a live arena's match
TriggerServerEvent('engine:arena:delete',    { arenaId })    -- manager only (creator's license, or admin)

RegisterNetEvent('ui:lobby', function(data)
    -- data is the snapshot below
end)

{
  modes = {
    {
      -- always present
      id = 'duel', label = '1v1 Duel', perTeam = 1, teamCount = 2,
      -- NUI card fields, from the mode's `menu` + shared `present` blocks (safe defaults)
      name = '1v1 Duel', short = '1V1', sub = 'Solo · Best of',
      rgb = '34 211 230', tagline = 'One arena. One opponent. Settle it.',
      desc = '...', flow = '1v1', category = 'Duels', flag = nil,
      present = { ... },              -- the full RfxPresent block (for the hero band)
      pop = { open = 1, live = 2, playing = 4 },   -- live per-mode activity for the cover badges
      status = 'available', access = 'player',
      -- the Create-arena form options — present for EVERY mode (all are arena-creatable)
      create = { maps = {{key='lot', label='Parking Lot'}, …},
                 loadouts = {{key='pistols', label='Pistols'}, …},
                 rounds  = { min = 1, max = 9, step = 2, default = 5 },
                 stamina = { min = 0, max = 100, step = 10, default = 100 } },
      canCreate = true,               -- may THIS player create an arena of this mode
      createReq = 'staff',            -- the tier required to create (for the gated hint)
    },
    -- ... sorted by flow then id
  },
  arenas = {          -- EVERY match Arena (all modes). The built-in NUI partitions this client-side:
                      -- CASUAL fills the browser; RANKED (ranked=true) surface on the mode cover.
    {
      id = 7, modeId = 'duel', mode = '1v1 Duel', name = "Ryu's arena",
      players = 1, max = 2,
      state = 'waiting',        -- 'waiting' | 'gathering' | 'in-game' | 'concluded'
      ranked = false, private = false,
      loadout = 'pistols',      -- weapon-config KEY (label via modes[].create.loadouts); nil = mode default
      rounds  = 5,              -- best-of for this arena (nil if the mode has no rounds)
      joinable    = true,       -- open + not full (a browser [Join])
      spectatable = false,      -- a public in-game arena that allows watchers ([Spectate])
      manage      = false,      -- may THIS viewer delete it (manager/admin) -> [Delete]
    },
    -- ... sorted by id
  },
  scenes = {
    {
      id = 1, modeId = 'duel', mode = '1v1 Duel', map = 'Warehouse',
      state = 'live', round = 3,
      teams = {                                  -- one slot per team, by index
        { team = 1, count = 1, max = 1, wins = 2 },
        { team = 2, count = 1, max = 1, wins = 1 },
      },
    },
    -- ... sorted by id
  },
  population = 12,    -- total connected players (lobby + in-match); the top-right badge
  myArena  = false,   -- the subscriber's current arena id, or false (always present)
  myScene  = 1,       -- the subscriber's current scene id, or nil
  myTeam   = 1,       -- the subscriber's team index, or nil
  status   = 'idle',  -- lobby activity: 'idle' (browsing) | 'joining' (waiting in an arena)
  maxScene = 8,       -- global concurrent-scene cap (engine config)
  ping     = 28,      -- the subscriber's ping in ms (for the menu's connection pill)
  profile  = {        -- the subscriber's profile (ACE tier live; stats from the stats store)
    name = 'VOID_Ryu', initials = 'VR', tier = 'staff', rank = 'STAFF',
    stats  = { duel = { kills, deaths, wins, losses, draws } },   -- CAREER (omitted when rfx_career_stats=false)
    season = { duel = { ... } }, seasonId = 'alpha',              -- current season layer
    canPrivate = true, privateReq = 'all',   -- may create a PRIVATE arena + the required tier
  },
  lobby = { count = 3, players = { { name = 'VOID_Ryu', initials = 'VR' }, … } },
  -- the always-on status widget: the ONE pre-match context, or false when idle
  lobbyHud = { kind = 'arena', name = "Ryu's arena", mode = '1v1 Duel',
               size = 1, max = 2, free = 1, members = { … } },
  -- the single authoritative pre-match commitment (drives the rail badges), or false.
  -- ARENA WINS over group: in an arena (even as a party) -> kind='arena' with the fields.
  commitment = { kind = 'arena', modeId = 'duel', arenaId = 7, label = "Ryu's arena" },
}

local snap
RegisterNetEvent('ui:lobby', function(d) snap = d end)
 
AddEventHandler('onClientResourceStart', function(res)
    if GetCurrentResourceName() ~= res then return end
    TriggerServerEvent('engine:lobbyOpen')
end)
 
-- create an arena of any mode (create == join: you drop straight in):
TriggerServerEvent('engine:arena:create', { modeId = 'mymode', name = 'My arena' })
 
-- or join a listed arena (pass `password` to clear a private gate):
TriggerServerEvent('engine:arena:join', { arenaId = snap.arenas[1].id, password = '' })
 
-- to leave (your pre-match arena slot, or a live scene):
TriggerServerEvent('engine:requestLeave')