Worlds help page 🧐

How to use the commands of the Worlds plugin? Which permissions are available and what to they do? Here's our wiki page for the Worlds Open Source plugin.

Setup

Download the plugin

You can get the packed plugin file (PHAR file) from Poggit.

A version which is not always up to date but approved by the Poggit team is available here. Download it by clicking on the black "Direct Download" button.

If you want the latest version which is always up to date, you can download it from here. Click on the "*** KB" link of the first row in the column "Download".

Now you should have a file with the file extension ".phar" in your Downloads folder.

Install the plugin on the server

To install the plugin, you can just put the PHAR-file you downloaded in the step before into the "plugins"-folder in your PocketMine-folder.

Commands

General

Commands for this plugin are always beginning with /worlds (you can also use /ws which is shorter).

List

Command Permission Example Short example Example description
/worlds list worlds.list /worlds list /ws ls Show the names of all worlds on the server

Create

Command Permission Example Short example Example description
/worlds create <worldname> worlds.admin.create /worlds create mycoolworld /ws cr mycoolworld Create a world with the name mycoolworld
/worlds create <worldname> <type> worlds.admin.create /worlds create mycoolworld NETHER /ws cr mycoolworld NETHER Create a world with the name mycoolworld and the type NETHER (can be NORMAL, FLAT or NETHER).

Removing, (un)loading and teleporting

Command Permission Example Short example Example description
/worlds remove <worldname> worlds.admin.remove /worlds remove mycoolworld /ws rm mycoolworld Remove the world with the name mycoolworld
/worlds load <worldname> worlds.admin.load /worlds load mycoolworld /ws ld mycoolworld Load the world with the name mycoolworld
/worlds unload <worldname> worlds.admin.unload /worlds unload mycoolworld /ws uld mycoolworld Unload the world with the name mycoolworld
/worlds teleport <worldname> worlds.admin.teleport /worlds teleport mycoolworld /ws tp mycoolworld Teleport into the world with the name mycoolworld

Copy and rename

Command Permission Example Short example Example description
/worlds copy <from> <to> worlds.admin.copy /worlds copy theoldworld anotherworld /ws cp theoldworld anotherworld Copy the world theoldworld to the world anotherworld
/worlds rename <from> <to> worlds.admin.rename /worlds rename theoldworld thenewworld /ws rn theoldworld thenewworld Rename the world theoldworld to the world thenewworld

GUI (Forms) - easy for beginners

Command Permission Example Short example Example description
/worlds set worlds.admin.set /worlds set /ws st Open the flag settings GUI for the current world
/worlds defaults worlds.admin.defaults /worlds defaults /ws df Open the default flag settings GUI

Set flags

Command Permission Example Short example Example description
/worlds set legacy worlds.admin.set /worlds set legacy /ws st legacy List all flags in a world
/worlds set permission <permissionstring> worlds.admin.set /worlds set permission you.arecool /ws st permission you.arecool Only players with the permission you.arecool are allowed to join the world
/worlds set gamemode <gamemodename> worlds.admin.set /worlds set gamemode creative /ws st gamemode creative Set the gamemode of a world to creative (possible values are survival, creative, adventure or spectator)
/worlds set build <value> worlds.admin.set /worlds set build true /ws st build true Allow building in this world by setting the value to true
/worlds set pvp <value> worlds.admin.set /worlds set pvp false /ws st pvp true Disable PvP in this world by setting the value to false
/worlds set damage <value> worlds.admin.set /worlds set damage true /ws st damage true Enable damage in this world by setting the value to true
/worlds set interact <value> worlds.admin.set /worlds set interact false /ws st interact false Disable interaction (opening chests, ...) in this world by setting the value to false
/worlds set explode <value> worlds.admin.set /worlds set explode false /ws st explode false Disable explosions in this world by setting the value to false
/worlds set drop <value> worlds.admin.set /worlds set drop false /ws st drop true Disable dropping items in this world by setting the value to false
/worlds set hunger <value> worlds.admin.set /worlds set hunger true /ws st hunger true Enable hunger in this world by setting the value to true
/worlds set fly <value> worlds.admin.set /worlds set fly true /ws st fly true Allow flying in this world by setting the value to true

Unset flags

