Plugin-Erstellung/Java/Eclipse Entwicklungsumgebung

Aus Rising World Wiki

Erstellung eines JAVA Plugin-Projekts für Rising World Plugin-API in Eclipse

In diesem Tutorial wird beschrieben, wie man ein JAVA Plugin-Projekt für die Rising World Plugin-API in der Entwicklungsumgebung Eclipse erstellt. Eclipse ist eine weit verbreitete und leistungsfähige Entwicklungsumgebung, die sich ideal für Java-Projekte eignet, einschließlich der Entwicklung von Plugins für Spiele wie Rising World.


Eclipse installieren

Zuerst muss sichergestellt werden, dass Eclipse auf dem Computer installiert ist. Eclipse kann von der offiziellen Webseite [1] heruntergeladen werden. Für die Entwicklung von Java-Anwendungen sollte die "Eclipse IDE for Java Developers" Version ausgewählt werden.


Java Development Kit (JDK) installieren

Für die Plugin-Entwicklung ist das Java Development Kit (JDK) erforderlich. JDK 20 wird empfohlen, da es mit der Rising World Plugin-API kompatibel ist. Es ist empfehlenswert, es aus dem Spielverzeichnis zu verwenden: _New Version/Data/Java/JDK . Es kann alternativ von jdk.java.net/20 heruntergeladen werden.
Nach der Installation von der JDK muss in Eclipse der Pfad zum JDK konfiguriert werden.

Neues Projekt anlegen

  1. Eclipse öffnen und auf "File" > "New" > "Java Project" klicken.
  2. Im Dialogfeld "New Java Project" den Projektnamen eingeben, z.B. "RisingWorldPlugin".
  3. Bei der JRE auf "Use an execution environment JRE:" gehen und die passende Java-Version auswählen, die mit der Rising World API kompatibel ist.
  4. Klicken Sie auf "Next" und dann auf "Finish".

Einbindung der Rising World Plugin-API

Das Spiel wird bereits mit der API-Bibliothek (.jar) und dem entsprechenden JavaDoc ausgeliefert, beides ist im
Spielverzeichnis unter Folder-icon.png RisingWorld\_New Version\Data\SDK\ zu finden. Wenn Sie die API aus dem Spielverzeichnis verwenden, verwendet Ihre IDE immer automatisch die neueste API. Unter diesem Link gibt es eine Online-Version des neuesten JavaDoc: API Packages.

Einbindung:

  1. Im Eclipse-Projektbaum mit der rechten Maustaste auf das Projekt klicken und "Properties" auswählen.
  2. Zum Bereich "Java Build Path" navigieren und zum Reiter "Libraries" wechseln.
  3. Auf "Add External JARs..." klicken und die API.jar Datei auswählen.

Plugin-Beispiel erstellen

...
... Code als Beispiel eingeben, um mit der Entwicklung zu beginnen:

import net.risingworld.api.Plugin;
import net.risingworld.api.events.EventMethod;
import net.risingworld.api.events.Listener;
import net.risingworld.api.objects.Player;

public class MainErstesPlugin extends Plugin implements Listener
{
    @Override
    public void onEnable()
    {
       System.out.println("Mein Plugin geladen!");
       registerEventListener(this);
    }

    @Override
    public void onDisable()
    {
        System.out.println("Mein Plugin entladen!");
    }

    @EventMethod
    public void onPlayerSpawn(PlayerSpawnEvent event)
    {
        Player player = event.getPlayer();
    }
}

Plugin kompilieren und testen

Um das Plugin zu kompilieren, einfach das Projekt in Eclipse bauen. Die generierte .jar-Datei soll dann im
Plugins-Verzeichnis Folder-icon.png RisingWorld\_New Version\Plugins\ platziert werden, um das Plugin zu testen.

Weiterentwicklung und Debugging

Weiterhin ist es empfehlenswert, regelmäßig neue Features zu implementieren, das Plugin zu testen und Fehler zu beheben. Eclipse bietet umfassende Debugging-Tools, die dabei helfen können, Probleme effizient zu identifizieren und zu lösen. ...


Siehe auch