Project Documentation

These notes move with each release.

Docs

💾 Saving and Continuing

Saving and Continuing

Booker Blitz is built for long-term careers, so get in the habit of saving often.

🛟 Save Habits That Prevent Pain

  • Save before major shows.
  • Save before contract negotiations.
  • Save after a great event result.
  • Keep more than one slot so you can roll back if needed.

🗓️ Continuing Your Career

When you load a save, jump into this quick check:

  1. Open Inbox for urgent updates.
  2. Check Calendar for your next events.
  3. Review Contracts for expiring deals.
  4. Check Medical for injuries.
  5. Confirm your main-event plans in Storylines.

🧠 Good Slot Strategy

  • Slot 1: Main timeline.
  • Slot 2: Backup from 2-4 in-game weeks earlier.
  • Slot 3: Experimental slot for risky booking ideas.

☁️ Steam Cloud Saves

When you play through Steam, your three save slots are backed up to Steam Cloud automatically, so your career can follow you from one machine to another.

  • On by default: Turn it off any time in Settings (the Steam Cloud saves card, next to autosave).
  • Every save counts: Manual saves and autosaves in slots 1-3 are copied to the cloud after they finish saving locally.
  • Nothing is overwritten behind your back: When you launch the game, each slot is compared with its cloud copy. A local save that is newer (or has no cloud copy) is uploaded. A cloud save in an empty slot is restored automatically with a "Save restored from Steam Cloud" toast. If the cloud copy is newer than a slot that already has a save, the slot is left alone and shows a Newer cloud save badge.
  • Load from the cloud: Load Game has a Local saves tab and a Steam Cloud tab (shown when cloud sync is ready). Loading a cloud save copies it into its slot and opens it. If that slot holds a different save, you're asked to confirm the replacement first. An unreadable cloud save shows an error and changes nothing.
  • Slot badges: Each slot on the Load Game screen shows whether it is Synced, Syncing, Pending, Offline or has a Sync error.
  • Offline is fine: With Steam closed or no connection, the game keeps saving locally and nothing breaks. Cloud copies catch up on the next save.
  • Steam's own setting rules: If Steam Cloud is turned off for Booker Blitz in your Steam settings, the game shows "Turned off in Steam's own settings" and does not sync. Re-enable it in Steam to resume.
  • Deleting a slot deletes its cloud copy too, so a removed save will not come back on the next launch. If you delete a slot while offline, the delete is remembered on that machine and sent to Steam the next time cloud sync runs. (Another machine that still holds the save locally, or has an empty slot, can still restore it from the cloud before that happens.)
  • Save and Exit waits for the upload: Quitting through Save and Exit waits up to 10 seconds for the cloud copy to finish uploading, then closes regardless. If the upload didn't finish, the newer local save is uploaded on the next launch.
  • A failed cloud read never overwrites the cloud: If Steam can't be reached while reading a slot, that slot is skipped and shows an error badge rather than uploading your local copy over the cloud one.

⚠️ Syncing compares the time each save was made, so if two computers have very different clocks the wrong copy can win. Keep your system clocks correct.

Exporting a Slot to a File

Each slot has an Export save button. It opens a save dialog and writes a .bbsave file you can keep as a one-off backup.

Import a .bbsave file

Load Game has an Import button (desktop app only). Pick a .bbsave file, choose which slot (1-3) it should go into, and confirm if that slot already holds a save. The file is validated first; an unreadable or wrong-format file shows an error and changes nothing. This is also the way back for saves from the old save-to-file flow. To carry a universe into a new career, use the datapack export below.

📦 Exporting your save as a datapack

You can package your current save game into a portable datapack folder that contains your entire universe: wrestlers, promotions, titles, show history, and key staff. This is perfect for:

  • Backups: Keep a standalone copy outside your save slots
  • New career from your universe: Start fresh while keeping the same roster and history
  • Sharing: Send your custom wrestling world to other players

How to Export

  1. Open Settings → Datapacks
  2. Click Export Save Database
  3. Choose a folder. The game creates a complete datapack with:
  • wrestlers.json: all wrestlers and staff with attributes, contracts, and history
  • promotions.json: all promotions, shows, championships, and storylines
  • images/: portraits, logos, and belt artwork

How to import into a new career

When starting New Game, press Custom DB, then either:

Import from Save Game

  1. Choose Import from Save Game and press Select save
  2. Pick a filled Slot 1, Slot 2, or Slot 3, or press Import from Exported Datapack Folder for a folder you exported earlier
  3. The game loads roster, promotions, title history, show history, key staff, and start date
  4. Select your promotion, press Continue, then Start Game

Import from folder

Use Import from folder in the same Custom DB dialog for any valid datapack folder on disk (same layout as the export above).

See Getting Started for the full new-game walkthrough.