LOOP Docs
Menu F1GuidesItems
Accueil/Configuration

Configuration du serveur

Le serveur LOOP se configure dans quelques fichiers .cfg à la racine (/home/debian/loop_dev sur loop_dev) puis, en jeu, dans le F1. Cette page reprend chaque fichier livré dans cfg_client/ (les modèles distribués aux clients) et explique chaque ligne. Toutes les valeurs secrètes sont remplacées par xxxx.

Ce qui ne doit jamais sortir du serveur

La clé Cfx (sv_licenseKey), la licence LOOP (loop_license), la chaîne SQL (mysql_connection_string), le token du bot Discord (loop_discord_token), les clés Fivemanage et le jeton de boutique. Ne les collez jamais dans Discord, un ticket ou une capture d’écran. Utilisez set (lu par le serveur seul), jamais setr pour un secret.

Ordre de chargement

  1. txAdmin lance FXServer avec server.cfg. OneSync doit être activé dans les paramètres FXServer de txAdmin (pas dans le fichier : le validateur de txAdmin le refuse). ox_lib, ox_inventory et pma-voice l’exigent.
  2. server.cfg pose les réglages techniques puis appelle exec customization.cfg et exec discord.cfg.
  3. Il se termine par exec resources.cfg : tous les réglages doivent être lus avant que les ressources démarrent, sinon elles prennent leurs valeurs par défaut.
  4. Au démarrage, loop_schema applique les migrations SQL. Tant qu’il n’a pas terminé, les ressources qui lisent la base attendent (loop_schema_required 1).

server.cfg

