Project Documentation

These notes move with each release.

Docs

πŸ“ Documentation Changelog

πŸ“ Documentation Changelog

[1.1.0] - 2026-09-28

✨ Features

  • wizard: space-to-advance and Ctrl+1-9 step jump with Ctrl-held highlight (648b2336)

πŸ“ Documentation

  • titles: document division setup and the cross-title rule (a20e79a2)

πŸ“¦ Build

  • add build:datastudio and prune redundant scripts (833961ec)

[1.0.0] - 2026-09-24

2026-09-24 β€” Booking Wizards, Trainers, Contracts, and DataStudio Staff

Catches the guides up with everything shipped since game v0.1.4.

βœ… Added

  • Segments guide: Match Wizard (Setup, Participants, Flow, Finish) and Segment Wizard (Duration, Sides, Location, Parts) walkthroughs, including six sides, eight parts, storyline suggestions, and manager auto-add.
  • Anonymous interference in Segments and Segment Simulation: hide the attacker's name for half the crowd pop and a +6 storyline rating bonus.
  • People guide: Trainers and Trainees (up to four trainees per trainer, post-match Charisma/Mic Skills/Hardcore growth, and where to assign them).
  • Front Office guide: renewal morale gate and happy-talent discount, the 60-day window for rival talent, the budget warning, and the Counter / Let Them Walk decision when a rival poaches your talent.
  • Shows and Events guide: the Going live intro (logo burst, lines revealed one per second, Space to start) and ringside companions on booking cards and in Live Event.
  • DataStudio guide: standalone installers, the Staff page and gallery, per-show and per-PPV staff with copy actions, and the calendar date picker.
  • Shortcuts: DataStudio staff page shortcuts (Ctrl+W, gallery T / S / N) and wrestler gallery weight shortcuts (Shift+C/L/H/S).

βœ… Updated

  • Segments β†’ Who Hosts a Part: a promotion with no ring announcers at all can use its commentators in the announcer slot.

2026-09-24 β€” Custom Themes and Theme Import

βœ… Added

  • DataStudio β†’ Themes: a live theme editor for the game's promotion colour variables (primary, secondary, accent, hue rotation, semantic and stat colours) with light/dark mode selection and a preview panel.
  • Background replacement: swap the six game backdrops (main menu/game shell, new game, live event, contract negotiation, and two spare slots) with your own images. Slots show a Default or Custom label.
  • Export .bbtheme: name your theme and export it as a single file carrying colours and every replaced background.
  • Settings β†’ Import Theme: load a .bbtheme file in game. It applies as your Custom promotion theme and swaps in the imported backgrounds, with a button to clear imported backgrounds.

βœ… Updated

  • DataStudio guide: new Custom Themes section covering the editor, the background slots, and how to import a theme in game.

2026-09-24 β€” Ring Announcers

βœ… Added

  • New staff role: Ring Announcer (ring_announcer). Ring announcers run Announcement, Injury, and Hype parts and use the same PR skills as interviewers (Media Handling, Social Media Savvy).
  • New Ring Announcers key staff slot for promotions, shows, and PPVs. New games fill it for promotions without key staff (two ring announcers at level 7+, one otherwise), and key-staff ring announcers grow after each show.
  • Datastudio: ring announcer role picker, grouping, stats, and roster breakdown, plus a Ring Announcers key staff editor.
  • Datapack warnings: a notice when someone sits in a broadcast key staff slot that doesn't match their role.
  • People, Glossary, Shows and Events, Segments, and Custom Datapacks guides cover the three broadcast roles, and Custom Datapacks explains how TEW, Cagematch, and Pro Wrestling imports assign them.

βœ… Updated

  • Segment Wizard: the announcer slot lists only ring announcers and the interviewer slot lists only interviewers, key staff first. Nobody else fills in, and an empty role shows "No ring announcer on staff" or "No interviewer on staff". The default ring announcer is preselected, and the announcer no longer has to be a segment participant.
  • Key Staff (in game and in Datastudio) only offers people with the matching role for Commentators, Interviewers, and Ring Announcers. People already assigned with the wrong role stay visible so you can remove them.
  • The commentary team and show intro stay commentators only, and "{interviewer}" narration never falls back to the ring announcer.
  • TEW conversion keeps announcers and colour commentators as commentators. Standard TEW databases have no ring announcer data, so converted universes start with none.

