Comment ajouter des plugins à votre serveur open.mp

Pour ajouter un plugin SA-MP à un serveur open.mp chez PlayNHost, envoyez le fichier .so Linux du plugin dans un dossier plugins sous Files, ajoutez son nom à legacy_plugins dans config.json, puis redémarrez. Un plugin qui a sa propre version pour open.mp va plutôt dans le dossier components et se charge sans ligne dans config.json.

De quel fichier ai-je besoin ?

Votre serveur fait tourner open.mp sous Linux, en programme 32 bits. Utilisez la version .so Linux du plugin. Un .dll Windows ne se charge pas : le guide Linux d'open.mp dit que les fichiers .dll ne marchent que sous Windows. Les versions de plugins proposent en général les deux, souvent avec « linux » dans le nom ou une extension .so.

Le guide d'installation d'open.mp liste les plugins qui demandent une version spéciale :

Ajouter un plugin legacy

1. Ouvrez votre serveur dans le panel et cliquez sur Files dans le menu de gauche.
2. Un serveur neuf n'a pas de dossier plugins. Cliquez sur Créer un dossier, nommez-le plugins et cliquez sur Créer.
3. Ouvrez plugins, cliquez sur Téléverser et choisissez le fichier .so, par exemple streamer.so.
4. Revenez au dossier principal et cliquez sur config.json pour l'ouvrir dans l'éditeur de texte.
5. Dans la partie pawn, ajoutez le nom du plugin à legacy_plugins, entre guillemets, avec des virgules s'il y en a plusieurs : "legacy_plugins": ["streamer", "mysql"],. L'extension .so est facultative.
6. Cliquez sur Enregistrer le contenu et redémarrez le serveur.

La Console affiche Loading plugin: et le nom pour chaque plugin chargé. Si l'un échoue, elle affiche Could not load plugin: avec le fichier et la raison.

Ajouter un composant open.mp

Un composant est un plugin conçu pour open.mp lui-même. Envoyez son .so dans le dossier components et redémarrez. open.mp charge tout ce qui est dans components au démarrage, donc config.json n'a besoin d'aucune ligne. La Console liste chacun avec Loading component et son nom de fichier.

Ne supprimez pas les fichiers déjà présents dans components : ce sont les propres éléments d'open.mp, comme le scripting Pawn et la console.

Plugins qui utilisent une base de données ou Internet

PlayNHost installe la version d'open.mp qui utilise la bibliothèque OpenSSL du système (la version « dynssl »). Le code source d'open.mp prévient que les plugins qui utilisent OpenSSL, comme discord-connector et pawn-requests, « might crash » avec l'autre version, et recommande celle-ci. Pour un plugin MySQL, votre serveur a besoin d'une base de données : voyez Comment utiliser des bases de données avec votre serveur.

Ai-je besoin des fichiers include ?

Non. Les fichiers include, comme sscanf2.inc ou streamer.inc, ne servent que sur votre PC quand vous compilez votre gamemode. Le serveur a besoin du .amx compilé et des plugins : Comment téléverser votre propre gamemode sur votre serveur open.mp.

Que faire si un plugin ne se charge pas ?

• "Could not load plugin" : le .so est absent de plugins, le nom dans legacy_plugins est écrit autrement, ou c'est une version 64 bits ou Windows.
• "This file is an open.mp component. Please move it to components/ folder." : vous avez envoyé la version open.mp d'un plugin. Déplacez-la dans components et retirez son nom de legacy_plugins.
• Le serveur s'arrête juste après le chargement d'un plugin : le plugin n'est peut-être pas compatible avec open.mp. Regardez le tableau ci-dessus, retirez-le de legacy_plugins et redémarrez.

Autres solutions : Problèmes et solutions du serveur open.mp.