Référence de configuration de la Base
La Base utilise deux sources de configuration : le panel pour les réglages dynamiques, et les fichiers Lua pour les catalogues ou systèmes avancés. Cette page permet de savoir immédiatement où intervenir.
Configuration générale
| Besoin | Source actuelle | Redémarrage conseillé |
|---|---|---|
| Identité et listing FiveM | Panel, section Général | serveur |
| Logos, couleurs et visuels | Panel, section Visuels | reconnexion |
| Écran de connexion | Panel, section Écran de connexion | prochaine connexion |
| Menus et RageUI | Panel, sections Menus et RageUI | reconnexion |
| Markers et densité | Panel | non, sauf incohérence |
| Menu pause et Rich Presence | Panel | reconnexion |
| Modules et Gameplay RP | Panel | serveur |
| HUD, AFK, boutique et loading screen | éditeurs dédiés du panel | selon l'éditeur |
| Clé de licence | server.cfg ou fichier .cfg exécuté | serveur |
| Logs du core | core/configs/general/logs.lua | core |
| Options générales non exposées | core/configs/general/config.lua | core |
Fichiers par système
Les chemins sont relatifs au dossier core.
| Famille | Emplacement |
|---|---|
| Addons | configs/addons/<module>/ |
| Métiers | configs/jobs/<job>/ |
| Police | configs/jobs/police/config.lua |
| Ambulance | configs/jobs/ambulance/config.lua |
| Concessionnaire | configs/jobs/concessionnaire/Config.lua |
| Mécano | configs/jobs/mecano/sh_config.lua |
| Justice | configs/jobs/justice/sh_main.lua |
| LTD | configs/jobs/ltd/config.lua |
| Drogues avancées | configs/addons/drugsystem/ |
| Groupes illégaux | configs/addons/groups/config_groups.lua |
| Inventaire | configs/addons/inventory/sh_config.lua |
| Personnage et vêtements | configs/addons/character/ et configs/addons/skins/ |
| Boutique | configs/addons/boutique/sh_config.lua et panel |
| CDN | configs/addons/cdn/sh_config.lua |
Le nom exact du fichier varie selon le module (sh_config.lua, config.lua, _shared.lua ou cfg_main.lua). Utilisez le fichier fourni dans le dossier du module ; ne créez pas un deuxième fichier portant un autre nom.
Comment lire une configuration
Les fichiers utilisent des tables Lua :
Config.Exemple = {
Enabled = true,
Price = 250,
Jobs = { 'police', 'ambulance' },
}| Type | Exemple | Attention |
|---|---|---|
| booléen | true, false | sans guillemets |
| nombre | 250, 1.5 | point pour les décimales |
| texte | 'police' | guillemets obligatoires |
| liste | { 'a', 'b' } | virgule entre les valeurs |
| coordonnées | vector3(x, y, z) | ordre X, Y, Z |
| coordonnées orientées | vector4(x, y, z, h) | h est l'orientation |
Une erreur de syntaxe empêche le fichier ou la ressource de se charger. Après modification, recherchez immédiatement une erreur Lua dans la console.
Méthode sûre
- Identifiez si le réglage appartient au panel ou à un fichier.
- Sauvegardez uniquement le fichier concerné.
- Modifiez une seule famille de valeurs à la fois.
- Vérifiez les virgules, accolades et guillemets.
- Redémarrez la ressource concernée hors production, ou le serveur si le module initialise des données.
- Contrôlez la console et testez le parcours complet.
Valeurs dynamiques
Le panel transmet une partie des réglages sous forme de convars et de sections dynamiques. Les profils Gameplay RP alimentent notamment les NumberVars du core. Pour ces valeurs, le panel est prioritaire : une modification directe dans le code serait écrasée ou ignorée.
Mise à jour
Lors d'une mise à jour :
- comparez vos fichiers personnalisés avec ceux de la nouvelle archive ;
- ne remplacez pas un nouveau fichier par votre ancienne version complète ;
- reportez seulement vos valeurs ;
- conservez les nouvelles clés ajoutées par KLMSTUDIO ;
- laissez les migrations SQL du core s'exécuter.