Documentation du module Game Server Hub

AutoMod Manager (AMM)

Game Server Hub intègre un système avancé de gestion des plugins (AutoMod Manager), permettant d’installer et configurer automatiquement des plugins, maps ou sons pour les serveurs de jeux. Ce système facilite l'ajout, la gestion et l'installation compatibles avec chaque jeu.


Ajouter un Plugin, map ou sons

Le formulaire d’ajout de plugin permet de référencer un nouveau plugin et de le rendre disponible à l’installation depuis le gamepanel. Pour cela veuillez suivre la procedure ci-dessous.

Champ Description
Image du pluginAjoutez une image ou un logo pour identifier rapidement le plugin.
Jeu concernéSélectionnez le jeu pour lequel le plugin est destiné.
Nom du pluginLe nom du plugin tel qu'il apparaîtra dans la liste.
Lien officiel du pluginVous permettra de retrouver plus facilement le plugin en cas de mise à jours.
DescriptionBrève description expliquant l’utilité du plugin.
Commandes post-installationCommandes spécifiques à exécuter après installation (ex: modifications de fichiers).
Commandes post-suppressionCommandes spécifiques à exécuter pour supprimer un plugin.
Ce plugin nécessite-t-il une gestion des administrateurs ?Vous permet de facilement activé la fonctionnalité permettant d'ajouter/editer des admin.
Chemin du fichier de configuration des administrateursRenseigner l'emplacement du fichier à modifier , exemple : cstrike/addons/amxmodx/configs/users.ini.
VersionSpécifiez la version du plugin (ex: 1.2.3).
AuteurAuteur original du plugin.
TypeVous avez le choix entre plusieurs type : Plugin , Addons , Map , Sons , Autre. Cela afin de bien référencé sur le game panel de type de module à installer
StatusVous avez le choix entre plusieurs status : Actif Inactif ou Obselète

Liste des Plugins

Cette section affiche tous les plugins enregistrés et permet de les gérer.

  • 📌 Filtrage automatique des plugins en fonction du jeu installé.
  • 📂 Affichage du nom, version et état du plugin.
  • ⚙️ Actions disponibles : Modifier ou Supprimer.
Modifier un Plugin

Chaque plugin peut être édité pour :

  • 🔄 Mettre à jour son nom, description ou image.
  • ⚙️ Modifier les commandes post-installation.
  • 🚀 Mettre à jour son statut (`actif`, `inactif`, `obsolète`).

Suppression d’un Plugin

Si un plugin devient obsolète, il peut être supprimé du panneau d’administration.
Attention : La suppression d’un plugin ne le désinstalle pas des serveurs de jeux déjà installés.

Pourquoi ce système est révolutionnaire ?
  • ⚡ Installation ultra-rapide avec un simple clic.
  • 🔄 Mises à jour simplifiées sans manipulation technique.
  • 📡 Compatibilité intelligente : Affichage uniquement des plugins compatibles avec le jeu.
  • 🚀 Gain de temps énorme pour les administrateurs et les joueurs.

Commandes Post-Installation

Le champ Commandes post-installation permet d'exécuter une série de commandes automatiquement après l’installation du plugin. Cela permet :

  • ✅ De télécharger le fichier du plugin.
  • ✅ De l’extraire dans le bon dossier.
  • ✅ De modifier des fichiers de configuration si nécessaire.
  • ✅ De redémarrer le serveur si besoin.
Exemple : Installation de AMX Mod X sur Counter-Strike 1.6

Voici les commandes post-installation à entrer :

# Créer les dossiers nécessaires
mkdir -p addons/amxmodx
mkdir -p addons/metamod

# Télécharger les fichiers nécessaires
wget -qO amxmodx.tar.gz "https://www.amxmodx.org/release/amxmodx-1.9.0-linux.tar.gz"
wget -qO metamod.tar.gz "https://www.amxmodx.org/release/metamod-1.21.1-am-linux.tar.gz"

# Extraire les fichiers
tar -xzf amxmodx.tar.gz -C addons/amxmodx
tar -xzf metamod.tar.gz -C addons/metamod

# Nettoyage des fichiers téléchargés
rm amxmodx.tar.gz metamod.tar.gz

