Administration en jeu

#Groupes et permissions

Les droits d'administration en jeu reposent sur des groupes (modérateur, administrateur…) qui portent des permissions. Un joueur appartient à un seul groupe ; il peut en plus recevoir des permissions individuelles.

• Le groupe par défaut de tous les joueurs est user : il est créé automatiquement, ne peut pas être supprimé et ne reçoit aucune permission.
• Chaque groupe a un libellé, une couleur, un badge et un rang (hiérarchie). Un staff ne peut agir que sur un joueur de rang inférieur au sien.
• La permission admin.* donne tous les droits, à deux exceptions près qui se donnent explicitement : admin.dutyBypass et admin.bypassPed. Un groupe qui possède admin.* est un groupe « racine » : seule la console du serveur ou un autre membre racine peut le gérer ou l'attribuer, et personne ne peut agir contre lui.

#Se donner les pleins droits (première fois)

Aucun groupe d'administration n'existe à l'installation. Pour le premier propriétaire :

1. Connecte-toi au serveur, puis repère ton identifiant de joueur (affiché en jeu ou dans la liste des joueurs).
2. Dans la console du serveur, crée ton groupe d'administration et attribue-le : setgroup <ton id> <groupe>.
3. Une fois les pleins droits obtenus, crée les autres groupes en jeu dans F10 › Gestion du serveur › Groupes, puis attribue-les avec /setgroup ou depuis la fiche d'un joueur.

#Prendre son service

Les outils staff ne fonctionnent que en service :

• F10 hors service n'affiche qu'un avertissement et la case Prendre mon service : « Tout abus sera sanctionné », « Chaque action staff est enregistrée ».
• En service, tout le menu apparaît et un HUD staff affiche les reports en attente et le nombre de staff en service.
• Ouvrir F10 demande la permission admin.duty.
• La permission admin.dutyBypass (« Outils staff sans prise de service ») dispense de prendre son service. Elle doit être donnée explicitement : admin.* seul ne dispense pas. À donner avec prudence : les actions de ce staff ne s'affichent plus « en service » pour les autres.

#Le ped staff

À la prise de service, le staff prend l'apparence du ped staff ; son personnage lui est rendu à la fin du service (vie et armure conservées). Réglages dans Panel › Ped staff :

Garder son personnage en service. La permission admin.bypassPed donne le choix de ne pas être transformé :

1. Donne admin.bypassPed au groupe ou au joueur, explicitement : admin.* ne l'inclut pas.
2. Le staff voit alors dans F10 › Gestion personnelle › Préférences la case Garder mon personnage en service, cochée par défaut. S'il la décoche, il reprend le ped staff.

La case n'apparaît pas si le ped staff est désactivé (staffped.enabled).

#Le menu F10

#Gestion du serveur

Le détail des commerces, entreprises, petits jobs et garages d'entreprise est dans Économie, métiers et commerces.

#Préférences du staff

