Administratoren (Benutzerhandbuch)
- Befehls-Übersicht
- Standard Konfigurationsdateien
- Migration von v1-legacy zu v2
- Wechsel von YAML (File) zu MySQL (DB)
- Die Flags und ihre möglichen Werte
- PlaceholderAPI (PAPI) Integration
- /gcreate - Welten erstellen
- /gset - Welten konfigurieren
- /gimport - Bestehende Welten importieren
- /grecreate - Eine Welt in ihren Ursprungszustand versetzen
- /ginfo - Informationen zu einer Welt
- /gtp - Zwischen Welten teleportieren
Befehls-Übersicht
Befehle & Permissions
<required> - Um den Befehl auszuführen, muss dieses Argument angegeben werden
[optional] - Dieses Argument muss nicht angegeben werden und kann ausgelassen werden. Ein Standardwert wird gewählt
<Name> - jeweils der Name der gewählten Welt
Sofern möglich, sind alle benötigten Parameter tabbar (mit der Tabulatortaste vervollständigbar)
| Befehl | Argumente | Beschreibung | Permission(s) |
| /gcreate | <Name> [Environment] [Seed] [Generator] | Erstellt eine neue Welt. Environment (Normal/Nether/End) ist optional, ebenso Generator und Seed. | gworld.commands.create |
| /gimport | <Name> <Environment> [Generator] |
Importiert einen existierenden Welt-Ordner in das GWorld System. Das Environment muss angegeben werden. Sofern ein Generator verwendet wurde, muss dieser auch angegeben werden |
gworld.commands.import |
| /gclone | <Name> <Name der geklonten Welt> | Klont eine Welt. | gworld.commands.clone |
| /gset | [Name] <Flag> <Wert> |
Ändert eine Einstellung der Welt. Sofern kein Weltenname angegeben wird, wird die aktuelle Welt des Spielers gewählt. Flags siehe Seite: |
gworld.commands.set |
| /gdelete | <Name> | Löscht eine Welt und ihre Dateien unwiderruflich | gworld.commands.delete |
| /gworlds | - |
Listet alle geladenen Welten auf. Teleportieren zur Welt per Klick auf den Eintrag |
gworld.commands.worlds |
| /gtp | <Name> [playername|@all] | Teleportiert dich, einen anderen Spieler oder alle Spieler in eine Welt. |
gworld.commands.tp (Basis) Permissions für die Basis müssen immer gesetzt sein!
Für bestimmte Welten: gworld.commands.tp.<Name>
Alle Welten: gworld.commands.tp.*
Andere Spieler teleportieren: gworld.tp.other Diese Permission wird immer extra benötigt Weitere Informationen siehe auf der Seite: |
| /ginfo | [Name] |
Zeigt Details (Seed, Umgebung, Flags) einer Welt an. Sofern kein Weltenname angegeben wird, wird die aktuelle Welt des Spielers gewählt. Für mehr Details Seite: /ginfo |
gworld.commands.info |
| /grecreate | <Name> <backup> |
Löscht die Chunks und generiert die Welt mit gleichem Seed neu. Es kann ein Backup im Verzeichnis "old_maps" angelegt werden. |
gworld.commands.recreate |
| /gload | <Name> | Lädt eine existierende Welt. | gworld.commands.load |
| /gunload | <Name> | Entlädt eine Welt, ohne sie zu löschen. Spieler werden teleportiert. | gworld.commands.unload |
| /ghelp | [Seite] | Zeigt Informationen zu den Befehlen ingame an. | gworld.commands.help |
Admin-Permission: gworld.* um direkt durchzustarten
Standard Konfigurationsdateien
Hier findest du alle Konfigurations- und Sprachdateien, die mit GWorld v2 ausgeliefert werden.
Sofern Abschnitte fehlen oder manuell übernommen werden sollen, findest du sie hier.
config.yml
# Copyright (c) Gilljan 2020-2026. All rights reserved.
# GWorld v2
#General
Prefix: '&eGWorld &8┃&7' #prefix of the plugin
Language: 'EN' #avaiable languages: german (de), english (en)
MainWorld: 'world' #while deleting a world the players which are on the world will be teleported to this world
#Update-Notifications
UpdateNotification: true
#AutoImporter
AutoImport: true #deactivate to stop import of maps provided by other systems
#Storage
Storage:
Type: 'YAML' #avaiable types: YAML, MYSQL
Host: 'localhost'
Username: 'root'
Password: ''
Database: 'gworld'
Port: 3306
de_DE.yml
#Copyright (c) Gilljan 2020-2026. All rights reserved.
#Plugin written by Gilljan
# %prefix% is a global placeholder for the prefix of the plugin, defined in the config.yml
NoPerm: '%prefix% &cDazu hast du keine Rechte!'
SecurityMessage: '%prefix% &cAus Sicherheitsgründen darf ein Weltenname keine Punkte (.) oder Schrägstriche (/) enthalten.'
UpdateNotification: '%prefix% &aEs ist eine neue Version von GWorld verfügbar: &e%version%&a. Link zum Update: &e%link%&a.'
AutoImport: '%prefix% &aDie Welt &e%world% &awurde automatisch von GWorld importiert.'
Create:
creating: '%prefix% &aDie Welt &e%world% &awird nun erstellt und geladen...'
success: '%prefix% &aDie Welt &e%world% &awurde erfolgreich erstellt!'
failed: '%prefix% &cDie Welt &e%world% &ckonnte nicht erstellt werden.'
use: '%prefix% &cBenutze: /gcreate <Weltname> <normal|nether|end|large_biomes|amplified|flat> {seed} {World Generator}'
Import:
creating: '%prefix% &aDie Welt &e%world% &awird nun importiert und geladen...'
success: '%prefix% &aDie Welt &e%world% &awurde erfolgreich importiert!'
failed: '%prefix% &cDie Welt &e%world% &ckonnte nicht importiert werden.'
use: '%prefix% &cBenutze: /gimport <Weltname> <normal|nether|end|large_biomes|amplified|flat> {World Generator}'
Teleport:
success: '%prefix% &aDu wurdest erfolgreich auf die Welt &e%world% &ateleportiert.'
failed: '%prefix% &cKonnte nicht Teleportieren.'
no_perm_world: '%prefix% &cDu hast keine Berechtigung, dich in die Welt &e%world% &czu teleportieren.'
no_perm_other: '%prefix% &cDu hast keine Berechtigung, andere Spieler zu teleportieren.'
failed_console: '%prefix% &cNur Spieler können diesen Befehl ausführen.'
player_target_success: '%prefix% &aDu wurdest von jemand anderem erfolgreich auf die Welt &e%world% &ateleportiert.' #Variable %player% ist möglich
sender_target_success: '%prefix% &aDu hast den Spieler &e%player% &aerfolgreich auf die Welt &e%world% &ateleportiert.'
sender_target_all_success: '%prefix% &aDu hast alle Spieler erfolgreich auf die Welt &e%world% &ateleportiert.' #%count% for number of teleported players is possible
use: '%prefix% &cBenutze: /gtp <Weltname> {Spielername}'
Clone:
creating: '%prefix% &aDie Welt &e%world% &awird nun zu &e%targetworld% &ageklont und geladen...'
success: '%prefix% &aDie Welt &e%world% &awurde zu &e%targetworld% &ageklont.'
failed: '%prefix% &cDie Welt konnte nicht geklont werden.'
use: '%prefix% &cBenutze: /gclone <Weltname> <TargetWeltname>'
Delete:
success: '%prefix% &aDie Welt &e%world% &awurde erfolgreich gelöscht.'
failed: '%prefix% &cDie Welt &e%world% &ckonnte nicht gelöscht werden.'
use: '%prefix% &cBenutze: /gdelete <Weltname>'
Worlds:
loadedMaps: '%prefix% &aEs sind folgende Maps geladen:'
noMapsloaded: '%prefix% &cEs sind gerade keine Maps geladen.'
hoverTeleport: '&aKlicke, um dich auf &e%world% &azuteleportieren.'
use: '%prefix% &cBenutze: /gworlds'
Set:
success: '%prefix% &aDie Weltenkonfiguration der Welt &e%world% &awurde erfolgreich geändert:'
changes: '%prefix% &6%flag% &awurde von &6%oldValue% &aauf &e%newValue% &agesetzt.'
add: '%prefix% &aDas Entity &e%value% &awurde zur Liste &6%flag% &ahinzugefügt.'
remove: '%prefix% &aDas Entity &e%value% &awurde von der Liste &6%flag% &aentfernt.'
failed: '%prefix% &cDie Weltenkonfiguration der Welt &e%world% &ckonnte nicht geändert werden. Flag: &e%flag% &ckonnte nicht auf &e%value% &cgesetzt werden.'
invalidEntity: '%prefix% &cDas Entity &e%value% &cist ungültig.'
use: '%prefix% &cBenutze: /gset <Weltname> <flag> <value>'
flags:
timeCycle: 'timeCycle'
time: 'time'
weatherCycle: 'weatherCycle'
weather: 'weather'
pvp: 'pvp'
monsters: 'mobSpawning'
disabledMonsters: 'disabledMonsters'
animals: 'animalSpawning'
disabledAnimals: 'disabledAnimals'
forcedGamemode: 'forcedGamemode'
defaultGamemode: 'defaultGamemode'
difficulty: 'difficulty'
randomTickSpeed: 'randomTickSpeed'
announceAdvancements: 'announceAdvancements'
loadOnStartup: 'loadOnStartup'
enabled: 'aktiviert'
disabled: 'deaktiviert'
true: '&atrue'
false: '&cfalse'
values: '&e'
Info:
failed: '%prefix% &cDie Welt &e%world% &ckonnte nicht gefunden werden.'
failed_world: '%prefix% &cDie Welt auf der du dich befindest, wurde nicht importiert.'
use: '%prefix% &cBenutze: /ginfo <Weltenname>'
header: '&8---- &eGINFO&8 ----'
footer: '&8---- &eGINFO&8 ----'
name: '&6Weltname &8: '
generator: '&6generator &8: '
flags:
type: '&6type &8: '
environment: '&6environment &8: '
timeCycle: '&6timeCycle &8: '
time: '&6time &8: '
weatherCycle: '&6weatherCycle &8: '
weather: '&6weather &8: '
pvp: '&6pvp &8: '
mobs: '&6mobs &8: '
disabledMobs: '&6disabledMobs &8: '
animals: '&6animals &8: '
disabledAnimals: '&6disabledAnimals &8: '
forcedGamemode: '&6forcedGamemode &8: '
defaultGamemode: '&6defaultGamemode &8: '
difficulty: '&6difficulty &8: '
randomTickSpeed: '&6randomTickSpeed &8: '
announceAdvancements: '&6announceAdvancements &8: '
keepSpawnInMemory: '&6keepSpawnInMemory &8: '
loadOnStartup: '&6loadOnStartup &8: '
true: '&atrue'
false: '&cfalse'
values: '&e%value%'
none: '&ckeine'
Recreate:
creating: '%prefix% &aDie Welt wird basierend auf der &e%world% &aneu erstellt und geladen.'
success: '%prefix% &aDie Welt &e%world% &awurde neu erstellt und geladen.'
failed: '%prefix% &cDie Welt &e%world% &ckonnte nicht neu erstellt werden.'
use: '%prefix% &cBenutze: /grecreate <Weltenname> <speichern (true:false)>'
Unload:
unloading: '%prefix% &aDie Welt &e%world% &awird nun entladen.'
success: '%prefix% &aDie Welt &e%world% &awurde erfolgreich entladen.'
alreadyUnloaded: '%prefix% &cDie Welt &e%world% &cist nicht geladen.'
failed: '%prefix% &cDie Welt &e%world% &ckonnte nicht entladen werden.'
teleport_players: '%prefix% &cDa die Welt &e%world% ¢laden wurde, wurdest du auf die Standard Welt teleportiert!'
use: '%prefix% &cBenutze: /gunload <Weltenname>'
Load:
loading: '%prefix% &aDie Welt &e%world% &awird nun geladen.'
success: '%prefix% &aDie Welt &e%world% &awurde erfolgreich geladen.'
alreadyLoaded: '%prefix% &cDie Welt &e%world% &cist bereits geladen.'
failed: '%prefix% &cDie Welt &e%world% &ckonnte nicht geladen werden.'
use: '%prefix% &cBenutze: /gload <Weltenname>'
Help:
header: '&eGWorld &8- &eWorld Managementsystem &8(&eSeite %site%&8/&e%maxsite%&8)'
use: '%prefix% &cBenutze: /ghelp <Seitenzahl>'
gclone: '&8/&egclone <Weltname> <TargetWeltname> &8- &7Klone eine Welt mit den gesetzten Flags und dem Gebauten'
gcreate: '&8/&egcreate <Weltname> <normal|nether|end|large_biomes|amplified|flat> {seed} {World Generator} &8- &7Erstelle eine Welt. Wähle optional einen Seed oder einen WorldGenerator aus.'
gdelete: '&8/&egdelete <Weltname> &8- &7Lösche eine Welt.'
gimport: '&8/&egimport <Weltname> <normal|nether|end|large_biomes|amplified|flat> {World Generator} &8- &7Importiere eine Welt. Wurde diese mit einem WorldGenerator erstellt, muss dieser angegeben werden, damit die Welt funktional bleibt.'
ginfo: '&8/&eginfo <Weltname> &8- &7Gibt die Werte der Flags für die angegebene Welt aus. Als Spieler ist es möglich, den Weltenname wegzulassen (dann wird die aktuelle Welt gewählt).'
gload: '&8/&egload <Weltname> &8- &7Lädt eine importierte, aber ungeladene Welt.'
grecreate: '&8/&egrecreate <Weltname> <speichern (true:false)> &8- &7Erstellt die Welt auf Basis des Seeds und Generators neu. Es besteht die Möglichkeit, die alte Welt sichern zu lassen.'
gset: '&8/&egset <Weltname> <Flag> <Value/Wert> &8- &7Setzt die Flags für eine bestimmte Welt. Als Spieler ist es möglich, den Weltenname wegzulassen (dann wird die aktuelle Welt gewählt).'
gtp: '&8/&egtp <Weltenname> {Spielername} &8- &7Teleportiert dich oder einen anderen Spieler auf eine Welt.'
gunload: '&8/&egunload <Weltenname> &8- &7Entlade eine importierte Welt, ohne diese zu löschen. Als Spieler ist es möglich, den Weltenname wegzulassen (dann wird die aktuelle Welt gewählt).'
gworlds: '&8/&egworlds &8- &7Liste alle geladenen Welten. Per Klick teleportierst du dich auf die gewählte Welt.'
en_EN.yml
#Copyright (c) Gilljan 2020-2026. All rights reserved.
#Plugin written by Gilljan
# %prefix% is a global placeholder for the prefix of the plugin, defined in the config.yml
NoPerm: '&cYou do not have the permission for that!'
SecurityMessage: '&cFor security reasons, a world name may not contains dots (.) or slashes (/).'
UpdateNotification: '&aThere is a new version of GWorld available: &e%version%&a. Link to the update: &e%link%&a.'
AutoImport: '&aThe world &e%world% &awas automatically imported from GWorld.'
Create:
creating: '%prefix% &aThe world &e%world% &awill now be created and loaded...'
success: '%prefix% &aThe world &e%world% &awas successfully created!'
failed: '%prefix% &cThe world &e%world% &ccould not be created!'
use: '%prefix% &cUse: /gcreate <world name> <normal|nether|end|large_biomes|amplified|flat> {seed} {world generator}'
Import:
creating: '%prefix% &aThe world &e%world% &awill now be imported and loaded...'
success: '%prefix% &aThe world &e%world% &awas successfully imported!'
failed: '%prefix% &cThe world &e%world% &ccould not be imported.'
use: '%prefix% &cUse: /gimport <world name> <normal|nether|end|large_biomes|amplified|flat> {world generator}'
Teleport:
success: '%prefix% &aYou have been successfully teleported to the world &e%world%&a.'
failed: '%prefix% &cCould not teleport.'
no_perm_world: '%prefix% &cYou do not have permission to teleport to the world &e%world%&c.'
no_perm_other: '%prefix% &cYou do not have permission to teleport other players.'
failed_console: '%prefix% &cOnly players can execute this command.'
player_target_success: '%prefix% &aYou have been successfully &ateleported to the world &e%world% &aby someone else.' #Variable %player% is possible
sender_target_success: '%prefix% &aYou have successfully teleported the player &e%player% &ato the world &e%world%&a.'
sender_target_all_success: '%prefix% &aYou have successfully teleported all players to the world &e%world%&a.' #%count% for number of teleported players is possible
use: '%prefix% &cUse: /gtp <world name> {playername}'
Clone:
creating: '%prefix% &aThe world &e%world% &ais now cloned and loaded to &e%targetworld%&a...'
success: '%prefix% &aThe world &e%world% &awas cloned to &e%targetworld%&a.'
failed: '%prefix% &cThe world could not be cloned.'
use: '%prefix% &cUse: /gclone <world name> <target world name>'
Delete:
success: '%prefix% &aThe world &e%world% &awas successfully deleted.'
failed: '%prefix% &cThe world &e%world% &ccould not be deleted.'
use: '%prefix% &cUse: /gdelete <world name>'
Worlds:
loadedMaps: '%prefix% &aThe following maps are loaded:'
noMapsloaded: '%prefix% &cThere are no maps loaded currently.'
hoverTeleport: '&aClick to teleport to &e%world%&a.'
use: '%prefix% &cUse: /gworlds'
Set:
success: '%prefix% &aThe world configuration of the world &e%world% &awas successfully changed:'
changes: '%prefix% &6%flag% &ahas been set from &6%oldValue% &ato &e%newValue%&a.'
add: '%prefix% &aThe entity &e%value% &ahas been added to the list &6%flag%&a.'
remove: '%prefix% &aThe entity &e%value% &ahas been removed from the list &6%flag%&a.'
invalidEntity: '%prefix% &cThe entity &e%value% &cis invalid.'
failed: '%prefix% &cThe world configuration of the world &e%world% &ccould not be changed.'
use: '%prefix% &cUse: /gset <world name> <flag> <value>'
flags:
timeCycle: 'timeCycle'
time: 'time'
weatherCycle: 'weatherCycle'
weather: 'weather'
pvp: 'pvp'
monsters: 'mobSpawning'
disabledMonsters: 'disabledMonsters'
animals: 'animalSpawning'
disabledAnimals: 'disabledAnimals'
forcedGamemode: 'forcedGamemode'
defaultGamemode: 'defaultGamemode'
difficulty: 'difficulty'
randomTickSpeed: 'randomTickSpeed'
announceAdvancements: 'announceAdvancements'
loadOnStartup: 'loadOnStartup'
enabled: 'enabled'
disabled: 'disabled'
true: '&atrue'
false: '&cfalse'
values: '&e'
Info:
failed: '%prefix% &cThe world &e%world% &ccould not be found.'
use: '%prefix% &cUse: /ginfo <world name>'
header: '&8---- &eGINFO&8 ----'
footer: '&8---- &eGINFO&8 ----'
name: '&6World name &8: '
generator: '&6generator &8: '
flags:
type: '&6type &8: '
environment: '&6environment &8: '
timeCycle: '&6timeCycle &8: '
time: '&6time &8: '
weatherCycle: '&6weatherCycle &8: '
weather: '&6weather &8: '
pvp: '&6pvp &8: '
mobs: '&6mobs &8: '
disabledMobs: '&6disabledMobs &8: '
animals: '&6animals &8: '
disabledAnimals: '&6disabledAnimals &8: '
forcedGamemode: '&6forcedGamemode &8: '
defaultGamemode: '&6defaultGamemode &8: '
difficulty: '&6difficulty &8: '
randomTickSpeed: '&6randomTickSpeed &8: '
announceAdvancements: '&6announceAdvancements &8: '
keepSpawnInMemory: '&6keepSpawnInMemory &8: '
loadOnStartup: '&6loadOnStartup &8: '
true: '&atrue'
false: '&cfalse'
values: '&e%value%'
none: '&cnone'
Recreate:
creating: '%prefix% &aThe world is newly created and loaded based on the &e%world%&a.'
success: '%prefix% &aThe world &e%world% &awas newly created and loaded.'
failed: '%prefix% &cThe world &e%world% &ccould not be recreated.'
use: '%prefix% &cUse: /grecreate <worldname> <keepSaved (true:false)>'
Unload:
unloading: '%prefix% &aThe world &e%world% &ais now unloading.'
success: '%prefix% &aThe world &e%world% &awas successfully unloaded.'
alreadyUnloaded: '%prefix% &cThe world &e%world% &cis not loaded.'
failed: '%prefix% &cThe world &e%world% &ccould not be unloaded.'
teleport_players: '%prefix% &cAs the world &e%world% &chas been unloaded, you have been teleported to the default world!'
use: '%prefix% &cUse: /gunload <worldname>'
Load:
loading: '%prefix% &aThe world &e%world% &ais now loading.'
success: '%prefix% &aThe world &e%world% &awas successfully loaded.'
alreadyLoaded: '%prefix% &cThe world &e%world% &cis already loaded.'
failed: '%prefix% &cThe world &e%world% &ccould not be loaded.'
use: '%prefix% &cUse: /gload <worldname>'
Help:
header: '&eGWorld &8- &eWorld management system &8(&epage %site%&8/&e%maxsite%&8)'
use: '%prefix% &cUse: /ghelp <page number>'
gclone: '&8/&egclone <worldname> <targetworldname> &8- &7clone a world with the flags set and the built'
gcreate: '&8/&egcreate <worldname> <normal|nether|end|large_biomes|amplified|flat> {seed} {World Generator} &8- &7Create a world. Optionally select a seed or a world generator.'
gdelete: '&8/&egdelete <worldname> &8- &7Delete a world.'
gimport: '&8/&egimport <worldname> &8- &7<normal|nether|end|large_biomes|amplified|flat> {World Generator} - Import a world. If this was created with a WorldGenerator, it must be specified to keep the world functional.'
ginfo: '&8/&eginfo <worldname> &8- &7Output the values of the flags for the specified world. As a player it is possible omit the world name (then the current world is selected).'
gload: '&8/&egload <worldname> &8- &7Loads an imported but unloaded world.'
grecreate: '&8/&egrecreate <worldname> <save (true:false)> &8- &7Creates the world based on the seed and generator new. There is an option to have the old world saved.'
gset: '&8/&egset <worldname> <flag> <value/value> &8- &7Sets the flags for a given world. As a player, it is possible to, omit the world name (then the current world is selected).'
gtp: '&8/&egtp <worldname> {playername} &8- &7Teleports you or another player to a world.'
gunload: '&8/&egunload <worldname> &8- &7Unload an imported world without deleting it. As a player it is possible to omit the world name (then the current world is selected).'
gworlds: '&8/&egworlds &8- &7List all loaded worlds. Click to teleport to the selected world.'
Migration von v1-legacy zu v2
GWorld v2 verfügt über intelligente Migrations-Systeme, die den Übergang von älteren Versionen oder den Wechsel zwischen Speichermedien (Dateien zu Datenbank) so einfach wie möglich gestalten.
Du suchst nach einer Möglichkeit, von YAML zu MySQL zu wechseln? Dann folge bitte diesem Link: Wechsel von YAML (File) zu MySQL (DB)
Migration von GWorld v1 zu v2
Wenn du von der ersten Version von GWorld auf v2 aktualisierst, erkennt das Plugin dies automatisch beim ersten Start.
Funktionsweise
- Erkennung: Das Plugin sucht nach einer existierenden
worlds.yml, in der...- das Feld
ConfigVersionfehlt - die Liste
LoadWorldsexistiert - die Liste
Worldsexistiert
- das Feld
- Automatisches Backup: Bevor Änderungen an den Datenbeständen vorgenommen werden, benennt GWorld die alte Datei in
worlds_legacy_backup.ymlum. - Daten-Konvertierung: Der
LegacyMigratorliest alle alten Welten-Definitionen aus und überführt sie in das neue, strukturierte v2-Format. Fehlende neue Felder werden mit Standardwerten (Defaults) aufgefüllt. - Seed-Reparatur: Da in der v1 keine Seeds abgespeichert wurden, erkennt GWorld v2 fehlende Seeds beim ersten Laden der Welt automatisch und liest den korrekten Seed aus den Welt-Dateien aus und korrigiert den Eintrag.
Hinweis: Während der Migration wird die Konsole dich über den Fortschritt informieren. Sobald die Datei worlds.yml eine ConfigVersion: 1 oder höher enthält, ist der Prozess abgeschlossen. Dies wird ebenfalls in der Konsole ausgegeben.
Nach einer erfolgreichen Migration starten GWorld v2 normal und alle Welten werden geladen
Sicherheitsmaßnahmen & Voraussetzungen
Um eine reibungslose Migration zu gewährleisten, beachte bitte folgende Punkte:
Voraussetzungen (siehe Einführung)
- Java-Version: GWorld v2 benötigt zwingend mindestens Java 21, da moderne Sprachfeatures verwendet werden.
Checkliste
- Erstelle vor dem Upgrade ein manuelles Backup deines gesamten Plugin-Ordners.
- Prüfe nach der Migration mit dem Befehl
/gworlds, ob alle Welten korrekt gelistet werden. - Kontrolliere die Server-Konsole auf Fehlermeldungen während des ersten Starts.
Beispielhafte worlds.yml Konfigurationen
| worlds.yml (v1) | worlds.yml (v2.0.1) |
|
|
Diese Dokumentation bezieht sich auf GWorld Version 2.0.1.
Wechsel von YAML (File) zu MySQL (DB)
GWorld v2 verfügt über intelligente Migrations-Systeme, die den Übergang von älteren Versionen oder den Wechsel zwischen Speichermedien (Dateien zu Datenbank) so einfach wie möglich gestalten.
Du suchst nach Informationen zur Migration von der v1 zur v2? Dann folge bitte diesem Link: Migration von v1-legacy zu v2
Wechsel von YAML zu MySQL
Möchtest du deine Welten-Daten nicht mehr lokal in einer Datei, sondern zentral in einer MySQL-Datenbank speichern, bietet GWorld v2 einen automatischen Transfer-Dienst.
Schritte zur Umstellung
-
Stoppe deinen Server.
-
Öffne die
config.ymlund setze denStorage.TypeaufMYSQL.-
Sollte
Storage.Typefehlen, update bitte deine config.yml. Siehe: Standard Konfigurationsdateien
-
-
Trage deine Datenbank-Zugangsdaten im Abschnitt
MySQLein. -
Starte den Server neu.
Was passiert beim Start?
- Daten-Transfer: GWorld stellt fest, dass MySQL aktiviert ist, aber noch eine lokale
worlds.ymlmit Daten existiert. - Import: Das Plugin liest alle Welten aus der Datei und schreibt sie in die entsprechenden MySQL-Tabellen.
- Abschluss: Um einen doppelten Import zu verhindern, wird die lokale Datei nach erfolgreichem Abschluss in
worlds.yml.importedumbenannt. - Sicherheit: Sofern eine Welt in der Datenbank bereits existiert, wird diese zur Sicherheit der Integrität nicht migiriert.
Sicherheitsmaßnahmen & Voraussetzungen
Um eine reibungslose Migration zu gewährleisten, beachte bitte folgende Punkte:
Voraussetzungen
- Datenbank-Verfügbarkeit: Wenn MySQL konfiguriert ist, bricht das Plugin den Startvorgang ab, falls keine Verbindung hergestellt werden kann, um Datenverlust zu vermeiden.
Checkliste
- Stelle sicher, dass der Datenbank-Nutzer Berechtigungen zum Erstellen von Tabellen (
CREATE), Einfügen (INSERT) und Ändern (UPDATE) von Daten hat. - Erstelle vor dem Wechsel ein manuelles Backup deines gesamten Plugin-Ordners.
- Prüfe nach dem Wechsel mit dem Befehl
/gworlds, ob alle Welten korrekt gelistet werden.
Diese Dokumentation bezieht sich auf GWorld Version 2.0.1.
Die Flags und ihre möglichen Werte
Hier findest du eine Übersicht aller möglichen Flags und die dazu wählbaren Werte.
| Flag | Werte | Beschreibung |
| ALIAS |
Text |
Setze den Anzeigenamen der Welt (für PAPI) |
| WEATHER_CYCLE |
true - Wetterveränderung aktiv false - Statisches Wetter, Wetter von WEATHER wird gesetzt |
Steuere, ob sich das Wetter ändern soll |
| WEATHER |
clear - Kein Regen/Gewitter thunder - Gewitter rain - Regen |
Setze das Wetter für die Welt Greift, wenn WEATHER_CYCLE auf false |
| TIME_CYCLE |
true - Zeit läuft weiter false - Statische Zeit, Zeit von TIME wird gesetzt |
Steuere, ob die Zeit weiterlaufen soll |
| TIME | Ganzzahliger Wert zwischen 0 und 24000 |
Setze die Zeit für die Welt Greift, wenn TIME_CYCLE auf false |
| DIFFICULTY |
peaceful - Friedlich easy - Einfach normal - Normal hard - Schwer = Minecraft Difficulty |
Setze den Schwierigkeitsgrad für die Welt |
| PVP |
true - PVP ist aktiv false - PVP ist deaktiviert |
Steuere, ob PVP möglich sein soll |
| MONSTERS |
true - Monster spawnen false - Monster spawnen nicht mehr |
Steuere, ob Monster generell spawnen dürfen |
| DISABLED_MONSTERS |
Monster, die in der aktuellen Minecraft-Version existieren Finde alle Möglichkeiten über das Tabben der Werte |
Sofern MONSTERS auf true gesetzt ist, können hier einzelne Monster deaktiviert (und wieder aktiviert) werden |
| ANIMALS |
true - Tiere spawnen false - Tiere spawnen nicht mehr |
Steuere, ob Tiere generell spawnen dürfen |
| DISABLED_ANIMALS |
Tiere, die in der aktuellen Minecraft-Version existieren Finde alle Möglichkeiten über das Tabben der Werte |
Sofern ANIMALS auf true gesetzt ist, können hier einzelne Tiere deaktiviert (und wieder aktiviert) werden |
| FORCED_GAMEMODE |
true - Erzwinge einen Gamemode in dieser Welt false - Erzwinge keinen Gamemode in dieser Welt |
Steuere, ob ein Gamemode in einer Welt erzwungen werden soll
|
| DEFAULT_GAMEMODE |
Erzwinge/setze einen Gamemode in einer Welt Greift nur, wenn FORCED_GAMEMODE auf true |
|
| RANDOM_TICK_SPEED | Ganzzahliger Wert | Setze den Tick-Speed einer Welt |
| ANNOUNCE_ADVANCEMENTS |
true - Erfolge werden im Chat angezeigt false - Erfolge werden nicht im Chat angezeigt |
Steuere, ob Erfolge angezeigt werden |
| LOAD_ON_STARTUP |
true - Die Welt wird beim Serverstart geladen false - Die Welt wird nicht standardmäßig geladen |
Steuere, ob eine Welt beim Serverstart geladen werden soll Die Standardwelt kann nicht entladen werden und muss standardmäßig geladen werden |
PlaceholderAPI (PAPI) Integration
GWorld v2 bietet eine native Unterstützung für die PlaceholderAPI. Das bedeutet, dass du keine zusätzliche Expansion über die PAPI-eCloud herunterladen musst. Sobald PlaceholderAPI auf deinem Server installiert ist, registriert GWorld seine Platzhalter automatisch.
Verfügbare Platzhalter
Alle GWorld-Platzhalter nutzen das Präfix %gworld_.
|
Platzhalter |
Beschreibung |
Beispiel-Ausgabe |
|---|---|---|
|
|
Der formatierte Anzeigename (Alias) der Welt, in der sich der Spieler aktuell befindet. |
|
|
|
Der formatierte Anzeigename einer spezifisch benannten Welt. |
➔
|
|
|
Der technische Ordnername der Welt, in der sich der Spieler aktuell befindet. |
|
|
|
Gibt den technischen Namen der angefragten Welt zurück. Nützlich für Skripte oder Validierungen. |
➔
|
Info zum Fallback: Hat eine Welt keinen Alias gesetzt, wird automatisch der technische Weltname zurückgegeben.
Ist der Spieler offline oder wird der Platzhalter fehlerhaft aufgerufen, wird ein leerer Text ("") ausgegeben, um das Layout deiner Tabliste oder deines Scoreboards nicht zu zerstören.
Wird die Welt von GWorld nicht verwaltet, wird ebenfalls ein leerer Text ("") ausgegeben!
Beispiele
Hier sind einige Beispiele, wie du die Platzhalter in anderen Plugins nutzen kannst:
1. In der Tabliste / im Scoreboard
Du möchtest deinen Spielern anzeigen, wo sie sich gerade befinden. Nutze dafür den Alias-Platzhalter, da dieser Farbcodes (z.B. &a) unterstützt: Aktuelle Welt: %gworld_alias%
2. In Chat-Formaten
Füge den Platzhalter in dein Chat-Format ein, um die Welt als Präfix vor dem Spielernamen anzuzeigen: chat-format: "[%gworld_alias%] %player_name%: %message%"
3. In GUI-Menüs
Wenn du ein Welten-Menü baust, kannst du den schönen Alias für das Item-Icon nutzen, musst aber den technischen Namen für den Teleport-Befehl im Hintergrund verwenden:
items:
survival_world:
material: GRASS_BLOCK
display_name: 'Teleport nach: %gworld_alias_farmwelt%'
left_click_commands:
- '[player] gtp %gworld_name_farmwelt%'
/gcreate - Welten erstellen
Welten erstellen
Das Erstellen von Welten ist eine der Hauptfunktionen von GWorld. Der Befehl ist mächtiger, als er auf den ersten Blick wirkt.
Der Befehl im Detail
/gcreate <Name> [Environment] [Seed] [Generator]
Parameter erklärt
- Name (Pflicht): Der Name der Welt. Dieser wird auch als Ordnername verwendet.
- Erlaubt: Buchstaben, Zahlen, Unterstriche, Bindestriche.
- Nicht erlaubt: Leerzeichen, Sonderzeichen.
- Environment/Umgebung (Pflicht): Legt fest, ob es eine Oberwelt, Nether oder End ist.
NORMAL(Standard-Welt)NETHERTHE_END
- Seed (Optional): Der Startwert für die Weltgenerierung.
- Leer lassen für zufälligen Seed.
- Generator (Optional): Hier kannst du Custom World Generatoren angeben (z.B. für Plot-Welten oder realistische Landschaften).
- Lasse das Argument weg, wenn es keinen Generator gibt.
- Beispiel:
TerraformGenerator,PlotSquared
Um einen Generator benutzen zu können, muss ein dementsprechendes Plugin installiert sein!
Beispiele
1. Standard Survival Welt
Einfach nur eine normale Welt erstellen:
/gcreate Farmwelt NORMAL
2. Welt mit Generator
Eine Welt mit einem Generator erstellen:
/gcreate Farmwelt NORMAL TerraformGenerator
3. Welt mit Generator und Seed
Eine Welt mit einem Generator und Seed erstellen:
/gcreate Farmwelt NORMAL 12345678 TerraformGenerator
/gset - Welten konfigurieren
Mit dem Befehl /gset kannst du die Eigenschaften deiner Welten in Echtzeit ändern.
Der große Vorteil: Alle Änderungen sind sofort aktiv, ohne dass der Server oder die Welt neu geladen werden muss. Gleichzeitig werden sie in der Datenbank/Config gespeichert.
Der Befehl
/gset [Name] <Flag> <Wert>
Parameter erklärt
- Name (Optional): Der Name der Welt.
- Es ist möglich, den Weltennamen wegzulassen. Dann wird die aktuelle Welt gewählt
-
Die Welt muss GWorld bekannt und verwaltet sein (erstellt/importiert)
- Flag (Pflicht): Gibt an, welche Einstellung der Welt geändert werden soll
-
Weitere Informationen zu allen Flags findest du auf der Flag-Seite
-
- Wert (Pflicht): Gibt an, auf welchen Wert die Flag gesetzt werden soll
-
Weitere Informationen zu allen Flags und möglichen Werten findest du auf der Flag-Seite
-
Alle Flags und ihre Werte: Die Flags und ihre möglichen Werte
Beispiele
1. Ein Monster/Tier verbieten/erlauben
Verbiete ein bestimmtes Tier oder Monster, in diesem Fall das Monster Pillager:
/gset DISABLED_MONSTERS pillager
Sofer das Tier/Monster erlaubt ist, wird es verboten und umgekehrt (toggle)
Für ein Tier (Kuh) analog: /gset DISABLED_ANIMALS cow
2. PVP deaktivieren
Verbiete PVP in einer Minecraft-Welt namens "MeineWelt":
/gset MeineWelt PVP false
3. Die Welt auf "friedlich" setzen
Setze die Schwierigkeitsstufe auf "friedlich", bzw. "peaceful":
/gset DIFFICULTY peaceful
4. Einen Anzeigenamen (Alias) setzen
Setze den Alias einer Welt auf "&bMeine Welt":
/gset ALIAS &bMeine Welt
/gimport - Bestehende Welten importieren
Hast du bereits eine Welt von einem anderen Server oder aus dem Singleplayer? Mit /gimport fügst du sie in das GWorld-System ein.
Vorbereitung
- Stoppe den Server (empfohlen, aber nicht zwingend).
- Kopiere deinen Welt-Ordner in das Hauptverzeichnis deines Servers (dort, wo auch
server.propertiesliegt).
Wichtig: Der Ordner darf keine Leerzeichen enthalten!
❌ Meine tolle Welt
✅ Meine_tolle_Welt
Der Befehl
/gimport <OrdnerName> <Environment> [Generator]
Parameter erklärt
- OrdnerName (Pflicht):
- Muss exakt mit dem Namen des Ordners übereinstimmen.
- Environment/Umgebung (Pflicht):
- Hilft GWorld, den richtigen Typ zuzuweisen (z.B. für Decken-Höhe im Nether). Dieses Argument muss angegeben werden
- Generator (Optional):
- Muss angegeben werden, wenn die Welt mit einem Generator erstellt wurde.
Um einen Generator benutzen zu können, muss ein dementsprechendes Plugin installiert sein!
Beispiel
Du hast einen Ordner namens Lobby_Backup hochgeladen.
- Führe den Befehl aus:
/gimport Lobby_Backup NORMAL - GWorld erkennt die Dateien (
level.dat, Region-Files). - Die Welt wird registriert und sofort geladen.
- Du kannst dich nun hin teleportieren:
/gtp Lobby_Backup.
Hinweis zur Datenbank: Wenn du MySQL aktiviert hast, wird die importierte Welt automatisch in die Datenbank eingetragen und ist nach einem Neustart auch auf anderen Servern verfügbar (sofern die Dateien dort auch liegen oder synchronisiert werden).
/grecreate - Eine Welt in ihren Ursprungszustand versetzen
Manchmal kann es sinnvoll sein, eine Welt in ihren Ursprungszustand zu versetzen. Beispielsweise, um eine Farmwelt wiederzuverwenden.
Der Befehl im Detail
/grecreate <Name> <backup>
Parameter erklärt
- Name (Pflicht): Der Name der Welt.
-
Die Welt muss GWorld bekannt und verwaltet sein (erstellt/importiert)
-
- Backup (Pflicht): Ob ein Backup von der Welt erstellt werden soll, bevor diese gelöscht und neu erstellt wird.
- Mögliche Werte: true, false
- true: Ein Backup der Welt wird in dem Verzeichnis "old_maps" angelegt
- false: Es wird kein Backup angelegt
Beispiele
1. Eine Welt mit Backup neu erstellen
Die Welt "MeineWelt" wird neu erstellt, vorher soll ein Backup angelegt werden:
/grecreate MeineWelt true
2. Eine Welt ohne Backup neu erstellen
Die Welt "MeineWelt" wird neu erstellt, ohne ein Backup anzulegen:
/grecreate MeineWelt false
/ginfo - Informationen zu einer Welt
Manchmal kann es hilfreich sein, alle Informationen und Einstellungen zu einer Welt auf einem Blick zu sehen.
Dafür gibt es den Befehl /ginfo.
Der Befehl im Detail
/ginfo [Name]
Parameter erklärt
- Name (Optional): Der Name der Welt
- Wird der Name leer gelassen, wird die aktuelle Welt der Benutzers gewählt.
Screenshot aus dem Spiel
Beispiele
1. Informationen zur aktuellen Welt
Bekomme Informationen zur aktuellen Welt:
/ginfo
2. Informationen zu einer anderen Welt
Bekomme Informationen zu der Welt "MeineWelt":
/ginfo MeineWelt
/gtp - Zwischen Welten teleportieren
Das Teleportieren zwischen Welten ist ebenfalls eine wichtige Funktionen.
Der Befehl kann durch die verschiedenen Berechtigungen etwas verzwickt wirken, jedoch ist es einfacher als gedacht.
Der Befehl im Detail
/gtp <Name> [Spielername|@all]
Parameter erklärt
- Name (Pflicht): Der Name der Welt, zu der teleportiert werden soll.
- Spielername/@all (Optional):
- Spielername: Der Name des Spielers, der teleportiert werden soll.
- @all: Teleportiere alle Spieler, außer dich selbst, in die gewünschte Welt.
Permissions
Basis Permission: gworld.commands.tp
Die Basis Permissions wird IMMER benötigt, damit der Befehl verwendet und automatisch vervollständigt werden kann.
Zu allen Welten teleportieren: gworld.commands.tp.*
Diese Permission wird benötigt, wenn man sich zu allen Welten teleportieren darf.
Zu bestimmten Welten teleportieren: gworld.commands.tp.<Welten-Name>
Mit dieser Permission darf sich ein Benutzer nur auf die innerhalb der Permission spezifizierten Welt teleportieren.
Andere Spieler teleportieren: gworld.tp.other
Achtung: Hier weicht die Permission von den anderen ab!
Mit dieser Permission darf der Benutzer alle Spieler auf andere Welten teleportieren, in dem der Spielernamen selbst oder @all verwendet wird.
Beispiele
1. Auf eine Welt teleportieren
In diesem Beispiel soll man sich auf die Welt "MeineWelt" teleportieren:
/gtp MeineWelt
2. Einen Spieler auf eine Welt teleportieren
In diesem Beispiel soll der User "MeinUser" auf "MeineWelt" teleportiert werden:
/gtp MeineWelt MeinUser
3. Alle Spieler auf eine Welt teleportieren
In diesem Beispiel sollen alle User auf die Welt "MeineWelt" teleportiert werden:
/gtp MeineWelt @all