> For the complete documentation index, see [llms.txt](https://docs.battle.fyi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.battle.fyi/hosting-events/create.md).

# Create a Battle

Any user can host a lobby. Here's what you configure.

## Lobby settings

| Setting          | Options                      | Description                                                          |
| ---------------- | ---------------------------- | -------------------------------------------------------------------- |
| Format           | Blitz, Elimination, Marathon | Determines round structure and elimination rules                     |
| Starting balance | Custom amount                | Paper money each trader starts with                                  |
| Assets           | BTC, ETH, SOL (any combo)    | Which markets are available to trade                                 |
| Leverage tiers   | 1x to 100x                   | Which leverage options players can use                               |
| Round duration   | 3 min to 60 min              | How long each round lasts                                            |
| Round count      | 1 to 10+                     | Total rounds in the battle                                           |
| Elimination %    | 0% to 50%                    | What % of the field gets cut each round                              |
| Visibility       | Public or Private            | Public lobbies appear in the Arena. Private requires an invite code. |
| Starting credits | Custom amount                | Credit balance for sabotage weapons                                  |

## Step by step

1. Go to your Dashboard
2. Tap **Create Battle**
3. Configure the settings above
4. Share the lobby link or invite code with players
5. When enough players have joined, start the battle from the admin panel

## Admin controls

As the host, you have access to the admin panel for your lobby:

* **Start/stop rounds** manually or let auto-admin handle timing
* **Trigger volatility events** (market-wide price disruptions)
* **Eliminate players** manually if needed
* **Manage the prize pool** distribution
* **Pause** the battle if something goes wrong

## Auto-admin

If you don't want to manually manage rounds, auto-admin handles the game loop automatically: countdown, rounds, elimination, and prizes. Just start it and let it run.


---

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

```
GET https://docs.battle.fyi/hosting-events/create.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.