Eigener Multiplayer-Server für Minecraft

Nach den ersten Schritten im letzten Heft, bei denen es um selbst erstellte Mods ging, setzen Sie dieses Mal einen eigenen Server für Ihre ganz persönliche Welt und mehrere Spieler auf. Mit einer eigenen Befehlsklasse ergänzen Sie die Möglichkeiten, die Sie in dieser Welt haben.

von Sascha Wolter

Minecraft-Server erlauben es Spielern, gemeinsam Welten zu erkunden. Jede Version von Minecraft enthält bereits einen einfachen lokalen Server zur Verwaltung der Welten. Üblicherweise kommen aber dedizierte Server zum Einsatz, sobald man mit mehreren Spielern gleichzeitig in einer eigenen Welt spielen möchte. Es gibt einen kostenlosen offiziellen Minecraft-Server für diejenigen, die sich selber um alles kümmern wollen (hosting) sowie ebenfalls offizielle, aber kostenpflichtige gehostete „Königreiche“ (engl. realms). Als das größte deutsche Minecraft Netzwerk mit rund 2 Millionen Spielern gilt GommeHD.net. Hierbei handelt es sich um Minecraft-Server, die bereits um eine Vielzahl zusätzlicher Funktionen ergänzt wurden.

Minecraft Forge

