Project Documentation

These notes move with each release.

Docs

🚀 Getting Started

🚀 Getting Started

Welcome to Booker Blitz, a keyboard-centric wrestling promotion simulator. Your job is to put on great shows, grow your stars, and keep your promotion hot.

Start a new career

Follow these steps the first time you play. Button names match what you see on screen.

1. Open the game

Launch Booker Blitz from your desktop shortcut or game library. The title screen shows Continue (when you already have a save), New Game, Load Game, Settings, Datapack Editor, and Documentation.

2. Choose New Game

The New Game Setup screen has two steps. The left column is always your save details. The big area on the right is where you pick data and your promotion.

Step 1 of 2 · Booking details

  1. Save slot: Pick Slot 1, Slot 2, or Slot 3. A dot means that slot already has a save. You can overwrite it later when you start.
  2. Save name: Name this career file.
  3. Player name: Your name as the player (Player Name field). The game may suggest one from Settings if you set a default.
  4. Start date: Pick the in-game calendar day your universe begins.

Promotions, Wrestlers, and Arenas tabs (top of the main area):

  • Promotions: Scroll the list and click your promotion. A preview rail on the right shows champions, staff, and shows for that company.
  • Wrestlers: Browse everyone in the loaded datapack (good for checking imports).
  • Arenas: Open the Venue book to add, edit, delete, Load arenas file, or Export arenas before the first show. Set Arena image pack if you use custom building pictures.

The first time you select a promotion, a short preferences dialog may appear (weights and heights, theme, interface zoom). You can Skip or finish it; everything lives in Settings later.

When the sidebar Continue button is active, go to step 2.

Step 2 of 2 · Look and feel

Tune promotion theme and interface zoom on the Light the arena screen. Press Start Game when you are ready.

If the save slot was already in use, confirm the overwrite. The game builds your save and opens the Inbox.

Tip: Press Ctrl+Enter on step 1 to jump to step 2, or on step 2 to start when the form is valid.

3. Use the default world or bring your own data

On step 1, the game loads the bundled default roster and promotions automatically. To swap in custom content before you pick a promotion:

ButtonWhat it does
Reset DBRestore the default bundled world and clear custom image paths.
Custom DBOpen the import hub (see below).
Edit DatapackOpen the in-game Datapack Editor to tweak the loaded datapack before you start.

Community-made packs are listed on the official website resources page (link also appears inside Custom DB).

4. Custom DB import options

Press Custom DB on step 1. Choose one path:

  1. Import database file (.bbdb): A single archive exported from DataStudio or the game. Pick the file, then point at image folders if the game asks.
  2. Import from folder: A hand-made or exported datapack folder on disk (wrestlers.json, promotions.json, optional alliances.json, and an images folder).
  3. Import from Save Game: Pick a filled save slot, or Import from Exported Datapack Folder at the bottom of that dialog for a folder you exported from Settings → Datapacks → Export Save Database.
  4. Convert Database (.db / .mdb): Turn a legacy wrestling sim .db or .mdb file into Booker Blitz wrestlers and promotions. After conversion, set an images folder if prompted, choose whether to merge imported venues into your arena list, and confirm the import start date.

After any import, pick your promotion again, check Arenas if venues changed, then Continue → Start Game.

If something goes wrong: unreadable files show an error toast and leave your current data alone. Use Reset DB to return to the default world, or fix the pack in DataStudio (see 8.1 DataStudio) and import again.

5. Your first show

From the Inbox, read anything urgent, then open Calendar or Shows for your next event. Build the card (matches and segments), run the show, and check the Inbox again for results and fallout.

Your first 10 minutes (after the save exists)

  1. Open Shows and pick your next event.
  2. Book a full card (matches plus talking segments).
  3. Simulate the show.
  4. Check Inbox for results, fallout, and offers.

🗓️ Your weekly loop

  • Inbox: Read important updates first.
  • Roster / Teams: Check condition, morale, and injuries.
  • Storylines: Move at least one feud forward each show.
  • Shows: Build your card from opener to main event.
  • Calendar: Plan upcoming weekly shows and big events.
  • Contracts / Medical / Facilities: Handle the business side before it becomes a crisis.

🧠 Rookie booking formula

  • Open with energy.
  • Keep the middle of the card varied.
  • Use promos and brawls to push feuds.
  • End with your biggest stars and highest stakes.

⚠️ Early mistakes to avoid

  • Booking the same wrestlers every segment.
  • Ignoring expiring contracts.
  • Running risky matches with tired talent.
  • Letting storylines stall for weeks.

Read next