Eerste setup

Checklist om Z-staff en Z-staff de eerste keer werkend te krijgen.

Volg deze volgorde. Als één stap ontbreekt, lijkt het alsof “niks werkt”. Framework: Framework.

Stap 1 — Zet jezelf in de overrides

Zonder Discord-bot kun je alsnog binnenkomen via license of Discord-ID.

In Z-staff/config.lua:

Config.LicenseOverrides = {
    ['discord:JOUW_DISCORD_ID'] = 'owner',
    -- of:
    -- ['license:JOUW_ROCKSTAR_LICENSE'] = 'owner',
}

In Z-staff/config.lua dezelfde ID (zonder rank mag, dan telt het als “mag in dienst”):

Config.allowedIdentifiers = {
    'discord:JOUW_DISCORD_ID',
}

Je Discord-ID: Discord → Instellingen → Geavanceerd → Developer Mode aan → rechtermuisklik op jezelf → ID kopiëren. Prefix discord: is optioneel; alleen het nummer werkt ook.

Stap 2 — Extra framework-toegang (optioneel)

ESX

Als jouw character superadmin of admin is, mag je ook in dienst.

-- Z-staff
Config.EsxGroupMap = {
    superadmin = 'owner',
    admin = 'admin',
    moderator = 'mod',
    mod = 'mod',
}

-- Z-staff
Config.esxGroups = {
    superadmin = true,
    admin = true,
}

Qbox / QBCore

Permissions en groups uit qbx_core / qb-core (god / admin / mod) mappen naar ranks.

-- Z-staff
Config.QbGroupMap = {
    god = 'owner',
    admin = 'admin',
    mod = 'mod',
    moderator = 'mod',
}

-- Z-staff
Config.qbGroups = {
    god = true,
    admin = true,
    mod = true,
}

Dit is naast Discord/license, niet de vervanger van een Discord-rol.

Stap 3 — Discord-bot (aanbevolen voor het team)

Discord Developer Portal → New Application → Bot.
Zet Server Members Intent aan.
Invite de bot in je guild (permission: View Server Members / Server Members Intent).
Plak token + guild ID in Config.Discord.
Rechtermuisklik op elke staff-rol → ID kopiëren:

Config.Discord.roles = {
    ['OWNER_ROLE_ID'] = 'owner',
    ['MGMT_ROLE_ID'] = 'management',
    ['HEAD_ROLE_ID'] = 'headadmin',
    ['SENIOR_ROLE_ID'] = 'senior',
    ['ADMIN_ROLE_ID'] = 'admin',
    ['MOD_ROLE_ID'] = 'mod',
    ['TRIAL_ROLE_ID'] = 'trialmod',
}

Uitgebreid: Discord.

Stap 4 — Webhooks (optioneel)

Config.Webhooks = {
    actions = 'https://discord.com/api/webhooks/...', -- alle staff-acties
    bans    = 'https://discord.com/api/webhooks/...', -- warn + ban
    reports = 'https://discord.com/api/webhooks/...', -- nieuwe reports
    staff   = 'https://discord.com/api/webhooks/...', -- in dienst
}

Lege strings = geen webhook. Het systeem blijft werken.

Stap 5 — Staffkleding

Pas in Z-staff Config.outfits.male en .female aan naar jullie kledingpack. Default-waarden zijn GTA-stock drawables, geen custom pack.

Zie Staffkleding.

Stap 6 — Testen

Test	Verwacht
Speler zonder rank typt `/staffdienst`	“Je hebt geen toegang tot staffdienst.”
Jij typt `/staffdienst`	Progressbar + outfit + “Je bent nu in dienst…”
F10 zonder dienst	“Ga eerst in dienst met /staffdienst.”
F10 in dienst	Panel opent, jouw rank-chip
`/staffdienst` opnieuw	Outfit terug, panel sluit, tools uit
Speler `/report testhoi`	Jij krijgt notify + ping als je `reports_view` hebt

Stap 7 — Perms vernieuwen

Na een Discord-rolwijziging:

Wacht tot 3 minuten (automatische refresh), of
Open het panel → Staff → Discord perms vernieuwen

Als F10 opent en je rank-chip “Owner” toont, is de setup klaar. De rest is fine-tuning: locaties, voertuigen, ban-durations.