Project Documentation

These notes move with each release.

Docs

🏆 Championship Titles

Championship Titles

Titles are your strongest storytelling tool. Book them with intention and they make everything feel bigger.

What Titles Do

  • Create clear goals for your roster.
  • Build feuds that feel important.
  • Anchor your main-event scene.
  • Give your promotion identity.

Building a Healthy Title Scene

  • Keep a clear pecking order (world, secondary, tag, etc.).
  • Give champions regular meaningful defenses.
  • Build challengers before the title match.
  • Avoid nonstop hot-shot title changes.

🧩 Divisions and Eligibility

Every title has a Division, its own pool of contenders. Open any belt to reach its Title Details screen. The Division card sits right below the champion.

  • Singles titles take wrestlers. Tag and trios titles take teams. Switch a belt to a team format and the picker switches to your teams automatically.
  • A full division shapes your bookings. When the title is on the line, the match wizard lists division members first in its suggestions, and auto-booked defences pull challengers from the division. Leave it empty and the whole eligible roster stays in play.
  • Wrestlers can be in more than one division. Your world champion's top rival can also chase the secondary belt.
  • Injured wrestlers keep their spot. You can add hurt wrestlers to a division, and they stay in it while they recover.
  • If a division member leaves your promotion, their spot stays on the card, marked as no longer on your roster. Remove it to free the spot.

🛠️ Managing a Division

Hit Manage Division on the Division card to open the division editor. It has two columns:

  • Left: the standings. Everyone already in the division, ranked by their record.
  • Right: the picker. Your roster, filtered by weight class, gender and card position. Each filter starts at the title's own setting, so a cruiserweight belt shows cruiserweights first. Turn on the ±1 card tier toggle to include wrestlers one step above or below the title's card position.
  • Tag and trios titles get a Teams tab, so you add whole teams instead of single wrestlers.

Weight classes come from each wrestler's listed weight in pounds: 215 lbs or less is Cruiserweight, 216-299 lbs is Heavyweight and 300 lbs or more is Super Heavyweight. Women are grouped by gender instead.

Division Standings

You never enter a division record by hand. The game works out each member's wins, losses and draws (W-L-D) from the results of matches you've already run.

  • The record starts over with every new title reign. When the belt changes hands, everyone in the division starts at 0-0-0. Use the All-time toggle to see records across every reign.
  • Each member also shows their current win streak and their last 5 results, so you can spot who's on a run.
  • Multi-person and tag matches count when division members are on opposite sides. Teammates never count against each other.
  • Draws and no contests count as a D.
  • Hover over a belt's title card to see the top 3 of its standings.
  • The wrestler details screen shows a wrestler's record in every division they belong to.

🥇 #1 Contendership

Each title can have one #1 contender: the wrestler (or team, for tag and trios belts) who has earned the next shot.

  • Book a #1 contender's match. In the match wizard, a #1 contender checkbox appears next to the title option. It's available when at least two sides of the match have members of that title's division and the current champion isn't in the match. A match is either a title match or a #1 contender's match, not both.
  • The winner becomes #1 contender. If they weren't in the division yet, they're added automatically.
  • When does the spot go away?
  • It's cleared after any title match for that belt, whoever ends up winning.
  • A loss in a non-title match does not take it away.
  • You can strip the contender manually from the title page at any time.
  • There's no time limit. The spot lasts until one of the above happens.
  • Book the title shot. When a belt has a #1 contender, the title page shows a Book the title shot button that sets up the champion vs. contender match for you.
  • Smarter suggestions. Match suggestions for a title list the #1 contender first, then the rest of the division by record.

🤖 AI Promotions and Divisions

Rival promotions use divisions too. If one of their titles has an empty division, they fill it automatically. When they book title defences, they choose challengers based on the #1 contender and division standings.

📜 Title History and Team Reigns

Every title keeps a history of its reigns. A tag or trios reign appears as a single entry under the team's name (or the members' names when the champions are not an official team), and the same single entry shows in each member's own history. Singles reigns are unchanged. Older saves are tidied up automatically when loaded.

If a champion passes away, the title is vacated and the history notes it.

Show-Focused Titles

If you run multiple shows, you can:

  • Keep some belts tied to one show.
  • Let some belts float across shows.
  • Save cross-show title clashes for special events.

Championship Booking Tips

  • Champions should feel hard to beat.
  • A long reign needs strong challengers to stay interesting.
  • Big title changes work best on big cards.

See Also