BuildBattle | EASY SETUP | TONS OF FEATURES | AUTOMATIC PLO
1.3.1Guaranteed the best Build Battle plugin you have come across!
Welcome to BuildBattle. The exact original plugin I made for BuildersRefuge now on spigot! :D
Requires ActionBarAPI

This plugin was originally designed and made for mc.buildersrefuge.com by me. With permission, I am now releasing the plugin on here as a free resource.
Keep in mind, currently this plugin only supports solo Build Battle (so no teams - unless you do something with your server to make that work).
You must have ActionBarAPI in order to use this plugin!
Want to support my plugins? Donate to the PayPal.me above. :)
I guarantee you this is the best Build Battle plugin you have seen here on SpigotMC.org. Why? Let me tell you!


Pictures


Fireworks being launched at the corners of the winner's arena or plot (better seen in-game rather than photos).



Wondering why this plugin is so great and how it works? Well let me explain by simply showing you how to setup the plugin. As you can see from below, it is real easy. I also have some images above of the plugin!
THE SETUP:
Setup Part 1
The process is real simple. Just make sure the hub world for the joining the mini game (so like a hub) and the mini game world, which will hold all the arenas, are on the same server. Once this is done, everything else should be real simple.
Make sure to set the world name for the hub world and the buildbattle world in the config. The default hub world name is world and the default buildbattle world name is buildbattle.
Once this has been done, go to the buildbattle world and set the lobby. To do this, do /buildbattle setlobby. Just make sure you have world guard to protect your spawn of course.
Setup Part 2
To set the arenas, this is just as easy. So in the config, the total amount of players that can join are 8. Only 2 are needed though for the game to start. You can of course edit these values in the config as literally everything is customizable. So since there can only be 8 players in a game by default, you need 8 arenas. Now if only 3 players join a game, only three of those arenas will be used but you need 8 total in this scenario just in case all 8 play.
Alright so how do you set them? Simple! In the config, the defined length and width, by default, of the arenas is 27 x 27. Therefore, you need an arena that is 27 x 27. Again you can change this. So stand in the center of your arena and do /buildbattle setarena 1. Then do the same for all the other arenas, except it would be /buildbattle setarena 2, then 3, and so on. The default height clearance in the config is 27 also. So players should only build up to 27 blocks high. Why? Well this is because of what I am about to tell you below. :)
When setting the arenas and lobby, the data is stored in the data.yml file in the plugin folder. This file is created upon first making the lobby spawn. :)
When the games are completely over, the plots are cleared automatically. No need to get another plugin for this! So that height that you defined in the config? Well that is how many blocks above the floor to the height defined are cleared. So the default height is 27, therefore, 27 blocks above the ground of the arena's floor are cleared.
FYI: To protect the arenas from being griefed, make sure you use worldguard and protect the floor and the surrounding area of the arena. But make it so players can build above the floor of the arena. Also since by default the height in the config is 27, you will need to protect the blocks above this number in the arena. This way players can only build in the arena and not grief it. If you're confused by this, simply PM me on Spigot and I will help you. This is super easy to do and takes less than a minute. It is just hard to explain. :p
IMPORTANT INFO:
Important Information
On the hub world, the plugin automatically places players into creative mode. To change this, you will need to set the default gamemode of that world (using a plugin like multiverse). If so, DO NOT change the default gamemode of the buildbattle world. Honestly this shouldn't be necessary to change the hub world's default gamemode, but keep this in mind.
Once the lobby and the arenas have been setup, when players enter the mini game world the lobby timer should start ticking. Once it hits 5 seconds, it will start counting down in the chat. If there are enough players, the game will begin. If not, the lobby timer will restart. The timer(s) are completely configurable in the config.
If enough players were in the lobby once hitting 0 on the lobby timer, the game should begin and players should be sent to their defined arenas spawns. Players will spawn in the center of each arena.
A random theme is chosen and players can then begin building what the theme is. You may add as many themes as you like in the themelist.yml. Just make sure you follow the format.
There is also a scoreboard displayed (as seen in the images) displaying how much time is left, the current theme, players playing in the game, and a text spot on the bottom for what ever you want (in this case, your server's website for example - in the images, it is www.buildersrefuge.com). The scoreboard is completely configurable in the config.yml. :D
FYI: Just about everything in the config.yml is configurable!
By default, players have 5 minutes to build. You may change this in the config if desired. When 10 seconds are left, the timer will start dinging to alert players that the voting session is about to begin.
If you're in a game and there is only you and 1 other person, then they leave, the game will officially end. However, if more than 2 players are in the game, and someone leaves, they may come back at any time as long as the game is still going on. If they join back during voting, they will be in spectator mode and their build will NOT be voted for.
At any time once the game has started, players may join to spectate the match. They are placed into spectator mode. --> ONLY IF THIS IS ENABLED IN CONFIG. CURRENTLY IT IS A BIT BUGGY. WOULD ADVISE ENABLING FOR NOW.
Once the time limit has ended, players are then teleported to a player's build in their specific arena, and they may now vote, using blocks in their inventories, on how they thought of the player's build. The blocks are wool by default. The block type can be changed in the config. The names of the voting blocks may be changed too.
By default, players cannot vote for themselves but this may be changed in the config.
When voting, you simply right click the voting blocks. Doing so will make a sound effect depending on the vote you chose. You can edit the sound effects in the config. I personally really like this feature, as everyone in the game hears the sounds. So yes you can hear what players are saying about your build. :)
Players, by default, have 10 seconds to vote for each build. Once the time is up, players are teleported to the next player's build. Once all players have been voted for, players are then teleported to the winner's build and fireworks will shoot out of each corner of the arena to celebrate the winner! The statistics of the votes resulting in who won are displayed in the chat. Players are then teleported back to the hub after a few seconds of the game being officially over.
When 3 seconds are left to vote for the current player, the timer will start dinging to alert players the voting session for the current player is about to end.
KEEP IN MIND...
If you have a plugin, such as multiverse, that automatically updates the world's gamemode, disable this for the hub world and buildbattle world as this will interfere with the game. Also if you use force-gamemode in the server.properties, then disable this.
BuildBattle shouldn't but might interfere with some plugins that alter the games teleportation system. This is highly unlikely but just throwing that out there.
This plugin 100% works with bungeecord servers and is encouraged to be used on a bungeecord server.
This plugin is designed for 1.13. It has not been tested on any other version and most likely would not function properly on 1.12 anymore (yet to have been tested though. If using 1.12, I advise downloading an older version for it here). If you use viaversion on your server, keep in mind that the scoreboard may not appear properly due to a bug with viaversion.
Make sure to disable enderpearls and chorus fruit when in the mini game arena, or players will be able to travel out of the arenas. This is common sense, but just saying. :p
It is best to not put this mini game on a server with a crap ton of plugins and to keep things minuscule. Most issues, if any, that you will have with my plugin is interference with other plugins. As more issues are found, I will list common fixes in this section here. As for now, this is all I can tell you. This is why you will probably want to run this plugin on a bungeecord server.
So if you have any issues, please don't hesitate to private message me on Spigot. I will be more than glad to help you and even get on your server for you to test what's up. The best way to make this plugin functioning well is you people telling me your problems!
Other than that, the plugin should be working just fine! :D

