> For the complete documentation index, see [llms.txt](https://cubixor.gitbook.io/cubixors-plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cubixor.gitbook.io/cubixors-plugins/mine-wars/overview-minewars/arena-setup.md).

# Arena setup

For a complete list of commands and permissions, open `Commands and Permssions` tab. Here are only these necessary for setup.

You can create multiple arenas on one server, but each arena will need its own world, which will be automatically reset after each game.

## Creating an arena

1. Create an arena using `/mw create <arena_name>`.
2. Create a separate world for your arena and name it the same as the arena. Copy the world save to the MineWars plugin folder. It will be necessary to restore its original state after each game.
3. Set the minimum and maximum number of players using `/mw setminplayers <arena> <count>` and `/mw set maxplayers <arena> <count>`.
4. Set the main lobby using `/mw setmainlobby <arena>`. Players will be teleported there when they leave the game.
5. Set the waiting lobby using `/mw setwaitinglobby <arena>`. Players will wait there until the game starts.
6. \[OPTIONAL] Make the arena accessible only for VIPs using `/mw setvip <arena> <true/false>`. VIPs are players with permission `sm.vip`
7. Add teams to the arena: use `/mw listteams <arena>` to get a list of available teams to add and `/mw addteam <arena> <team>` to the arena. Add as many teams\
   as you want, but at least 2.
8. Set spawns for teams: for each team execute `/mw setspawn <arena> <team>`.
9. \[OPTIONAL] Add loot chest locations using `/mw addchest <arena>`, while looking at a chest.
10. \[OPTIONAL] Add mob spawn locations using `/mw addmobspawn <arena>`.
11. Copy your arena world folder to the `plugins/MineWars/` folder. It will be reset to this state after each game.
12. Use `/mw setactive <arena> <true>` to activate the newly created arena.

## Creating signs

### Arena sign

To create a sign for a specific arena, place a sign and put `[minewars]` in the first line and arena name in the second line.

### Quick join sign

To create a quick join sign (which will select an arena for a player automatically),\
place a sign and put `[minewars]` in the first line and `quickjoin` in the second line.

### Removing signs

To remove a sign destroy it while sneaking

## Joining an arena

* Use `/mw join <arena>` command
* Use `/mw quickjoin` command to let the plugin choose the best arena for you and automatically join it
* Use `/mw arenasmenu` to open a menu with all available arenas
* Click a game sign or quick join sign.

You can also create NPCs or menus using external plugins and make them execute any of the commands above.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cubixor.gitbook.io/cubixors-plugins/mine-wars/overview-minewars/arena-setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
