GWorld API

Einfach und schnell Welten verwalten!

Einleitung

In dem folgenden Beitrag lege ich dar, wie Du die GWorld API einfach und schnell benutzen kannst.

Erste Schritte

//Wichtigste Imports für Dich!
import de.gilljan.gworld.api.GWorldAPI;

//Neue GWorldAPI für deine Welt
GWorldAPI api = new GWorldAPI("Deine Welt");

Welt erstellen

api.create(GWorldAPI.WorldType.NORMAL);
api.create(
        GWorldAPI.WorldType.NORMAL,
        -9874561L /*Seed kann auch null sein*/,
        "Dein Generator" /*Generator null, wenn nicht benötigt*/
);

//Die Welt auf Basis des Seeds und des Generators 
//der alten Welt neuerstellen.
api.reCreate(saveOldWorld /*boolean*/);

Welt löschen

api.delete();

Welt klonen

api.clone("Name der neuen Welt");

Welt importieren

api.importExisting(
GWorldAPI.WorldType.NORMAL, 
"Dein Generator" /*Generator null, wenn nicht benötigt*/
);
api.importExisting(GWorldAPI.WorldType.NORMAL);

//Abfrage, ob die Welt bereits importiert ist
api.isImported();

Welt laden/entladen

//Welt laden
api.load();

//Welt entladen
api.unload();

//Abfrage, ob die Welt geladen ist
api.isLoaded();

Automatisches Laden der Welt aktivieren/deaktivieren

api.setAutoLoad(autoLoad /*boolean*/);

//Abfrage, ob die Welt automatisch geladen wird
api.isAutoLoad();

Flags

Getter

boolean#api.isPvp(); //Gibt true zurück, wenn PvP aktiviert ist
boolean#api.isMobSpawning(); //Gibt true zurück, wenn das Spawnen von Monstern aktiv ist
boolean#api.isAnimalSpawning(); //Gibt true zurück, wenn das Spawnen von Animals aktiv ist
boolean#api.isDayNightCycle(); //Gibt true zurück, wenn der DayNightCycle aktiv ist
boolean#api.isForceGameMode(); //Gibt true zurück, wenn ein bestimmter GameMode auf der Welt erzwungen wird
boolean#api.isWeatherCycle(); //Gibt true zurück, wenn der Wetterwechsel auf der Welt aktiv ist
GWorldAPI.WeatherType#api.getDefaultWeather(); //Gibt den gesetzten Wettertyp der Welt zurück
long#api.getDefaultTime(); //Gibt die gesetzte Festzeit der Welt zurück
GWorldAPI.Gamemode#api.getDefaultGamemode(); //Gibt den gesetzten GWorld-Gamemode zurück
GWorldAPI.Difficulty#api.getDifficulty(); //Gibt die gesetzte GWorld-Difficulty zurück

Setter

api.setPvp(enablePvp /*boolean*/); //Aktiviere/Deaktiviere PvP auf einer Welt
api.setMobSpawning(enableMobSpawning /*boolean*/); //Aktiviere/Deaktiviere MobSpawning auf einer Welt
api.setAnimalSpawning(enableAnimalSpawning /*boolean*/); //Aktiviere/Deaktiviere MobSpawning auf einer Welt
api.setWeatherCycle(enableWeatherCycle /*boolean*/); //Aktiviere/Deaktiviere das Wechseln des Wetters auf einer Welt
api.setForceGamemode(enableForceGamemode /*boolean*/): //Aktiviere/Deaktiviere das Erzwingen eines GameModes auf einer Welt
api.setDayNightCycle(enableDayNightCycle /*boolean*/); //Aktiviere/Deaktiviere den Tag- und Nachtwechsel
api.setDefaultWeather(GWorldAPI.WeatherType.SUN); //Setze das normale Wetter für eine Welt
api.setDefaultTime(defaultTime /*long*/); //Setze die normale Zeit auf einer Welt
api.setDifficulty(GWorldAPI.Difficulty.EASY); //Setze den Schwierigkeitsgrad auf einer Welt

Wichtig aber ist, die gesetzten Werte zu speichern. Nutze dafür

api.save();

Simple Getter

String#api.getName(); //Gibt den Namen der Welt zurück
Long#api.getSeed(); //Gibt den Seed der Welt zurück
String#api.getGenerator(); //Gibt den Generator der Welt zurück
GWorldAPI.WorldType#api.getType(); //Gibt den GWorld-Type zurück
org.bukkit.World#api.getBukkitWorld(); //Gibt die Bukkit-Welt zurück