# Introduction

**Battle Royale Trading Competition** — built on [Pacifica](https://pacifica.fi/) perpetual futures.

{% hint style="info" %}
**Traders enter an arena. Rounds get harder. Leverage drops. Drawdown tightens. Only one survives.**
{% endhint %}

## What is Pacifica Colosseum?

Pacifica Colosseum transforms perpetual futures trading into a **competitive battle royale**. Traders share arenas, fight for strategic board positions, form alliances (and betray them), and survive four increasingly brutal elimination rounds — all while trading real assets on Pacifica's testnet exchange.

It's not just about who trades best. It's about **who survives**.

## The Core Loop

```mermaid
flowchart LR
    A[🚪 Join Arena] --> B[🗺️ Draft Territory]
    B --> C[📈 Trade to Survive]
    C --> D[⚔️ Skirmish]
    D --> E[🤝 Form Alliance]
    E --> F[🗳️ Betray Vote]
    F --> G{Round End}
    G -->|Eliminated| H[💀 Out]
    G -->|Survived| I[Next Round\nHarder Rules]
    I --> B
    I -->|Last Standing| J[🏆 Champion]
```

## Key Features

<table><thead><tr><th width="238">Feature</th><th>Description</th></tr></thead><tbody><tr><td>⚔️ <strong>4-Round Battle Royale</strong></td><td>Progressive elimination — leverage drops, drawdown tightens each round</td></tr><tr><td>🗺️ <strong>Territory System</strong></td><td>Snake draft assigns board positions with unique PnL/leverage modifiers</td></tr><tr><td>💥 <strong>Skirmish Battles</strong></td><td>Attack adjacent territories every 60s to steal better positions</td></tr><tr><td>🤝 <strong>Alliance &#x26; Betrayal</strong></td><td>Average PnL with allies — then vote to betray at round's end</td></tr><tr><td>🛡️ <strong>Ability System</strong></td><td>Shield, Fortress, Second Wind, Sabotage — one-time use powers</td></tr><tr><td>⚠️ <strong>Hazard Events</strong></td><td>Random market disruptions shake up the competition mid-round</td></tr><tr><td>🌿 <strong>Progression Tree</strong></td><td>Choose your path after each round: Aggressive / Defensive / Scout</td></tr><tr><td>🤖 <strong>Demo Mode</strong></td><td>6 AI bot traders with personalities — no testnet needed</td></tr></tbody></table>

## Round Progression at a Glance

<table><thead><tr><th width="99">Round</th><th width="140">Name</th><th width="139" align="center">Max Leverage</th><th width="149" align="center">Max Drawdown</th><th>Elimination</th></tr></thead><tbody><tr><td><strong>1</strong></td><td>Open Field</td><td align="center">20x</td><td align="center">20%</td><td>Bottom row + bottom 30% PnL</td></tr><tr><td><strong>2</strong></td><td>The Storm</td><td align="center">10x</td><td align="center">15%</td><td>Bottom row + bottom 40% PnL</td></tr><tr><td><strong>3</strong></td><td>Final Circle</td><td align="center">5x</td><td align="center">10%</td><td>Top 5 advance only</td></tr><tr><td><strong>4</strong></td><td>Sudden Death</td><td align="center">3x</td><td align="center">8%</td><td><strong>Any</strong> drawdown breach = out</td></tr></tbody></table>

{% hint style="danger" %}
**Sudden Death is brutal.** In Round 4, a single wrong position at 3x leverage can breach 8% drawdown and eliminate you instantly — no grace, no buffer.
{% endhint %}

## Live Links

{% hint style="success" %}
🚀 **Live Demo**: [pacifica-colosseum.vercel.app](https://pacifica-colosseum.vercel.app/) — fully running with 6 bot traders, no login required to spectate.
{% endhint %}

<table><thead><tr><th width="245">Service</th><th>URL</th></tr></thead><tbody><tr><td><strong>Frontend App</strong></td><td><a href="https://pacifica-colosseum.vercel.app/">pacifica-colosseum.vercel.app</a></td></tr><tr><td><strong>Game Engine</strong></td><td><a href="https://adequate-determination-production-4cb3.up.railway.app/health">adequate-determination-production-4cb3.up.railway.app</a></td></tr><tr><td><strong>Testnet Access</strong></td><td>Code <code>Pacifica</code> at <a href="https://test-app.pacifica.fi/">test-app.pacifica.fi</a></td></tr></tbody></table>

## Built For

**Pacifica Hackathon 2026** — submitted April 16, 2026.

This documentation covers everything: game mechanics, system architecture, full API reference, deployment guide, and a complete demo walkthrough.

## Where to Start

{% tabs %}
{% tab title="I" %}

1. [Demo Walkthrough](https://stylenecy.gitbook.io/colosseum/demo/walkthrough) — 5-minute guided feature tour
2. [How to Play](https://stylenecy.gitbook.io/colosseum/game-mechanics/how-to-play) — understand the game mechanics
3. [Architecture Overview](https://stylenecy.gitbook.io/colosseum/architecture/system-overview) — system design & tech decisions
   {% endtab %}

{% tab title="I" %}

1. [Quick Start](https://stylenecy.gitbook.io/colosseum/quick-start) — running locally in 5 minutes
2. [Architecture Overview](https://stylenecy.gitbook.io/colosseum/architecture/system-overview) — 3-tier system design
3. [Engine Services](https://stylenecy.gitbook.io/colosseum/game-engine/engine-services) — all 17 game engine services
4. [API Reference](https://stylenecy.gitbook.io/colosseum/api) — frontend + engine API
   {% endtab %}

{% tab title="I" %}

1. [How to Play](https://stylenecy.gitbook.io/colosseum/game-mechanics/how-to-play) — step-by-step player guide
2. [Territory System](https://stylenecy.gitbook.io/colosseum/game-mechanics/territory-system) — positioning strategy
3. [Alliance & Betrayal](https://stylenecy.gitbook.io/colosseum/game-mechanics/alliance-and-betrayal) — social mechanics
   {% endtab %}
   {% endtabs %}