En bref
| Élément | Ce qu'il faut |
|---|---|
| Système | Windows (machine ou VPS). L'agent du panel pilote le serveur avec les outils Windows (PowerShell, FXServer.exe). |
| Serveur FiveM | L'artifact Windows (FXServer.exe) et une clé de licence FiveM (portal.cfx.re › Server Keys). |
| OneSync | Obligatoire : set onesync on. |
| Build du jeu | Libre : le server.cfg livré n'en impose aucun (voir plus bas). |
| Base de données | MariaDB recommandé ; MySQL accepté. |
| Framework | ESX (es_extended), livré avec la base. |
| Node.js | Node.js 20 ou plus (version LTS), pour l'agent qui relie le serveur au panel. |
Artifact FiveM
La vérification d'installation (verifier-installation.ps1) cherche FXServer.exe dans un dossier artifact\ placé à côté du dossier du serveur ; l'agent, lui, utilise le chemin indiqué dans son config.json. Seul l'artifact Windows est pris en charge.
OneSync
OneSync doit être activé. Le server.cfg livré contient :
# Hors txAdmin : onesync doit être activé ici (pma-voice l'exige).
set onesync onAvec txAdmin, active OneSync dans les réglages de txAdmin : la ligne de server.cfg est alors ignorée.
OneSync est aussi ce qui permet au serveur de lire lui-même la position des joueurs : toutes les vérifications de distance de Socle (et Placer en jeu) en dépendent.
Build du jeu
Le server.cfg livré ne contient pas de sv_enforceGameBuild : le serveur tourne sur le build par défaut de FiveM. Tu peux en imposer un dans Visuel › Informations › Identité › Game build (build par défaut, 2189, 2372, 2545, 2612, 2699, 2802, 2944, 3095, 3258 ou 3323) ; le changement demande un redémarrage.
Base de données
| Point | Détail |
|---|---|
| Moteur | MariaDB (Socle est développé sur MariaDB 10.11). MySQL est accepté ; compatibilité complète à confirmer. |
| Connexion | mysql_connection_string dans server.cfg, forme mysql://utilisateur:motdepasse@hôte:3306/base?charset=utf8mb4. |
| Encodage | utf8mb4. |
| Import initial | install/base.sql, à importer avec HeidiSQL ou mariadb < base.sql (voir Installation). |
| Évolutions | Les tables se mettent à jour toutes seules au démarrage du serveur. |
Version minimale de MariaDB : à confirmer.
Dépendances livrées
Ces ressources open source sont livrées en clair (hors escrow), avec leur licence (fichier THIRD-PARTY-NOTICES.txt). Garde les versions livrées : Socle a été préparé avec elles, et une autre version n'est pas garantie compatible.
| Domaine | Ressources |
|---|---|
| Base de données et outils | oxmysql, ox_lib, PolyZone, yarn, webpack, chat, screenshot-basic |
| Framework ESX | es_extended, skinchanger, esx_skin, esx_status, esx_basicneeds, esx_billing |
| Inventaire et ciblage | ox_inventory, ox_target |
| Voix, son, intérieurs | pma-voice, xsound, bob74_ipl |
La ressource socle refuse de démarrer sans oxmysql, ox_lib, es_extended et ox_inventory (déclarées dans son fxmanifest.lua).
Les ressources de Socle elles-mêmes (protégées par l'escrow Cfx) : socle, core, banking, cardealer, ltd, order-system, interactions, radio, territory, atmheist, fleecaheist.
L'ordre de démarrage est donné par server_resources.cfg (dépendances d'abord, puis socle, puis core et les autres). Les vérifications de démarrage du panel signalent toute ressource listée dans ce fichier mais absente du dossier resources.
Ce qui n'est pas livré
- lb-phone : pas de téléphone dans Socle, et Socle n'en dépend pas.
- OmniShield : produit séparé, inclus ou non selon ton offre.
Vérifier une installation
Le paquet livré contient verifier-installation.ps1, qui contrôle notamment la présence de FXServer.exe, la connexion à la base et son import, avant le premier démarrage. Le panel refait des contrôles semblables avant chaque lancement : voir Les vérifications de démarrage.