cfg_client/server.cfg (88 lignes)
Réglage Rôle
loop_schema_required 1, loop_schema_timeout 120000 Les ressources attendent la fin des migrations SQL (jusqu’à 120 s). En cas de conflit, les données sont conservées et le démarrage des consommateurs SQL est bloqué : résoudre avec sauvegarde, puis commande console volta_schema.
endpoint_add_tcp / Port d’écoute du serveur (10013 sur loop_dev).
sv_licenseKey Clé Cfx.re du serveur (portail Cfx). Secrète.
loop_license Licence LOOP : autorise le démarrage des modules gérés. Secrète.
mysql_connection_string Connexion à la base MariaDB (forme mysql://xxxx). Secrète. Les autres mysql_* règlent l’interface et les alertes de requêtes lentes d’oxmysql.
sv_enforceGameBuild 3570 Version du jeu imposée (DLC disponibles). Tous les joueurs chargent cette build.
sv_maxclients 48 Nombre de places.
set event_size 1048576 Taille maximale d’un événement réseau (1 Mo).
sv_authMinTrust 1 Niveau de confiance minimum des comptes Cfx.
sv_requestParanoia 3 Contrôle maximal des requêtes entrantes.
sv_master1 "" Serveur retiré de la liste publique (vide = privé).
sv_pureLevel 0 Mods graphiques client tolérés (1 = bloqués : décision visible par les joueurs).
resources_useSystemChat false Le chat de base est remplacé par celui de LOOP.
voice_* pma-voice : animation radio coupée, audio natif, portée d’émission seulement, rafraîchissement 300 ms.
esx:locale, illenium-appearance:locale, locale Langue française.
add_ace / add_principal Droits ACE de base (group.admin). La ligne identifier.discord:xxxx donne le groupe admin à votre compte Discord. Les vrais droits staff passent par loop-permissions.
inventory:* Réglages d’ox_inventory : 50 slots, 50 kg, groupes police (police, bcso), images, flou, notifications, props au sol, comptes money et black_money, nettoyage des coffres après 6 mois. Les convars explicites sont prioritaires sur .
increase_pool_size Agrandit les réservoirs du moteur pour les nombreuses maps et véhicules (textures, modèles, intérieurs, animations).
setr disconnected_chars 1 Les personnages déconnectés restent visibles quelques instants.
exec resources.cfg Toujours en dernier.

resources.cfg

Version réellement utilisée sur loop_dev

customization.cfg

Réglage Rôle
sv_hostname, sv_projectName, sv_projectDesc, tags, Owner, Discord Fiche publique du serveur dans la liste FiveM.
load_server_icon "icon.png" Icône 96×96 de la liste des serveurs.
loop:serverName Nom affiché par toutes les interfaces (F1, pause, HUD).
loop:serverLogoUrl Logo des menus. Utilisez un hébergement durable : un lien de pièce jointe Discord expire.
volta:primaryColor "231, 216, 194" Couleur principale (R, G, B) : interface et couleur par défaut des markers.
volta_ui_primary_gradient Dégradé de la couleur principale (0 = couleur unie).
loop:clothesImgUrl, loop:vehicleImgUrl Adresse des images de vêtements et de véhicules (vide = images locales).
volta_bootstrap_discord Identifiant Discord qui reçoit l’accès propriétaire au premier démarrage. Nom historique : ne pas le renommer.
loop_perm_discord true : rangs pilotés par les rôles Discord ; false : rangs manuels (/setpermission).
loadscreen_* Écran de chargement : nom, vidéo, statut, liens Discord, TikTok, guide.
loop_boutique_url, loop_boutique_token (ancien nom volta_boutique_token encore lu) Boutique en ligne et son jeton (secret).
FIVEMANAGE_MEDIA_API_KEY, phone_fivemanage_api_key*, LPMDT_FIVEMANAGE_API_KEY Clés d’hébergement des photos et vidéos (téléphone, MDT, studio). Secrètes.
loop_cash_item "money" Item qui représente l’argent liquide.
loop_bank_name, loop_shop_name, loop_shop_currency Libellés de la banque (Fleeca) et de la boutique (devise Coins).
loop_tebex_url, loop_battlepass_enabled Lien Tebex et passe de combat.
loop_plate_prefix "VLT" Préfixe des plaques générées (concessionnaire, locations).
non_roleplay, money_dm, money_l Préréglages de mode de jeu (0/1).

discord.cfg

cfg_client/discord.cfg (90 lignes)

Points clés : la base parle à Discord par son API, sans bot connecté ; l’application n’apparaît jamais « en ligne » et c’est normal. Tant que loop_discord_token et loop_discord_guild sont vides, toute la partie Discord est désactivée sans rien bloquer. loop_discord_require_guild 1 impose d’être membre du Discord pour se connecter : à activer seulement après avoir rempli token et guilde. loop_discord_strict doit rester à 0 (sinon une panne de Discord ferme le serveur). loop_discord_reaction_mode choisit qui paie les réactions aux annonces : menu (défaut), bot ou off ; ne lancez jamais le bot en laissant menu, sinon le joueur est payé deux fois. loop_discord_ranks règle seulement les badges visibles en jeu, pas les droits.

hardening.cfg

hardening.cfg (74 lignes)

Ce fichier durcit le moteur : ScriptHook interdit, explosions de téléphone en réseau coupées, gestionnaire d’événements de jeu expérimental activé, paranoïa des requêtes au maximum. Les lignes commentées documentent ce qui n’est pas appliqué et pourquoi (chaque option casserait quelque chose de mesuré dans la base). Retour arrière : commenter exec hardening.cfg dans server.cfg.

loopprotect.cfg et assets

Réglages en jeu

Une fois le serveur lancé, plus rien ne passe par les fichiers :

Quoi Où
Prix, braquages, concessionnaire, boutiques, économie F1 › Administration › Réglages du serveur (panneau loop-reglages) et Gestion économique › Variables
Styles des interfaces (F1, pause, HUD...) de , voir Interfaces
Rangs et droits F1 › Administration › Permissions
Tout le contenu du monde F1 › Administration : markers, actions, conditions, zones, propriétés, groupes...

Le registre complet des convars lues par le code est sur la page Convars.

LOOP Studios · documentation générée depuis le serveur loop_dev le 22/10/2026 · accueil · Raccourci : Ctrl K