Panneau d'administration

HZ-Bridge embarque un panneau d'administration centralise dans lequel chaque module HZ-Script se branche. Au lieu que chaque script fournisse sa propre commande + interface pour la config, tout est regroupe derriere un seul /hzpanel accessible aux admins. Le panneau construit automatiquement un editeur type pour chaque champ de config declare dans le bridge_schema.lua de chaque module.

Ouvrir le panneau

En jeu (chat, console F8 ou raccourci clavier) :

/hzpanel

• Console seulement (F8 serveur) — /hzpanel depuis la console serveur n'ouvre pas le NUI. Tapez-le depuis le jeu.
• Necessite la permission ACE configuree sous HZBridge.Panel.AcePermission (defaut admin) — voir Configuration des permissions ci-dessous.
• Appuyez sur Escape ou cliquez sur le bouton fermer pour quitter. Les sessions sont protegees par token et expirent apres HZBridge.Panel.SessionTokenTtlMs (5 min par defaut) — rouvrez pour rafraichir.

-- server export — ouvre le panneau pour src et preselectionne le module nomme
exports['HZ-Bridge']:OpenPanel(src, 'HZ-Weather')

Configuration des permissions

Le panneau est protege par le noeud ACE canonique admin de FXServer. Deux lignes dans server.cfg sont requises :

add_principal identifier.license:YOUR_LICENSE group.admin
add_ace group.admin admin allow

Remplacez YOUR_LICENSE par la licence du joueur de votre serveur (visible en tapant /hzpanel une fois — la sortie console de l'echec affiche tous vos identifiants + un bloc pret a copier-coller avec votre licence deja interpolee).

Vous pouvez coller les deux lignes directement dans la console serveur pour corriger immediatement — aucun redemarrage requis. Si vous les mettez dans server.cfg, redemarrez FXServer (ou relancez exec server.cfg) pour les charger.

Le probe framework se rabat sur les tables admin de qb-core / qbx_core / ESX / ox_core si la verification ACE echoue. Donc un joueur marque comme admin dans votre table qbcore_admins peut ouvrir le panneau meme sans la configuration ACE. Mais ACE est la methode recommandee car elle est agnostique au framework et auditable en un seul endroit.

Si la verification echoue, la console serveur affiche :

• Le noeud ACE exact verifie
• Tous vos identifiants joueur
• Une matrice de probe ACE (quels noeuds sont accordes, lesquels ne le sont pas)
• Les deux lignes exactes add_principal + add_ace a copier-coller, avec votre licence deja interpolee

Noeud ACE personnalise

Si vous ne voulez pas utiliser le noeud canonique admin (par ex. vous voulez qu'un sous-ensemble specifique du staff ouvre le panneau sans leur donner toutes les autres commandes admin), configurez un noeud personnalise dans config.lua :

HZBridge.Panel.AcePermission = 'hzbridge.panel.admin'

Puis dans server.cfg :

add_principal identifier.license:YOUR_LICENSE group.hzbridge.staff
add_ace group.hzbridge.staff hzbridge.panel.admin allow

Le fallback (quand AcePermission est nil ou '') est 'admin' — aligne sur le defaut de config depuis v1.1.1. Les versions anterieures utilisaient 'HZ-Bridge.admin' comme fallback, ce qui etait un ecart documente et bloquait les clients qui n'avaient que l'ACE canonique admin accorde. Mettez a jour vers v1.1.1 si vous etes concerne.

Ce que vous pouvez modifier

Le panneau decouvre automatiquement chaque ressource qui embarque un fichier bridge_schema.lua a sa racine. A partir de HZ-Bridge v1.1.0, les modules suivants fournissent un schema et s'integrent au panneau :

Le DSL de schema

Le bridge_schema.lua de chaque module est un petit DSL Lua qui declare la config que le panneau expose. Le DSL s'execute dans un environnement sandbox (pas de _G, pas de io brut, sous-ensembles restreints de string / table / math) donc un schema buggue ou malveillant ne peut pas casser le serveur.

Exemple minimal

-- resources/your-script/bridge_schema.lua
module('your-script', {
    schemaVersion = 1,
    label = { en = 'Your Script', fr = 'Ton script' },
}, function()
    section('general', {
        label = { en = 'General', fr = 'Général' },
    }, function()
        field('Enabled', 'boolean', {
            default = true,
            label = { en = 'Enabled', fr = 'Activé' },
            description = {
                en = 'Master on/off switch for the script.',
                fr = 'Interrupteur global du script.',
            },
        })

field('PlayerLimit', 'number', {
            default = 32, min = 1, max = 256, step = 1,
            label = { en = 'Max concurrent players', fr = 'Joueurs simultanés max' },
        })
    end)
end)

C'est tout — ouvrez /hzpanel, l'onglet "Your Script" apparait avec deux champs types, les changements de valeur sont ecrits sur disque et diffuses a chaque client abonne.

Types de champ

-- bridge_schema.lua
field('ZonesEditor', 'view', {
    component = 'HZ-Weather:ZoneEditor',
    events = {
        upsertZone = 'hz_weather:admin:upsertZone',
        deleteZone = 'hz_weather:admin:deleteZone',
    },
})

// web/src/views/HZ-Weather/index.tsx
import { registerView } from '../registry'
import { ZoneEditor } from './ZoneEditor'
registerView('HZ-Weather:ZoneEditor', ZoneEditor)

-- server (any resource)
AddEventHandler('HZ-Bridge:theme:updated', function(theme)
    -- theme: { preset, accent, accentHi, gold, surface, subpanel, tint,
    --         gradientMode, radiusNone, radiusXs, radiusSm, ..., radiusXl }
end)

-- client
RegisterNetEvent('HZ-Bridge:theme:updated', function(theme)
    SendNUIMessage({ action = 'theme', data = theme })
end)

local theme = exports['HZ-Bridge']:GetTheme()