Utiliser GitHub Desktop pour simplifier les mises à jour de FiveM et repérer chaque changement

Introduction

Chaque propriétaire de serveur connaît ce sentiment. Une nouvelle version d'une ressource sort, le changelog indique "remplacez le dossier /config/framework", et vous restez figé — parce que vous avez passé des heures à ajuster ces fichiers et vous n'avez aucune idée de ce que la mise à jour a réellement modifié. Écrasez-vous tout en perdant votre travail ? Ignorez-vous le dossier au risque de casser le script ? Copiez-vous les lignes manuellement en espérant n'avoir rien oublié ?

Il existe une bien meilleure façon — et vous n'avez pas besoin de taper une seule commande. Avec une application gratuite appelée GitHub Desktop, vous pouvez voir exactement ce qui a changé dans n'importe quelle mise à jour, conserver vos propres personnalisations en toute sécurité, et revenir en arrière en quelques secondes, le tout via une interface simple en point-clic.

Qu'est-ce que Git, et qu'est-ce que GitHub Desktop ?

Git est un système de contrôle de version — voyez cela comme un historique d'annulation illimité et parfait pour un dossier. Chaque fois que vous enregistrez un instantané (appelé un commit), il enregistre l'état exact de chaque fichier. Plus tard, vous pouvez comparer n'importe quels deux instantanés ligne par ligne, restaurer un état antérieur ou fusionner des changements.

GitHub Desktop est une application visuelle gratuite qui simplifie Git grâce à des boutons conviviaux. Pas de terminal noir, pas de commandes à mémoriser — juste une fenêtre claire qui vous montre ce qui a changé et vous permet de valider, d'annuler et de fusionner en un clic.

Pour un serveur FiveM, le dossier que vous suivez est votre répertoire resources (ou un script unique à l'intérieur). Git transforme "Je pense avoir changé quelque chose ici il y a quelques semaines" en "montre-moi précisément ce qui a changé entre le mois dernier et aujourd'hui."

Pourquoi c'est parfait pour les mises à jour de ressources

Mettre à jour un script de manière traditionnelle signifie travailler à l'aveugle. Git vous donne trois super-pouvoirs :

1. Détection de changements — après avoir installé une nouvelle version, GitHub Desktop met en évidence chaque fichier modifié et chaque ligne modifiée. Le journal des modifications vous indique quels dossiers remplacer ; Git vous montre ce qui a réellement changé afin que vous puissiez lui faire confiance.
2. Personnalisation sécurisée — vos modifications sont enregistrées dans des commits. Lorsqu'une mise à jour d'un fournisseur touche le même fichier, Git peut fusionner les deux ensembles de modifications, conservant les vôtres et les leurs.
3. Retour en arrière instantané — si une mise à jour fait planter votre serveur, vous n'êtes qu'à un clic de l'état exact que vous aviez il y a cinq minutes. Fini la panique du "où ai-je mis cette sauvegarde".

Configuration unique avec GitHub Desktop

Vous ne le faites qu'une seule fois par serveur.

# Never track secrets
**/*.env
**/secrets.lua
server.cfg

# Caches, logs, build output
**/cache/
**/logs/
**/.DS_Store

Le flux de travail de mise à jour

C'est la routine que vous répétez pour chaque mise à jour. Cela prend environ une minute.

Revenir en arrière en cas de problème

Une mise à jour se comporte mal ? Restez calme — GitHub Desktop vous offre plusieurs options, de la plus douce à la plus radicale.

Annuler les modifications non validées. Dans l'onglet Changes, sélectionnez les fichiers (ou tous), faites un clic droit et choisissez Discard Changes / Discard All Changes. Cela les restaurera à votre dernier commit.

Retournez à un instantané précédent. Ouvrez l'onglet History dans la barre latérale gauche pour voir chaque instantané que vous avez créé :

• Pour annuler en toute sécurité une mise à jour tout en conservant un historique propre, faites un clic droit sur le commit erroné et choisissez Revert Changes in Commit. Cela crée un nouveau commit d'« annulation » — rien n'est perdu.
• Pour revenir complètement à un état antérieur, faites un clic droit sur l'instantané souhaité et choisissez Reset to commit.

Mettez vos changements de côté temporairement — pratique pour tester une mise à jour sur une base propre, puis récupérer votre travail. Faites un clic droit sur l'en-tête Changed files et choisissez Stash All Changes. Pour les récupérer, sélectionnez Stashed Changes dans la barre latérale et cliquez sur Restore.

Astuce de pro : Fusion automatique des mises à jour fournisseur

Fatigué de réappliquer manuellement vos modifications de config après chaque mise à jour ? GitHub Desktop peut le faire pour vous en utilisant une fusion à trois voies.

L'idée : conservez une branche avec les versions fournisseurs d'origine et une autre avec vos modifications par-dessus.

C'est la même technique que les équipes professionnelles utilisent pour suivre les bibliothèques amont sans perdre les modifications locales — et cela fonctionne tout aussi bien pour votre serveur.

Vous préférez la ligne de commande ?

Si vous êtes à l'aise avec un terminal, l'intégralité du flux de travail ci-dessus correspond à une poignée de commandes :

# One-time setup (run inside your resources folder)
git init
git add .
git commit -m "Baseline: working server before updates"

# Each update
git add . && git commit -m "Pre-update snapshot"   # snapshot first
# ...drop in the new release, overwriting files...
git status            # which files changed
git diff --stat       # a compact per-file summary
git diff              # full line-by-line changes
git add . && git commit -m "Update sky_base to 1.21.0"

# Rolling back
git restore <file>    # undo changes to one file
git restore .         # undo all uncommitted changes
git log --oneline     # find a snapshot
git reset --hard <id> # rewind to it (destructive)
git stash / git stash pop   # shelve and restore temporarily

Bonnes pratiques

• Validez avant chaque mise à jour. Un instantané prend deux secondes et fait gagner des heures.
• Écrivez des résumés clairs. Update sky_base to 1.21.0 est préférable à stuff lorsque vous parcourez l'historique six mois plus tard.
• Gardez les secrets ignorés. Les identifiants ne doivent jamais figurer dans l'historique des versions.
• Validez après un démarrage propre, pas avant. Ne marquez un instantané comme "bon" qu'une fois que le serveur fonctionne réellement.
• Suivez tout votre dossier resources dans un seul dépôt. De cette façon, un seul rollback peut permettre de se rétablir d'une mauvaise mise à jour pour n'importe quel script.
• Gardez cela en local. Ne publiez jamais de ressources sous licence ou protégées par escrow sur un dépôt public.

Conclusion

Mettre à jour un serveur FiveM ne signifie plus faire des suppositions, perdre vos personnalisations ou chercher frénétiquement des sauvegardes. Avec une configuration unique via GitHub Desktop et une routine d'une minute, vous pouvez voir chaque changement effectué par une mise à jour, conserver vos propres modifications intactes, et annuler instantanément toute erreur — le tout sans taper une seule commande.

La prochaine fois qu'un journal des modifications vous demandera de remplacer un dossier, vous le ferez en toute confiance — car GitHub Desktop vous montrera exactement ce qui a changé, à chaque fois.