Installer des macros dans Logitech G HUB : importer, configurer ou créer votre script .lua

Les scripts .lua ouvrent énormément de possibilités pour les souris Logitech compatibles G HUB. Concrètement, ces macros Logitech G HUB peuvent automatiser des actions répétitives, accélérer certains gestes, ou assister des scénarios précis en jeu comme en bureautique. Pour des titres populaires comme Rust, CS 2 ou PUBG, beaucoup d’utilisateurs cherchent par exemple à mettre en place une macro de contrôle (souvent appelée recoil macro selon le contexte).

Vous avez deux options : utiliser un script prêt à l’emploi (acheté ou fourni) ou créer votre propre script. Dans les deux cas, l’élément clé est le même : importer le fichier .lua dans Logitech G HUB, l’activer correctement, puis vérifier qu’il fonctionne comme prévu. Ci-dessous, vous trouverez une procédure complète et structurée pour installer une macro dans G HUB (de A à Z), avec des conseils utiles pour éviter les problèmes les plus fréquents.

1. Télécharger et installer Logitech G HUB

1. Téléchargez G HUB depuis le site officiel Logitech.
   Rendez-vous sur la page Logitech : Logitech G HUB. Utilisez de préférence la version stable la plus récente pour démarrer.
   
   Si vous rencontrez des bugs (boucle de chargement, scripts qui ne s’exécutent pas, crash), testez une version plus ancienne connue pour sa stabilité, par exemple 2021.10.8013 : Télécharger G HUB (2021.10.8013).
2. Installez (et lancez) G HUB en tant qu’administrateur.
   C’est un point critique : certains jeux et systèmes de protection peuvent empêcher les scripts de fonctionner sans privilèges élevés. En pratique, le mode administrateur résout souvent le scénario classique : « la macro marche sur Windows, mais pas en jeu ».
3. Désactivez le mode “On-board memory” (mémoire embarquée).
   Sur les versions récentes de G HUB, l’option se trouve généralement sur l’écran principal, à droite de l’image de la souris. Le mode mémoire embarquée peut bloquer l’utilisation des scripts Lua dans certains cas.

2. Préparer le profil “Bureau” (Desktop) pour vos macros

1. Préparez votre script .lua.
   Que vous l’ayez créé vous-même ou obtenu via une solution prête, enregistrez-le dans un emplacement facile à retrouver (par exemple sur le bureau). Cela évite les erreurs au moment de l’import, surtout si vous gérez plusieurs scripts différents.



2. Définissez le profil “Desktop” comme profil principal (persistant).
   
   • Lancez G HUB.
   • Ouvrez “Games & Applications” / “Jeux et applications” (ou “Manage Profiles”).
   • Trouvez le profil “Desktop” / “Bureau”.
   • Marquez-le comme profil permanent / principal dans les détails du profil.
   
   
   

   Pourquoi c’est important : si G HUB bascule automatiquement vers un profil de jeu, vos scripts peuvent ne plus s’exécuter, ou se comporter différemment. Utiliser “Desktop” pour les scripts Lua est la méthode la plus simple et la plus fiable pour obtenir un comportement constant.

3. Créer un script et importer une macro Lua dans G HUB

1. Activez le profil “Desktop”.
   C’est le meilleur profil pour tester : il réduit les conflits, limite les restrictions, et simplifie le diagnostic en cas de problème.



2. Créez un nouveau script Lua, puis importez votre fichier .lua.
   
   • Cliquez sur “Create New LUA Script” (ou l’équivalent selon la langue).
   • Dans la fenêtre de script, ouvrez le menu “Script” → “Import”.
   • Sélectionnez votre fichier .lua (celui que vous avez enregistré sur votre PC).

   Cette méthode est très pratique si vous souhaitez gérer plusieurs macros : par exemple un script pour Rust, un autre pour CS2, et un troisième pour PUBG. Vous pouvez organiser vos scripts proprement et les activer selon votre besoin.




