Plutonium Plugin SDK#

L’une des fonctionnalités offertes par Plutonium est la possibilité pour les propriétaires de serveurs de développer leurs propres plugins DLL C++ afin de personnaliser davantage l’expérience joueur. Afin d’encourager la sécurité des plugins indépendants des mises à jour de version, l’équipe de développement de Plutonium a créé un SDK simple permettant aux plugins d’interfacer avec certains des aspects les plus importants de chaque jeu supporté par Plutonium.

Commencer#

Commencez par créer un projet DLL C++ vierge dans Visual Studio ou avec les outils de votre choix. Dans cet exemple, un nouveau projet sera créé directement dans Visual Studio, initialisé en tant que dépôt Git, et les fichiers SDK seront inclus dans le chemin de compilation.

Créer un nouveau projet#

Dans Visual Studio, créez un nouveau projet en utilisant l’option Dynamic-Link Library (DLL) pour C++
Ouvrez l’explorateur dans le répertoire contenant le fichier .sln nouvellement créé pour votre projet
Ouvrez une fenêtre d’invite de commande dans ce répertoire et exécutez les commandes suivantes :

git init
git submodule add https://github.com/plutoniummod/plutonium-sdk.git <project-folder-name>/plutonium-sdk
- Remplacer <project-folder-name> avec le nom de votre projet que vous avez saisi dans Visual Studio

Utilisez l’exemple dans V1 API pour installer votre main.cpp
DLL de construction

API#

Explorez le V1 API Documentation pour une liste complète des fonctionnalités.

Exemple de plugin#

Regardez le Exemple de plugin Documentation pour un exemple de base de création d’un plugin utilisant le SDK.

FAQ#

Q) Où dois-je mettre la DLL pour que le plugin soit chargé ?
A) Les plugins doivent être dans votre %localappdata%\Plutonium\plugins\ annuaire. Si ce répertoire n’existe pas, vous pouvez le créer.

Q) Comment charger des plugins sans serveur dédié ?
A) Les plugins ne sont autorisés à charger que sur le serveur. Essayer de charger un plugin sur le client entraînera un bannissement.

Q) Mes anciens plugins fonctionnent-ils encore ?
A) Oui ! La méthode héritée de chargement des plugins est toujours prise en charge. Cependant, il est recommandé de convertir vos plugins en charge via ce SDK afin de s’assurer que les futures mises à jour Plutonium ne cassent pas votre plugin.