Installation sur un hébergeur

Utilisez ce guide si votre base FiveM doit tourner directement sur un hébergeur avec panel, gestionnaire de fichiers, FTP ou SFTP.

Prérequis

• Une offre FiveM active chez votre hébergeur
• Une base MySQL ou MariaDB créée chez l'hébergeur ou sur un service externe
• Un accès au gestionnaire de fichiers, FTP ou SFTP
• Votre clé Cfx.re
• Votre clé API KLMSTUDIO
• Les fichiers de votre base déjà récupérés
• Un dossier resources déjà préparé dans la bonne arborescence

Étapes d'installation

1. Préparer l'hébergement

Avant d'importer quoi que ce soit :

1. Créez votre serveur FiveM chez l'hébergeur.
2. Vérifiez que vous avez accès au gestionnaire de fichiers ou au FTP.
3. Créez votre base MySQL ou MariaDB.
4. Notez les informations de connexion :

• hôte SQL
• port SQL
• nom de la base
• utilisateur SQL
• mot de passe SQL

2. Envoyer resources

Envoyez le dossier resources déjà préparé sur votre hébergeur.

L'arborescence attendue est :

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

3. Importer le SQL

1. Connectez-vous à la base distante avec HeidiSQL ou l'outil SQL de votre hébergeur.
2. Importez le SQL principal fourni avec la base.
3. Importez ensuite le FIX SQL fourni avec la base.

4. Configurer le server.cfg

Ajoutez dans votre server.cfg :

• la clé Cfx.re
• les endpoints
• OneSync
• la connexion MySQL

Gardez seulement les lignes techniques dans ce fichier. Le nom du serveur, le listing, la locale, les tags et les slots se gèrent ensuite depuis le panel KLMSTUDIO.

Ajoutez votre clé Cfx.re :

sv_licenseKey "VOTRE_CLE"

Chaque serveur doit avoir sa propre clé.

Ajoutez ensuite les endpoints :

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

Si votre hébergeur impose un autre port, remplacez 30120 par celui fourni.

OneSync doit être activé :

• avec txAdmin, activez-le dans Settings -> FXServer -> OneSync
• sans txAdmin, ajoutez cette ligne dans votre server.cfg

set onesync on

Exemple :

sv_licenseKey "VOTRE_CLE"
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
set onesync on
set mysql_connection_string "mysql://UTILISATEUR:MOT_DE_PASSE@HOTE:PORT/NOM_BASE"
set mysql_slow_query_warning 5000

5. Configurer le listing FiveM

Si votre serveur doit apparaître publiquement dans la liste FiveM :

1. Prenez votre propre abonnement Element Club.
2. Ajoutez les lignes de listing dans server.cfg.
3. Renseignez ensuite les champs visibles dans le panel KLMSTUDIO.

À ajouter dans le server.cfg :

Exemple :

sv_useDirectListing true
set sv_listingIPOverride "VOTRE_IP_SERVEUR"
sv_licenseKey "VOTRE_CLE_PATREON"

À remplir dans le panel :

• Nom dans la liste FiveM
• Titre dans la fiche serveur
• Description dans la fiche serveur
• Tags FiveM
• Locale

Supprimez sv_master1 si cette ligne est encore présente dans votre server.cfg.

6. Ajouter la Key API

Ajoutez dans config.cfg :

setr klmstudios_license_key "VOTRE_CLE_API"
# Cle du telephone, produit separe (facultatif si vous ne l'avez pas) :
# setr zsphone_license_key "VOTRE_CLE_TELEPHONE"

Lien utile : Clé API

7. Créer le serveur dans le panel KLMSTUDIO

1. Connectez-vous à panel.klmstudios.fr avec Discord.
2. Cliquez sur Ajouter un serveur.
3. Associez la bonne licence.
4. Renseignez l'IP publique du serveur.
5. Configurez les logs Discord si besoin.

Pour les logs Discord :

1. Créez une application sur le Discord Developer Portal.
2. Ajoutez le bot zLogs sur votre serveur Discord.
3. Ajoutez ces URLs dans OAuth2 :

https://panel.klmstudios.fr/auth/discord/callback
https://panel.klmstudios.fr/auth/discord/logs/callback

Lien utile : Créer son panel de logs

8. Configurer le panel

Après la création du serveur sur le panel :

1. Réglez l'identité du serveur dans Général.
2. Ajoutez vos couleurs et logos.
3. Configurez l'écran de connexion.
4. Réglez les menus et interfaces.
5. Renseignez vos liens Discord, boutique et Rich Presence.

Lien utile : Configuration via le Panel

Points importants sur un hébergeur

1. Créez la base MySQL avant d'importer les fichiers SQL.
2. Déposez bien toutes les ressources dans le dossier resources utilisé par votre hébergeur en respectant l'arborescence recommandée.
3. Utilisez les identifiants SQL fournis par l'hébergeur dans votre server.cfg.

set mysql_connection_string "mysql://UTILISATEUR:MOT_DE_PASSE@HOTE:PORT/NOM_BASE"

4. Vérifiez que l'IP et le port du serveur correspondent bien à ceux de votre hébergement.
5. Démarrez le serveur depuis le panel de l'hébergeur, puis corrigez les erreurs console avant d'aller plus loin.