INFORMATION & PICTURES
A user by the name of Roissica had requested on the plugin discussion page to add a join command and a sign feature. To his request, they have now been added! :D
Now the sign feature! I spent a good amount of time implementing this is in. There is a lot of features to it, from it catching errors to etc. However, you will figure a lot of those out as you mess around with the signs. For now, let me tell you the basics. :)
To begin, make sure the player has the permission buildbattle.signplace or they will NOT be able to place a sign. How do you place a sign? Simple! In order to place a BuildBattle sign, type [BuildBattle] on the first line of sign (case sensitive!). If you want the sign title to be, for example, [BuildCraft], you can then edit this in the config! :D
Once you have created a BuildBattle sign, the sign will have the following lines:
[BuildBattle]
Players: 1/8
---------------------
JOIN LOBBY


The second and fourth lines are dynamic. This meaning they will change automatically overtime. So if a new player joins the lobby, the "Players: 0/8" will change to 1/8 (8 as in this example as that is the default amount of players that can be in a game in the config - changeable) and etc. If a game is going on, the last line will change to JOIN BACK/SPECTATE.

If you edit the sign any time in the config (like the color), simply do /buildbattle reload in-game and the sign will automatically update for you. :)
If you try placing a BuildBattle sign before setting the lobby and/or arenas, an error message will be displayed.


