Installer la Base KLMSTUDIO

Ce guide décrit l'installation actuelle de la Base KLMSTUDIO. Suivez l'ordre indiqué : il évite la majorité des erreurs de démarrage, de licence et de base de données.

Avant de commencer

Vous devez disposer de :

• Windows Server ou Linux compatible avec les artefacts FiveM récents ;
• une clé serveur créée sur le portail Cfx.re ;
• OneSync activé ;
• MySQL ou MariaDB avec une base vide et un utilisateur autorisé à la modifier ;
• un accès au panel KLMSTUDIO ;
• la dernière archive téléchargée depuis la rubrique Téléchargements du panel.

Arborescence attendue

Placez les ressources dans le dossier resources de votre serveur. Le core doit conserver exactement ce nom :

resources/
├── [base]/
├── [clothes]/
├── [essential]/
├── [system]/
├── [vocal]/
└── [cfx lock]/
    ├── [stream]/
    └── [klmstudios]/
        ├── core/
        ├── discord/
        ├── es_extended/
        ├── imagecapture/
        ├── ox_inventory/
        ├── web/
        └── web2/

Les crochets font partie du nom des dossiers. N'ajoutez pas un niveau resources supplémentaire lors de l'extraction.

Importer la base de données

1. Créez une base en utf8mb4.
2. Importez le SQL fourni avec la version téléchargée.
3. Vérifiez qu'aucune requête n'a échoué.
4. Configurez la connexion dans le fichier principal du serveur.

set mysql_connection_string "mysql://UTILISATEUR:MOT_DE_PASSE@HOTE/NOM_DE_LA_BASE?charset=utf8mb4"

Le core applique ensuite ses migrations de module au démarrage. N'importez pas à nouveau un ancien dump sur une base déjà utilisée.

Configuration minimale

Dans server.cfg ou dans un fichier exécuté par celui-ci :

sv_licenseKey "VOTRE_CLE_CFX"
set onesync on
setr klmstudios_license_key "VOTRE_CLE_KLMSTUDIOS"

ensure oxmysql
ensure ox_lib
ensure core

exec @core/configs/panel_server.cfg

core/configs/panel_server.cfg est généré et mis à jour depuis le panel. Ne recopiez pas son contenu dans plusieurs fichiers : la dernière valeur chargée gagnerait et rendrait le diagnostic difficile.

Ordre de démarrage

Respectez ces dépendances :

1. ressources Cfx et builders ;
2. oxmysql et ox_lib ;
3. framework et inventaire fournis ;
4. core ;
5. interfaces, bot Discord, maps, vêtements et ressources additionnelles ;
6. zs-phone-props, puis zs-phone si le téléphone est installé.

Vous pouvez démarrer un dossier avec ensure [nom-du-dossier], à condition que son contenu respecte lui-même cet ordre.

Premier démarrage

Au premier lancement :

1. surveillez la console jusqu'au message de démarrage du core ;
2. vérifiez la validation de la licence ;
3. laissez les migrations SQL se terminer ;
4. ouvrez le panel et associez le serveur à la bonne licence ;
5. enregistrez la configuration générale ;
6. redémarrez une fois le serveur si panel_server.cfg vient d'être créé.

Vérifications rapides

Une installation correcte répond à ces critères :

• aucune erreur No such export dans la console ;
• connexion SQL établie avant le démarrage du core ;
• licence KLMSTUDIO reconnue ;
• OneSync actif ;
• personnage créé puis chargé sans écran bloqué ;
• inventaire, HUD et menu principal accessibles ;
• configuration du panel reçue par le serveur.

En cas d'échec

Consultez ensuite la section Diagnostic et erreurs avec le message complet de la console.