LobbyAPI
What is LobbyAPI
LobbyAPI was created to manage multiple worlds and allow players to teleport to those worlds using user friendly menu, while being able to be fully configurable.Just by using the commands /lobby or /hub, the player has access to all worlds specified in the menu, where when they click on the block the represents a world they are teleported to location given to that world. LobbyAPI has tons of configurable methods to change the color of the block in the menu, the amount of that block, what spot it is located, and the description of the world, who can see or go to a world, along with the methods for how the world will interact with other worlds.
How to create and manage worlds
If you a re new to LobbyAPI, you can find a guide how to set up worlds at this link:
https://dev.bukkit.org/projects/lobbyapi/pages/events/basic-command-tutorial
Features
- Allows players to teleport from world to world.
- Menu is fully customizable
- Shows all players in given world
- Allows players to teleport from Server to Server (for bungee servers only).
- Allows other plugins to access when a player teleports to a new world or clicks on a new world in the menu.
- Works on all versions of Bukkit
- Plugin support LobbyAPI is just the back-bone for the plugins that will add the worlds. All that is needed to add a world to the menu will be under Developer Information.
Icon Customization is here!
Now you can easily customize the materials, description, and other attributes for each world registered!
Commands
/Lobby | Opens up the WorldMenu |
/Hub | Opens up the WorldMenu |
/LobbyApi | Allows you to change some properties of LobbyAPI |
/LobbyApi addWorld [world] [slot] [x][y][z]..... | Adds a world to the LobbyAPI menu |
/LobbyApi removeWorld [world] | Removes a world to the LobbyAPI menu |
/LobbyApi addServer [server-name] [slot] | Adds a server to the LobbyAPI menu |
/LobbyApi removeServer [server-name] | Removes a server to the LobbyAPI menu |
/LobbyApi listServers | Shows a list for all the servers |
/LobbyApi listWorlds |
Shows a list for all the worlds |
/LobbyApi setDefaultWeather [world] [weather] | Sets the default weather for a world. Choices are NORMAL, NO_RAIN, and ALWAYS_RAINING |
/LobbyApi addJoiningCommand [world] [command] | Adds a command that should be sent when a player joins that world. |
/LobbyApi removeJoiningCommand [world] [command id] | Removes a command that should be sent when a player joins that world. |
/LobbyApi listJoiningCommands [world] | Lists all the commands that are sent when a player joins that world. |
/LobbyApi listJoiningCommands [world] | Lists all the commands that are sent when a player joins that world. |
(There are a few more commands, but I've had issues recreating the table :p):
/LobbyAPI generateNetherAndEndFor", "Generates a nether and end world for the world"
/LobbyAPI setMainLobby", "Changes the default spawn world"
/LobbyAPI removeMainLobby", "Removes default spawn world"
/LobbyAPI setMaterial", "Sets the material icon for a world"
/LobbyAPI setDisplayName", "Changes a display name for a world."
/LobbyAPI setDescription", "Sets the description for a world"
/LobbyAPI hideWorld", "Hides a world from the menu."
/LobbyAPI showWorld", "Shows the world from the menu, if previously hidden"
/LobbyAPI setWorldSelector", "Sets the word selector to be the item in the sender's hand"
/LobbyAPI removeWorldSelector", "removes word selector"
/LobbyAPI setGamemode", "Sets the description for a world"
/LobbyAPI changeSpawn", "Changes the spawn location for a world"
/LobbyAPI version", "Gets the version of the plugin"
/LobbyAPI setvoidlooping", "Enables or disables teleporting players to spawn if they are in the void"
/LobbyAPI setdisablehealthandhunger", "Enables or disables health or hunger changes for worlds"
/LobbyAPI setlocationsaving", "Enables or disables location saving when a player leaves the world"
/LobbyAPI setcanuseportals", "Enables or disables portals for certain worlds."
/LobbyAPI addDefaultItem", "Adds the item in your hand to the list of default items."
/LobbyAPI removeDefaultItem", "Adds the item in your hand to the list of default items."
/LobbyAPI listDefaultItems", "Adds the item in your hand to the list of default items."
/LobbyAPI addDecor", "Adds a decor item to the hub menu"
/LobbyAPI removeDecor", "Removes a decor item."
/LobbyAPI toggleWhitelist", "Toggles whether the world is restricted to only certain players"
/LobbyAPI addToWhitelist", "Adds a player to a world's whitelist"
/LobbyAPI removeFromWhitelist", "Adds a player to a world's whitelist"
/LobbyAPI listWhitelist", "Adds a player to a world's whitelist"
/LobbyAPI goto", "Teleports the player to the spawn of a world"
Permissions:
- lobbyapi.*
- ---Gives access to all lobbyapi features
- lobbyapi.user
- --Gives all commands that users should have. If you do not know what permissions to give to your players, just give them this.
- lobbyapi.commands
- --Only gives access to commands
- lobbyapi.hub
- --Gives access to the /hub commands.
- lobbyapi.bypassworldlimits
- --Gives players the ability to join worlds that are private, or have gone over the player limit
Dependencies and Compatibility
LobbyAPI does not depend on any other plugin, and should work with all other plugins. If you receive any errors from my plugin or features or not enabled for you, please make a comment or ticket of this page.
Developer Information
If you want to register a world through a plugin, use the guide HERE . Call this method in onEnable method to register worlds when the plugin loads.
To add a BungeeServer to the menu, all you need is this line: LobbyAPI.registerBungeeServer(String bungeeServersName, Description, WoolColor);
How to Install
- Drop this plugin into you plugins folder
- Find/Create a plugin that will allow you get to your world
- Restart your server
This plugin uses bStats:
bStats is a metrics service that allows me to to see how many servers use my plugins, how many players they have, and which countries use my plugin the most. All information is anonymized, so no information can be directly linked to you, and instead is added to the average of all severs that use the plugin.
In reply to goldenredstone04:The player data is still there in the world files in the playerdata folder.
You can fix this by going to server.properties and change your level-name to the world that you lost your inventory in. Tell everyone to put there stuff in a chest. Then finish setting up LobbyAPI. This should happen automatically ZombieStriker
hello i'd like to use lobby api for a per world lobby system. For example, I'd like to set a player limit for the lobby worlds. And when a player limit has been met on 1 lobby word they will be teleported to the other. Is there a way to do that. Also is their a way to change the commands from /hub and /lobby to something else to open the world menu. Also how do you customize it so instead of showing 0 players it'll show 0/50 players and not show the players in it. And one more thing. I'd like to change the name of the gui. Right Now it's LobbyApi - World Selector.
So, I have a world named "Hub" and I do /lobbyapi addWorld Hub. I then set the spawn where I want players to join the server and warp to when selecting "Hub" on the lobby menu. This works fine, but... when I restart my server the world "Hub" is now a default world. I'm guessing this plugin is mixing in with multiverse as I want the Hub worlds and many other worlds to be the Void and not Land. Is there any way of resolving this?
- Aqua
when I try using the plugin, it says "an internal error has occurred while attempting to perform this command" but I don't know whether this is my mistake or the plugin's
In reply to TheRealSenrigan:
this is what it says when I try to do the command. it says the plugin is disabled, but I haven't done anything with that. I don't even remember how to enable/disable plugins
[16:10:23 ERROR]: null
org.bukkit.command.CommandException: Cannot execute command 'lobbyapi' in plugin LobbyAPI v3.7.103 - plugin is disabled. at org.bukkit.command.PluginCommand.execute(PluginCommand.java:36) ~[patched_1.12.2.jar:git-Paper-1618]
at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:152) ~[patched_1.12.2.jar:git-Paper-1618]
at org.bukkit.craftbukkit.v1_12_R1.CraftServer.dispatchCommand(CraftServer.java:685) ~[patched_1.12.2.jar:git-Paper-1618]
at net.minecraft.server.v1_12_R1.PlayerConnection.handleCommand(PlayerConnection.java:1492) ~[patched_1.12.2.jar:git-Paper-1618]
at net.minecraft.server.v1_12_R1.PlayerConnection.a(PlayerConnection.java:1297) ~[patched_1.12.2.jar:git-Paper-1618]
at net.minecraft.server.v1_12_R1.PacketPlayInChat.a(PacketPlayInChat.java:45) ~[patched_1.12.2.jar:git-Paper-1618]
at net.minecraft.server.v1_12_R1.PacketPlayInChat.a(PacketPlayInChat.java:5) ~[patched_1.12.2.jar:git-Paper-1618]
at net.minecraft.server.v1_12_R1.PlayerConnectionUtils.lambda$ensureMainThread$0(PlayerConnectionUtils.java:14) ~[patched_1.12.2.jar:git-Paper-1618]
at java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source) ~[?:1.8.0_211]
at java.util.concurrent.FutureTask.run(Unknown Source) ~[?:1.8.0_211]
at net.minecraft.server.v1_12_R1.SystemUtils.a(SourceFile:46) ~[patched_1.12.2.jar:git-Paper-1618]
at net.minecraft.server.v1_12_R1.MinecraftServer.D(MinecraftServer.java:850) ~[patched_1.12.2.jar:git-Paper-1618]
at net.minecraft.server.v1_12_R1.DedicatedServer.D(DedicatedServer.java:423) ~[patched_1.12.2.jar:git-Paper-1618]
at net.minecraft.server.v1_12_R1.MinecraftServer.C(MinecraftServer.java:774) ~[patched_1.12.2.jar:git-Paper-1618]
at net.minecraft.server.v1_12_R1.MinecraftServer.run(MinecraftServer.java:666) ~[patched_1.12.2.jar:git-Paper-1618]
at java.lang.Thread.run(Unknown Source) [?:1.8.0_211]
In reply to TheRealSenrigan:
If you have "Multiverse-Inventories" or "PerWorldInventory" enabled on your server, try removing them, as there could be a conflict with LobbyAPI.
If it still happens without those plugins, could you post the full console log when the server starts up?
In reply to TheRealSenrigan:
what plugin are you using?
Fixed.
hi, how can i set different teleport points in the same world? like spawn, shops, crates....
In reply to Forge_User_36854749:
You can use warps
Quick question: When you have LobbyAPI Connecting worlds through Bungeecord, it says in the World description, "Bungeecord Server" is there any way to remove this?
Also, is it possible to add multiple lines for the description and if so how?
I have a question,
I recently added this wonderful and very great plugin to my server. It worked just fine until 5 min. ago.
People texted me about that they could not click anymore. (Left and right mouse button) If they click the world selector menu pops up. So they can’t mine or place a block anymore.
Can anyone help me with this.
I very very much appreciate it. (And all the people on my server)
In reply to Forge_User_85555430:
Are there any errors in the console when players click? If so, could you post them?
Also, which item did you set as the world selector?
In reply to Zombie_Striker_bukkit:
There are no errors in the console when somebody clicks.
And I think i have no item selected as the world selector. (I did not use that yet.) Do you mean the command: /LobbyAPI setWorldSelector ? Because I didn’t use that command before
Edit:
We use the commands: /lobby & /hub to navigate from worlds to worlds
(I can send you my plugins folder or something else that you need)
I hope this helps.
Much, much thanks
Moonskiemoox & all the people on the server
when I tried to go back to the world I was thrown into a whole different world.
please help
Looks Amazing! But the only problem is that when I switch between worlds, it takes me right to the spawn I have set, which means if I build a house, go to another world, then return, it sends me to spawn, and I have lost my base. Is there a way I can prevent this?
In reply to Etomic_Studios:
If you use /lobbyapi setLocationSaving <world> true, the player will be teleported back to their last location whenever they go back to that world.
In reply to Zombie_Striker_bukkit:
Thank you so much!
Stragely for my it does not work at all. When I run /lobbyapi there is no response at all. My server runs on bukkit 1.7.10. Not trying to make it look bad I just want it to work.
ty in advance ~ Oldwarhand
Hallo :)
ich nutze dein Plugin, es funktioniert super. Es lässt sich alles einstellen.
Allerdings löscht es einfach so meine Welten...
Ich kann mir das nicht erklären. Es funktioniert immer eine Zeit lang, nach mehreren Neustarts sind dann die anhängenden Welten gelöscht. ( der Seed ist richtig inden gelöschten welten, da die Hologramme am richtigen platz sind) Kannst du das erklären?
Danke :)