Aller au contenu principal

Mettre à jour les Artifacts FiveM

Ce guide vous explique comment mettre à jour les artifacts de votre serveur FiveM pour bénéficier des dernières fonctionnalités et corrections.

Qu'est-ce qu'un Artifact ?​

Les artifacts sont les fichiers du serveur FiveM. Ils contiennent le moteur du serveur et doivent être mis à jour régulièrement pour :

  • Corriger des bugs
  • Améliorer les performances
  • Ajouter de nouvelles fonctionnalités
  • Assurer la compatibilité avec les dernières ressources

Étape 1 : Télécharger le nouvel Artifact​

  1. Rendez-vous sur le site officiel : https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/
  2. Choisissez la version souhaitée :
    • Recommended : Version stable recommandée
    • Latest : Dernière version (peut contenir des bugs)
  3. Cliquez sur le lien pour télécharger l'archive
astuce

Il est conseillé d'utiliser la version Recommended pour un serveur en production.

Étape 2 : Arrêter le serveur​

  1. Connectez-vous à votre Panel Game :
  2. Sélectionnez votre serveur FiveM
  3. Cliquez sur Stop pour arrêter le serveur
attention

Ne mettez jamais à jour les artifacts pendant que le serveur est en cours d'exécution !

Étape 3 : Sauvegarder les anciens fichiers​

  1. Allez dans Files (Gestionnaire de fichiers)
  2. Créez un dossier backup_artifacts (optionnel mais recommandé)
  3. Déplacez les fichiers suivants dans ce dossier :
    • alpine/
    • run.sh
    • Tout autre fichier à la racine sauf server-data/ ou resources/

Étape 4 : Uploader les nouveaux Artifacts​

  1. Dans le gestionnaire de fichiers, cliquez sur Upload
  2. Sélectionnez l'archive téléchargée (fx.tar.xz)
  3. Une fois uploadée, faites un clic droit sur l'archive
  4. Cliquez sur Unarchive pour extraire les fichiers

Étape 5 : Vérifier les permissions​

Assurez-vous que le fichier run.sh est exécutable :

  1. Faites un clic droit sur run.sh
  2. Cliquez sur Permissions
  3. Vérifiez que l'exécution est autorisée (755)

Étape 6 : Redémarrer le serveur​

  1. Retournez sur la page principale de votre serveur
  2. Cliquez sur Start pour démarrer le serveur
  3. Vérifiez les logs pour vous assurer que tout fonctionne correctement

Vérifier la version​

Une fois le serveur démarré, vous pouvez vérifier la version de l'artifact dans la console. La version s'affiche au démarrage du serveur.

Problèmes courants​

Le serveur ne démarre pas​

  • Vérifiez que tous les fichiers ont été extraits correctement
  • Assurez-vous que run.sh a les bonnes permissions
  • Consultez les logs pour identifier l'erreur

Erreurs de compatibilité​

  • Certaines ressources peuvent nécessiter une version spécifique d'artifact
  • Vérifiez la compatibilité de vos ressources avec le nouvel artifact
  • En cas de problème, restaurez l'ancien artifact depuis votre backup

txAdmin ne fonctionne plus​

  • Après une mise à jour majeure, txAdmin peut nécessiter une reconfiguration
  • Vérifiez que la version de txAdmin est compatible avec le nouvel artifact
info

Pensez à faire des mises à jour régulières pour maintenir votre serveur sécurisé et performant.