Wiki

Comment configurer ses permissions Discord ?

Dernière mise à jour, 1 juillet 2026 · Par Surge Studio

Ce guide décrit l'intégralité du système de permissions staff par rôles Discord de la Base Surge. La ressource surge_discord_perms relie votre serveur Discord à FiveM : menu F10, panneau /gestion, commandes chat, boutique s-menu et scripts externes. Aucun bot Node.js n'est requis.

Vue d'ensemble du système

1. Créez un bot Discord et configurez server.cfg (token + guild ID).
2. FiveM synchronise les rôles Discord via l'API REST.
3. Dans /gestion, vous mappez chaque rôle aux permissions Surge.
4. À la connexion, les rôles du membre sont lus et fusionnés en permissions effectives.
5. Les ACE command.* sont accordés dynamiquement au joueur.

Prérequis

• Serveur Discord communauté + droits admin Discord.
• Discord Developer Portal.
• MySQL via oxmysql, grade ESX fondateur pour la première config.
• Staff : compte Discord lié à FiveM (lancement via Discord ou CFX).

Étape 1 : Créer l'application et le bot Discord

1. Developer Portal > New Application.
2. Menu Bot > copiez le token (secret).
3. Activez Server Members Intent (Privileged Gateway Intents).

Étape 2 : Inviter le bot

1. OAuth2 > URL Generator : scope bot.
2. Permission minimale : View Channels.
3. Invitez le bot sur votre serveur Discord.

Étape 3 : Récupérer le Guild ID

1. Mode développeur Discord activé.
2. Clic droit sur le serveur > Copier l'identifiant du serveur.
3. C'est la valeur de surge_discord_guild_id.

Étape 4 : Configurer le server.cfg

ensure surge_discord_perms

add_ace resource.surge_discord_perms command.add_ace allow
add_ace resource.surge_discord_perms command.remove_ace allow

set surge_discord_bot_token "VOTRE_TOKEN_BOT"
set surge_discord_guild_id "ID_DU_SERVEUR_DISCORD"

set surge_discord_role_sync_ms "600000"
set surge_discord_resync_ms "60000"
set surge_discord_member_delay_ms "400"
set surge_discord_require_id "true"
set surge_discord_log_member_errors "false"
set surge_discord_sync_secret "change-me"

Étape 5 : Base de données MySQL

Tables auto-créées au boot. SQL manuel : surge_discord_perms/sql/discord_perms.sql.

Étape 6 : Démarrer et vérifier la connexion API

1. Redémarrez FXServer.
2. Console : Sync Discord via API (FiveM uniquement) et X rôles Discord synchronisés.
3. discordperm_status puis discordperm_test_api (console).

• 401 : token invalide.
• 403 : bot absent ou Members Intent off.
• 404 membre : joueur pas sur le Discord du guild_id.

Étape 7 : Créer les rôles sur Discord

Créez vos rôles staff dans Discord. La position hiérarchique influence le libellé F10 et la couleur gamertag si plusieurs rôles sont cumulés.

Étape 8 : Configurer le mapping dans /gestion

Chemin : /gestion > Serveur > Rôles Discord · Permission : serveur.discord_roles.

1. Sélectionnez un rôle Discord (colonne gauche).
2. Appliquez un préréglage staff, affinez les toggles.
3. Couleur gamertag + tenue staff si besoin.
4. Enregistrer : push immédiat aux joueurs en ligne avec ce rôle.
5. Test : /discordperm_sync_me, /staffservice, F10.

Interface du panneau Rôles Discord

Préréglages staff (détail complet)

Permissions globales (raccourcis)

F10 : Menu

F10 : Modules

F10 : ManagePlayers

F10 : VehiclesOptions

F10 : OutFit

F10 : COMMANDS

F10 : VIP

F10 : ServerOptions

F10 : UniqueIDoptions

Catalogue Admin Menu /gestion (nui.*)

Format nui.{section}.{action}. Un hub nui.hub.*.view débloque les pages enfants du hub.

Hub

Legal

Illegal

Monde

Serveur

Commandes chat (cmd.*)

Permissions extra (hors cmd)

Scripts externes (ext.*)

Boutique s-menu (boutique.*)

Couleur gamertag et tenue staff

Index gamertagColor (HUD_COLOUR). Rôle au position Discord le plus élevé l'emporte. Tenue staff : composants ESX Male/Female, appliquée à la prise de service (pas de repli grade ESX).

Règles de calcul des permissions effectives

• Union de tous les rôles Discord du membre.
• Discord prioritaire sur ESX si la ressource tourne.
• f10.staff.full étend F10, NUI, bridge et cmd liées.
• surge_discord_require_id true : sans discord: = aucune perm Discord.

Prise de service staff (/staffservice)

Staff Discord (grade user) : /staffservice avant F10 et commandes. Diagnostic : /discordperm_test_cmd.

Synchronisation automatique

Commandes de diagnostic et console

Dépannage (problèmes fréquents)

Sécurité et bonnes pratiques

• Ne jamais exposer le token bot publiquement.
• Limiter serveur.discord_roles.edit aux fondateurs.
• Principe du moindre privilège : rôles séparés Modo / Gestion Légal / Illégal.
• Dossier bot/ Node.js : optionnel, obsolète.

Ordre de configuration recommandé (récapitulatif)

1. Grade fondateur ESX.
2. Bot + Members Intent + invitation.
3. server.cfg (ensure, token, guild, add_ace).
4. Validation API console.
5. Rôles Discord + mapping /gestion.
6. Tests sync, debug, staffservice, F10.

Comment créer proprement son HUD ?

Dernière mise à jour, 1 juillet 2026 · Par Surge Studio

Ce guide décrit l'intégralité de la personnalisation du HUD joueur de la Base Surge. La ressource surge_hud regroupe jauges (vie, armure, faim, soif), minimap, compteur de vitesse, notifications, safezones, chat et widgets personnalisés. La configuration se fait principalement via /gestion > Serveur > Modules > HUD, persistée dans ServerConfig.hud_layout et propagée à tous les joueurs via GlobalState.

Vue d'ensemble de l'architecture

1. Vous configurez le HUD dans /gestion (couleurs, formes, positions, widgets).
2. surge_core sauvegarde hud_layout en KVP + MySQL (s_core_server_config).
3. GlobalState.ServerConfig.hud_layout est mis à jour (tous les clients).
4. surge_hud lit ce state et pousse la config au NUI (html/index.html).
5. Les joueurs voient le HUD mis à jour sans redémarrage (sauf changements identité surge_*).

Prérequis

• Ressource surge_hud démarrée (ensure surge_hud dans server.cfg).
• surge_core et oxmysql opérationnels (persistance config).
• Grade fondateur ou permission serveur.modules.edit / accès hub Serveur.
• Identité serveur renseignée : surge_logo_url, surge_color_r/g/b/a (section Général).
• Pour tester : personnage en jeu, faim/soif actives (esx_status), véhicule pour le speedometer.

Étape 1 : Accéder au panneau HUD

Chemin : /gestion > Serveur > Modules > HUD.

1. Ouvrez /gestion (grade fondateur ou staff avec hub Serveur).
2. Hub Serveur > tuile Modules.
3. Sélectionnez la section HUD dans le menu latéral des modules.

Barre d'outils en haut du panneau :

Étape 2 : Calibrer les couleurs serveur (Général)

Avant le HUD, configurez /gestion > Serveur > Général : logo 512×512, surge_color_r/g/b/a, nom serveur. Ces convars alimentent le mode server des couleurs (notifications, speedo, ID unique si server_info_id_color vide).

Étape 3 : Vie, armure, faim et soif

Section HUD - Vie, armure, faim, soif du panneau.

Les jauges lisent esx_status (faim, soif) et la vie/armure du ped. L'oxygène apparaît à la nage (réglages fines dans modules/minimap/config.lua : maxTime, rechargeSeconds).

Étape 4 : Compteur de munitions

Section HUD - Munitions.

• Couleurs radiant : ammo_color_a, ammo_color_b (texte, icône, barre).
• Déplacer : ouvre l'éditeur in-game sur le calque ammo.
• Position persistée : ammo_offset_left_vw, ammo_offset_bottom_vh.

Étape 5 : Compteur de vitesse (speedometer)

Section HUD - Compteur de vitesse.

Sans surcharge serveur, le HUD utilise modules/interface/config.lua > config.interface.speedometer (modes default, server, custom par barre). Un clic dans /gestion enregistre une surcharge globale pour tous les joueurs.

Le bouton Déplacer du speedometer déclenche surge_hud:speedometerPlacement:start (aperçu en jeu, Entrée = valider, Échap = annuler).