Command Permission Example Short example Example description
/worlds unset permission worlds.admin.unset /worlds unset permission /ws ust permission Remove the permission for this world so everybody can join
/worlds unset gamemode worlds.admin.unset /worlds unset gamemode /ws ust gamemode Remove the gamemode for this world so it's not changed when joining the world
/worlds unset build worlds.admin.unset /worlds unset build /ws ust build Don't allow or forbid building in this world like the plugin wasn't there
/worlds unset pvp worlds.admin.unset /worlds unset pvp /ws ust pvp Don't allow or forbid PvP in this world like the plugin wasn't there
/worlds unset damage worlds.admin.unset /worlds unset damage /ws ust damage Don't allow or forbid damage in this world like the plugin wasn't there
/worlds unset interact worlds.admin.unset /worlds unset interact /ws ust interact Don't allow or forbid interaction in this world like the plugin wasn't there
/worlds unset explode worlds.admin.unset /worlds unset explode /ws ust explode Don't allow or forbid explosions in this world like the plugin wasn't there
/worlds unset drop worlds.admin.unset /worlds unset drop /ws ust drop Don't allow or forbid dropping items in this world like the plugin wasn't there
/worlds unset hunger worlds.admin.unset /worlds unset hunger /ws ust hunger Don't enable or disable hunger in this world like the plugin wasn't there
/worlds unset fly worlds.admin.unset /worlds unset fly /ws ust fly Don't allow or forbid flying in this world like the plugin wasn't there

(Set) default flags

Command Permission Example Short example Example description
/worlds defaults legacy worlds.admin.defaults /worlds defaults legacy /ws df legacy List all default flags for worlds
/worlds defaults set gamemode <gamemodename> worlds.admin.defaults /worlds defaults set gamemode creative /ws df st gamemode creative Set the default gamemode of worlds to creative (possible values are survival, creative, adventure or spectator)
/worlds defaults set build <value> worlds.admin.defaults /worlds defaults set build true /ws df st build true Allow building by default by setting the value to true
/worlds defaults set pvp <value> worlds.admin.defaults /worlds defaults set pvp false /ws df st pvp true Disable PvP by default by setting the value to false
/worlds defaults set damage <value> worlds.admin.defaults /worlds defaults set damage true /ws df st damage true Enable damage by default by setting the value to true
/worlds defaults set interact <value> worlds.admin.defaults /worlds defaults set interact false /ws df st interact false Disable interaction (opening chests, ...) by default by setting the value to false
/worlds defaults set explode <value> worlds.admin.defaults /worlds defaults set explode false /ws df st explode false Disable explosions by default by setting the value to false
/worlds defaults set drop <value> worlds.admin.defaults /worlds defaults set drop false /ws df st drop true Disable dropping items by default by setting the value to false
/worlds defaults set hunger <value> worlds.admin.defaults /worlds defaults set hunger true /ws df st hunger true Enable hunger by default by setting the value to true
/worlds defaults set fly <value> worlds.admin.defaults /worlds defaults set fly true /ws df st fly true Allow flying by default by setting the value to true

Unset flags

Command Permission Example Short example Example description
/worlds defaults unset permission worlds.admin.defaults /worlds defaults unset permission /ws df ust permission Remove the permission for this world so everybody can join
/worlds defaults unset gamemode worlds.admin.defaults /worlds defaults unset gamemode /ws df ust gamemode Remove the gamemode for this world so it's not changed when joining the world
/worlds defaults unset build worlds.admin.defaults /worlds defaults unset build /ws df ust build Don't allow or forbid building in this world like the plugin wasn't there
/worlds defaults unset pvp worlds.admin.defaults /worlds defaults unset pvp /ws df ust pvp Don't allow or forbid PvP in this world like the plugin wasn't there
/worlds defaults unset damage worlds.admin.defaults /worlds defaults unset damage /ws df ust damage Don't allow or forbid damage in this world like the plugin wasn't there
/worlds defaults unset interact worlds.admin.defaults /worlds defaults unset interact /ws df ust interact Don't allow or forbid interaction in this world like the plugin wasn't there
/worlds defaults unset explode worlds.admin.defaults /worlds defaults unset explode /ws df ust explode Don't allow or forbid explosions in this world like the plugin wasn't there
/worlds defaults unset drop worlds.admin.defaults /worlds defaults unset drop /ws df ust drop Don't allow or forbid dropping items in this world like the plugin wasn't there
/worlds defaults unset hunger worlds.admin.defaults /worlds defaults unset hunger /ws df ust hunger Don't enable or disable hunger in this world like the plugin wasn't there
/worlds defaults unset fly worlds.admin.defaults /worlds defaults unset fly /ws df ust fly Don't allow or forbid flying in this world like the plugin wasn't there

Language

Changing the language

To change the language of the plugin, open the "config.yml" file in "plugins/Worlds". It should contain those lines:

# Language of the plugin messages
# Possible options are: en (English), de (German), ...
language: "en"

Change the value in quotes after "language:" into the language you want to use. For example, to set the plugin on German, it should look like this:

# Language of the plugin messages
# Possible options are: en (English), de (German), ...
language: "de"

Creating a new language

You're always welcome to translate the plugin into languages which don't exist yet or correct translations which already exist.

First, you need to download the plugin sources and go into the folder "resources/languages". Then, copy the "en.yml" file and rename it to the ISO 639-1 language code of the language you want to create.

After you translated it, feel free to create a PR on GitHub to add your translation to the plugin.


BY SURVA NETWORK 2020 www.surva.network send an e-mail 📫 to our open source team surva network on GitHub privacy policy