BattleArena
NOTE: This project has moved to Modrinth. All future updates will be posted there and this page will no longer receive updates.
A complete match and event framework for creating arenas and minigames in Minecraft. Supports creating modes through config files, or fully custom modes through plugins.
BattleArena allows you to create your own competitions on a Minecraft server through config files. Nearly all aspects of game logic are configurable, ranging from team sizes, spawn points, maps, game mechanics and many other features.
Features
- Arena isolation - Store/restore player items when joining or leaving competitions
- Classes - Create custom kits or classes
- Dueling - Configure dueling options for your competitions
- Dynamic arenas - Scale up competitions in worlds on-demand
- Scoreboards - Configure scoreboards for competitions
- Statistic Tracking (with BattleTracker) - Store competition statistics and include leaderboards
- Team configuration - Create solo or team-based competitions
- Tournaments - Run bracket tournaments for any match type
- World restoration - Restore maps once a competition ends
Default Modes
Active games in BattleArena are referred to as Competitions. BattleArena natively supports two competition types:
Matches
A game that is started when a certain condition is met (i.e. number of players), or is always active. These games can be joined at any time, as long as there are available maps. Common examples may include Spleef, SkyWars, Survival Games, or Capture the Flag.
A list of additional gamemodes can be found here.
Events
A game that is started based on a certain interval, or when triggered by a server administrator. These games cannot be joined normally unless the event is active. Common examples may include a bracket tournament, deathmatch, or a free for all.
Builtin Match Types
- Arena: Simple duels mode that you fight with what is given to you in the config.
- Skirmish: You bring in items you want to fight with. The game is always running, and you can join and leave at any time.
- Colosseum: 4v4 team deathmatch. Last team standing wins.
- Battlegrounds: 1 minute match in which the winner is the player with the most kills.
Builtin Event Types
- Free for All: A free for all deathmatch that starts every 30 minutes. Last player alive wins.
- Deathmatch: A 2-minute event where if you die you respawn. The player with the highest number of kills wins.
- Tournament: Bracket tournament for any number of teams.
User Guide
Most all of the configurable features in BattleArena will lie in the respective <arena>.yml files located in plugins/BattleArena/arenas. These can be modified, removed, and new ones can be added.
The full user guide for BattleArena can be found at the User Guide on the BattleDocs.
For Developers
BattleArena is highly extendable and has wide support for creating your own matches, events, and even competition types. It is an event driven framework, meaning external plugins can easily add or modify behavior in numerous ways.
Full documentation for the BattleArena API can be found on the Developer Guide on the BattleDocs.
Additional Extensions and Modules
BattleArena is a framework at heart, meaning that the base plugin comes with a very standard feature set, with the bulk of additional content coming from modules and extensions. The following extensions and modules build on top of BattleArena, and allow you to further extend BattleArena's capability.
Extensions
These are plugins which add new modes to BattleArena.
- ArenaSpleef - Adds Spleef to BattleArena
- ArenaCTF - Adds Capture the Flag to BattleArena
- ArenaPaintball - Adds a Paintball mode to BattleArena
- ArenaParkour (coming soon) - Adds Parkour to BattleArena
Statistic Tracking
Statistics are tracked by our sister plugin BattleTracker. This adds functionality such as leaderboards and ranking to BattleArena. See the BattleTracker page for more information.
Modules
These extend on existing BattleArena functionality and can (often) be used in any mode, even custom ones.
Bundled: These modules come pre-installed with BattleArena.
- Arena Resoration - Allows you to restore maps at the end of a competition from a WorldEdit schematic
- Boundary Enforcer - Ensures that players do not leave the arena bounds while in a competition.
- Classes - Adds custom classes (or kits) to BattleArena.
- Duels - Allows you to duel other players in configured arenas.
- One in the Chamber - Adds One in the Chamber support to BattleArena.
- Scoreboards - Adds scoreboard support to BattleArena.
- Team Colors - Changes the color of a player's name in arenas this module is enabled in.
- Team Heads - Sets each player's head item to a wool item of their team color.
- Tournaments - Adds bracket tournament support to BattleArena.
- Vault Integration - Support for functionality with Vault, such as adding/removing currency or giving/removing permissions in arenas
Third Party:
- PhatLoots - Support for configuring and resetting loot tables inside competitions.
A full list of party modules and plugins that utilize BattleArenacan be found on the Modules and Other Tools page on the BattleDocs.
Links
- Website: https://www.battleplugins.org
- Discord: BattlePlugins Discord
- Donate: BattlePlugins Patreon
Important Mentions
Special thanks to alkarin_v for writing the original BattleArena plugin back in 2011. While very little of the original code survives today, this laid the foundation of what would eventually become the BattlePlugins suite and the innovations that followed.
Comments
-
Zach443 Owner
-
clovisd5 Author
-
Kalashnikov79 Author
-
Redned_23 Author
-
View User Profile
-
Send Message
Posted Mar 28, 2015@haxxorzd00d
What version of WorldEdit ? What version of WorldGuard ?
-
View User Profile
-
Send Message
Posted Mar 28, 2015@Europia79
I wasn't thinking of the game types cycling automatically (though that's a good idea too), more that players can choose which type they want to play.
To give a practical example of what this could be used for, let's say we're on a mostly PvE server and the residents of Noobtown build a PvP arena so they can kick the snot out of each other in a controlled environment. But the thing is, sometimes they want to take in their gear and play for keeps, and sometimes they want to take in their gear just to play around without fear of losing it (like how duels work in Borderlands, for example). But not everyone in Noobtown has epic gear, so they add a class-based game type to accommodate those guys.
Each of these three games is easy to config with BattleArena, but all this happens in just one physical arena, so they need a way that only one game type can be active at once. That's what the group tag idea was for - if each of the 3 arenas was tagged "noobtown" then when someone joins one of the 3 arenas in the "noobtown" group then the other 2 would be locked until the match was over. There's probably a more elegant way to go about that, but that was how I figured it could be done.
On a totally unrelated note, I can't get /arena alter <arena> addregion to add a Worldguard region. It throws up a big old pile of errors in console and the in-game error wants me to specify a GameStage, which doesn't seem right.
http://pastebin.com/sc2GLwuB
Compatibility trouble with WG 6? Could be user error of course... :)
-
View User Profile
-
Send Message
Posted Mar 28, 2015@haxxorzd00d
I like this idea. I had a similar idea called "Medley" where you could join this one "Medley" game... and it would be a mixture of different game types... Like, when one game ends (say CTF for example), the next game type might be Football or BombArena (obviously configurable).
But you're talking about an idea of a PhysicalArena defined by Location... that contains more than one game type. When the arena ends, does the next game type automatically start ?
-
View User Profile
-
Send Message
Posted Mar 28, 2015Fantastic plugin, but one feature I'd love is to be able to "group" arenas so only one can be active at once.
Say I've built an awesome colosseum and I want to be able to play several game types inside it (let's say skirmish, arena, and I dunno, paintball) without having to copy and paste it to make multiple arenas (maybe it's in survival, or we don't have a lot of space). Obviously I can define three arenas inside this one building and set up three join signs for players, but the plugin treats each of these as a separate arena - meaning there could be three matches going on in the one arena, which would be a big mess for everyone.
Ideally I'd like a command to add a group tag to an arena (in this case "colosseum" would make sense) then when a player joins one of these three arenas, the other two tagged "colosseum" are closed so no-one can join them. Sort of like a menu system, right?
tl;dr: a way to pick from multiple game modes in one location would be awesome.
-
View User Profile
-
Send Message
Posted Mar 26, 2015@WinFamSurv
There are no compatibility issues with bungeecord, but at the same time, BattleArena is not going to teleport players to another server via bungeecord.
To do Paintball inside a CTF arena, You would have to develop a custom BattleArena module or use Crackshot. If you use Crackshot, just configure an arena class to have a paintball weapon & ammo. If you develop a custom module, then just put the .class file into the /plugins/BattleArena/modules/ directory, then to activate that module for a CTF arena, you would goto /plugins/ArenaCTF/CaptureTheFlagConfig.yml and add a new YML node key-value pair: The key would be modules: and the value would be the name of the module's .class file without the .class file extension
-
View User Profile
-
Send Message
Posted Mar 26, 2015We are currently considering adding Battle Arena 2 with the paintball and CTF extensions to our servers, but first I have a couple of questions I hope can be answered here.
Firstly are there any compatibility issues currently when running the plugins on a Spigot bungeecord servers with Minecraft version 1.8.3?
Secondly I am not familiar with the amount of customisation that is available with these plugins, so I wanted to know If I can incorporate a paintball match into a CTF arena/match so I can effectively have Paintball CTF matches?
Thanks in advance EllisWin
-
View User Profile
-
Send Message
Posted Mar 25, 2015!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! I have a few problems ... 1) Sometimes there is a problem with the mini-games. At first, everything is going right, but then, on some match there is a queue that is filled with players and a match dosesn't start for some reason. Only the command "/Wg cancel" (example for Woolgame) or "/Ctf cancel" (example for CaptureTheFlag) can solve this problem.
2) On the pre-start there is a countdown, which starts exactly at the same time as the match time.
-
View User Profile
-
Send Message
Posted Mar 17, 2015same here it happen more ofter with parkour plugin, and after like 2 days without restart the server
-
View User Profile
-
Send Message
Posted Mar 9, 2015Players cannot join battlearena : says "already in a match"
Players get stuck in que waitroom forever if there was not enough players to start.
-
View User Profile
-
Send Message
Posted Mar 5, 2015@Zach443
Why yes I do. If that causes issues, then I'll have to work around it. Thank you for the input.
-
View User Profile
-
Send Message
Posted Mar 5, 2015@MayorMike
Do you by any chance have Multiverse Inventories installed? I am investigating the bug right now, but I think that plugin might be interfering and causing problems like this.
@SatoAV
I don't know a whole lot about Cauldron, however that is definitely not normal. I would need to talk to you a little bit more before I could diagnose the problem accurately.
-
View User Profile
-
Send Message
Posted Mar 4, 2015I'm unsure why, but for ArenaSpleef, players never have an inventory after. They lose all XP, Items, etc. Here's the SPleef's config for reference. http://pastebin.com/egYuvWZZ I don't know why they don't work, but reloading the config doesn't help. Unless I need to /reload or shutdown the server for these changes.
-
View User Profile
-
Send Message
Posted Mar 4, 2015I get serious performance issues with this plugin on Cauldron 1.7.10. I have only one Skirmish arena set up, and currently the server is on test with no active players whatsoever. Despite that, server's allocated RAM is increasing at insane rates. After couple hours it can reach to 12 Gb. Without the plugin server runs just fine.
More than that, I get constant 3-4 sec freezes every now and then when running this plugin. Also, freezes occured when player died in the arena.
Any ideas on how to fix the issue? I don't use any extra functions, just pure Skirmish arena with no WG or WE options.
-
View User Profile
-
Send Message
Posted Mar 2, 2015@Europia79
I have a few problems ... 1) Sometimes there is a problem with the mini-games. At first, everything is going right, but then, on some match there is a queue that is filled with players and a match dosesn't start for some reason. Only the command "/Wg cancel" (example for Woolgame) or "/Ctf cancel" (example for CaptureTheFlag) can solve this problem.
2) On the pre-start there is a countdown, which starts exactly at the same time as the match time.
-
View User Profile
-
Send Message
Posted Mar 2, 2015@videodrone81
Your second problem is similar to one of my problems.
-
View User Profile
-
Send Message
Posted Feb 26, 2015Problems : 1. Upon making extra arenas for bg for example, it won't go to the next arena no more after the first arena map is over since changing to Battlearena2. 2. If players are in queue in the waitroom and there are not enough players after the timestart, they stay in the waitroom forever and don't get removed from that queue. However, when new players join the same game, they are in a different queue. So this player gets left out forever.(or until /bg leave and /bg join again)
-
View User Profile
-
Send Message
Posted Feb 23, 2015Somesone can update and continue ArenaParkour? (source https://github.com/AugmentedWolf/Parkour ) because it got a bug about checkpoints, sometimes after some die, player will lose all checkpoint and have to start the parkour again.... no errors in console...
-
View User Profile
-
Send Message
Posted Feb 23, 2015@AdamTragedy
Adam, nobody has reported any details (until now) to investigate. It appears that you have to remove clearInventory from onCompete: That should fix your issue.
@LastTulare
I wouldn't use old configs because of all the changes... For example, one change in particular is related to configs... In newer versions, SerializerUtil.parseLocations(cs) will be returning a List of SpawnLocations indexed in a Map, whereas your arenas.yml file will NOT have them in YAML List format... because older versions of SerializerUtil.parseLocations(cs) simply returned a Map where each index contained only ONE location... not a list of locations.
@GodsDead
All of the timing reports that i've seen are simply lag spikes caused by WorldEdit pasting a schematic at the end of a match... So the solution would be to not allow players to destroy blocks during a match, and you won't have to have WE replace them at the end. Or, try AsyncWorldEdit.
http://www.spigotmc.org/wiki/timings/
Pct Total = Lag
Pct Tick = Lag Spike
And I have NEVER seen a timings report where BattleArena has a high Pct Total.
-
View User Profile
-
Send Message
Posted Feb 22, 2015@LastTulare
All of your old config files should work just fine. The only thing you will have to update is your arena locations. If your arenas are in new worlds and/or locations then you will need to delete your arenas.yml and recreate them all.
@AdamTragedy
I will be trying to fix this tomorrow. Sorry for the wait, but please know that we are working hard to get all the bugs worked out.
-
View User Profile
-
Send Message
Posted Feb 22, 2015So...for some reason, when the players are done with the battle and leave the ARENA gamemode, their inventory is gone. Here is my ARENA config file, what am I doing wrong here?
Few people have questions and stuff regarding this on the spigot page. FYI.
http://pastebin.com/fh05AbqQ
Going on 26 days now with no fix. I was told to follow this link for updates.....and there has been nothing: https://github.com/BattlePluginsDev/BattleArena/issues/11
Is this going to be fixed or should I find a better plugin? I can't stay online and monitor every person that players and manually fix all of their inventories.