3. Enregistrez et activez le script (“Save and Run”).
   Après l’importation, ouvrez le menu “Script” et choisissez “Save and Run”. C’est l’action qui active réellement votre macro et permet de la tester immédiatement.

4. Vérifier que la macro fonctionne correctement

1. Assignez un bouton de souris (ou une touche).
   Beaucoup de scripts sont configurés par défaut sur un bouton latéral (par exemple “G5”). Selon le script, vous pouvez changer l’affectation directement dans le code Lua ou via l’interface G HUB.
2. Testez sur le profil Desktop.
   Appuyez ou maintenez le bouton assigné. Si le curseur bouge ou si l’action prévue se déclenche, c’est que le script est correctement chargé et actif.
   
   Pour des scripts de contrôle en jeu, l’étape suivante est de tester la stabilité en conditions réelles, mais commencez toujours par valider la base : le script doit être actif et réagir immédiatement sur Desktop.

5. Ajouter plusieurs macros (organisation et bonnes pratiques)

Si vous utilisez plusieurs scripts à la fois, voici une approche fiable :

1. Répétez le processus : créez un nouveau script et importez le fichier .lua correspondant.
2. Activez chaque script avec “Save and Run” après l’import.
3. Nommez clairement vos scripts (par jeu, par arme, par usage), pour éviter toute confusion.

Sur TopMacro, il existe également des scripts Premium qui regroupent plusieurs profils / armes dans un seul fichier Lua. L’avantage est simple : vous pouvez basculer d’un “mode” à l’autre via des raccourcis clavier ou des boutons, tout en conservant un système unifié et plus facile à maintenir.

6. Créer votre propre macro dans Logitech G HUB

Si vous souhaitez écrire votre script vous-même, prévoyez un minimum de logique et de rigueur : même si Lua est relativement simple, une macro fiable demande une bonne structure, des temporisations cohérentes, et des tests. L’éditeur Lua de G HUB inclut une documentation intégrée ; vous pouvez progresser étape par étape, tester vos modifications et comprendre comment adapter le script à votre souris et à votre style d’utilisation.

Conseil : commencez par un script très petit (un seul bouton, une seule action), puis ajoutez progressivement des conditions et des paramètres. Vous gagnerez du temps et éviterez les “scripts monstres” difficiles à déboguer.

7. La macro ne fonctionne pas en jeu

• Vérifiez que le profil “Desktop” est bien défini comme profil permanent.
• Fermez complètement G HUB (quittez aussi l’icône dans la barre système), puis relancez-le en administrateur.
• Désactivez le mode On-board memory si ce n’est pas déjà fait, puis redémarrez le PC.
• Assurez-vous que le script est bien en “Save and Run” (et pas seulement importé sans exécution).
• Si le problème persiste : réinstallez G HUB et retestez avec une version stable plus ancienne.

8. G HUB ne démarre pas (ou reste bloqué sur un chargement infini)

• Une solution efficace consiste à désinstaller complètement G HUB, puis installer une version plus ancienne, par exemple 2021.10.8013. Une fois installée, l’application vous proposera parfois une mise à jour : vous pouvez accepter, car le simple fait de repartir d’une base stable résout souvent la boucle de chargement.
• Si vous utilisez des profils et scripts multiples, sauvegardez vos fichiers .lua avant toute réinstallation. Les scripts sont rapides à réimporter, mais c’est toujours mieux de sécuriser vos fichiers au préalable.

9. Conclusion

Installer et configurer une macro sur une souris Logitech devient simple quand on suit un ordre logique et qu’on respecte les points essentiels :

1. Installer G HUB et le lancer en administrateur.
2. Choisir “Desktop” comme profil principal pour éviter les conflits de profils de jeu.
3. Créer un script Lua et importer votre fichier .lua.
4. Activer via “Save and Run”, puis tester sur Desktop avant de valider en jeu.

En suivant ces étapes, vous gagnez du temps, vous réduisez les erreurs, et vous obtenez une configuration stable. Bon paramétrage et bon jeu.