Die Installation einer Mod genannten Erweiterung (kurz für engl. modification) gelingt am einfachsten mit Minecraft Forge. Dabei handelt es sich sowohl um einen Mod-Loader zum unkomplizierten Einbinden von Modifikationen, als auch um eine vereinfachte Programmierschnittstelle (kurz API: application programming interface) zum Programmieren solcher Erweiterungen. Letztendlich muss nicht mehr getan werden, als die passende Version des Forge-Installer aus einer vertrauenswürdigen Quelle (http://files.minecraftforge.net/) herunterzuladen und zu installieren. Forge sucht im Verzeichnis

.minecraft/mods nach Erweiterungen. Unter Windows findet sich dieser Ordner normalerweise unter

%AppData%/.minecraft bei MacOS:

~/Library/Application Support/minecraft.

Abschließend muss nur noch ComputerCraft heruntergeladen und in diesen Ordner kopiert werden.

Multiplayer-Server und Plug-ins

Es gibt zahlreiche Projekte für eigene angepasste Server. Die bekannteren umfassen neben dem eigentlichen Server auch eine vereinfachte Programmierschnittstelle. Sie ist Minecraft Forge ganz ähnlich: Es wird der Original-Server dekompiliert, angepasst und wieder kompiliert. Diese inoffizielle und modifizierte Variante des originalen Minecraft-Servers ist dann über sogenannte Plug-ins erweiterbar. Die meisten Projekte orientieren sich dafür am Serversystem Bukkit. Das bekannteste davon nennt sich Spigot.

Das Aufsetzen eines eigenen Spigot-Servers wird auf der Spigot-Website für unterschiedliche Betriebssysteme erklärt. Im Wesentlichen ist es erforderlich, dass die Datei-Versionsverwaltung Git und eine Java-Laufzeitumgebung installiert sind. Anschließend müssen die BuildTools (BuildTools.jar) heruntergeladen und mit Git Bash (Windows) oder innerhalb des Terminals (Linux, MacOS) mit Java ausgeführt werden. Mit java -jar BuildTools.jar –rev latest erhält man die neueste Version, mit java -jar BuildTools.jar –rev 1.8.8 den neuesten zur Minecraft Version 1.8. kompatiblen Server. Es werden nun eine Reihe von Dateien erzeugt. Für den Minecraft Server wird das parallel zu den BuildTools abgelegte Spigot-Java-Archiv benötigt. Der genaue Dateiname hängt von der Version ab. Mit Hilfe der vorherigen Anweisung erhält man beispielsweise spigot-1.8.8.jar.

Der Server lässt sich mit der Anweisung java -Xms512M -Xmx1G -XX:MaxPermSize=128M -XX:+UseConcMarkSweepGC -jar spigot-1.8.8.jar starten. Doch der erste Start schlägt mit der Meldung „You need to agree to the EULA in order to run the server. Go to eula.txt for more info.“ fehl. Dies lässt sich einfach beheben, indem nun in der frisch generierten eula.txt-Datei die Lizenzbedingungen durch das Setzen von eula=true akzeptiert werden. An dieser Stelle bietet es sich außerdem an, in der ebenfalls frisch generierten server.properties-Datei die beiden folgenden Zeilen einzutragen, damit zum einen der Kreativmodus aktiviert ist und zum anderen auch Spieler ohne offizielles Minecraft-Benutzerkonto mitspielen dürfen: gamemode=1 online-mode=false.

In Minecraft kann nun aus dem Hauptmenü heraus der Multiplayer-Modus genutzt werden, indem man sich im nachfolgenden Menü direkt mit dem laufenden Server verbindet. Falls der Server noch nicht bereits bekannt ist, kann hier dessen URL angegeben werden.

Es gibt bereits unzählige Erweiterungen für Minecraft – je nachdem, ob diese mit Forge oder über einen Spigot-Server bereitgestellt werden, spricht man von Mod oder Plug-in. Doch nicht alle Erweiterungen harmonieren mit der verwendeten Minecraft-Version. Und manchmal fehlt auch einfach schlicht die gewünschte Funktionalität. Da ist es gut, dass man selbst Hand anlegen und – wie in unserem Fall – selbst programmieren kann.

Die Erstellung eines eigenen Plug-ins für Spigot wird dadurch erleichtert, dass während des Build-Prozesses eines Spigot-Servers ein Java-Archiv mit vereinfachter Programmierschnittstelle spigot-api-1.8.8-R0.1-SNAPSHOT-shaded.jar im Verzeichnis Spigot/Spigot-API/target erzeugt wird. Somit muss nur noch ein Java-Projekt erstellt, eine Beschreibungsdatei angelegt und diese Schnittstelle hinzugefügt werden.

1 Java-Projekt erstellen

In der Eclipse IDE legt man über das Menü File/New/Java Project ein neues Projekt an, indem man einen Projektnamen eingibt. Hier lautet er SpigotExample.

2 Hinzufügen der Bibliothek

Über die Schaltfäche Next gelangt man zum nächsten Schritt, wo im Register Libraries via Add External JARs die Spigot-API referenziert wird. Diese Bibliothek-Datei befindet sich wie oben beschrieben im Verzeichnis Spigot/Spigot-API/target. Falls man das Hinzufügen der Bibliothek einmal vergisst, kann das über die Projekteigenschaften im Menü Projec/Properties für den Java Build Path jederzeit nachgeholt werden.

3 Neue Java-Klasse anlegen

Als Nächstes wird eine neue Java-Klasse über File/New/Class angelegt. Der Einfachheit halber hier direkt im Quellcode-Verzeichnis src mit dem Namen „SpigotExample“. Wichtig ist, dass diese neue Klasse von der Oberklasse org.bukkit.plugin.java.JavaPlugin abgeleitet ist, die im Feld Superclass angegeben wird.

4 yaml-Datei anlegen

Das Minimum für ein Plug-in besteht aus der eigentlichen Java-Klasse mit dem Programmcode, der Spigot-API und einer Beschreibungsdatei für den Minecraft-Server. Jetzt wird über File/New/Untitled Text File eine Datei namens plugin.yml angelegt, die auf die Java-Klasse für das Plug-in verweist, so dass der Minecraft-Server später weiß, wie das Plug-in zu nutzen ist. Diese yaml-Datei hat in diesem Beispiel den folgenden Inhalt:

name: Example main: SpigotExample version: 1.0

5 Plug-in exportieren

Das Plug-in exportiert man nun über File/Export als Java Archive (JAR file), indem man den Quellcode und die plugin.yml-Datei als Ressourcen auswählt und das plugins-Verzeichnis des Servers als Ziel der neuen JAR-Datei angibt.

6 Im Server Aktivierung des Plug-ins prüfen

Sobald nun der Minecraft-Server gestartet wird, sollte in der Konsole zu sehen sein, dass das Plug-in aktiviert wurde: „[10:35:48 INFO]: [Example] Enabling Example v1.0“. Das Plug-in kann bisher noch nichts, aber das lässt sich einfach ändern, indem wir einen neuen Befehl hinzufügen.

7 Klasse für Befehl anlegen

Dazu wird eine Klasse über File/New/Class angelegt, die in diesem Beispiel den Namen „ExampleCommand“ erhält und außerdem zwingend die Schnittstelle org.bukkit.command.CommandExecutor implementiert.

8 Code für den Befehl eingeben

import org.bukkit.Bukkit;
import org.bukkit.command.Command;
import org.bukkit.command.CommandExecutor;
import org.bukkit.command.CommandSender;
import org.bukkit.command.ConsoleCommandSender;
import org.bukkit.entity.Player;
public class ExampleCommand implements CommandExecutor {
     @Override
     public boolean onCommand(CommandSender arg0, Command arg1, String arg2, String[] arg3) {
          if (arg0 instanceof ConsoleCommandSender) {
               ConsoleCommandSender sender = (ConsoleCommandSender) arg0;
               Bukkit.broadcastMessage("Hello " + sender.getName());
          } else if (arg0 instanceof Player) {
               Player sender = (Player) arg0;
               Bukkit.broadcastMessage("Hello " + sender.getName() + " in World " + sender.getWorld().getName());
          }
          return false;
     }
}

Innerhalb der Klasse fügen wir nun noch den Programmcode für den eigentlichen Befehl in der Methode onCommand hinzu. Es soll der hello-Befehl realisiert werden, der bereits im ersten Teil zur Veranschaulichung diente und den Namen des aktuellen Spielers ausgibt. Im Code wird unterschieden, ob der Befehl über die Serverkonsole oder aus Minecraft heraus in dem Chat-Bereich von einem Spieler aufgerufen wurde. Anschließend wird eine Nachricht mit dem Namen der Konsole beziehungsweise mit dem Namen des Spieles und dem Bezeichner der aktuellen Welt erzeugt.

9 Befehl in yaml-Datei eintragen

Damit der Minecraft-Server den neuen Befehl und dessen Verwendung auch kennt, wird dieser in der plugin.yml-Datei eingetragen:

name: Example main: SpigotExample version: 1.0 commands: hello: usage: /hello

10 Befehls-Ausführer zuordnen

import org.bukkit.plugin.java.JavaPlugin;
public class SpigotExample extends JavaPlugin {
     @Override
     public void onEnable() {
          getCommand("hello").setExecutor(new ExampleCommand());
     }
}

Im nächsten Schritt wird innerhalb der Hauptklasse des Plug-ins die onEable-Methode genutzt, um Minecraft den neuen Befehl gleich von Anfang an während der Aktivierung der Erweiterung bekannt zu machen. Dafür wird dem in der yaml-Datei deklarierten Befehl ein Befehls-Ausführer zugeordnet, in diesem Fall der neu programmierte Befehl ExampleCommand:

11 Plug-in exportieren und aktivieren

Die Auswirkungen des Befehls sind nun sowohl in Minecraft als auch auf der Server-Konsole zu sehen. Natürlich nur, wenn das neue Plug-in auch wieder exportiert und aktiviert wurde. Dies gelingt wahlweise über Stoppen und Neustarten des Servers oder einfacher über die Eingabe reload auf der Server-Konsole. Der eigentliche Befehl kann in der Server-Konsole als hello oder aus einem mit dem Server verbundenen Minecraft im Chat-Fenster mit führendem vorwärts gerichtetem Schrägstrich über /hello aufgerufen werden.

Ausblick

Die zahlreichen Varianten von Minecraft, deren Programmierung und die Erweiterungsmöglichkeiten zeigen, dass die virtuelle Blockwelt auf vielfältige Weise von jedem angepasst werden kann. Je nach Programmiergeschick und Funktionsumfang gibt es unterschiedliche Herangehensweisen, um ans Ziel zu gelangen.

Und wer sich nicht so richtig an die Programmierung von Mods und Plug-ins traut, für den gibt es zahleiche vorgefertigte Erweiterungen bis hin zur speziellen Minecraft-Version für die Lehre. Es soll sogar Lehrer geben, die Minecraft auch außerhalb des Informatikunterricht versuchen, etwa um auf Basis der Rezepte in Minecraft Chemie zu vermitteln: Zum Beispiel werden analog zum Bohrschen Atommodell dank des Advanced Chemistry Mods mit Protonen, Elektronen und Neutronen auf einer speziellen Werkbank Atome „gecraftet“.

Wem das nicht reicht: Wir haben auf Github ein Server-Plug-in im Quellcode zur Verfügung gestellt, das viele Aktionen in Minecraft als REST-Schnittstelle bereitstellt. So kann Minecraft beinahe aus jeder Technologie heraus genutzt werden, beispielsweise um reale Hardware wie ein Smart Home mit einem virtuellen Zuhause in Minecraft zu vermischen. —esk/fls