---
description: Learn more about creating battlegrounds!
---

# Setting up for the first time

Battleground consists of many parts that work together and at the same time independently of each other. Setting up a battleground is an iterative process, where content of interest to you is added step by step. But first things first.

## Creating a new battleground

Everything is simple here. Just enter the command `/ms create battleground <battleground_name>` and a battleground with the given name will be created. It is recommended to give a name like `dm_mapname` or `ctf_mapname` to avoid confusion in the future.

After creating a new battleground, you will automatically enter the editor mode. You will understand it by the **sidebar**, which contains all information about the current edit session and the battleground that you are currently editing. In the future, when you need to edit some already existing battleground again, use the `/ms edit battleground <battleground_name>` command.

{% hint style="warning" %}
It's highly recommended to create a new battleground in a separate world. Personally, I prefer to use [**Multiverse**](https://www.spigotmc.org/resources/multiverse-core.390/) and [**VoidGen**](https://www.spigotmc.org/resources/voidgen.25391/) to create empty worlds without a single block, where I can build a new map from scratch.
{% endhint %}

## The basic requirements

In order for the battleground to be considered working and playable, you need to set the **volume** and create **two teams** with at least **one respawn point** and at least **one loadout**.

{% hint style="info" %}
It is assumed that you have already built yourself or downloaded a map from somewhere that you can use to play the game. If you have no idea where you can download them and don't want to build it yourself, then you can use my shematics. (currently not)
{% endhint %}

### Setting up the volume

To edit the battleground volume, use the `/ms edit volume` command. After executing this command, you will see a message in the chat that will say that you need to select two corners with the golden sword.

1. Execute the `/ms edit volume` command
2. While holding the **golden sword**, click `RMB/LMB` to select the first and the second corner
3. Execute the `/ms save` command
4. Wait until the save task is completed (execution time depends on the volume size)

### Setting up the teams

To create a **new team**, use the `/ms create team <team_name>` command. After that, a new team will be automatically selected in the editor. But this is only the beginning. Players have to spawn somewhere, right? To add a **respawn point** to a team, use the `/ms add respawn` command while standing where you want to create a respawn point.

{% hint style="success" %}
Use the `/ms edit color <hex_color>` command to change the team color.
{% endhint %}

To add a **loadout**, equip the items you want to give to the players first. It can be armor, blocks, tools, weapons, food, potions, whatever. Then run `/ms add loadout <loadout_name>` and your inventory will be saved as loadout. When players join a battleground, their inventory will saved and overwritten with the loadout you created.

1. Execute the `/ms create team <team_name>` command
2. Add at least one respawn point to the team using the `/ms add respawn` command
3. Add at least one loadout to the team using the `/ms add loadout` command

{% hint style="info" %}
The maximum number of loadouts is unlimited. If there is more than one loadout, then a random one will be selected when joining the battleground (the same goes for respawn points). Item parameters like custom name, enchantments, durability, and generally all possible NBT information also will be saved.
{% endhint %}

### Launching the battleground

So, you have created a battleground, setted up its volume, added and configured teams. How to play? Make sure you meet all basic requirements and execute the `/ms launch <battleground_name>` command. Battleground will be launched. When the battleground is launched, a message will be displayed in the chat about it. Also, players will be prompted to connect to the game.