Étape 6 : Bloc infos serveur (logo, ID, joueurs)

Configurable via hud_layout (clés server_info_* et offsets cluster).

Repositionnement : éditeur in-game (calque cluster) ou callbacks server_cluster_offset_*.

Étape 7 : Minimap

Carte custom (fichiers stream/minimap.gfx, graphics.ytd, circlemap.ytd).

Réglage fin vertical fichier : modules/minimap/config.lua > MinimapConfig.MinimapOffsetY. Commande utile en debug : hud_minimap_reload (recharge la minimap).

Étape 8 : Studio HUD (calques type Figma)

Section Studio HUD - Calques personnalisés. Données : custom_widgets[].

• Ajouter : calque Texte, Fond (box) ou Image.
• Calques intégrés (éditeur in-game) : Faim, Soif, Vie & armure, Munitions, Speedometer.
• Studio : canvas avec calques, alignement, snap, z-index, opacité.
• Déplacer en jeu : même flux que la barre d'outils (sélection calque optionnelle).

Bindings dynamiques (texte)

Propriétés d'un widget

Polices disponibles

Familles chargées via surge-hud-fonts.css : montserrat, inter, roboto, poppins, oswald, bebas, rajdhani, orbitron, exo2, kanit, russo, anton, share_tech_mono, permanent_marker, teko, audiowide.

Étape 9 : Éditeur de placement in-game

Workflow complet :

1. Dans /gestion > HUD, cliquez Déplacer en jeu (ou Déplacer sur un calque précis).
2. Le panneau /gestion se ferme, surge_hud:layoutEditor:start s'exécute.
3. Le HUD reste visible. Glissez les calques (souris). Calques : faim, soif, vie/armure, munitions, widgets custom.
4. Entrée : valide et sauvegarde offsets + widgets via surge_core:admin:serverConfig:set / save all.
5. Échap : annule, restaure l'état GlobalState précédent.

Offsets enregistrés par l'éditeur :

• hunger_offset_left_vw, hunger_offset_bottom_vh
• thirst_offset_left_vw, thirst_offset_bottom_vh
• health_armor_offset_left_vw, health_armor_offset_bottom_vh
• ammo_offset_left_vw, ammo_offset_bottom_vh
• speedometer_offset_dx_vw, speedometer_offset_dy_vh
• custom_widgets (positions x/y/w/h mises à jour)

Étape 10 : Sauvegarder et réinitialiser

Après reset ou save, le client reçoit surge_hud:reloadFromServerConfig pour resynchroniser le NUI.

Référence complète : toutes les clés hud_layout

Registre serveur (HUD_LAYOUT_KNOWN_KEYS dans sv_server_config.lua) :

Configuration fichier : interface/config.lua

Fichier : [gameplay]/[ath]/surge_hud/modules/interface/config.lua (non obfusqué).

Features (activer/désactiver modules)

statusColors (fallback si pas de hud_layout)

Par statut (health, armor, hunger, thirst, oxygen) : mode = default (gradient vie), server (surge_color_*), custom (hex + opacity).

Autres blocs interface

• serverLogo : mode serverlogo, serverbanner ou custom + URL.
• idColor : mode server ou custom (hex).
• notificationIcon : server, custom ou disabled.
• notificationProgressBar : default, server ou custom.
• speedometer : style round/square + couleurs rpm/fuel/speed (modes default/server/custom).
• appearance.notificationsRounded : angles notifications carrés ou arrondis.

Modules intégrés à surge_hud

Exports surge_hud (scripts tiers)

Principaux exports documentés dans fxmanifest.lua :

• exports.surge_hud:GetUserPreferHudVisible
• exports.surge_hud:SetUserPreferHudVisible
• exports.surge_hud:ToggleVisible
• exports.surge_hud:IsHudHidden
• exports.surge_hud:SetForceHidden
• exports.surge_hud:SetHudVisible
• exports.surge_hud:SetInventoryOpen
• exports.surge_hud:GetServerColors
• exports.surge_hud:SetFeatures
• exports.surge_hud:GetFeatures
• exports.surge_hud:Notify
• exports.surge_hud:showNotification
• exports.surge_hud:createPrompt
• exports.surge_hud:IsPromptOpen
• exports.surge_hud:IsInSafeZone
• exports.surge_hud:IsDJMenuOpen
• exports.surge_hud:OpenDJMenu
• exports.surge_hud:ShowChatInput
• exports.surge_hud:HideChatInput
• exports.surge_hud:AddChatMessage
• exports.surge_hud:ShowAdvancedServerInfo
• exports.surge_hud:ShowServerAnnouncement
• exports.surge_hud:SendNotificationInit
• exports.surge_hud:RefreshServerInfo

