LOOP Docs
Menu F1GuidesItems
Accueil/Installation

Installation

La procédure officielle d’installation de la base LOOP, telle que décrite dans le README.md du serveur, détaillée étape par étape.

Vous n’êtes pas hébergé chez LOOP ?

Machine, artefacts, txAdmin, envoi des fichiers avec WinSCP, création de la base MariaDB et emplacement de chaque .cfg : tout est sur Installer sa base LOOP soi-même.

Les étapes

  1. Préparer une base SQL dédiée et vide. Sauvegardez toute base existante avant une migration. loop_dev tourne sur MariaDB 11.8 ; MySQL 8 n’est pas encore validé.
  2. Copier les fichiers de cfg_client/ à la racine du serveur : server.cfg, customization.cfg, discord.cfg, resources.cfg, assets.cfg et assets_optional.cfg. Renseignez la connexion SQL, la clé Cfx et la licence LOOP dans les champs prévus. Ne partagez jamais ces secrets. Le détail de chaque ligne est sur la page Configuration.
  3. Activer OneSync dans les paramètres FXServer de txAdmin avant le démarrage (sans txAdmin : dans la configuration de lancement). ox_lib, ox_inventory et pma-voice l’exigent.
  4. Configurer les clés loop_* de Discord, de boutique et de personnalisation. Certains noms historiques restent utilisés, notamment volta_bootstrap_discord : ne faites pas de remplacement global. Renseignez ce bootstrap pour l’accès propriétaire initial, puis vérifiez les permissions en jeu.
  5. Assets. Le profil standard charge les packs de assets.cfg. core_cinematics et fatpack6 restent désactivés dans assets_optional.cfg : activez-les seulement si votre clé serveur possède leurs droits. Les assets propriétaires doivent être complets et autorisés.
  6. Premier démarrage : vérifier que loop_schema termine sans erreur. Une connexion SQL disponible ne garantit pas une migration réussie. En cas de conflit, les données sont conservées et le démarrage des ressources qui lisent la base est bloqué : résolvez le conflit avec une sauvegarde, puis lancez la commande console volta_schema.
  7. Faire la recette : connexion, création de personnage, apparition, inventaire, banque, métiers, téléphone, garage, permissions staff et boutique. Une compilation Lua réussie ne remplace pas ces essais en jeu.

Mettre à jour une base existante (vers 2.6.14)

La 2.6.14 s’installe avec le même outil depuis la 2.6.12 comme depuis la 2.6.13. Ne remplacez pas les dossiers à la main : APPLIQUER.bat reprend vos données, garde vos recettes d’artisanat et vos marqueurs, puis range les anciennes ressources sans rien supprimer.

  1. Arrêter le serveur et tout sauvegarder : le dossier complet du serveur (ressources et fichiers .cfg) et un export complet de la base SQL. L’outil refuse de tourner si FXServer est lancé.
  2. Extraire le paquet dans un dossier vide, en dehors du dossier du serveur. Le client MariaDB / mysql doit être dans le PATH, et server.cfg doit contenir la connexion mysql://.
  3. Faire une simulation : powershell -NoProfile -ExecutionPolicy Bypass -File appliquer.ps1 -Resources "C:\serveur\resources" -Simulation. Rien n’est écrit. Elle signale aussi un prérequis manquant (client mysql, server.cfg, connexion SQL, place disque). Lisez les lignes « Retraits prévus » et chaque ligne « ATTENTION ».
  4. Lancer APPLIQUER.bat et donner le chemin du dossier resources du serveur arrêté. Les mêmes prérequis sont vérifiés avant toute copie : en cas de refus, rien n’est laissé dans le dossier du serveur.
  5. Démarrer et faire la recette : console sans SCRIPT ERROR, puis connexion, personnage, inventaire, téléphone, garage, permissions staff et boutique avant d’ouvrir aux joueurs.

Depuis la 2.6.13

  • Vos données restent dans loop-storage et les autres ressources loop-*. Vos recettes d’artisanat (ox_inventory/data/crafting.lua) et vos marqueurs (loop-f1/modules/loop-markers/data) sont gardés.
  • Six anciennes ressources qui ne sont plus livrées sont rangées dans loop-update-backups si elles sont encore chez vous, et leurs lignes ensure sont retirées des fichiers .cfg, qui gardent leur encodage (ANSI, UTF-8 ou UTF-16).
  • Le pack de props des propriétés (housing_props) est posé s’il manque : sans lui, la base ne démarrait pas.
  • Pour utiliser /ecrandiag, accordez sa permission (Commandes › Outils de développement) aux rangs staff voulus dans F1 › Administration › Permissions : une permission neuve n’est accordée à personne.

Depuis la 2.6.12

  • Les données de volta-data, volta-permissions, volta-f1, volta-boutique, volta-image et des autres volta-* sont recopiées dans leurs remplaçantes loop-*, y compris les marqueurs posés avec volta-f1, sans jamais écraser un fichier déjà présent.
  • Les 39 ressources qui n’existent plus sont rangées dans loop-update-backups (rien n’est supprimé) et leurs lignes ensure sont retirées des fichiers .cfg.
  • Les anciens noms volta_* de vos fichiers .cfg (Discord, présence, boutique, Tebex, banque, plaques, nom et logo du serveur) restent lus. Renommez-les en loop_* à votre rythme, sans remplacement global : les tables SQL volta_* et les réglages volta:primaryColor, volta_ui_primary_gradient, volta_pausemenu_char_slots et volta_bootstrap_discord gardent leur nom.

Retour arrière : arrêtez le serveur, remettez votre sauvegarde (ou les dossiers rangés dans loop-update-backups), puis la base si besoin. Les ajouts SQL de la mise à jour n’empêchent pas l’ancienne version de démarrer. Avec l’hébergement LOOP, la mise à jour se fait depuis le panel quand elle y est proposée.

Arborescence des ressources

Dossier Contenu
Ressources de base FiveM (spawnmanager, sessionmanager, hardcap, chat...) et bibliothèques (oxmysql, bob74_ipl, cron).
es_extended et ses modules.
ox_lib, ox_inventory, ox_target.
Toute la base LOOP : loop-f1, loop-core, loop-menu, loop-world, loop-data, loop-storage, loop-ui, loop-permissions, les modules métier, phone...
Streams : véhicules, maps, peds, vêtements, sons.
LoopProtect Anticheat (chargé par loopprotect.cfg).
loop-root Ancien module de protection, désactivé depuis le 14/09/2026.

La liste complète des 324 ressources est sur la page Ressources.

Où sont les données

Données Emplacement
Contenu du monde (markers, actions, conditions, boutiques, crafts, zones, portes, propriétés...)
Définition des items
Rangs et catalogue de permissions
Joueurs, personnages, véhicules, comptes Base SQL (tables volta_*, noms historiques)

Ne pas éditer à chaud

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