Compiler des plugins

Cette section décrit comment compiler des plugins vous-mêmes. Cela peut parfois être utile si vous trouvez un plugin qui n'est disponible que sous la forme de code source, ou si une mise à jour d'AMX nécessite que vos plugins soient recompilés avec la nouvelle version.

Compiler sous Windows :

• Trouvez un plugin que vous voulez ajouter à votre serveur. Ils peuvent être trouvés ici avec leur code source.
• Chaque sujet sur ce forum est pour un plugin différent. Téléchargez le fichier zip (ou le fichier .smaVous ne pouvez pas voir l'extension du fichier?
  
  Ouvrez Poste de Travail > menu Outils > Options des répertoires > onglet Affichage > décochez Masquer les extensions des fichiers dont le type est connu ensuite revérifiez le nom du fichier. si aucun zip n'est fourni) du plugin que vous voulez et faites une extraction du fichier avec l'extension .smaVous ne pouvez pas voir l'extension du fichier?
  
  Ouvrez Poste de Travail > menu Outils > Options des répertoires > onglet Affichage > décochez Masquer les extensions des fichiers dont le type est connu ensuite revérifiez le nom du fichier. vers le répertoire addons\amx\examples\source.
• Dans le répertoire parent ('examples'), vous verrez un fichier appelé compile.bat (Fichier Batch MS-DOS). Exécutez-le. Tandis que le plugin se compile, vous verrez une fenêtre DOS apparaître et, avec de la chance, vous verrez ceci :
  ********************
  * AMX MOD COMPILER *
  ********************
  
  Warnings/Errors:
  
  Appuyez sur une touche pour continuer . . .

Si vous voyez ceci, alors vous avez réussi ! Vous trouverez le plugin compilé dans le répertoire amx\examples\compiled avec à présent une extension .amx. Maintenant installez le plugin en le déplaçant vers votre répertoire addons\amx\plugins et en apportant les modifications appropriées à votre fichier plugins.ini. Si vous avez obtenu des erreurs ou des avertissements lors de la compilation, jetez un oeil à la section conseils ci-dessous.

Autrement, vous pouvez glisser les fichiers .sma sur le fichier compile_drag&drop.bat pour des compilations rapides de plugins. Cela créera le plugin compilé avec une extension .amx dans le répertoire qui contient le fichier compile_drag&drop.bat.

Compiler sous Linux :

• Trouvez un plugin que vous voulez ajouter à votre serveur. Ils peuvent être trouvés ici avec leur code source.
• Chaque sujet sur ce forum est pour un plugin différent. Téléchargez le fichier zip (ou le fichier .sma si aucun zip n'est fourni) du plugin que vous voulez et faites une extraction du fichier avec l'extension .sma vers le répertoire addons\amx\examples\source.
• Dans le répertoire addons\amx\examples vous verrez un fichier exécutable appelé sc. Pour compiler votre plugin, faites ceci :
  ./sc source/afk_manager.sma
  Ensuite vous devriez voir ceci :
  Small compiler 2.7.3        Copyright (c) 1997-2006, ITB CompuPhase

Si vous voyez ceci, alors vous avez réussi ! Vous trouverez le plugin compilé dans le répertoire amx\examples\compiled avec à présent une extension .amx. Maintenant installez le plugin en le déplaçant vers votre répertoire addons\amx\plugins et en apportant les modifications appropriées à votre fichier plugins.ini. Si vous avez obtenu des erreurs ou des avertissements lors de la compilation, jetez un oeil à la section conseils ci-dessous.

Note : vous pouvez aussi utiliser le script Shell ./compile pour compiler tous vos plugins d'un coup. Ils seront placés dans le répertoire amx/examples/compiled.

Conseils pour compiler des plugins :

• Faites attention aux commentaires présents dans le code source. La plupart du temps, des explications sur le fonctionnement du plugin et les commandes disponibles sont écrites en haut du code source.
• Il se peut qu'il soit nécessaire de créer de nouveaux fichiers .cfg ou .ini pour faire fonctionner le plugin, donc étudiez comment le plugin marche à partir des explications du code source et du sujet du forum dans lequel est posté le plugin.
• Les avertissements (Warnings) ne sont pas des erreurs. Si vous voyez nom_plugin.sma(51) : warning 217: loose indentation, vous pouvez l'ignorer sans danger.
• Le Bloc-notes peut être utilisé à condition que vous soyez conscients de ce dont il est capable. Certaines versions insistent pour sauvegarder les fichiers avec l'extension .txt. Vous pouvez sauvegarder un fichier avec .smaVous ne pouvez pas voir l'extension du fichier?
  
  Ouvrez Poste de Travail > menu Outils > Options des répertoires > onglet Affichage > décochez Masquer les extensions des fichiers dont le type est connu ensuite revérifiez le nom du fichier. dans l'extension, mais il se peut que le Bloc-notes le sauvegarde en fait sous nom_plugin.sma.txt. Et puisque par défaut Windows n'affiche pas les extensions de fichiers, il n'est pas forcément évident de savoir sous quelle extension le fichier a été sauvegardé.
• Certains plugins nécessitent l'activation de modules supplémentaires pour fonctionner. Encore une fois, lisez attentivement les commentaires du code source et le sujet dans lequel le plugin est posté. Le module VexdUM est inclus par défaut dans les packs AMX depuis la version 0.9.9.