Un terme que tu ne comprends pas dans un chapitre ? Il est ici, défini en une phrase. Une question qui revient sur le Discord ? Elle est dans la FAQ, avec une réponse courte et le chapitre qui détaille.
Glossaire #
Les termes sont classés par ordre alphabétique.
ACE : règle d'autorisation de FXServer (add_ace <qui> <quoi> allow|deny) qui donne ou refuse un droit à un principal, par exemple add_ace group.admin command allow.
Additional Server Settings : réglage AMP (Configuration → FiveM) qui ajoute une ligne par réglage à la fin du server.cfg généré ; les ConVars lues au démarrage d'une ressource vont plutôt en tête de Starting Resources.
Adminer : l'interface web de ta base de données (db.teamkit.fr), ouverte par un lien pré-rempli du tableau de bord teamkit.fr, pour importer un .sql, regarder les tables et exporter.
AMP : le panel web (amp.teamkit.fr) qui pilote ton serveur, page par page : Status, Console, File Manager, Configuration, Backups, Schedule, Updates, SFTP.
Artefact : le programme FXServer lui-même, téléchargé par AMP dans server/ selon le Server Build choisi (Recommended, Optional, Latest, Critical ou une URL précise).
Backups : page AMP qui crée et restaure des sauvegardes des fichiers de l'instance, sans la base de données.
cfx-server-data : le dépôt officiel des ressources de base de FiveM (chat, spawnmanager, mapmanager, sessionmanager, hardcap…), cloné par AMP dans server-data/resources/ à l'installation.
Chaîne de connexion : la ligne mysql://UTILISATEUR:MOT_DE_PASSE@HOTE:PORT/BASE?charset=utf8mb4 que lit oxmysql pour joindre ta base ; elle se règle par set mysql_connection_string "...".
Clé Cfx.re : la clé d'enregistrement de ton serveur (portal.cfx.re/servers/registration-keys), liée à l'adresse IP du serveur, obligatoire pour démarrer et pour apparaître dans la liste ; elle porte aussi tes achats escrow.
Console : page AMP branchée sur la console FXServer, où tu lis la sortie du serveur et tapes des commandes comme ensure ou status.
ConVar : une variable de configuration de FXServer, posée par set (serveur), setr (répliquée aux clients) ou sets (publiée dans la liste des serveurs), lue par le serveur ou par les scripts.
Deferral : mécanisme de l'événement playerConnecting qui met une connexion en attente (deferrals.defer()), affiche un message (update), puis accepte (done()) ou refuse (done("motif")) le joueur ; base de toute whitelist.
Dépendance : ressource qui doit tourner avant une autre (ox_lib avant ce qui l'utilise, oxmysql avant le framework), ce qui impose l'ordre des ensure.
Ensure : commande console qui démarre une ressource arrêtée ou la redémarre si elle tourne ; une ligne ensure <res> par ressource dans Starting Resources.
Escrow : protection Cfx.re qui chiffre les fichiers d'un script acheté et ne le laisse démarrer que sur le serveur dont la clé a reçu l'autorisation ; sinon « You lack the required entitlement ».
ESX : le framework RP le plus ancien et le plus répandu en France (es_extended + esx_*), en version Legacy sur ox_lib et oxmysql.
F8 : la touche qui ouvre la console du joueur dans FiveM, où l'on tape connect, resmon 1, netgraph 1 et où l'on lit les erreurs côté client.
File Manager : page AMP qui montre l'arborescence de l'instance (dossiers server/ et server-data/), avec éditeur de texte, upload, création de dossiers et décompression d'archives.
Framework : la ressource centrale qui gère personnages, argent, métiers et inventaire, et sur laquelle tous les autres scripts s'appuient : ESX, QBCore ou Qbox.
fxmanifest.lua : le fichier à la racine de chaque ressource qui déclare ses scripts client et serveur, ses fichiers, ses dépendances et son provide ; modifié, il exige refresh puis restart.
Game build : la version du jeu GTA V que le serveur impose aux clients (réglage Enforce Game Build : 1604 par défaut, jusqu'à 3751) ; les DLC récents et certains véhicules en dépendent.
Instance : ton serveur tel qu'AMP le voit : un conteneur avec ses fichiers, son port 30120, ses réglages et ses pages.
Keymaster : l'ancien nom de l'espace Cfx.re (keymaster.fivem.net) où l'on enregistre ses serveurs et où l'on retrouve ses assets ; aujourd'hui portal.cfx.re fait le même travail.
MariaDB : le moteur de base de données recommandé par TeamKit pour FiveM, parce que MySQL 8.4 refuse quatre constructions courantes des packs (DEFAULT sur TEXT, ADD COLUMN IF NOT EXISTS, ADD INDEX IF NOT EXISTS, mot réservé STORED).
MLO : un intérieur ajouté à la carte, diffusé en streaming comme une ressource, souvent payant et sous licence « un achat par serveur ».
OneSync : le mode de synchronisation côté serveur (OneSync Mode : Off, On, Legacy), obligatoire au-delà de 32 joueurs.
oxmysql : la ressource qui relie tes scripts à la base de données via la chaîne de connexion ; référence actuelle pour ESX moderne, QBCore et Qbox.
ox_inventory : l'inventaire de l'écosystème ox (overextended.dev), utilisé par Qbox et en option par ESX et QBCore ; ses ConVars inventory:* se lisent au démarrage.
ox_lib : la bibliothèque de fonctions partagées de l'écosystème ox (menus, notifications, callbacks, locale ox:locale), à démarrer avant tout ce qui l'utilise.
ox_target : le système d'interaction « viser un objet et cliquer » de l'écosystème ox, requis par Qbox et par beaucoup de scripts récents.
Principal : l'entité à qui s'applique une ACE : un joueur (identifier.license:XXXX), un groupe (group.admin), une ressource ; add_principal rattache l'un à l'autre.
Pure mode : le réglage sv_pureLevel (Block Modified Client Files) qui refuse les joueurs aux fichiers de jeu modifiés : 1 tolère l'audio et les mods graphiques connus, 2 bloque tout.
QBCore : framework RP très répandu dans le monde anglophone (qb-core + qb-*), dépendant d'oxmysql, avec qb-inventory ou ox_inventory.
Qbox : fork moderne de QBCore (qbx_core + qbx_*) bâti sur ox_lib, ox_inventory, ox_target et oxmysql, compatible avec la plupart des scripts QBCore via un pont.
RCON : le protocole de commande à distance de FXServer ; inutile chez TeamKit puisque la page Console d'AMP parle directement au serveur.
Refresh : commande console qui relit le dossier resources/ et tous les manifestes ; obligatoire après l'ajout d'une ressource ou la modification d'un fxmanifest.lua.
resmon : le moniteur de ressources de la console F8 (resmon 1) qui affiche la charge CPU et mémoire de chaque ressource chez le joueur.
Ressource : un dossier dans resources/ contenant un fxmanifest.lua et des scripts ou des fichiers ; le nom du dossier est le nom de la ressource.
Sauvegarde : chez TeamKit, trois niveaux : les Backups AMP (fichiers, sur la machine), l'export .sql de la base, et la copie sur ton PC, seule à survivre à la suppression de l'instance.
Schedule : page AMP des tâches planifiées : un déclencheur (heure fixe, intervalle) et des tâches (redémarrer, sauvegarder, envoyer une commande console).
server.cfg : le fichier de configuration lu par FXServer ; chez TeamKit il est généré par AMP à chaque démarrage à partir de Configuration, donc jamais édité à la main.
SFTP : le transfert de fichiers sécurisé vers ton instance, avec ton compte AMP, sur le port propre à l'instance (Status → Connection Info), via FileZilla ou WinSCP.
Starting Resources : réglage AMP (Configuration → FiveM) où chaque ligne est écrite dans server.cfg : les set/setr en tête, puis les ensure dans l'ordre des dépendances.
Stream : le mécanisme qui envoie aux clients les fichiers de jeu d'une ressource (dossier stream/ : modèles, textures, cartes), utilisé par les MLO, véhicules et vêtements ajoutés.
Tebex : le partenaire de vente officiel de FiveM, par lequel passent la plupart des boutiques de scripts et la boutique de ton propre serveur (sv_tebexSecret).
txAdmin : le panneau d'administration livré avec FXServer ; absent chez TeamKit, où AMP tient ce rôle (console, planification, sauvegardes, mises à jour).
Watchdog (chien de garde) : l'automatisme TeamKit qui relance un serveur planté s'il est inscrit dans la liste par le staff ; pour FiveM, il vérifie http://ADRESSE:30120/info.json.
Whitelist : la liste des joueurs autorisés à se connecter, appliquée par un script au moment de playerConnecting (par ACE ou par base de données).
Wipe : la remise à zéro de la base de données (personnages, argent, véhicules), décidée par toi avant une ouverture, après un export .sql de sécurité.
YMAP : un fichier de carte streamé qui place des objets dans le monde (props, décor), souvent livré avec un MLO.
FAQ #
1. Puis-je avoir txAdmin ? Non. Chez TeamKit, AMP remplace txAdmin : la console est dans la page Console, la planification dans Schedule, les sauvegardes dans Backups, les mises à jour dans Updates. Il n'y a pas de « recipe » : on installe son framework à la main (chapitres 03 à 05).
2. Où est mon server.cfg ?
Dans server-data/server.cfg, mais ne l'édite pas : AMP le régénère à chaque démarrage à partir de Configuration. Tout ce que tu y écrirais serait perdu. Passe par Starting Resources et Additional Server Settings (chapitre 07).
3. Pourquoi mon serveur n'apparaît pas dans la liste ?
Cinq causes : Project Name non conforme (tags, majuscules abusives), clé Cfx.re absente ou enregistrée avec une autre IP, port bloqué, sv_master1 "" par erreur, ou zéro joueur depuis longtemps. Vérifie dans cet ordre (chapitre 08).
4. Combien de joueurs max ? Player Limit vaut 32 par défaut. Au-delà, OneSync est obligatoire. La limite réelle dépend de tes scripts et du CPU plafonné du conteneur : monte par paliers en lisant CPU et RAM dans Status (chapitre 10).
5. Puis-je changer de framework ?
Oui, mais c'est une réinstallation : les scripts et la base ne sont pas compatibles entre ESX, QBCore et Qbox. Exporte ta base, garde une copie de resources/, vide Starting Resources et repars du chapitre d'installation. Qbox accepte beaucoup de scripts QBCore via son pont (chapitre 02).
6. Mon script acheté dit « license invalid » ou « You lack the required entitlement ». Le script est accordé à un compte ou une clé Cfx.re qui n'est pas celle de ton serveur. Connecte-toi sur portal.cfx.re avec le compte qui a acheté, vérifie que ta clé actuelle est bien celle enregistrée et retélécharge l'asset pour ce serveur (chapitre 10).
7. Comment donner l'admin à un ami ?
Lis sa licence dans la console au moment où il se connecte, puis ajoute dans Configuration → FiveM → Access Control Commands : add_principal identifier.license:SA_LICENCE group.admin (avec add_ace group.admin command allow déjà présent). Redémarre l'instance. Pour un accès au panel, crée-lui un sous-compte depuis teamkit.fr (chapitre 01).
8. Mon serveur a été supprimé pour inactivité, que faire ?
L'instance et ses sauvegardes AMP ont disparu avec elle. Si tu as une copie de resources/ et un export .sql sur ton PC, refais une demande sur teamkit.fr et réinstalle depuis tes copies. Sinon, tu repars de zéro : c'est pour ça que la copie sur ton PC est la seule qui compte.
9. Comment me connecter à mon serveur ?
Lance FiveM, appuie sur F8, tape connect ADRESSE:30120 avec l'adresse affichée sur ton tableau de bord teamkit.fr. Le serveur doit être démarré et sa console avoir affiché le message de fin de chargement.
10. J'ai modifié Configuration mais rien ne change.
Redémarre l'instance depuis Status. Le server.cfg n'est régénéré qu'au démarrage ; un refresh en console ne suffit pas.
11. Mon serveur redémarre en boucle. Lis les premières lignes rouges de la console : clé Cfx.re absente ou invalide, chaîne de connexion fausse (1045 ou ECONNREFUSED), ou une ressource qui plante au chargement. Retire les derniers ajouts de Starting Resources un par un (chapitre 08).
12. Erreur « ER_ACCESS_DENIED_ERROR 1045 » ou « ECONNREFUSED ». 1045 : utilisateur, mot de passe ou hôte faux dans la chaîne de connexion (le mot de passe est celui de ton compte AMP). ECONNREFUSED : hôte ou port faux ; le port n'est pas 3306 mais celui affiché sur le tableau de bord (chapitre 06).
13. Mon .sql ne s'importe pas.
Si l'erreur cite DEFAULT sur TEXT, IF NOT EXISTS ou STORED, ta base est sur MySQL 8.4 : demande au staff une base MariaDB, recommandée pour FiveM. Ce n'est pas un bug du pack (chapitre 06).
14. Puis-je changer le port 30120 ? Non. Le port est attribué par TeamKit et une seule instance peut l'utiliser. Laisse Server Port tel quel.
15. Quelle différence entre set, setr et sets ?
set pose une variable serveur, setr la réplique aux clients (les scripts client la lisent), sets la publie dans la liste des serveurs. Les trois vont en tête de Starting Resources, avant le premier ensure (chapitre 07).
16. Puis-je installer un bot Discord ou un autre programme sur la machine ? Pas dans ton instance FiveM : tu n'as accès qu'aux fichiers du serveur, pas au dédié. Un bot Discord se fait héberger ailleurs ; demande au staff sur le Discord TeamKit si un hébergement de bot est proposé.
17. Le serveur lag, c'est TeamKit ?
Regarde d'abord Status (CPU et RAM), puis demande aux joueurs resmon 1 et netgraph 1. Une ressource en tête chez tout le monde est en cause ; un seul joueur avec du ping a un problème de connexion (chapitre 10).
18. Où sont les logs ?
La console AMP garde les dernières lignes. Pour l'historique, File Manager → dossier AMP_Logs de l'instance. Côté joueur, la console F8 (chapitre 08).
19. Comment mettre à jour FiveM ? Configuration → Updates → Server Build (Recommended par défaut), puis sauvegarde, arrêt, bouton Update dans Status, redémarrage. Latest seulement si une ressource l'exige (chapitre 09).
20. Qui contacter et avec quoi ? Le Discord TeamKit, avec : ce que tu as changé, un extrait de la console autour de la première ligne rouge, et ta liste Starting Resources. Une capture floue d'un écran noir ne permet pas de t'aider (chapitre 08).