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
- 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é.
- Copier les fichiers de
cfg_client/à la racine du serveur :server.cfg,customization.cfg,discord.cfg,resources.cfg,assets.cfgetassets_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. - Activer OneSync dans les paramètres FXServer de txAdmin avant le démarrage (sans txAdmin : dans la configuration de lancement).
ox_lib,ox_inventoryetpma-voicel’exigent. - Configurer les clés
loop_*de Discord, de boutique et de personnalisation. Certains noms historiques restent utilisés, notammentvolta_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. - Assets. Le profil standard charge les packs de
assets.cfg.core_cinematicsetfatpack6restent désactivés dansassets_optional.cfg: activez-les seulement si votre clé serveur possède leurs droits. Les assets propriétaires doivent être complets et autorisés. - Premier démarrage : vérifier que
loop_schematermine 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 consolevolta_schema. - 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.
- 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é. - Extraire le paquet dans un dossier vide, en dehors du dossier du serveur. Le client MariaDB / mysql doit être dans le PATH, et
server.cfgdoit contenir la connexionmysql://. - 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 ». - Lancer
APPLIQUER.batet donner le chemin du dossierresourcesdu 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. - 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-storageet les autres ressourcesloop-*. 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-backupssi elles sont encore chez vous, et leurs lignesensuresont 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-imageet des autresvolta-*sont recopiées dans leurs remplaçantesloop-*, y compris les marqueurs posés avecvolta-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 lignesensuresont 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 enloop_*à votre rythme, sans remplacement global : les tables SQLvolta_*et les réglagesvolta:primaryColor,volta_ui_primary_gradient,volta_pausemenu_char_slotsetvolta_bootstrap_discordgardent 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 Docs