# Ajouter la ligne pour activer AMX Mod X
echo 'linux addons/amxmodx/dlls/amxmodx_mm_i386.so' >> addons/metamod/plugins.ini

# Modifier liblist.gam
sed -i 's#^gamedll_linux.*#gamedll_linux "addons/metamod/metamod.so"#' liblist.gam
				

Commandes les plus utilisées
Commande Description Exemple
wgetTélécharge une archive depuis une URLwget https://site.com/plugin.zip
tar -xzfDécompresse une archive .tar.gztar -xzf plugin.tar.gz
tar -xzf -CDécompresse une archive dans un dossier spécifiquetar -xzf plugin.tar.gz -C addons/plugins
rm -rfSupprime un fichier ou un dossierrm -rf plugin.tar.gz
echoAjoute une ligne à un fichierecho "command" >> config.cfg
sed -iModifie une ligne spécifique dans un fichiersed -i 's/old_value/new_value/' config.cfg

Exemple de désinstallation de AMX Mod X sur Counter-Strike 1.6
# Suppression des dossiers liés à AMX Mod X et Metamod
rm -rf /cstrike/addons/amxmodx
rm -rf /cstrike/addons/metamod

# Suppression de la configuration du plugin dans Metamod
sed -i '/amxmodx_mm_i386.so/d' /cstrike/addons/metamod/plugins.ini

# Restauration du fichier liblist.gam à son état d'origine
sed -i 's|gamedll_linux "addons/metamod/metamod.so"|gamedll_linux "dlls/mp.dll"|' /cstrike/liblist.gam

# Vérification et suppression des fichiers restants
rm -f /cstrike/addons/amxmodx/dlls/amxmodx_mm_i386.so
rm -f /cstrike/addons/metamod/metamod.so
				

🛠 Bonnes pratiques
  • ✔ Vérifiez les chemins d'installation et suppression pour éviter toute erreur.
  • ✔ Utilisez rm -rf avec précaution afin d’éviter la suppression de fichiers non liés au plugin.
  • ✔ Ajoutez un commentaire explicatif pour chaque commande pour une meilleure compréhension.
  • ✔ Testez vos commandes manuellement avant de les enregistrer dans AMM.

Ajout des Administrateurs aux Plugins

Game Server Hub (GSH) introduit une fonctionnalité permettant de gérer les administrateurs directement depuis l'interface pour certains plugins.


Quels plugins sont compatibles ?

Certains plugins nécessitent une gestion des administrateurs, d’autres non. Pour cela, GSH inclut une option permettant de différencier les plugins administrables.

  • Plugins nécessitant des admins : AMX Mod X, SourceMod.
  • Plugins sans gestion d'admin : Packs de maps, sons.

Comment fonctionne l'ajout d’un administrateur ?
  1. GSH détecte automatiquement le fichier contenant la liste des administrateurs.
  2. Une interface affiche la liste des administrateurs existants.
  3. Un bouton "Ajouter un administrateur" permet d'ajouter un nouvel admin.
  4. Le fichier est mis à jour automatiquement via SSH.
  5. Les changements sont instantanés et pris en compte immédiatement.

Options lors de l'ajout d'un plugin
Champ Description Exemple
Plugin administrableIndique si ce plugin permet l'ajout d'administrateurs.✅ Oui / ❌ Non
Chemin du fichier adminFichier contenant la liste des administrateurs.Exemple : cstrike/addons/amxmodx/configs/users.ini

Ajout d’un administrateur - Exemple AMX Mod X
  1. Sélection du serveur concerné.
  2. Accès à la gestion du plugin (AMX Mod X).
  3. Ajout d’un nouvel administrateur (SteamID, niveau d’accès).
  4. Validation.
  5. Mise à jour automatique du fichier users.ini.
"STEAM_0:1:12345678" "abcdefghijklmnopqrstu" "ce"
"STEAM_0:1:23456789" "abcde" "ce"
				

Suppression d’un administrateur

- Sélectionnez un administrateur dans la liste.
- Cliquez sur "Supprimer".
- GSH met automatiquement à jour le fichier et applique les changements.


Conclusion

Le système AutoMod Manager (AMM) permet d’installer et configurer facilement les plugins, maps et sons, sans intervention manuelle.