F10 › Gestion personnelle › Préférences règle les outils de chaque staff. Ces choix sont gardés sur son PC d'une session à l'autre (la prise de service, elle, ne l'est pas).

#HUD staff

Le HUD staff (reports en attente, staff en service) n'apparaît qu'en service. Chaque staff peut le masquer (« Afficher le HUD staff ») ou changer sa disposition.

#Gamertags

Les gamertags affichent le nom des joueurs au-dessus de leur tête (permission admin.gamertags). Deux rendus : Interface (étiquette du Socle) ou Natif (étiquettes de GTA). Réglages dans Panel › Gamertags :

#Noclip

F3 active le noclip (permission admin.noclip). Deux modes : Entity (le personnage se déplace) et Caméra (caméra libre). Une barre d'aide en bas à droite rappelle les touches.

Le mode est mémorisé : changer de mode avec H pendant le noclip le garde comme préférence, pour les noclips suivants et les prochaines connexions, comme le choix fait dans les Préférences. Le mode de départ d'un nouveau staff est Panel › Noclip › Mode par défaut (noclip.defaultMode).

#Sanctions et codes de ban

#Bannir

/ban <id> <durée en heures> <raison> (0 heure = définitif), ou depuis la fiche du joueur dans F10. Permission admin.ban.

Chaque bannissement reçoit un code lisible de la forme BAN-12. Le staff le voit dans la confirmation (« Joueur banni (code BAN-12) »). Le joueur banni le voit sur l'écran de refus, à chaque tentative de connexion :

Vous êtes banni.
Raison : <raison>
Expiration : <date ou Permanent>
Émis par : <auteur>
Code du ban : BAN-12 (à donner au staff pour toute contestation)

Le ban vise la licence Rockstar, le compte Discord et l'adresse IP du joueur.

#Retrouver et lever un ban

Quand un joueur conteste son ban avec son code :

• En jeu : F10 › Gestion du serveur › Bannissements › Rechercher un bannissement, tape BAN-12 : seul ce ban s'affiche. La recherche accepte aussi un identifiant, une raison ou un auteur.
• Dans le panel : Communauté › Joueurs, tape BAN-12 dans la recherche (« Nom, identifiant, licence, ID ou code BAN-… ») : le titulaire du ban s'affiche. Sa fiche liste ses bans avec leur code.
• Lever le ban : /unban BAN-12 (permission admin.ban), ou depuis la liste des bannissements en jeu. La commande accepte aussi ban-12, ban12, #12 ou 12.

#Logs

Les évènements importants sont enregistrés en base et consultables dans Serveur › Logs du panel : connexions, actions staff, argent, inventaire, braquages, drogue, morts, immobilier, véhicules, métiers, groupes, chat, sanctions (dont celles de txAdmin), explosions, vie du serveur.

#La page Logs

• Compteurs sur 24 heures : évènements enregistrés, Attention, Critiques, joueurs concernés. Un clic filtre la liste.
• Pastilles de catégorie avec leur nombre, puis filtres : catégorie, niveau (« Attention et plus », « Critiques »), texte (joueur, identifiant, texte) et période (du… au…).
• Chaque ligne montre le joueur et, s'il y en a une, la cible, avec leur identifiant, la position et un bloc Détails. Un clic sur un joueur affiche tout son historique.
• La première page se rafraîchit toute seule toutes les 10 secondes (interrupteur « en direct »).
• Exporter en CSV télécharge les logs filtrés (20 000 lignes au maximum).

#Les niveaux

#Réglages : Panel › Logs

#Alertes Discord

Chaque ligne de Webhooks Discord associe une catégorie (connection, admin, money, heist, drugs, death, inventory, job, chat, sanction, server, explosion, ou * pour toutes), l'adresse du webhook et le niveau minimal envoyé. Exemple : un salon « alertes » qui ne reçoit que le critique de toutes les catégories :

Pour faire sonner le staff sur une alerte critique, mets la mention de son rôle dans Mention sur alerte critique, par exemple <@&ID_DU_ROLE>.

#Maintenance planifiée

Serveur › Maintenance lance des opérations globales sur la base de données. Elles ne s'exécutent pas au clic : le serveur de jeu les exécute au prochain redémarrage complet, après avoir sauvegardé les tables concernées.

#Planifier

1. Seul le propriétaire du panel planifie ; les administrateurs consultent.
2. Règle les paramètres de l'action, puis tape CONFIRMER dans le champ prévu : le bouton Planifier s'active.
3. L'action passe dans En attente. Tu peux l'annuler tant que le serveur n'a pas redémarré. Une même action ne peut pas être en attente deux fois.
4. Redémarre le serveur depuis Serveur › État & redémarrage : le redémarrage n'est pas lancé automatiquement.

#Ce qui se passe au redémarrage

1. Sauvegarde complète de chaque table touchée dans une copie bak_<table>_<AAAAMMJJ_HHMMSS>, vérifiée par comptage des lignes. Si la sauvegarde échoue, l'action passe en Échec et rien n'est modifié.
2. Exécution de l'action.
3. Résultat noté dans l'Historique : statut (Exécutée, Échec, Annulée), date, nombre de lignes modifiées, nom de la sauvegarde.

Seules les 5 dernières sauvegardes bak_ de chaque table sont gardées (convar maintenance_backup_keep du serveur de jeu) : les plus anciennes sont supprimées.

#Points d'emote

Le staff peut poser des points d'emote : à cet endroit, les joueurs voient la touche E qui les place exactement au point et joue l'animation choisie (s'asseoir sur un muret, s'accouder à un bar…).

• Ouvrir la gestion : F10 › Options supplémentaires › Points d'emote, ou /emotepoint. Permission admin.emotepoints et service staff requis.
• Poser un point ici : libellé affiché aux joueurs, emote du Socle (identifiant) ou scénario GTA, rayon d'interaction. Mode suppression pour en retirer.
• Réglages dans Panel › Mobilier & points d'emote : points du staff (emotepoints.pointsEnabled), rayon par défaut (emotepoints.pointRadius, 1,5 m) et maximal (emotepoints.pointRadiusMax, 5 m), nombre maximal de points (emotepoints.pointsMax, 300), commande (emotepoints.staffCommand, prise en compte au redémarrage). La liste Points posés du panel est en lecture seule : on modifie et on supprime en jeu.

La même catégorie règle le mobilier (S'asseoir / S'allonger sur les chaises, bancs et lits, par le ciblage) et les points personnels des joueurs (/emoteperso, désactivés par défaut : emotepoints.personalEnabled).

#Liste complète des permissions

Les libellés sont ceux affichés dans les menus de groupes et de permissions en jeu.

Seul un membre racine peut accorder admin.* et admin.variables.private (affichées en rouge dans les menus).

#Journal du staff

Les actions staff sont enregistrées dans les Logs du panel (catégorie Staff) et peuvent être envoyées sur un salon Discord dédié. Un même staff ne génère pas plus d'une entrée « Action staff » par intervalle (logs.adminThrottle, 500 ms).