plugins.ini - Ajout de plugins
Le fichier plugins.ini dans votre répertoire addons\amx\config contient la liste des plugins qui sont exécutés sur votre serveur. Lisez ci-dessous pour savoir comment modifier ce fichier et comment ajouter/enlever des plugins de votre serveur. Voici ce que contient le fichier plugins.ini par défaut :
; Plugins d'AMX Mod
; Pour désactiver un plugin, ajoutez un point-virgule au début de la ligne
; Vous pouvez désactiver le compilateur JIT avec le mot-clé 'nojit' :
; pluginname.amx nojit
; (lisez la documentation pour plus de détails)
; Pour charger des admins à partir d'une base MySQL, ouvrez le fichier amx/examples/source/default/admin.sma
; et suivez les instructions.
language.amx ; gestion des langues
admin.amx ; base admin (requis)
admincmd.amx ; commandes admin de base
adminhelp.amx ; commande d'aide pour les commandes admin
adminslots.amx ; réservation de slots
menufront.amx ; interface pour les menus admin et custom
cmdmenu.amx ; menu de commandes (voix, réglages)
mapsmenu.amx ; menu de maps (vote, changement de map)
plmenu.amx ; menu des joueurs (kick, ban, cmds. client)
telemenu.amx ; menu de téléportation (Module Fun requis !)
adminvote.amx ; commandes de vote
antiflood.amx ; empêche les joueurs de flooder le chat du serveur
adminchat.amx ; commandes de chat
scrollmsg.amx ; affiche un message défilant
imessage.amx ; affiche les messages d'information
nextmap.amx ; affiche la prochaine map
mapchooser.amx ; permet de voter pour la prochaine map
timeleft.amx ; affiche le temps restant sur la map
mapconfig.amx ; exécute un fichier de configuration spécifique par map
pausecfg.amx ; permet de suspendre/relancer certains plugins
statscfg.amx ; permet de gérer les stats via un menu et des commandes
plugmod_manager.amx ; gère les fichiers modules.ini et plugins.ini d'AMX
; Counter-Strike
; Vous n'avez pas besoin de déclarer csstats.amx ici (CSStats le chargera)
ff_manager.amx ; gestion du friendly-fire
restmenu.amx ; menu de restriction des armes pour Counter-Strike
statsx.amx ; stats de mort/fin de round (Module CSStats requis !)
miscstats.amx ; diverses annonces d'événements pour Counter-Strike
stats_logging.amx ; log des stats d'armes (Module CSStats requis !)
; Ajoutez les plugins custom ci-dessous
A propos du JIT :
Le compilateur Just-In-Time a été mis en place avec AMX 0.9.9.
Il permet une exécution des plugins 10 fois plus rapide.
Pour les curieux qui se demanderaient comment ça marche :
vos plugins .sma sont compilés en fichiers .amx
avec le compilateur sc. Les fichiers .amx sont des
Abstract Machine eXecutables : ils
contiennent du code binaire (instructions qui doivent être interprétées). Avant AMX Mod 0.9.9,
l'unique moyen d'exécuter des plugins était d'interpréter leur code binaire en permanence, et ceci consommait beaucoup de ressources.
Maintenant grâce au JIT, les plugins .amx sont compilés au chargement en instructions
qui peuvent être envoyées directement au processeur, ne nécessitant plus l'interpréteur (lent). Les plugins sont exécutés plus rapidement, et
votre serveur souffrira moins si vous déclarez beaucoup de plugins.
Par défaut, AMX Mod essaie de charger les plugins avec le JIT. Vous pouvez contrôler ceci grâce au localinfo amx_usejit (ajoutez +localinfo amx_usejit valeur à la commande lançant votre serveur).
Il y a trois valeurs possibles pour ce localinfo :
De toute façon, si le compilateur JIT échoue pour une quelconque raison sur un plugin, ce dernier sera exécuté à l'ancienne.
Il y a deux manières d'ajouter des plugins à votre serveur :
Téléchargez des plugins précompilés :
Ensuite copiez le fichier .amx dans votre répertoire addons\amx\plugins et ajoutez la ligne pour ce plugin dans votre fichier plugins.ini. Voici quelques raisons qui expliquent pourquoi ce n'est pas le meilleur moyen de procéder :
- Le plugin compilé nécessite d'être compilé pour votre version d'AMX ou il ne marchera peut-être pas.
- Quand vous mettez à jour AMX vous devriez recompiler tous vos plugins de toute manière.
- Vous devriez apprendre comment compiler des plugins, c'est très facile et beaucoup de modifications peuvent être apportées même par des non programmeurs comme moi-même.
- Vous n'avez aucun moyen de savoir si quelqu'un décide de jouer au hacker et vous donne un plugin contenant du code malveillant.
Téléchargez le code source et compilez le :
(Cliquez ici pour savoir comment compiler !)
Ensuite copiez le fichier .amx dans votre répertoire addons\amx\plugins et ajoutez le nom du plugin dans votre fichier plugins.ini. Voici quelques raisons qui expliquent pourquoi c'est le meilleur moyen de procéder :
- Vous pouvez modifier le niveau d'accès selon vos préférences.
- Beaucoup d'autres personnes ont vu le code et ont peut-être offert des améliorations et peuvent voir si le plugin est malveillant.
- Cela vous permet d'en apprendre un peu plus sur la manière dont AMX fonctionne. Et cela peut s'avérer utile.
Comment procéder :
Il y a littéralement des centaines de plugins qui peuvent être téléchargés et ajoutés à AMX pour bénéficier de nouvelles fonctionnalités. Voici deux endroits où vous pouvez aller pour trouver de nouveaux plugins :
Donc allez sur un de ces deux liens et trouvez un plugin qui vous intéresse. Il est préférable de ne vous occuper que d'un plugin à la fois, de cette manière si vous rencontrez des problèmes il sera plus facile d'en trouver l'origine. Disons que vous avez un plugin appelé amx_gag.amx. Voici à quoi cela ressemblerait s'il était dans le fichier plugins.ini.
; Ajoutez les plugins custom ci-dessous
amx_gag.amx ; les admins peuvent empêcher les joueurs d'écrire
J'ai créé une nouvelle section pour tous les plugins que j'ai ajoutés et j'ai laissé à part la section des plugins par défaut. Maintenant pour tester et voir si le plugin que vous avez ajouté est installé et fonctionne, démarrez votre serveur. Dans la console serveur tapez amx plugins. Vous devriez obtenir quelque chose comme cela :
Plugins actuellement charges :
nom version auteur fichier etat jit
[ 1] Gestion de Langue 2006.3 AMX Team language.amx running oui
[ 2] Base Admin 2006.3 AMX Team admin.amx running oui
[ 3] Commandes Admin 2006.3 AMX Team admincmd.amx running oui
[ 4] Aide Admin 2006.3 AMX Team adminhelp.amx running oui
(etc, etc. Tous les plugins ne sont pas montrés)
[ 24] Admin gag 0.6 default amx_gag.amx running oui
Résolution de problèmes :
Si vous voyez quelque chose comme bad load dans la colonne etat ou unknown dans la colonne nom lorsque vous tapez amx plugins, ou [AMX] Plugin file open error (plugin "un_plugin.amx") lorsque votre serveur démarre, alors il est possible que :
- le plugin n'ait pas été copié dans le répertoire addons\amx\plugins
- le nom du plugin ne corresponde pas à ce que vous avez écrit dans le fichier plugins.ini.
AMX peut aussi afficher [AMX] Function not found (name "une_fonction") (plugin "un_plugin.amx") au démarrage, alors le problème vient du fait que le plugin nécessite un certain module AMX pour être chargé.