![WorldSelector [1.8-1.12]](https://www.spigotmc.org/data/resource_icons/49/49096.jpg?1509651248){kind=icon}
Description
WorldSelector is a World Selector plugin. And yes, I am aware that that is pretty obvious, but I needed something to start the description with. Going on. The plugin allows for you to select an item that, when right clicked, will open a GUI with a list of worlds to teleport to. Very useful if you have a non-bungee server with multiple worlds.
Quick note: I have received PM's from multiple users asking me how to get the compass. The compass is a normal vanilla compass, which you can get trough the creative inventory. To give the compass to users use a plugin that has the ability to give players items when they join. I will add an option for this in future updates. The future is now, I have added it with the latest update
Features
¤ Completely configurable!
¤ Up to 54 slots!
¤ Permission system that allows you to make certain worlds visible only to vips or staff!
¤ The GUI can only be opened in one of the specified worlds! This means that you can select an item without fear that players start to accidentally open up the GUI while playing!
¤ The name and lore of items support placeholders, allowing for a personalised GUI!
¤ Send players a welcome message after teleporting to a world!
¤ Contains a debug mode to allow you to easily find where the problem lays if you get an error!
¤ New: Give players the item used to open the GUI on join, but only if they join in a specified world!
¤ New: Give players the item used to open the GUI when they change worlds and join the lobby world via teleportation or portals!
¤ New: The item opening the GUI has full attribute support, meaning you can specify a name, lore and more!
¤ New: Open the GUI instantly using the /worldselector command!
Placeholders
Commands and Permissions
worldselector.get
Allows the user to use the command /worldselector to either open the GUI or get the item used to open it, depends on your configuration.
worldselector.admin
Allows the access to the main command /worldselector and its subcommands.
The subcommands are:
reload - Reloads the config file
setspawn - Sets the point where players going to that world will spawn
getworld - Gets the world name
reference - Opens an inventory with 54 slots, with all slots numbered. This allows for an easy reference when creating your GUI.
debug - Starts the debug. Use this when you run into error. It should be user-friendly and help you with finding the error.
addworld - Add the world you are in to the list of allowed worlds (You can also do this from the config). In allowed worlds the compass (or what you specified) can be used as world selector. In other worlds it will just act like a normal item.
worldselector.slot.x
x can be any number between 1-54. Everyone has this permission by default. If you do not have the permission for example for slot 5, than whatever item is displayed in slot 5 is not displayed to you, but instead the item from the config called "replacement" will be shown. This allows you to have certain worlds accessible only to staff or VIP-players.
Images
Installation
Usage
(Please don't get scared from the big list, its very easy. I just tend to over specify things)
To use the plugin, follow the following steps:
Config:
¤ Worldplaytime and serverplaytime placeholders
Other
¤ Please go over to my Discord or to the discussion if you found a bug or have any other question about the plugin.
¤ If you enjoyed the plugin, please leave a (positive
) review!
¤ I would love to here any suggestions for future updates
¤ Really liked the plugin? Consider a donation!
WorldSelector is a World Selector plugin. And yes, I am aware that that is pretty obvious, but I needed something to start the description with. Going on. The plugin allows for you to select an item that, when right clicked, will open a GUI with a list of worlds to teleport to. Very useful if you have a non-bungee server with multiple worlds.
Quick note: I have received PM's from multiple users asking me how to get the compass. The compass is a normal vanilla compass, which you can get trough the creative inventory. To give the compass to users use a plugin that has the ability to give players items when they join. I will add an option for this in future updates. The future is now, I have added it with the latest update
Features
¤ Completely configurable!
¤ Up to 54 slots!
¤ Permission system that allows you to make certain worlds visible only to vips or staff!
¤ The GUI can only be opened in one of the specified worlds! This means that you can select an item without fear that players start to accidentally open up the GUI while playing!
¤ The name and lore of items support placeholders, allowing for a personalised GUI!
¤ Send players a welcome message after teleporting to a world!
¤ Contains a debug mode to allow you to easily find where the problem lays if you get an error!
¤ New: Give players the item used to open the GUI on join, but only if they join in a specified world!
¤ New: Give players the item used to open the GUI when they change worlds and join the lobby world via teleportation or portals!
¤ New: The item opening the GUI has full attribute support, meaning you can specify a name, lore and more!
¤ New: Open the GUI instantly using the /worldselector command!
Placeholders
Spoiler: Placeholders
%playername% = The name of the player that uses the GUI
%onlineplayers% = The amount of players currently online on the server
%worldonlineplayers% = The amount of players in the world selected under teleportation.
Expect more in future updates. If you have suggestions for placeholders, please PM me or go over to the recourse section
%onlineplayers% = The amount of players currently online on the server
%worldonlineplayers% = The amount of players in the world selected under teleportation.
Expect more in future updates. If you have suggestions for placeholders, please PM me or go over to the recourse section
Commands and Permissions
worldselector.get
Allows the user to use the command /worldselector to either open the GUI or get the item used to open it, depends on your configuration.
worldselector.admin
Allows the access to the main command /worldselector and its subcommands.
The subcommands are:
reload - Reloads the config file
setspawn - Sets the point where players going to that world will spawn
getworld - Gets the world name
reference - Opens an inventory with 54 slots, with all slots numbered. This allows for an easy reference when creating your GUI.
debug - Starts the debug. Use this when you run into error. It should be user-friendly and help you with finding the error.
addworld - Add the world you are in to the list of allowed worlds (You can also do this from the config). In allowed worlds the compass (or what you specified) can be used as world selector. In other worlds it will just act like a normal item.
worldselector.slot.x
x can be any number between 1-54. Everyone has this permission by default. If you do not have the permission for example for slot 5, than whatever item is displayed in slot 5 is not displayed to you, but instead the item from the config called "replacement" will be shown. This allows you to have certain worlds accessible only to staff or VIP-players.
Images
Spoiler
An example GUI:
These are outdated. GUI can now be way bigger. Will update the pictures at some point.
The same GUI, but now for someone who doesn't have the permission worldselector.slot.6:
These are outdated. GUI can now be way bigger. Will update the pictures at some point.
The same GUI, but now for someone who doesn't have the permission worldselector.slot.6:
Installation
- Download the plugin
- Drop the .jar file in your /plugins folder
- Restart or reload the server
- Configure the plugin
Usage
(Please don't get scared from the big list, its very easy. I just tend to over specify things)
To use the plugin, follow the following steps:
- Go to the worlds you want as destination, and get the name of the world using /worldselector getname. Remember it or write it down somewhere.
- Go to the config, and edit the list of displayed items. Please check the Config section if anything confuses you.
- In the config, set for every item you want to use to teleport "enabled" to true, and add the worldname you got from '/worldselector getname'.
- Go to the destination world and use '/worldselector setspawn' to set the point players will get teleported to.
- Go to the world you travel from, get the name and add it to the list of allowed worlds in the config.
- Go to the config, and select the item players must use to open the gui, by default the compass.
- If everything went correctly, opening the compass will now display the correct list of items, and clicking on one should teleport you to the correct world.
Config:
Spoiler: Config explanation
general:
GUI-item:
item: COMPASS # Item that will open the GUI when rightclicked
item-name: "&cWorld Selector" # Item that will open the GUI when rightclicked
glowing: false # Whether the item glows like it is enchanted
damage-value: 0 # The damage value of the item, take a look at the “Slots” section for more explanation
Lore:
- "&9Right click to open the" # Line one of the lore of the item
- "&9World Selector GUI" # Line two of the lore of the item
GUI:
inventory-name: "&cWorld Selector" # The name of the GUI
inventory-slots: 54 # Amount of slots in the GUI, has to be between 9 and 54, and has to be a multiply of 9
options:
debug: false # Whether debug is enabled.
worldselector-command: # What happens when players use the /worldselector command
give-GUI-item: false # Whether the command will give the item or not
open-GUI: true # Whether the command will instantly open the GUI or not
GUI-item-give:
give-item-in-worlds: # List of allowed worlds for the on-server-join and on-world-join section
- world
on-server-join:
enabled: true # Wether the player will get the item whenever they join the server in one of the worlds listed above and they don’t yet have it in their inventory.
hotbar-slot: 1 # The slot the item will get placed in
on-world-join:
enabled: true # Wether the player will get the item whenever they join one of the above worlds and they don’t yet have it in their inventory.
hotbar-slot: 1
allow-use-in-world:
- world # List of worlds the GUI can be opened in (/worldselector can be used in any world)
Slots:
slot-1:
# The settings for the first slot
item: DIAMOND_SWORD
# The item displayed in the first slot. Go over to https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html for the correct item names.
damage-value: 0
# Damage value. You can use this to specify 'sub-blocks', e.g. a special colored wool
amount: 1
# Amount of the specified item that are displayed.
name: "&aPVP"
# Name of the item that is displayed. Supports colors.
glowing: true
# If set to true the item will glow like it is enchanted
lore:
# The lore set for the item.
- '&cThe PvP arena'
- '&9Playing > &e%worldonlineplayers%'
teleport:
enabled: false
# If enabled clicking the item will result in teleport.
message: '&cWelcome to the &lPVP Arena'
# The message send to the player after teleporting. Remove it to send no message.
destination: 'world'
# The destination of the teleport. Make sure to first set the worldselector spawn in that world!
# This is the only slot that is specified. When creating a GUI bigger than 9 slots, simple completely copy one of the other slots, and change the slot number (the "slot-1" part).
# The ones you remove/leave open will simple be air.
# If you need a reference to get the correct slot, use the command /worldselector reference. This will open an inventory with the slots numbered
# When copying and pasting, make sure the indents stay the same, they are important. Please ensure that you only use spaces, not tabs.
# If any of this confuses you, please pm me or go to the discord link down below
# One last thing to note: you cannot have two exactly the same items. Exactly meaning same name and same item.
# The last one is a special one and should not be deleted:
replacement:
item: AIR
damage-value: 0
amount: 1
name: '&aNAME'
glowing: true
teleport:
enabled: false
destination: world
# The 'replacement' is what will show up to anyone if the miss the permission required to view a certain slot. Go to "Commands and Permission" for more info.
# Once you set the spawn the coordinates of each world will show up down here
Code (Text):
general:
GUI-item:
item: COMPASS # Item that will open the GUI when rightclicked
item-name: "&cWorld Selector" # Item that will open the GUI when rightclicked
glowing: false # Whether the item glows like it is enchanted
damage-value: 0 # The damage value of the item, take a look at the “Slots” section for more explanation
Lore:
- "&9Right click to open the" # Line one of the lore of the item
- "&9World Selector GUI" # Line two of the lore of the item
GUI:
inventory-name: "&cWorld Selector" # The name of the GUI
inventory-slots: 54 # Amount of slots in the GUI, has to be between 9 and 54, and has to be a multiply of 9
options:
debug: false # Whether debug is enabled.
worldselector-command: # What happens when players use the /worldselector command
give-GUI-item: false # Whether the command will give the item or not
open-GUI: true # Whether the command will instantly open the GUI or not
GUI-item-give:
give-item-in-worlds: # List of allowed worlds for the on-server-join and on-world-join section
- world
on-server-join:
enabled: true # Wether the player will get the item whenever they join the server in one of the worlds listed above and they don’t yet have it in their inventory.
hotbar-slot: 1 # The slot the item will get placed in
on-world-join:
enabled: true # Wether the player will get the item whenever they join one of the above worlds and they don’t yet have it in their inventory.
hotbar-slot: 1
allow-use-in-world:
- world # List of worlds the GUI can be opened in (/worldselector can be used in any world)
Slots:
slot-1:
# The settings for the first slot
item: DIAMOND_SWORD
# The item displayed in the first slot. Go over to https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html for the correct item names.
damage-value: 0
# Damage value. You can use this to specify 'sub-blocks', e.g. a special colored wool
amount: 1
# Amount of the specified item that are displayed.
name: "&aPVP"
# Name of the item that is displayed. Supports colors.
glowing: true
# If set to true the item will glow like it is enchanted
lore:
# The lore set for the item.
- '&cThe PvP arena'
- '&9Playing > &e%worldonlineplayers%'
teleport:
enabled: false
# If enabled clicking the item will result in teleport.
message: '&cWelcome to the &lPVP Arena'
# The message send to the player after teleporting. Remove it to send no message.
destination: 'world'
# The destination of the teleport. Make sure to first set the worldselector spawn in that world!
# This is the only slot that is specified. When creating a GUI bigger than 9 slots, simple completely copy one of the other slots, and change the slot number (the "slot-1" part).
# The ones you remove/leave open will simple be air.
# If you need a reference to get the correct slot, use the command /worldselector reference. This will open an inventory with the slots numbered
# When copying and pasting, make sure the indents stay the same, they are important. Please ensure that you only use spaces, not tabs.
# If any of this confuses you, please pm me or go to the discord link down below
# One last thing to note: you cannot have two exactly the same items. Exactly meaning same name and same item.
# The last one is a special one and should not be deleted:
replacement:
item: AIR
damage-value: 0
amount: 1
name: '&aNAME'
glowing: true
teleport:
enabled: false
destination: world
# The 'replacement' is what will show up to anyone if the miss the permission required to view a certain slot. Go to "Commands and Permission" for more info.
# Once you set the spawn the coordinates of each world will show up down here
Spoiler: Example config
general:
GUI-item:
item: COMPASS
item-name: '&cWorld Selector'
glowing: false
damage-value: 0
lore:
- '&9Right click to open the'
- '&9World Selector GUI'
GUI:
inventory-name: '&cWorld Selector'
inventory-slots: 36
options:
debug: false
worldselector-command:
give-GUI-item: false
open-GUI: true
GUI-item-give:
give-item-in-worlds:
- world
on-server-join:
enabled: true
hotbar-slot: 1
on-world-join:
enabled: true
hotbar-slot: 1
allow-use-in-world:
- world
- main
Slots:
replacement:
item: AIR
damage-value: 0
amount: 1
name: '&aNAME'
glowing: true
teleport:
enabled: false
destination: world
slot-5:
item: SKULL_ITEM
damage-value: 5
amount: 1
name: '&a%playername%'
glowing: true
lore:
- '&9&lOnline > &6%onlineplayers%'
- '&9Welcome back &e%playername%'
teleport:
enabled: false
destination: world
slot-20:
item: DIAMOND_SWORD
damage-value: 0
amount: 1
name: '&cPVP'
glowing: true
lore:
- '&9&lOnline > &6%onlineplayers%'
- '&eIn world: &c%worldonlineplayers%'
teleport:
enabled: true
message: '&cYou were teleported to the PVP arena!'
destination: main
slot-26:
item: GRASS
damage-value: 0
amount: 1
name: '&a&lSurvival'
glowing: false
lore:
- '&9&lOnline > &6%onlineplayers%'
- '&eIn world: &c%worldonlineplayers%'
teleport:
enabled: true
destination: world
world-spawn:
main:
world: main
x: 141.5
y: 64.0
z: 213.5
world:
world: world
x: -246.5
y: 64.0
z: 245.5
Planned features
Code (Text):
general:
GUI-item:
item: COMPASS
item-name: '&cWorld Selector'
glowing: false
damage-value: 0
lore:
- '&9Right click to open the'
- '&9World Selector GUI'
GUI:
inventory-name: '&cWorld Selector'
inventory-slots: 36
options:
debug: false
worldselector-command:
give-GUI-item: false
open-GUI: true
GUI-item-give:
give-item-in-worlds:
- world
on-server-join:
enabled: true
hotbar-slot: 1
on-world-join:
enabled: true
hotbar-slot: 1
allow-use-in-world:
- world
- main
Slots:
replacement:
item: AIR
damage-value: 0
amount: 1
name: '&aNAME'
glowing: true
teleport:
enabled: false
destination: world
slot-5:
item: SKULL_ITEM
damage-value: 5
amount: 1
name: '&a%playername%'
glowing: true
lore:
- '&9&lOnline > &6%onlineplayers%'
- '&9Welcome back &e%playername%'
teleport:
enabled: false
destination: world
slot-20:
item: DIAMOND_SWORD
damage-value: 0
amount: 1
name: '&cPVP'
glowing: true
lore:
- '&9&lOnline > &6%onlineplayers%'
- '&eIn world: &c%worldonlineplayers%'
teleport:
enabled: true
message: '&cYou were teleported to the PVP arena!'
destination: main
slot-26:
item: GRASS
damage-value: 0
amount: 1
name: '&a&lSurvival'
glowing: false
lore:
- '&9&lOnline > &6%onlineplayers%'
- '&eIn world: &c%worldonlineplayers%'
teleport:
enabled: true
destination: world
world-spawn:
main:
world: main
x: 141.5
y: 64.0
z: 213.5
world:
world: world
x: -246.5
y: 64.0
z: 245.5
¤ Worldplaytime and serverplaytime placeholders
Other
¤ Please go over to my Discord or to the discussion if you found a bug or have any other question about the plugin.
¤ If you enjoyed the plugin, please leave a (positive
) review!
¤ I would love to here any suggestions for future updates
¤ Really liked the plugin? Consider a donation!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
WorldSelector [1.8-1.12] is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 5,692 times (via Spigot). Download it and open it directly in the game.