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
- 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_inventoryetpma-voicel’exigent. server.cfgpose les réglages techniques puis appelleexec customization.cfgetexec discord.cfg.- 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. - Au démarrage,
loop_schemaapplique 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 Docs