Skip to content

Free agent rules reference#43693

Open
JustinWinningham wants to merge 9 commits intospace-wizards:masterfrom
JustinWinningham:free-agent-rules-reference
Open

Free agent rules reference#43693
JustinWinningham wants to merge 9 commits intospace-wizards:masterfrom
JustinWinningham:free-agent-rules-reference

Conversation

@JustinWinningham
Copy link
Copy Markdown
Contributor

About the PR

Refactored ghost selection flow
Added new document tag support for ghost role picker
Reworked guidebook layout and added new pages for existing content (did not change underlying content, just guidebook)
Added rule clarifications for ghost role specific rule interactions

Why / Balance

This PR was originally opened to address a rule gap for free agents - our rules did not clarify what free agents like closet skeletons were allowed (or not allowed) to do. In pursuit of this, I also refactored our ghost selection screen to assist new players in how a role should/could be played. This was done in support of the this rules update as admins get many common / repeat questions about how a specific role interacts with the rules.

Technical details

New GhostRoleComponent.GuideEntry field
GhostRoleSystem populates it
GhostRoleRulesWindow rewritten - window went from fixed size to a ScrollContainer which links to the specific guidebook page for that role - now also includes role specific interactions for said role. Has fallback protection to use the old 'raw rules' richtext if no link is present on the prototype (for cases where admins make something sentient or somebody uses cogni on a mob not otherwise configured for ghost role).
GhostRoleRulesEmbed New document tag.

New guidebook prototype Trees - added Free agents, Other Roles sections; and move Minor Antagonists from 'Antagonists' where all were crammed into a single page so each minor antag type can have its own page.

Media

N/A

Requirements

Breaking changes

Changelog

🆑

  • tweak: Refactored ghost role selection - now shows the guidebook page for the relevant ghost role, and includes a collapsible common rule interactions section for that role at the top.

This was just supposed to be a rules update but this got a little out of hand.
@PJBot PJBot added S: Untriaged Status: Indicates an item has not been triaged and doesn't have appropriate labels. Changes: UI Changes: Might require knowledge of UI design or code. S: Needs Review Status: Requires additional reviews before being fully accepted. Not to be replaced by S: Approved. size/M Denotes a PR that changes 100-999 lines. labels Apr 22, 2026
@JustinWinningham JustinWinningham marked this pull request as draft April 22, 2026 22:35
@Princess-Cheeseballs Princess-Cheeseballs self-assigned this Apr 22, 2026
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/antagonists.ftl Outdated
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/antagonists.ftl Outdated
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/antagonists.ftl Outdated
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/minorantagonists.ftl
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/minorantagonists.ftl Outdated
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/free-agents.ftl
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/free-agents.ftl Outdated
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/antagonists.ftl
@K-Dynamic
Copy link
Copy Markdown
Contributor

K-Dynamic commented Apr 23, 2026

I am pretty sure only the closet skeleton remains as a free agent.

Regardless, I don't like free agents since they end up following many of the same rules as crew members (especially around mass sabotage or indiscriminate murder), which brings into question why they exist.

I personally think all characters should have agency to mess around and cause issues for security rather than splitting them between an ambigious free agent role or goodie crew member, especially since we don't have many free agents in a single round.

@JustinWinningham JustinWinningham marked this pull request as ready for review April 23, 2026 04:31
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/antagonists.ftl
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/antagonists.ftl Outdated
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/antagonists.ftl
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/antagonists.ftl
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/antagonists.ftl
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/free-agents.ftl Outdated
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/antagonists.ftl Outdated
Comment thread Resources/Locale/en-US/guidebook/ghost-roles/free-agents.ftl Outdated
@Pok27 Pok27 added P3: Standard Priority: Default priority for repository items. T: Refactor Type: Refactor of notable amount of codebase D2: Medium Difficulty: A good amount of codebase knowledge required. A: Roundflow/Antag Area: Roundflow - "What happens in the game", including antagonist roles and their capabilities A: Rules Area: Changes to the default server rules as provided by Wizden. and removed S: Untriaged Status: Indicates an item has not been triaged and doesn't have appropriate labels. labels Apr 23, 2026
@Pok27 Pok27 added D3: Low Difficulty: Some codebase knowledge required. and removed D2: Medium Difficulty: A good amount of codebase knowledge required. labels Apr 23, 2026
@K-Dynamic K-Dynamic mentioned this pull request Apr 24, 2026
2 tasks
@LordEclipse
Copy link
Copy Markdown
Member

I am pretty sure only the closet skeleton remains as a free agent.

Regardless, I don't like free agents since they end up following many of the same rules as crew members (especially around mass sabotage or indiscriminate murder), which brings into question why they exist.

I personally think all characters should have agency to mess around and cause issues for security rather than splitting them between an ambigious free agent role or goodie crew member, especially since we don't have many free agents in a single round.

The problem with that is then security becomes unplayable, needs stronger tools for better crowd control, and basically is encouraged to literally 1984 the crew.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A: Roundflow/Antag Area: Roundflow - "What happens in the game", including antagonist roles and their capabilities A: Rules Area: Changes to the default server rules as provided by Wizden. Changes: UI Changes: Might require knowledge of UI design or code. D3: Low Difficulty: Some codebase knowledge required. P3: Standard Priority: Default priority for repository items. S: Needs Review Status: Requires additional reviews before being fully accepted. Not to be replaced by S: Approved. size/M Denotes a PR that changes 100-999 lines. T: Refactor Type: Refactor of notable amount of codebase

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants