> 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/irl.md).

# IRL Event Setup

Battle Trade was built for live events. Conferences, meetups, watch parties, trading competitions. Here's how to run one.

## What you need

* A laptop to run the admin panel
* A screen or projector for the stage/wall view
* WiFi for all participants (or cellular as backup)
* Optional: a second screen for the commentator cast view

## Setup flow

1. **Create a private lobby** with an invite code specific to your event
2. **Test the broadcast views** on your display hardware before the event
3. **Share the invite code** at the venue (on-screen, printed, QR code)
4. **Run the admin panel** from your laptop to control rounds

## Display views

| Screen          | View                                | Resolution        |
| --------------- | ----------------------------------- | ----------------- |
| Main stage      | `/lobby/[id]/wall` or `/stage/[id]` | 4K recommended    |
| Commentary desk | `/cast/[id]`                        | 1080p             |
| Audience phones | `/spectate/[id]`                    | Mobile-responsive |

## Running the event

### Pre-show

Put the stage view on the big screen showing the countdown and lobby code. Let people join on their phones.

### During rounds

Switch to the broadcast view. The leaderboard, trades, and sabotage effects all update live. Use the admin panel to trigger volatility events for dramatic moments.

### Between rounds

Show the leaderboard. Announce eliminations. Build tension.

### Post-match

Display final results. Announce the winner. The stage view handles this automatically.

## WiFi contingency

If WiFi drops during a live event, open `/booth/offline` on the display. It runs a demo loop entirely client-side with no network required. Players can continue trading on cellular.

## Sponsor-funded lobbies

For sponsored events, you can pre-fund the lobby with credits so players don't need to bring their own. Configure the starting credit balance in lobby settings.


---

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