BattleArena

!(https://cdn.modrinth.com/data/cached_images/011523b3ffa12ef2c48ccb9fd92c4ab0fa014257.png)

A complete match and event framework for creating arenas and minigames in Minecraft. You can define game modes using simple config files or build fully custom modes through plugins for maximum flexibility.

Create fully custom PvP arenas, minigames, tournaments and server events with one powerful framework. BattleArena gives Minecraft servers everything needed to run scalable competitions, from duels to SkyWars-style games and automated tournaments with nearly all aspects of game logic configurable through config files or extendable through plugins.

## 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 - Map restoration - Restore maps once a competition ends - Parties - Integration with various party plugins - PlaceholderAPI support - Display arena information in third party plugins through PlaceholderAPI - Scoreboards - Configure scoreboards for competitions - Statistic tracking (with (https://modrinth.com/plugin/battletracker)) - Store competition statistics and include leaderboards - Team configuration - Create solo or team-based competitions - Tournaments - Run bracket tournaments for any match type

## 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.

### 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.

### A list of pre-configured games can be found (https://docs.battleplugins.org/books/additional-gamemodes).

## 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 .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 (https://docs.battleplugins.org/books/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 (https://docs.battleplugins.org/books/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. - (https://modrinth.com/plugin/arenaspleef) - Adds Spleef to BattleArena - (https://modrinth.com/project/arenactf) - Adds Capture the Flag to BattleArena - (https://modrinth.com/project/arenapaintball) - Adds a Paintball mode to BattleArena - (https://modrinth.com/project/arenaparkour) - Adds Parkour to BattleArena

### Statistic Tracking Statistics are tracked by our sister plugin (https://modrinth.com/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 Enf