CTQCore

⚠️ NOT PRODUCTION-READY — DO NOT USE ON A LIVE SERVER

CTQCore is an early scaffold and has not been tested on a real FiveM server. It builds on CTQBridge (also untested). Use only on a throwaway test server, at your own risk, until properly tested and this notice is removed.

The CARTIQO core resource — the main in-game piece that builds on CTQBridge. First feature: a connect queue that gates and orders joins by Discord role, using CTQBridge's whitelist decision. More configuration features will live here.

How it works

CTQCore does not talk to the dashboard directly — it consumes CTQBridge's exports. On connect it:

1. Asks exports.CTQBridge:CheckWhitelist(src) for an allow/deny + priority (role-weighted, configured from the CARTIQO dashboard / /whitelist command).
2. Denies players who aren't whitelisted (they must have Discord running in-game — there's no link step).
3. Places allowed players in a priority queue and admits them as slots free up, showing their position on the connection screen (adaptive card).

CTQBridge detects that CTQCore is running and steps back from gating connections itself, so there's exactly one connect gate.

Install

1. Install CTQBridge first (it must start before CTQCore).
2. Drop CTQCore into resources/ and add ensure CTQCore to server.cfg (after ensure CTQBridge).
3. Configure config.lua (Config.Queue.MaxSlots, branding, messages).

Config

See config.lua — queue size (0 = sv_maxclients), refresh interval, adaptive card on/off, slot reservation window, and the connection-screen branding/messages.

Diagnostics

In the server console: ctqcore queue prints who's waiting and whether CTQBridge is ready.

Exports

exports.CTQCore:GetQueue()   -- { { name, priority }, … }
exports.CTQCore:QueueSize()  -- number waiting