Plutonium-Plugin-SDK#
Eine der Funktionen, die Plutonium bietet, ist die Möglichkeit für Serverbesitzer, ihre eigenen C++-DLL-Plugins zu entwickeln, um das Spielerlebnis weiter anzupassen. Um sichere und versionsunabhängige Plugins zu fördern, hat das Plutonium-Entwicklungsteam ein einfaches SDK entwickelt, das es Plugins ermöglicht, sich mit einigen der wichtigsten Aspekte jedes von Plutonium unterstützten Spiels zu verbinden.
Erste Schritte#
Erstellen Sie zunächst ein leeres C++-DLL-Projekt in Visual Studio oder mit den Tools Ihrer Wahl. In diesem Beispiel wird ein neues Projekt direkt in Visual Studio erstellt, als Git-Repository initialisiert, und die SDK-Dateien sind im Buildpfad enthalten.
Erstellen eines neuen Projekts#
- Erstellen Sie in Visual Studio ein neues Projekt mit der Option Dynamic-Link Library (DLL) für C++
- Öffnen Sie den Explorer in das Verzeichnis, das die neu erstellte .sln Datei für Ihr Projekt enthält
- Öffnen Sie ein Eingabeaufforderungsfenster in diesem Verzeichnis, und führen Sie die folgenden Befehle aus:
git init
git submodule add https://github.com/plutoniummod/plutonium-sdk.git <project-folder-name>/plutonium-sdk
- Ersetzen
<project-folder-name>
mit dem Namen Ihres Projekts, den Sie in Visual Studio eingegeben haben
- Ersetzen
- Verwenden Sie das Beispiel in V1-API So richten Sie Ihre main.cpp ein
- Erstellen von DLL
API#
Entdecken Sie die V1-API Dokumentation für eine vollständige Liste der Funktionen.
Beispiel-Plugin#
Schauen Sie sich die Beispiel-Plugin -Dokumentation für ein grundlegendes Beispiel für die Erstellung eines Plugins, das das SDK verwendet.
Häufig gestellte Fragen#
F) Wo lege ich die DLL ab, damit das Plugin geladen wird?
A) Plugins sollten sich in Ihrem %localappdata%\Plutonium\plugins\
Verzeichnis. Wenn dieses Verzeichnis nicht existiert, können Sie es erstellen.
F) Wie lade ich Plugins ohne dedizierten Server?
A) Plugins dürfen nur auf dem Server geladen werden. Der Versuch, ein Plugin auf den Client zu laden, führt zu einer Sperre.
F) Funktionieren meine alten Plugins noch?
A) Ja! Die alte Methode zum Laden von Plugins wird weiterhin unterstützt. Es wird jedoch empfohlen, Ihre Plugins so zu konvertieren, dass sie mit diesem SDK geladen werden, um sicherzustellen, dass zukünftige Plutonium-Updates Ihr Plugin nicht beschädigen.