Exemples : exports.surge_hud:Notify(...), exports.surge_hud:IsInSafeZone(), exports.surge_hud:SetInventoryOpen(true) (masque HUD à l'ouverture inventaire).

Fichiers modifiables (hors escrow)

Liste escrow_ignore dans surge_hud/fxmanifest.lua : configs, clients modules listés, assets html/assets/*.css|js, override.css.

Pour un CSS avancé : html/assets/override.css masque les barres natives GTA ; surge-hud-custom.css pour le positionnement responsive (commentaire dans sv_server_config : le vw/vh fin peut aussi s'y régler).

Notifications et identité visuelle

Les couleurs de notifications se règlent dans /gestion > Serveur > Notifications (ServerConfig.notifications), injectées dans surge_hud. Titres par défaut : Succès, Informations, Erreur (personnalisables). Le HUD réutilise le logo serveur pour l'icône des toasts si mode server.

Dépannage

Ordre de configuration recommandé (récapitulatif)

1. Général : nom, logo, couleurs DA (surge_color_*).
2. Notifications : couleurs toasts cohérentes avec la DA.
3. Modules > HUD : formes et couleurs radiant des jauges.
4. Test à pied : vie, faim, soif, munitions (arme équipée).
5. Test véhicule : speedometer style + couleurs + position.
6. Studio widgets : calques branding (logo texte, rappel règlement, etc.).
7. Déplacer en jeu : alignement pixel-perfect sur 1080p et 1440p.
8. Sauvegarder, puis validation avec un joueur non-staff.

Comment bien configurer sa boutique en jeu ?

Dernière mise à jour, 1 juillet 2026 · Par Surge Studio

Ce guide décrit l'intégralité de la boutique en jeu de la Base Surge : menu F1 (s-menu), panneau /gestion > Serveur > Boutique IG, coins virtuels, catalogue articles, navigation, commandes staff et connectivité Tebex (paiements réels, livraison coins/VIP).

Vue d'ensemble de l'architecture

1. Vous configurez identité + URL Tebex dans /gestion > Serveur > Général (surge_tebex).
2. Vous personnalisez la boutique via Boutique IG (liens, nav F1, catalogue, commandes).
3. Les réglages sont persistés en KVP ressource + GlobalState (temps réel en jeu).
4. Le joueur ouvre le menu avec F1 ou /boutique (Config.Command).
5. Les achats coins débitent ncoins et journalisent dans boutique_purchase_history.
6. Tebex déclenche des commandes console sur le FXServer via l'intégration native FiveM (sv_tebexSecret) : giveidboutique, givevip, etc.

Prérequis

• Ressource s-menu démarrée (ensure s-menu dans server.cfg).
• es_extended, oxmysql, tables users (colonne ncoins) et vips.
• surge_admin_menu + surge_core pour le panneau /gestion.
• Permission serveur.boutique (view/edit) ou grade fondateur pour configurer.
• Boutique Tebex créée sur tebex.io + serveur FiveM lié via sv_tebexSecret (voir section Tebex).
• Optionnel : surge_discord_perms pour droits fins staff ; surge_logs pour logs Discord des achats IG.

Étape 1 : URL Tebex globale (Général + fallback fichier)

Chemin : /gestion > Serveur > Général > champ Tebex / boutique.

La valeur est stockée dans le convar surge_tebex (max 512 caractères) et dans ServerConfig.general.identity.tebex. Au démarrage, server_identity.cfg est régénéré.

1. Ouvrez /gestion > Serveur > Général.
2. Collez l'URL publique de votre boutique Tebex dans le champ Tebex.
3. Sauvegardez. Vérifiez surge_core/data/server_identity.cfg : ligne setr surge_tebex "…".
4. Alignez s-menu/shared/config.lua → Config.ShopURL sur la même URL (fallback client).
5. Redémarrez FXServer si vous modifiez uniquement le fichier Lua (le convar /gestion est live après save).

Étape 2 : Permissions Discord et accès staff

Voir aussi Comment configurer ses permissions Discord ?. La boutique utilise deux familles de droits.

Accès panneau /gestion (Boutique IG)

Permissions boutique in-game (F1 Administration)

Étape 3 : Panneau Boutique IG (/gestion)

Chemin : /gestion > Serveur > Boutique IG. Ressource backend : s-menu. Interface : BoutiqueIgPanel.tsx.

La colonne gauche comporte réglages généraux et pages du menu F1 :

Étape 4 : Gestion des boutons et liens Tebex (détail)

Onglet Gestion des boutons = deux blocs : slots fixes (KVP smenu_extra_button_links) et entrées navigation externe (KVP smenu_nav_config, champ external_url).

Les 3 slots fixes

Validation serveur : URL vide autorisée ; sinon https:// ou http://, max 2048 caractères. Résolution côté client (boutiqueStore.openExternalShop) : URL passée en paramètre → slot KVP → shopUrl (ou callback openExternalUrl) → ouverture via invokeNative("openUrl").

Entrée menu VIP (nav_type = external)

Par défaut l'entrée vip est de type external : un clic dans le menu latéral ouvre le navigateur. Vous pouvez définir external_url dédiée (ex. catégorie VIP Tebex). Si vide, même cascade que ci-dessus. Les entrées vip, cart, logs, admin restent toujours visibles (non désactivables).

Étape 5 : Menu latéral F1 (navigation)

Onglet Menu latéral F1. Données : KVP smenu_nav_config, exposées en GlobalState.SmenuNavConfig. Callbacks : s-menu:admin:boutiqueNav:get|set|reset.

Champs modifiables par entrée : label (48 car.), icon (classe CSS icône), sort_order (0-999), enabled (sauf entrées système), external_url.

Étape 6 : Catalogue par page (articles boutique coins)

Pour chaque page weapons, vehicles, helicoboats, pets, packs : l'éditeur surcharge le fichier Lua d'origine via KVP smenu_page_catalog.

• Source par défaut : shared/items/config_weapons.lua, config_vehicles.lua, etc.
• Limite : 400 articles/page, 64 packs, 80 items/pack.
• Reset page : callback s-menu:admin:boutiquePageCatalog:resetPage restaure le fichier Lua.
• Stock limité : champ stock sur un article + table MySQL smenu_limited_stock (compteur + reset).
• Pool « À la une » : union de tous les catalogues ; rotation via module Featured.

Étape 7 : Page Accueil et mise en page

KVP smenu_home_layout → GlobalState.SmenuHomeLayout avec tiles (max 12) et featured (bandeau titre/sous-titre/position).

• Tuiles : style bannière, image, CTA, action page (vers une route) ou lien externe autorisé.
• IDs page autorisés : home, featured, weapons, vehicles, vip, cart, etc.
• Liens externes autorisés sur tuiles : mêmes clés que les slots boutons (header_get_coins, …).
• Page À la une : liste noire pour exclure des articles de la rotation automatique.
• Staff avec boutique.refresh peut forcer un rafraîchissement de la sélection.

Étape 8 : Ouverture joueur et commandes chat

Onglet Commandes chat : renomme les commandes admin stockées dans s-menu/data/boutique_admin_command_names.json. Redémarrage s-menu requis après modification (RegisterCommand au start).

giveidboutique accepte l'UniqueID joueur (colonne users.UniqueID) ; le code affiché en en-tête boutique correspond à ce même identifiant.

Étape 9 : Journal des achats et données joueur

Table boutique_purchase_history : chaque achat coins en jeu (arme, véhicule, pack…). Colonnes : identifier (UniqueID), player_name, purchase_type, item_name, item_id, price, created_at. Option fulfilled_at / fulfilled_by si migration staff appliquée.

Coins stockés dans users.ncoins (pas de table boutique séparée pour le solde). VIP dans vips (expiration, tier). s-menu/server/init_db.lua crée les tables manquantes au boot.

Logs Discord optionnels via surge_logs à chaque achat (Queries.LogPurchase). Webhooks internes s-menu pour actions admin (give coins, give VIP).

Étape 10 : Panel Administration F1 (en jeu)

Joueurs avec boutique.panel (ou droits équivalents) voient l'entrée Administration dans le menu F1. Fonctions typiques : recherche par UniqueID, donner/retirer coins, attribuer VIP, consulter historique, marquer commandes fulfilled.

Ce panel complète le journal /gestion : le staff en service peut agir sans ouvrir le menu admin global.

Connectivité Tebex : guide complet de A à Z

Tebex remplit deux rôles distincts sur la Base Surge : (1) lier le FXServer pour livrer coins/VIP après paiement réel ; (2) fournir l'URL web ouverte depuis le menu F1 (« Obtenir des coins », page VIP). Ne confondez pas la clé secrète (sv_tebexSecret) et le lien public (surge_tebex).

1. Lier Tebex au FXServer (livraison des achats)

FiveM intègre Tebex nativement : aucune ressource ensure tebex n'est nécessaire sur la Base Surge. La liaison se fait avec une clé secrète générée dans le panel Tebex.

1. Créez un compte sur tebex.io et une boutique type FiveM (sous-domaine *.tebex.io).
2. Panel Tebex : Integrations > Game Servers > Connect Game Server.
3. Choisissez l'option Plugin (libellé historique : c'est l'intégration native FiveM, sans téléchargement).
4. Donnez un nom au serveur, cliquez Continue, puis copiez la clé secrète affichée.
5. Ajoutez-la en bas de votre server.cfg : sv_tebexSecret "VOTRE_CLE_SECRETE" (guillemets recommandés).
6. Redémarrez le FXServer. Dans Tebex, validez l'étape : le statut doit passer à Connected.

2. URL publique de la boutique (redirections F1)

Une fois la boutique Tebex en ligne, configurez le lien web que les joueurs ouvrent depuis le menu F1. Procédure détaillée : section Étape 1 : URL Tebex globale ci-dessus (/gestion > Serveur > Général > Lien Tebex, convar surge_tebex, fallback Config.ShopURL, slots Boutique IG).

1. Copiez l'URL publique (ex. https://monserveur.tebex.io/).
2. Collez-la dans /gestion > Serveur > Général > Lien Tebex (surge_tebex).
3. Alignez s-menu/shared/config.lua > Config.ShopURL sur la même URL (fallback si slot vide).
4. Optionnel : renseignez les slots header_get_coins, vip_page_tebex dans Boutique IG si vous voulez des liens différents par bouton.

3. Identifier le joueur à la caisse (critique)

Tebex doit savoir quel joueur recevra la commande. Sur la Base Surge, l'identifiant standard est l'UniqueID (nombre affiché en haut du menu boutique F1, champ boutiqueCode / shopCode).

• Les commandes giveidboutique et givevip attendent cet UniqueID numérique, pas la license FiveM.
• Créez un champ personnalisé au checkout Tebex (libellé ex. « ID boutique F1 ») et mappez la variable du package sur ce champ.
• Communiquez dans la boutique : « Entrez l'ID affiché en haut du menu F1 (boutique) ».
• Si l'ID est incorrect, la commande échoue côté console : vérifiez les logs FXServer après un achat test.

4. Packages Tebex et commandes console

Chaque package Tebex « Game Server Command » déclenche une ou plusieurs lignes console au moment de l'achat (joueur en ligne ou file d'attente si offline, selon réglage Tebex).

{username} (ou la variable liée à votre champ checkout) doit contenir l'UniqueID saisi par le joueur. Dans chaque package : type Game Server Commands, exécution même si le joueur est hors ligne recommandée. Tiers VIP valides : bronze (Premium), silver (Héros), gold (Divinité) - voir Config.VIP.

5. Cohérence des liens (parcours joueur)

1. Joueur appuie sur F1 → voit son UniqueID et son solde coins.
2. Clic « Obtenir des coins » / VIP → ouverture navigateur Tebex (URL surge_tebex / slots Boutique IG, voir sections Étape 1 et 4).
3. Paiement Tebex → intégration native exécute giveidboutique ou givevip sur le FXServer.
4. Joueur reconnecte ou refresh → solde coins / statut VIP mis à jour (boutique:refreshPlayerData).
5. Achats en coins (armes, voitures…) restent entièrement in-game, sans Tebex.

6. VIP : règles métier

• Le VIP ne s'achète pas avec les coins boutique (message : « Le VIP s'achète sur Tebex »).
• La page VIP affiche les avantages et boutons Tebex ; les tiers sont définis dans config_vip.lua (durée par défaut 30 jours).
• Avantages VIP (custom armes, drift, props…) passent par surge_core F5 / exports ; la boutique ne fait qu'afficher et rediriger.
• Événement spécial arme custom Tebex : tebex:on-process-checkout-weapon-custom (handler F5 surge_core) pour certains packs armes personnalisées.

7. Test achat et validation

1. Créez un package test à 0 € ou mode sandbox Tebex si disponible.
2. Connectez-vous en jeu, notez votre UniqueID, lancez l'achat test avec cet ID.
3. Surveillez la console FXServer : ligne [Boutique] X coins ajoutés ou confirmation VIP.
4. Rouvrez F1 : vérifiez solde / badge VIP. Consultez le journal /gestion si achat in-game.
5. Testez un achat hors ligne (déconnecté) : Tebex doit livrer à la prochaine connexion.

8. Dépannage Tebex

Callbacks techniques (référence développeur)

Exports : IsBoutiquePanelStaff, CanEditBoutiqueGestion, CanManageBoutiqueCoins, CanManageBoutiqueVip.

Dépannage général boutique IG

Ordre de configuration recommandé (récapitulatif)

1. Tebex : boutique créée, sv_tebexSecret dans server.cfg, statut Connected.
2. Général : surge_tebex (lien public) + Config.ShopURL identiques.
3. Packages Tebex : commandes giveidboutique / givevip avec variable UniqueID.
4. Permissions Discord : serveur.boutique pour l'équipe config ; boutique.* pour staff en jeu.
5. Boutique IG : liens boutons → menu F1 → catalogue pages → accueil.
6. Commandes chat : renommage si besoin + restart s-menu.
7. Test bout en bout : achat Tebex test + achat coins arme + journal staff.

Comment configurer le système de personnage ?

Dernière mise à jour, 1 juillet 2026 · Par Surge Studio

Ce guide décrit l'intégralité du système de personnage de la Base Surge : sélection multichar, création identité + apparence, premier spawn, slots, économie de départ, magasins vêtements, administration staff et base de données. La stack remplace esx_identity, esx_skin, illenium-appearance et fivem-appearance par surge_multicharacter, surge_clothing et surge_ui.

Vue d'ensemble de l'architecture

1. Le joueur passe par surge_loadingscreen puis arrive sur l'écran de sélection multichar.
2. Un routing bucket isolé (instance) affiche le menu sans interférence du monde.
3. Nouveau slot : création identité RP + apparence dans surge_ui / surge_clothing.
4. Fin créateur : carte de spawn (ServerConfig.general.spawn_points) ou spawn direct selon config.
5. ESX charge le personnage (users), ox_inventory reçoit skin + items de départ.
6. Staff configure spawn, économie et fiches via /gestion (Serveur + Monde).

Prérequis

• ensure surge_multicharacter, surge_clothing, surge_ui, es_extended, oxmysql.
• Table users ESX avec colonnes Surge : UniqueID, hasFinishedCreator, skin (JSON), metadata.
• Tables slots optionnelles : multicharacterv3, multicharacterv3_code (slots payants / codes).
• Base SQL importée (surge.sql) depuis le guide Installation.
• Pour admin : /gestion avec serveur.general, serveur.economy ou monde.citizens.

Flux joueur : de la connexion au spawn (détail)

1. Connexion et chargement

Après connexion FiveM, surge_loadingscreen affiche identité serveur (surge_server_name, couleurs, slides). Puis le client multichar déclenche multicharacter:client:loadUserData quand la session réseau est prête.

2. Instance de sélection

Le serveur place le joueur dans un routing bucket dédié (isolation). L'UI de sélection s'ouvre (UseSurgeEsxUi = true → dossier surge_multicharacter/ui/). Si ShowCharacterPreview = true, un ped 3D + caméra scriptée illustre le personnage sélectionné.

3. Liste des personnages

Callback multicharacter:callback:getCharacters : personnages liés à la licence FiveM. Format identifier ESX : {slot}:{hash_licence} (ex. 1:abc…). Chaque fiche affiche prénom, nom, job, argent, etc. Slots vides ou verrouillés selon DefaultCharacterSlots.

4a. Jouer un personnage existant

1. Clic Jouer → multicharacter:server:playCharacter.
2. Si hasFinishedCreator = 0 : réouverture du créateur (création inachevée).
3. Sinon : ESX.Login, chargement skin, spawn à users.position ou point fallback.
4. Retour bucket 0 (monde partagé), événement esx:playerLoaded.

4b. Créer un nouveau personnage

1. Slot libre → multicharacter:server:createCharacter → ligne users avec hasFinishedCreator = 0.
2. Ouverture créateur : clothing:client:openCreationMenu (studio intérieur MP si TeleportWhenCreatingChar).
3. Écran identité surge_ui : prénom, nom, date de naissance, sexe, taille, nationalité.
4. Sauvegarde identité : clothing:server:saveCharacterIdentity sur users via UniqueID.
5. Étapes apparence : héritage, traits, vêtements, accessoires (catégories surge_clothing).
6. Validation → multicharacter:server:characterCreationComplete → hasFinishedCreator = 1.
7. Carte spawn surge_ui:character:openSpawn avec afterCreation = true (si ApartmentStart = false).
8. Choix point → multicharacter:server:confirmAfterCreationSpawn : position + éventuelle location véhicule.
9. Injection vêtements ox_inventory, items de départ, comptes ESX initialisés.

5. Changement de personnage (F5)

Si AllowCharacterSwitch = true, le menu F5 propose Mes personnages (callback esx_multicharacter:canSwitchCharacters). esx_multicharacter:relog sauvegarde, déconnecte le perso actuel et rouvre la sélection. Le personnage quitté est temporairement verrouillé (relogLocked) pour éviter le re-switch immédiat.

Étape 1 : Configuration multichar (surge_multicharacter/config/)

Fichier principal : config/config.lua. Redémarrage ressource requis après modification.

Fichiers d'ambiance

• locations.lua : décors / coords arrière-plan preview sélection (10 emplacements configurables).
• animation.lua, camera.lua, effects.lua, weather.lua : cinématique sélection.
• database.lua : tables nettoyées lors d'une suppression de personnage.
• SpawnLocations (config.lua) : liste legacy si sélecteur multichar interne (souvent remplacée par surge_ui).

Slots payants et codes

CharacterSlots.Tebex, Discord, Custom : activation slots bonus via boutique, rôles Discord ou licences listées. Table multicharacterv3 : slots achetés par unique_id. Table multicharacterv3_code : codes one-shot échangeables (callback multicharacter:server:checkTebexCode). Commandes admin : /addslots <UniqueID>, /resetslots <UniqueID>, /debugslots.

Étape 2 : Création et apparence (surge_clothing)

Fichier : shared/config.lua.

Magasins en jeu

surge_clothing gère les points d'interaction : boutiques vêtements, coiffeur, barber, tatoueur. Prix, blips et positions sont dans le même fichier config (sections ClothStores, BarberShops, etc.). À l'ouverture, l'UI catalogue réutilise le même moteur que la création (ForceSurgeUiShop). Édition personnage existant : EditCharacter (TextUI + distance).

Compatibilité skinchanger

surge_clothing expose les événements legacy skinchanger:loadSkin et callback esx_skin:getPlayerSkin pour les scripts tiers (ex. s-menu). Colonne users.skin : JSON apparence persistée.

Étape 3 : Interface surge_ui (création + spawn)

• Module création : surge_ui/modules/character/creation/web/ - formulaire identité + hub catégories apparence.
• Module spawn : surge_ui/modules/character/spawn/web/ - carte interactive des spawn_points.
• Exports : openCharacterCreation, openCharacterSpawn, openSpawnAfterCreation, forceCloseAllUi.
• Previews intégrées : Pillbox South, Burton, Davis, LSIA Terminal (assets dans spawn/web/assets/previews/).

Étape 4 : Configuration /gestion (sans redémarrage pour la plupart)

Serveur > Général (serveur.general)

Section Points de spawn : éditeur de general.spawn_points[]. Chaque entrée : id, name, zone, coords (x,y,z,heading), vehicleRental, vehicleSpawn, image (preview carte). Le premier point sert de fallback si users.position est NULL. Boutons staff : « Utiliser ma position », « Tester » in-game. Voir aussi le hub Serveur > Général.

Serveur > Économie (serveur.economy)

Réglages appliqués à chaque nouvelle création via GlobalState.ServerConfig :

Priorité : valeurs /gestion > Config.StarterItems multichar > Config.StartingInventoryItems ESX. Hub détaillé : Serveur > Économie.

Monde > Citoyens (monde.citizens)

Fiches personnages complètes : identité RP, UniqueID, personnages liés (alts même licence), jobs, gang, argent, véhicules, propriétés, skin, warns. Actions edit : ajuster argent, jobs, gang, donner véhicule, sanctions. Distinct du F10 (actions rapides en service). Hub : Monde > Citoyens.

Monde > Greenscreener (monde.greenscreener)

Génère les images catalogue pour le créateur (ClothingCdnBase). Sans captures à jour, certaines vignettes vêtements peuvent manquer dans l'UI création.

Étape 5 : ESX et base de données

Configuration ESX (es_extended/shared/config/main.lua)

Colonnes users essentielles

Tables slots

• multicharacterv3 : slots bonus par joueur (unique_id + character_slot).
• multicharacterv3_code : codes échangeables (code, slot).
• lpcharacter_saved_clothes, lpcharacter_marketplace_outfits : tenues sauvegardées (wipe staff).

Étape 6 : Permissions Discord et commandes

Permissions complètes : guide Permissions Discord.

Étape 7 : Exports et callbacks (référence)

Exports surge_multicharacter

Callbacks / événements clés

Intégrations connexes

• Loadscreen : couleurs et liens depuis ServerConfig.loadscreen + convars identité.
• HUD : masqué pendant multichar ; reconfigurable via guide HUD.
• Boutique : UniqueID affiché F1 = même ID pour Tebex (voir guide Boutique).
• Téléphone : numéro créé à la connexion multichar (hub Monde / Légal).
• Safezones : protéger zone spawn / sélection avant activation PvP (hub Monde).
• Deathscreen : vérifie hasFinishedCreator avant affichage.

Dépannage

Ordre de configuration recommandé (récapitulatif)

1. Installation : SQL, ensure multichar + clothing + surge_ui.
2. Général : identité serveur + spawn_points carte (4 points minimum testés).
3. Économie : argent et items de départ cohérents avec votre RP.
4. multichar config.lua : slots par défaut, /register, preview, F5 switch.
5. surge_clothing : CDN images, magasins, prix, /skin staff.
6. Permissions : monde.citizens, commandes slots, /skin.
7. Test bout en bout : nouveau perso + reconnect + switch F5 + fiche Citoyens.

Comment configurer le système de création de métier ?

Dernière mise à jour, 1 juillet 2026 · Par Surge Studio

Ce guide décrit l'intégralité de la création et de la configuration des métiers sur la Base Surge. Il n'existe pas de ressource isolée « job_creator » : le cœur est le Society Manager (/gestion > Légal > Sociétés), qui crée simultanément le job ESX, ses grades et la société in-game (boss, coffre, vestiaire). Des extensions couvrent les farms (jobs_builder), l'intérim, la police, le mécano, la cuisine, etc.

Vue d'ensemble de l'architecture

1. Staff en service → /gestion → hub Légal → Sociétés.
2. Créer une société : identifiant job + label + positions + 4 grades obligatoires.
3. Backend surge_core insère society_data, jobs, job_grades et enregistre le stash ox.
4. Configuration avancée : catalogues (coffres, magasins, craft), farm, blip pause menu, employés.
5. Recrutement joueur via surge_tablette_legal (job center) ou menu boss société.
6. Jobs spécialisés (police, EMS, mécano…) : panneaux dédiés sur un job ESX déjà existant.
7. Boulots intérim : hub Serveur > Modules > Métier Intérim (sans ligne dans jobs).

Prérequis

• surge_core, es_extended, oxmysql, surge_admin_menu démarrés.
• Tables ESX : jobs, job_grades, users (colonnes job, job_grade, job2, job2_grade).
• Table Surge : society_data (+ jobs_builder si farms).
• Staff en service (/staffservice) + permission legal.societies.create ou grade ESX gestionlegal / fondateur.
• Items ox déclarés avant de configurer farms ou magasins (noms exacts).

Étape 1 : Accéder au Society Manager

Chemin : /gestion > Légal > Gestions des sociétés (tuile Society Manager).

Vérification serveur : societyCanCreate() dans surge_core/addon/[legal]/society/server/sv_main.lua (groupes ESX, F10, ou Discord legal.societies.create|edit).

Étape 2 : Créer une société / métier ESX (modal « Créer une société »)

Composant : CreateSocietyModal.tsx. Callback : surge_core:admin:society:create → societyCreateFromAdmin().

Champs obligatoires

Grades par défaut (noms techniques ESX)

Les clés internes sont imposées pour compatibilité menu société :

Le grade boss est requis pour le menu patron, permissions coffre par défaut (Society.DefaultPermissions : ouverture coffre, boss, dépôts, armes… réservés au boss). Après création : ESX.RefreshJobs(), sync clients, RegisterSocietyStash.

Options à la création

• Blip carte : sprite, couleur, position (optionnel).
• Vestiaire : toujours activé ; position séparée du boss.
• Coffre initial : structure JSON vide (compte société 5000$ dans le template SQL).

Étape 3 : Configurer la société (onglets Society Manager)

Fichier : SocietyManagerPage.tsx. Quatre onglets principaux :

Panneau pause et recrutement

Champs blip avancés : pauseTitle, pauseTagline, pauseImageUrl, pauseRecruitmentOpen (entreprise visible au job center si ouvert). Config partagée : surge_core/addon/[legal]/society/shared/config.lua.

Permissions coffre par grade

Éditables par société : dépôt/retrait cash, items, armes, accès boss. Défaut : tout réservé au grade boss (open_coffre, open_boss, etc.).

Étape 4 : Farm récolte / traitement / vente (jobs_builder)

Un farm par société (clé = name du job). Modal CreateFarmModal.tsx. Callbacks : surge_core:admin:jobs_builder:create|update|delete. Runtime : surge_interim/modules/jobs_builder_farm/.

Table SQL : jobs_builder (voir surge_interim/install/install_jobs_builder.sql).

Étape 5 : Métiers spécialisés (job ESX préalable requis)

Ces panneaux enregistrent une configuration liée à un jobs.name existant. Créez d'abord la société avec le bon identifiant (ex. police, bennys, burgershot).

Modules intégrés surge_core/addon/[legal]/[job]/ : police, mecano, ambulance, concess, taxi, realestate (runtime in-game, pas création SQL job).

Étape 6 : Métier intérim (sans création job ESX)

Chemin : /gestion > Serveur > Modules > Métier Intérim. Permission : serveur.modules view/edit. Persistance : KVP interim_jobs_admin_v1 → GlobalState.InterimJobModulePatches.

Chaque module : formulaire simplifié + mode JSON avancé. Actions : sauvegarder, recharger, reset module, reset global. Callbacks : surge_core:admin:interimJobs:get|set|reset. Hub détaillé : Serveur > Métier intérim.

Étape 7 : job principal vs job2

Le Society Manager compte les employés sur job ET job2. Attribution staff : /gestion > Monde > Citoyens → setJob / setJob2 ou commandes /setjob, /setjob2 (permission staff).

Étape 8 : Recrutement et job center (côté joueur)

Ressource : surge_tablette_legal.

• Ouverture tablette : item tablettelegal ou bouton « Gestion entreprise » menu boss (pas de /tablette par défaut).
• Patron ouvre le recrutement → ligne tablet_recruitment_status.is_open = 1.
• Job center : liste les entreprises avec recrutement ouvert (+ services publics si config).
• Candidature acceptée → setJob ou setJob2 selon flux tablette.
• Reset hebdomadaire candidatures : lundi 00:00 (Config.Recruitment).
• Services publics exclus de la tablette entreprise (Config.PublicServiceJobs : police, EMS, etc.).

Menu boss in-game (surge_core:society) : gestion employés, coffre, facturation selon job. Menu F6 et scripts métier (police, EMS…) s'activent une fois le bon job.name assigné.

Étape 9 : Suppression d'une société

Event surge_core:admin:deleteSociety (permission legal.societies.delete). Purge orchestrée :

• Farm jobs_builder, magasins ox, stashes, craft benches liés.
• Véhicules société (owned_vehicles), comptes addon_account / company_accounts.
• Recrutement tablette, lignes society_data, jobs, job_grades.
• Joueurs affectés : repassés unemployed (job et job2 si correspondant).

Script migration orphelins : surge_core/addon/[gestion]/staff/sql/migration_society_delete_orphans_mysql.sql.

Base de données (référence complète)

Callbacks et commandes (référence)

Callbacks société / farm / intérim

Commandes staff utiles

Export permission : exports["surge_core"]:HasAdminNuiPermission(source, feature, action).

Dépannage

Ordre de configuration recommandé (récapitulatif)

1. Permissions : legal.societies.* pour l'équipe légal (voir Discord).
2. Créer la société : name = identifiant définitif (ex. unicorn, police).
3. Positions : boss, coffre, vestiaire testés in-game.
4. Grades et salaires : boss confirmé, permissions coffre ajustées.
5. Catalogues : magasin employé, craft, farm si activité récolte.
6. Panneau pause : blip + recrutement ouvert pour job center.
7. Panneau spécialisé si police / mécano / cuisine (après job créé).
8. Test joueur : setJob → service → F6 / tablette / farm / intérim selon cas.

Comment configurer le système de garage ?

Dernière mise à jour, 1 juillet 2026 · Par Surge Studio

Ce guide décrit l'intégralité du système de garage sur la Base Surge : garages publics (voiture, bateau, avion), fourrières, flottes entreprise et gang, rangement et sortie côté joueur, attribution staff et intégrations (concession, téléphone, immobilier). Il n'existe pas de ressource isolée surge_garage : le cœur métier vit dans surge_core/addon/[monde]/vehicles, l'interface joueur dans surge_ui, et l'administration dans surge_admin_menu (/gestion).

Vue d'ensemble de l'architecture

1. Migration SQL garages + garage_pounds (une fois par serveur).
2. Staff configure les garages publics : /gestion > Monde > Gérer les garages.
3. Au boot, surge_core charge les garages et fourrières, spawn les PNJ surge_interact et les blips.
4. Joueur appuie sur E au PNJ → NUI surge_ui (catégories Personnel / Entreprise / Groupe).
5. Sortie véhicule : spawn serveur, props BDD, clé vehicle_key ox_inventory, state = sorti.
6. Rangement : zone deletepos, sauvegarde fuel + coffres ox, state = au garage, suppression entité.
7. Flottes société / gang : panels dédiés dans hubs Légal et Illégal, mêmes tables owned_vehicles.

Prérequis

• surge_core, surge_ui, surge_admin_menu, surge_interact, oxmysql, ox_inventory démarrés.
• Table owned_vehicles (ESX) avec colonnes Surge : state, garageid, type, label, fuel, optionnel gang, propertiesID, boutique.
• Migration exécutée : surge_core/addon/[monde]/vehicles/sql/migration_garages_pounds_mysql.sql.
• Staff en service (/staffservice) pour les panels admin.
• Pour flotte entreprise : société / job ESX déjà créé (voir création de métier) avec jobs.name identique au owner des véhicules.
• Pour flotte gang : gang existant dans hub Illégal (illegal_gangs).

Base de données (référence complète)

Table garages (garages publics)

Table garage_pounds (fourrières)

Si la table est vide au premier boot, un seed automatique crée les fourrières principales (ville, plage, Paleto, Sandy, Cayo, LSPD, ports, aéroports…). Fallback legacy : surge_core/addon/[monde]/vehicles/shared/config_impound.lua.

Table owned_vehicles (colonnes garage)

Tables connexes : property_vehicles (immobilier), illegal_gangs, illegal_gang_users, users (lookup admin).

Étape 1 : Migration SQL et premier démarrage

1. Exécutez migration_garages_pounds_mysql.sql sur votre base MySQL (phpMyAdmin, HeidiSQL, txAdmin…).
2. Redémarrez surge_core puis surge_admin_menu.
3. Vérifiez en SQL : SELECT id, name, label, type FROM garages; (3 lignes par défaut si seed initial).
4. Vérifiez garage_pounds : lignes seed ou édition manuelle si besoin.
5. En jeu : blips garage sur la carte si activeblip=1, PNJ aux defaultpos.

Garages par défaut non supprimables via menu legacy : ID 1 (terrestre), 2 (aérien), 3 (nautique).

Étape 2 : Créer et configurer un garage public (/gestion)

Chemin : /gestion > Monde > Gérer les garages. Page React : GaragesAdminPage.tsx (classe CSS sub-page--garages-admin).

Création d'un garage (modal)

1. Cliquez Créer un garage.
2. Renseignez name (unique), label, type (terrestre / nautique / aérien).
3. Placez-vous in-game : le modal capture vos coords pour defaultpos, deletepos et un premier spawnpos.
4. Activez le blip carte si souhaité.
5. Validez → event serveur surge_core:garage:create → INSERT garages → sync tous les clients.

Édition d'un garage existant

• Identité : renommer name / label.
• PNJ : repositionner defaultpos (bouton position joueur).
• Rangement : repositionner deletepos (zone « RANGER VÉHICULE »).
• Spawns : ajouter / supprimer des entrées dans spawnpos via coords joueur.
• Blip : toggle → surge_core:garage:edit + surge_core:garages:edit:blips.

Côté serveur, les events surge_core:garage:create|edit|delete vérifient la permission staff Config.Staff.HavePermission("Menu", "openMenu") (menu staff large), en complément des perms NUI Discord.

Étape 3 : Fourrières (récupération véhicules « sortis »)

Un véhicule avec state=0 apparaît dans l'onglet Fourrière du menu garage joueur et au PNJ fourrière (message FOURRIÈRE, touche E).

Configuration admin

• Onglet Fourrières dans GaragesAdminPage : lecture via callback admin-nui:garages:getPounds (staff requis).
• Champs : slug, label, type, modèle PNJ, position, points spawn, blip, ordre.
• La UI NUI peut appeler surge_core:garage:pound:create|edit|delete ; en pratique, les fourrières sont surtout gérées via seed SQL au boot ou édition directe table garage_pounds, puis surge_core:garage:pound:refreshAll.

Côté joueur (récupération)

1. Interagir avec le PNJ fourrière du bon type (car / boat / aircraft).
2. Liste des véhicules personnels en state=0 compatibles avec le type.
3. Action spawnPound : paiement 500$ banque (perso) ; gratuit pour véhicules société ; VIP peut être exempté (surge_core:garage:paidPound).
4. Sortie serveur : parfois frais additionnel 250$ selon flux sortVehicle type pound.

Config jobs gratuits potentiels : config_impound.lua → free_impound_jobs (police, ambulance…). Mise en fourrière police : event surge_core:police:impoundVehicle supprime l'entité en map (pas toujours de sync state BDD automatique).

Étape 4 : Expérience joueur (garage public)

Ouvrir le menu

1. PNJ surge_interact à defaultpos (message GARAGE).
2. Garages:openMenuNui(id, type) → exports['surge_ui']:openMain().
3. Catégories NUI :
   • Personnel → callback surge_core:garage:myvehicle
   • Entreprise → surge_core:garage:myvehicle_entreprise (si job ≠ unemployed)
   • Groupe illégal → surge_core:garage:myvehicle_group
4. Onglets : « Véhicules au garage » (state=1) / « Fourrière » (state=0).

Sortir un véhicule

• Action NUI spawn : vérif plaque pas déjà spawnée (surge_core:garages:checkPlateInMap).
• Garages:sortVehicle → surge_core:garages:sortVehicle : spawn, applique props JSON, donne clé ox, state=false.
• Preview 3D : caméra client surge_ui + surge_core:garages:spawnPreview.
• Miniatures CDN : https://r2.fivemanage.com/pPcFP1xSIbg33OUlpI8Vs/{model}.png.
• VIP : localisation véhicule sorti via surge_core:garages:getVehicleLocation.
• Véhicule bâché (surge_bache) : sortie bloquée tant que bâché.

Ranger un véhicule

1. Conduire jusqu'à deletepos ou sous le PNJ (zone RANGER VÉHICULE, E).
2. Garages:rentVehicle(id, type) :
   • Vérif propriété surge_core:garage:getType
   • Vérif compatibilité type garage / véhicule
   • Sauvegarde fuel et coffres ox (surge_core:garages:saveVehicleInventories)
   • surge_core:garage:state avec state=true + props JSON à jour
   • Retrait clé vehicle_key, suppression entité client

Actions secondaires menu

Étape 5 : Garage entreprise (flotte société)

Chemin : /gestion > Légal > Garage d'entreprise. Page : EnterpriseGaragePage.tsx. Permission : legal.enterprise_garage (view / edit).

Les véhicules sont des lignes owned_vehicles où owner = jobs.name de la société (ex. police, ambulance). Créez d'abord la société via Society Manager (guide métier, hub Sociétés).

Fonctions admin

• Liste par job : filtres total / au garage / sortis.
• Donner un véhicule : modal AttribVehicleModal → modèle, quantité, garageid → surge_core:garages:attribuevehiculetosociety.
• TP véhicule (bring) : spawn admin près du staff.
• Rangement admin (store) : force state=1.
• Suppression : retire la ligne SQL.
• Changer état : surge_core:admin:society:garage:setState / delete.

Particularités flotte entreprise : pas de limite « une plaque sur la map » (plusieurs sorties autorisées). Fourrière entreprise : gratuite. Catalogue véhicules société aussi depuis Society Manager (onglet Catalogues).

Étape 6 : Garage de gang (flotte illégale)

Chemin : /gestion > Illégal > Garage de gang. Page : GroupGaragePage.tsx. Permission : illegal.gang_garage (view / edit).

Résolution gang via illegal_gang_users → illegal_gangs. Attribution : gang = id numérique, owner = label du gang. Event : surge_core:admin:gang:garage:giveVehicle, surge_core:garages:attribuevehiculetogang.

• Même UX que garage entreprise : liste, bring, store, delete, donner véhicule.
• Callbacks : surge_core:admin:gang:garage:list, setState, delete, gangsList.
• Véhicules boutique=1 : non transférables vers gang.

Étape 7 : Attribution véhicules via Citoyens et F10

Chemin : /gestion > Monde > Citoyens → onglet véhicules du joueur sélectionné. Permission : monde.citizens.

Menu F10 staff : options liées véhicules selon permissions configurées (ex. f10.ServerOptions.creategarage pour création garage legacy, groupes fondateur, admin, gestionlegal). Voir menu F10.

Étape 8 : Concessionnaire, téléphone et immobilier

Concession (concess)

Vente véhicule → INSERT owned_vehicles avec garageid choisi à la livraison, facturation société concession, attribution plaque. Le véhicule apparaît ensuite au garage public correspondant. Hub : Légal > Concession.

Téléphone (surge_phone)

Config : surge_phone/config/garage.lua (RetrievalFees, colonnes BDD, whitelist modèles). Bridge : garage_esx-owned-vehicles.lua. API NUI : surge_phone:nui:garage_list, garage_retrieve, garage_sync.

Immobilier

Véhicules avec propertiesID ≠ 0 : exclus des listes garage public et gérés via le système propriété (property_vehicles). Wipe joueur supprime aussi ces lignes.

Étape 9 : Commandes staff legacy et PNJ

Alternative au panel NUI pour staff autorisés (groupes fondateur, gestionillegal, admin) :

Mêmes events serveur que le panel /gestion : surge_core:garage:create|edit|delete.

Clés véhicule, carburant et coffres

• Clés : item ox vehicle_key avec métadonnée plaque ; module sv_vehicle_keys.lua.
• Carburant : colonne fuel + cache Garages.fuels ; sauvegarde au rangement.
• Coffres : inventaires trunk et glove persistés via ox au rangement (saveVehicleInventories).
• Custom mécano : met à jour owned_vehicles.vehicle sans passer par le flux garage.

Fichiers de configuration

ServerConfig (notifications véhicules)

Clés dans surge_core/addon/[gestion]/staff/server/sv_server_config.lua :

Les prix fourrière (500$ / 250$) sont codés en dur + config_impound.lua, pas de clé ServerConfig dédiée.

Callbacks, events et exports (référence)

Callbacks joueur

Callbacks admin NUI

Events réseau principaux

Exports surge_ui (module garage)

Intégration jobs_builder et Society Manager

jobs_builder (farms intérim) n'a pas de garage dédié : les véhicules de service passent par la flotte entreprise et le catalogues Society Manager (onglet véhicules). Après création société police, configurez la flotte dans Garage entreprise ou Catalogues.

Dépannage

Ordre de configuration recommandé (récapitulatif)

1. SQL : migration garages + garage_pounds.
2. Permissions : monde.garages.*, legal.enterprise_garage.*, illegal.gang_garage.* (voir Discord).
3. Garages publics : au moins un garage par type utilisé sur le serveur (ou éditer les 3 par défaut).
4. Fourrières : vérifier seed ou compléter positions spawn.
5. Sociétés : créer jobs puis flottes entreprise si services publics / métiers.
6. Gangs : créer organisations puis flottes gang.
7. Test joueur : donner véhicule → sortie → rangement → fourrière → récupération.
8. Concession / téléphone : valider livraison et app garage si activés.

Comment configurer le système d'immobilier ?

Dernière mise à jour, 1 juillet 2026 · Par Surge Studio

Ce guide décrit l'intégralité du système immobilier sur la Base Surge : agences, création de biens, tarification, achat et location, intérieurs IPL/MLO, garages de propriété, coffres ox_inventory, meubles, colocataires, facturation agent et intégrations économie / société / garage public. La ressource principale est surge_property (alias interne et préfixe events admin : s-property). Le job agent est géré par surge_core/addon/[legal]/[job]/[entreprise]/realestate.

Vue d'ensemble de l'architecture

1. Créer la société realestateagent via Society Manager (guide métier).
2. Staff place le point Gestion des prix : /gestion > Légal > Immobilier.
3. Le boss agence configure la grille tarifaire (NUI ou shared/price.json).
4. Agent en service ouvre /immo → NUI création → placement porte monde → INSERT property_list.
5. Joueur ou agent à la porte : achat, location, facture F6 ou paiement direct.
6. Propriétaire entre (instance routing bucket 1500 + property_id), coffre ox property_{id}, meubles, garage intégré si type garage_*.

Prérequis

• surge_property, surge_core, ox_lib, oxmysql, ox_inventory, surge_interact, surge_hud démarrés.
• Tables immo créées au premier boot ou via SQL fourni (voir section BDD).
• Société ESX realestateagent (ou job listé dans Config.RealEstateJobs).
• Asset pack /assetpacks pour certains intérieurs (dépendance fxmanifest).
• Permission staff legal.realestate pour le panel admin points agence.

Base de données (référence complète)

Table property_list (biens immobiliers)

Tables connexes

Migrations SQL fournies dans surge_property/sql/ : add_stored_pos_column.sql, add_plate_normalized_unique.sql, performance_indexes.sql. Index unique (id_property, plate_normalized) sur les véhicules garage.

Étape 1 : Créer la société agent immobilier

Chemin Society Manager : /gestion > Légal > Sociétés → créer société realestateagent (label « Agence Immobilière Los Santos » ou personnalisé). GPS société par défaut : Arcadius vec3(-705.49, 269.15, 83.14) (PSRealEstate.Jobs).

• Positions boss, coffre, vestiaire à l'Arcadius ou votre QG RP.
• Grade boss requis pour modifier les prix (Config.BossGrade).
• Agents prennent service via vestiaire ou checkbox F6 (surge_core:service:set).
• Variantes multi-agences : décommenter realestateagentsandy, realestateagentpaleto dans Config.RealEstateJobs et créer les sociétés correspondantes.

Étape 2 : Configurer les points agence (/gestion)

Chemin : /gestion > Légal > Gestion Immobilier. Page : RealEstateAdminPage.tsx (classe sub-page--realestate-admin).

Fallback staff serveur (sv_admin_config.lua) : groupes ESX fondateur, admin, superadmin, gestionlegal, ou IsServerNuiStaff.

Types de points (Config.AgencyPointTypes)

Pour ajouter un point « création » en agence : étendre agency_points.lua avec une entrée action = "creation" (non présent par défaut ; la création passe surtout par /immo et F6).

Placement d'un point

1. Sélectionner l'agence (realestateagent) dans le panel.
2. Se téléporter au point existant ou se placer in-game.
3. Cliquer Enregistrer ici → event s-property:admin:point:save → INSERT/UPDATE realestate_agency_points.
4. Sync clients : s-property:agency:points:sync.

Étape 3 : Grille tarifaire (boss agence)

Le boss se rend au point gestion_prix (interaction surge_interact, message « Gérer les prix ») ou utilise les coords fallback Config.GestionCoords si aucun point placé.

Formule de prix

prix_achat = base[type] × zone[secteur] × storage[taille]
prix_location = prix_achat / Config.Economy.RentalPriceRatio (défaut : 25, soit 4 % du prix achat par semaine).

Fichier shared/price.json

UI NUI Gestion des prix (openGestionPrixUI) : sous-menus #subGestionHabitation, #subGestionGarage, #subGestionEntrepot, #subGestionCoffre, #subGestionSecteurs. Sauvegarde → callback property:updatePrice → réécrit price.json sur disque.

Autres ratios économie (Config.Economy)

Factures F6 : 100 % vers society_realestateagent via billing ESX (pas de split agent).

Étape 4 : Catalogue des types de biens

Défini dans shared/config_property.lua : PropertyTypes (catégories UI), PropertyInterior (coords IPL intérieur), PropertyGarage (intérieurs garage + emplacements Spaces), PreviewCameras (prévisualisation création).

Shells custom : la catégorie shell est commentée en production ; l'infra (ConfigProperty.IsShell, ShellSpawn, stream ytyp) reste pour debug (testshell, tpshell). Les intérieurs actifs sont des IPL natifs.

Blips carte (Config.Blips)

Étape 5 : Créer une propriété (agent en service)

1. Prendre service (vestiaire Arcadius ou F6 realestate).
2. Ouvrir création :
   • Commande /immo
   • F6 → « Créer une propriété »
   • Point agence creation si configuré
3. NUI #creationContainer :
   • Adresse auto (rue + numéro)
   • Catégorie : habitation / garage / entrepôt / coffre
   • Type précis (habitation_2, etc.)
   • Secteur tarifaire
   • Taille stockage (sauf garage)
   • Mode placement : placer la porte dans le monde (coords sauvées)
4. Validation → property:createProperty :
   • INSERT property_list statut free
   • Register stash ox property_{id} (sauf type garage pur)
   • Refresh blips et interactions tous clients (property:refreshProperties)

Contrôles placement (Config.Controls) : E interaction, F placement mode, Entrée confirmer, Backspace annuler, Caps lock gizmo.

Étape 6 : Vente et location (agent → client)

À la porte d'un bien free, menu agent RageUI :

Crédit société : CreditCompanyAccount → priorité society_data.coffre, fallback company_accounts (surge_bank), puis esx_addonaccount. Menu patron : dépôt/retrait via surge_core:properties:moneyBoss.

Étape 7 : Expérience joueur (propriétaire, visiteur, locataire)

Approche porte (surge_interact, distance Config.Distance.PropertyInteraction = 3 m)

Accès autorisés : propriétaire (property_owner), property_access, job lié (property_jobs), crew gradé si Config.UsePsTerritory, perquisition police (grade min configurable, durée 300 s).

À l'intérieur

• Entrer → ESX:initInstance → routing bucket 1500 + property_id → téléport IPL/MLO.
• Sortir → ESX:outInstance → retour position extérieure sauvegardée.
• Coffre : point intérieur → property:openPropertyChest → ox stash (poids selon property_storage : 50k à 1M g).
• Menu H (ouvrir_menu_habitation) : colocataires, assignation job/crew, options gestion.
• Meubles : propsmenu → catalogue shared/props.json (~2000 entrées) → property:saveProp / removeProp.
• Revente propriétaire à la porte : property:sellMyProperty → 25 % prix calculé, bien repasse free.

Location et expiration

Cron serveur : si property_expiration < NOW() → statut free, propriétaire libéré. Prolongation : agent sur bien rented. Commande admin debug : property_fix_expirations.

Colocataires et partage

• Ajouter : menu H → property:addColocataire → INSERT property_access.
• Lister : property:getColocataires, property:getMyAccess.
• Assigner job coffre : property:setPropertyJob.
• Assigner crew : property:setPropertyCrew (si territoire actif).

Étape 8 : Garage de propriété

Biens de type garage_* : intérieur dédié avec emplacements définis dans ConfigProperty.PropertyGarage (coords Spaces par slot).

1. Entrée en véhicule à la porte ou depuis intérieur garage.
2. Instance bucket 1500 + property_id (même logique que habitation).
3. Ranger : property:storeVehicle → INSERT/UPDATE property_vehicles + sync owned_vehicles.
4. Sortir : property:takeOutVehicleByBucket → spawn slot, fourrière pound = property_garage si applicable.
5. Inventaires coffre véhicule : colonnes trunk, glovebox en BDD.

Les véhicules garage propriété ont propertiesID sur owned_vehicles et sont masqués des garages publics (voir système de garage).

Étape 9 : Admin citoyens et perquisitions

Panel Monde → Citoyens

Fiche joueur : liste des propriétés possédées. Action libérer bien : surge_core:admin:citizens:removeProperty (remet free, ne supprime pas la ligne property_list). Permission : monde.citizens.

Perquisition police (gameplay)

Config.Security : job police / saspn, grade minimum 6, durée 300 s. Callbacks property:isPropertyUnderSearch, property:canStartSearch. Donne accès temporaire coffre/intérieur aux forces de l'ordre.

Fichiers de configuration (référence)

Bannière NUI menus : GlobalState.ServerConfig.general.identity.banner_menu ou convars surge_banner_menu, surge_color_r/g/b/a. Pas de section ServerConfig dédiée immobilier.

Callbacks, events et commandes (référence)

Callbacks serveur principaux

Events réseau principaux

Commandes

Intégrations logs

surge_logs export EmitProperty(kind, opts) : ventes, locations, coffres, garage, création. Hook ox_inventory dans bridge_property.lua pour swaps stash propriété.

Intégration économie, société et garage public

• Billing cross-resource : surge_core détecte factures immo → déclenche property:billPaid.
• Compte société : ventes créditent society_realestateagent (menu patron Arcadius).
• Statut entreprise carte : surge_core:jobs:updateSocietyStatus.
• Garage public : véhicules propertiesID ≠ 0 exclus des UIs (lien article garage).
• Territoire illégal : id_crew + UsePsTerritory pour accès coffre crew gradé.
• Banking alternatif : Config.UsePsBanking (désactivé par défaut).

Dépannage

Ordre de configuration recommandé (récapitulatif)

1. Société : créer realestateagent (Society Manager).
2. Permissions : legal.realestate.* pour staff légal (Discord).
3. Points agence : placer gestion_prix via /gestion Immobilier.
4. Tarifs : boss configure price.json via NUI.
5. Blips : ajuster Config.Blips selon carte RP.
6. Test agent : service → /immo → créer habitation + garage test.
7. Test vente : achat, location, facture F6, sonnette, revente 25 %.
8. Test garage propriété : ranger / sortir, vérif masquage garage public.
9. Test admin : Citoyens → libérer bien.

Comment configurer le système de création de gang ?

Dernière mise à jour, 1 juillet 2026 · Par Surge Studio

Ce guide décrit l'intégralité du système d'organisations illégales sur la Base Surge : création admin et joueur, grades, recrutement, tablette F7, PNJ représentant, coffre groupe, territoires, labos, cargaisons d'armes, garage gang et intégrations missions / drogue / KOTH. La ressource centrale est surge_illegal_tablette (alias interne illegal-tablet). L'UI joueur passe par surge_ui/modules/illegal/tablet ; l'administration par surge_admin_menu (/gestion > Illégal).

Vue d'ensemble de l'architecture

1. Migration SQL install.sql (tables gangs, territoires, labos, craft armes).
2. Staff crée un groupe : /gestion > Illégal > Gestion des gangs.
3. Serveur INSERT illegal_gangs + 5 grades par défaut + stash ox illegal_gang_{id}.
4. Ajout membres : panel gang, Citoyens, ou commandes /setidgroup / /setillegal.
5. Joueur ouvre tablette F7 : carte, effectifs, missions, territoires, cargo armes.
6. PNJ représentant (rep_npc_pos) : recrutement, effectif, quitter groupe.
7. Extensions : territoires, labos, garage gang, drogues, black market, events KOTH.

Prérequis

• surge_illegal_tablette, surge_ui, surge_admin_menu, surge_core, oxmysql, ox_inventory démarrés.
• SQL exécuté : surge_illegal_tablette/sql/install.sql (+ migrations auto sv_migrations.lua).
• Staff en service (/staffservice) pour /gestion.
• Permissions Discord : hub.illegal, illegal.gangs.* (voir Discord).
• Pour garage gang : voir aussi système de garage (flotte owned_vehicles.gang).

Base de données (référence complète)

Table illegal_gangs

Tables membres et grades

Tables connexes (écosystème illégal)

Étape 1 : Migration SQL et premier démarrage

1. Exécutez surge_illegal_tablette/sql/install.sql une fois sur MySQL.
2. Redémarrez surge_illegal_tablette (migrations sv_migrations.lua complètent les colonnes).
3. Vérifiez : SELECT id, name, label, type FROM illegal_gangs;
4. Types par défaut seed : orga, gang, independant dans illegal_gang_types.

Étape 2 : Créer un gang via /gestion (workflow admin)

Chemin : /gestion > Illégal > Gestion des gangs. Page : GangsAdminPage.tsx. Modal : GangModal.tsx.

Champs modal création

1. name : identifiant technique unique (auto snake_case).
2. label : nom affiché RP.
3. type : depuis illegal_gang_types (orga / gang / indépendant ou custom).
4. color : couleur hex du groupe.
5. Coffre (optionnel) : coords x,y,z, slots, poids max.
6. PNJ représentant (optionnel) : x,y,z,h, modèle ped.
7. Valider → NUI illegal:adminCreateGang → bridge → illegal-tablet:adminCreateGang.

Côté serveur (sv_tablet.lua) : INSERT gang, INSERT 5 grades depuis Config.DefaultGrades, register stash ox illegal_gang_{id}, sync clients (coffre + PNJ).

Étape 3 : Grades par défaut et permissions

À la création, 5 grades sont insérés depuis shared/config_tablet.lua → Config.DefaultGrades :