Pausemenu

Menu pause : au lieu du menu GTA, ESC ouvre un menu plein écran personnalisé avec les infos du joueur, une carte 3D de toute la ville et Guide & règles, que l'équipe peut modifier en jeu.

Prérequis

ESX Legacy (es_extended)
oxmysql

Fonctionnalités

Menu principal avec Reprendre, Carte, Guide & règles, Paramètres, Discord et Quitter le serveur. En plus : fiche joueur (nom, métier, grade, liquide, banque), heure et nombre de joueurs. Pendant ce temps, la caméra tourne lentement autour du joueur.
Carte 3D (mapMode = 'script') : la caméra survole la ville. La ville reste dégagée – c'est seulement quand tu choisis une catégorie à gauche que ses lieux apparaissent et que la caméra vole vers le plus proche. Un clic place un point de passage. Les autres joueurs et leurs véhicules sont invisibles uniquement pour toi et seulement tant que la carte est ouverte (pas de changement de dimension) – la carte ne sert donc pas à espionner. Par défaut (mapMode = 'gta'), Carte ouvre la carte GTA normale.
Guide & règles : onglets avec titres, listes et citations. Les groupes autorisés les modifient directement en jeu, tout le monde voit les changements aussitôt.
Paramètres ouvre les paramètres GTA pour les graphismes, l'audio et les touches. P ouvre toujours le menu GTA (désactivable).

Installation

Place le dossier off_pausemenu dans ton dossier resources.
Dans le server.cfg – après oxmysql et ESX :

cfg

ensure oxmysql
ensure es_extended
ensure off_pausemenu

La table off_pausemenu_guide est créée automatiquement et remplie avec des règles d'exemple au premier démarrage.

Configuration

`config/settings/config.lua`

Option	Par défaut	Description
`serverInfo.name`	`'OFF Scripts'`	Nom du serveur, affiché en haut du menu et dans l'interface à la place de « OFF SCRIPTS »
`serverInfo.locale`	`'de'`	Langue : `de`, `en`, `pl`, `fr`, `es` ou `it`
`serverInfo.color`	`{ 155, 89, 255 }`	Couleur de l'UI (RGB)
`serverInfo.design`	`3`	Design de l'interface : `1` = Classique, `2` = Ticket, `3` = Storefront
`blur`	`true`	Fond flou tant que le menu est ouvert. Dans la carte, il redevient net automatiquement
`discord`	Lien	Invitation Discord (`''` = bouton masqué)
`gtaMenuOnP`	`true`	`true` = P ouvre le menu GTA, `false` = P ouvre aussi ce menu
`orbitCamera`	`true`	La caméra tourne autour du joueur dans le menu
`mapMode`	`'gta'`	`'script'` = carte 3D du script, `'gta'` = carte GTA normale
`guide.groups`	`{ 'projektleitung' }`	Groupes ESX autorisés à modifier Guide & règles
`guide.maxTabs` / `maxLength`	`10` / `8000`	Nombre max. d'onglets et de caractères par onglet
`map.minHeight`	`150.0`	Hauteur minimale de la caméra au-dessus du sol (mètres), impossible de zoomer jusqu'aux markers ou aux joueurs
`map.categories`	16 catégories	Catégories de la carte : `label`, `sprites` (IDs de blips GTA) et `color`

Une catégorie affiche tous les blips avec ces sprites – y compris ceux d'autres scripts. Pour ajouter tes propres blips : indique l'ID du sprite dans une catégorie.

`config/settings/config.server.lua`

Option	Utilité
`Webhooks.guide`	Log Discord lors d'un enregistrement/d'une suppression dans le guide
`Webhooks.leave`	Log Discord quand quelqu'un quitte via le menu

`config/functions.lua`

Fonction	Utilité
`ServerPlayerLeft(source)`	Action personnalisée avant qu'un joueur soit déconnecté via le menu
`ClientCanOpen()`	`false` = ESC n'ouvre pas le menu pour le moment (p. ex. ton propre menu est ouvert), encore 0,5 s après
`ClientMenuOpened()` / `ClientMenuClosed()`	Masquer puis réafficher ton propre HUD

Langues

Tous les textes se trouvent dans config/locales/<langue>.json. Pour ta propre langue, copie un fichier, traduis-le et définis locale – garde les placeholders comme %s et {n}.

En jeu

ESC ouvre le menu, ESC le referme. Dans la carte et le guide, ESC revient au menu principal. Si tu fermes un autre menu avec ESC (p. ex. inventaire ou garage), le menu pause reste fermé. Contrôle à la souris ou avec ↑ ↓ et Entrée.
Carte (mapMode = 'script') : glisser avec le clic gauche ou WASD = se déplacer (Shift = plus vite), glisser avec le clic droit = tourner, molette = zoom, clic gauche = point de passage, Espace = retour à ta position. Clique sur une catégorie à gauche : ses lieux apparaissent, la caméra vole vers le plus proche. Cliquer encore = lieu suivant, × = effacer la sélection. Les catégories sans lieux ne sont pas affichées.
Guide & règles : les groupes autorisés voient Modifier, Ajouter un onglet et Supprimer l'onglet. Avec Enregistrer pour tous, tout le monde voit le changement.

Problèmes fréquents

Problème	Solution
`[ERROR]` ou `[WARNING]` dans la console	Le script vérifie l'installation au démarrage. Lis le message, corrige, redémarre le script.
ESC ouvre toujours le menu GTA	Un autre script ouvre lui-même le menu pause – retire ce script.
ESC ouvre le menu dans mon menu	Ajoute une vérification dans `ClientCanOpen()`.
La carte ouvre la carte GTA	`mapMode` est sur `'gta'`. Pour la carte 3D, indique `'script'`.
La carte n'affiche aucun lieu	Les sprites dans `map.categories` ne correspondent pas aux blips de ton serveur.
Le bouton Discord manque	`discord` est vide.

Pas encore acheté ?

Voir Pausemenu dans la boutique