⚠️ No migration

Existing saves and datapacks are not converted. Anyone previously filed as an interviewer or commentator keeps that role, so your old ring announcers won't appear in the new announcer slot. Re-type them by hand in the Staff screen or in Datastudio, then add them to your promotion's Ring Announcers key staff.

2026-09-18 β€” Commentary Team and Show Intro

βœ… Added

  • Shows and Events guide: commentary team resolution (show, promotion, then a seeded fallback from your commentator staff), the pre-show intro dialog, and who speaks what in a segment.

βœ… Updated

  • Live events now open with a broadcast intro from the commentary team before segment 1.
  • Wrestlers now voice their own promo, interview, announcement, hype, confrontation, and interruption lines. Fights and match beats are called by commentators, who alternate strictly.

2026-09-18 β€” Special Matches Review Fixes

βœ… Updated

  • Debut booking no longer overrides a player-picked retirement (or other) special match.
  • Loser-leaves fallout records departures on the wrestler’s home promotion.
  • Player docs clarify card-position gates vs prestige and debut eligibility.

2026-09-18 β€” Special Matches Guide

βœ… Added

  • Special Matches guide: types, side-card debut checkboxes, live feed beats, and post-show stipulations.
  • Segments guide: link to the special matches doc from match booking.

2026-09-17 β€” Part-Scoped Segment Narration

βœ… Added

  • Segment Simulation guide: part labels in the live feed and part-driven random beats per booked wizard part.
  • Segments guide: note that Segment Wizard parts drive simulation narration.

βœ… Updated

  • Multi-part wizard segments now pull random commentary from a pool matched to each part type (promo, fight, interview, etc.) instead of generic canned lines.

2026-08-15 β€” Trainers and Datapack Cleanup

βœ… Added

  • Trainer is now a staff role. Veterans hang up the boots to coach in-ring skill and character work. Assign them on the company Key Staff board.

βœ… Updated

  • People β†’ Staff table: added the Trainer role.
  • Default datapack: numeric ticket prices, show key staff, birthplaces from each worker's base, non-exclusive contracts capped at six months, and trainers converted from existing backstage staff (no new people added).

2026-07-24 β€” Save Export/Import Feature

βœ… Added

  • Export Save as Database in Settings β†’ Datapacks: package your current save into a portable datapack folder containing wrestlers, promotions, titles, show history, and key staff.
  • Import from Save Game on the New Game screen: start a fresh career using an existing save slot's universe (roster, promotions, title history, show history, key staff, start date).
  • Import from Exported Datapack Folder: load a previously exported database package as the foundation for a new game.
  • Updated Saving and Continuing guide with export/import workflows.

2026-07-07 β€” Staff-Driven Auto Book

βœ… Added

  • New Auto Book sections in People β†’ Staff and Shows and Events explaining how Head Booker/GM skill, Writers, and Road Agents shape the auto-generated card.
  • New Development Shows section in Shows and Events covering automatic pre-booking by an assigned GM or company Head Booker.

βœ… Updated

  • People β†’ Staff table: added the Road Agent role (production quality for travelling/guest talent); clarified Booker as the company-level Head Booker; noted the Writer role now also covers production duties (the former Producer role has been folded into Writer).

2026-06-24 β€” Alliances and Factions Update

βœ… Added

  • New guide on Alliances and Factions (stables, inter-promotion alliances, shared rosters, cross-promotional shows, and alliance championships).
  • Integrated new links to promotions and alliances in Getting Started and Promotion Strategy guides.

2026-04-22 β€” Docs Refresh

βœ… Updated

  • Rewrote player-facing docs to remove technical/internal implementation details.
  • Cleaned outdated sections and simplified language for in-game readability.
  • Fixed broken replacement characters in headings/content.
  • Improved cross-linking between core gameplay guides.

βœ… Added

  • Front office guide covering Contracts, Facilities, Medical, Development, and Talent Finder.
  • New guides for Storylines, Tournaments, and Inbox/Calendar workflow.
  • This changelog to track future documentation updates.

βœ… Modding Coverage Kept

  • Preserved a dedicated modder section for custom datapacks, including:
    • wrestler/promotion/image structure
    • ID/reference expectations
    • validation checklist before import