SDK du plug-in Plutonium#

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++ pour personnaliser davantage l’expérience du joueur. Afin d’encourager les plugins sûrs et indépendants de la mise à jour de version, l’équipe de développement de Plutonium a créé un SDK simple pour permettre aux plugins de s’interfacer avec certains des aspects les plus importants de chaque jeu pris en charge par Plutonium.

Commencer#

Commencez par créer un projet DLL C++ vide dans Visual Studio ou avec les outils de votre choix. Dans cet exemple, un projet sera créé directement dans Visual Studio, initialisé en tant que référentiel Git et les fichiers SDK seront inclus dans le chemin d’accès à la génération.

Création d’un nouveau projet#

Dans Visual Studio, créez un projet à l’aide de l’option DLL (Dynamic-Link Library) 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 entré dans Visual Studio

Utiliser l’exemple dans V1 API pour configurer votre main.cpp
Générer une DLL

API#

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

Exemple de plugin#

Regardez le Exemple de plugin pour un exemple de base de création d’un plug-in qui utilise le SDK.

FAQ#

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

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

Q) Mes anciens plugins fonctionneront-ils toujours ?
R) Oui ! L’ancienne méthode de chargement des plugins est toujours prise en charge. Cependant, il est recommandé de convertir vos plug-ins pour qu’ils se chargent à l’aide de ce SDK afin de vous assurer que les futures mises à jour de Plutonium ne cassent pas votre plug-in.