If you remove the Lobby spawn information and/or arena locations in the data.yml, the sign's text will change to "ERROR" in red letting you know that there is an issue. The error message will be printed in the console telling you how to fix the issue.

Basically if you do something wrong in the data.yml file, the plugin will notify you by printing a specific error message in the console to let you know how to fix the problem. :)
Only ONE sign can be placed. If the player tries placing more than one sign on one server, the player will be notified that they can't. This is because only one instance of the BuildBattle game can run per server. So more than one sign would be unnecessary. You also of course can't place a BuildBattle sign in the BuildBattle world. You can only place it in the hub world defined in the config.yml.


When players right click the sign, they will join the BuildBattle game. If the lobby and/or arenas haven't been setup, then the player will be teleported no where. The player will also be notified. In order to use the sign join feature, the player needs the permission node buildbattle.signjoin. If they do not have this permission, then they will NOT be able to right click the sign and it will say they have no permission.
To remove a BuildBattle sign, you can change the "signPlaced" from "true" to "false" in the data.yml file and the sign will be deleted. Then a message, saying the sign has been removed via the data.yml file, will be printed in the console. To remove the sign in-game, make sure to give the player buildbattle.signremove and when ever a player punches the sign, it will be removed. Otherwise, it will tell them they have no permission to remove the sign.


1. /buildbattle | buildbattle.buildbattle
Aliases: /bb
When a player types in this command, it will list the plugins following commands. It only will show commands the player has access to.
2. /buildbattle setlobby | buildbattle.setlobby
Aliases: /bb setlobby
Sets the lobby spawn location for the BuildBattle lobby.
3. /buildbattle setarena [arena_number] | buildbattle.setarena
Aliases: /bb setarena [arena_number]
Sets the arena spawn locations for the BuildBattle arenas.
4. /buildbattle join | buildbattle.join
Aliases: /bb join
Join the lobby if the game has been fully setup.
5. /buildbattle reload | buildbattle.reload
Aliases: /bb reload
Reloads the entire config.yml file.
6. /buildbattle about
Aliases: /bb about
Gives information about the plugin (you can disable this command in the config.yml).
BuildBattle Sign Permissions:
buildbattle.signplace - Allows a player to place a BuildBattle sign.
buildbattle.signjoin - Allows a player to right click the BuildBattle sign and join the game.
buildbattle.signremove - Allows a player to remove a BuildBattle sign.

1. %prefix%
The plugin's prefix for in chat messages.
2. %start_timer%
Displays the amount of time remaining until the game will start (if enough players are in the lobby that are required to start).
3. %players_needed%
The amount of players needed for the game to start.
4. %arena_number%
The arena (1, 2, 3, etc).
5. %time_remaining%
The amount of time remaining until players will vote.
6. %current_theme%
Displays the current theme players are focusing on building.
7. %players_playing%
Displays the number of users playing in the game.
8. %players_allowed%
The total amount of players that can join the game.
9. %num_arenas%
Total number of arenas.
10. (SIGN ONLY) %sign_join_text%
The first line of the sign. This line displays the "signJoinText" from the config.yml.
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
26.2MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.9MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
4.7MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta