HOLODECK & TOURNAMENTS

The Big Picture

The Holodeck is where you create reusable tournament configurations. Think of it as programming your tournament "environment" before you run it.

┌─────────────────────────────────────────────────────────────────────┐
│                           HOLODECK                                  │
│  ┌─────────────────┐    ┌─────────────────┐                        │
│  │   Battle Mode   │    │     Staging     │                        │
│  │  (match rules)  │    │ (structure)     │                        │
│  │                 │    │                 │                        │
│  │  • Point goal   │    │  • Swiss 5R     │                        │
│  │  • Deck size    │    │  • Top 8 SE     │                        │
│  │  • Scoring      │    │  • Championship │                        │
│  │  • Ring out     │    │  • Auto rounds  │                        │
│  └────────┬────────┘    └────────┬────────┘                        │
│           │                      │                                  │
│           └──────────┬───────────┘                                  │
│                      ▼                                              │
│              ┌───────────────┐                                      │
│              │    Program    │  ← Battle Mode + Staging             │
│              │  "WBO Swiss"  │    (optional: League Compliance)     │
│              └───────┬───────┘                                      │
└──────────────────────┼──────────────────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────────────────────┐
│                         TOURNAMENT                                  │
│                                                                     │
│   Load Program → Register Players → Start → Progress Stages        │
│                                                                     │
│   ┌─────────────────────────────────────────────────────────┐      │
│   │              Tournament Progression                      │      │
│   │                                                          │      │
│   │   Swiss R1 → R2 → R3 → R4 → R5 → Finals → Championship  │      │
│   │         ↑                                                │      │
│   │    "One button to advance"                               │      │
│   └─────────────────────────────────────────────────────────┘      │
└─────────────────────────────────────────────────────────────────────┘

The key insight: Organizers don't need to think about pairing algorithms, round counts, or stage transitions. They load a Program, register players, and tap the FAB to advance. The system handles the complexity.

Creating Modules in Holodeck

Battle Mode (Match Rules)

Defines how individual matches are played:

Staging (Tournament Structure)

Defines how the tournament progresses:

Special: WBO Ranked Auto

When staging is set to WBO Ranked Auto:

• Structure auto-configures based on player count at tournament start
• 16 players → Swiss 5R → Top 8 → Championship
• 40 players → Swiss 6R → Top 16 → Championship
• No manual round count needed — the system calculates it

Assembling Programs

A Program = Battle Mode + Staging (+ optional League Compliance filter)

Program: "WBO Standard"
├── Battle Mode: "WBO Official" (FT7, 3v3, standard scoring)
├── Staging: "Swiss + Finals" (Swiss 5R → Top 8 → Championship)
└── League: "WBO Ranked" (filters to compliant options only)

Creating a Program

Programs are created in Holodeck's Assemble tab:

• Select League (optional) — filters available options to compliant ones
• Pick Staging — your tournament structure
• Pick Battle Mode — your match rules
• Validation panel shows any compatibility warnings
• Save → Program ready to use in tournaments

Programs in Tournament

Creating a Tournament

• Tournament Room → Create Tournament
• Load Program from Holodeck (or use a template)
• Program auto-populates all settings
• Share QR code for registration

The New Flow (v1.5.6+)

Before, running a tournament required navigating through Shōmen tabs, manually generating rounds, and tracking stage transitions:

Before (with manual Shōmen):
Create → Shōmen Setup → Shōmen Management → Generate Rounds → Judge → Shōmen Results
         (configure)    (manual pairing)     (manual trigger)

Now, the contextual FAB (floating action button) uses the TournamentProgressionService to always show the next logical action:

After (v1.5.6+):
Create with Program → Register Players → Start → FAB drives progression

Floating Action Button State Machine

Multi-Stage Progression

Rounds as Entities

Each round is a first-class database record:

• Isolated data per round (no overwriting previous rounds)
• Cached when complete (never re-fetched unnecessarily)
• Stage-aware (Swiss R1-R5 vs Finals SF1/SF2/F)

Stage Visualization

The tournament view adapts to show your current position in the bracket:

• Sticky stage header shows current stage + progress
• Wheel picker (iOS-style) for stage navigation
• Round pills show only the current stage's rounds
• Auto-navigate to new stage when generated

Each stage has its own rounds, standings, and progression rules. The system handles the transitions automatically.

Summary

Continue Learning