Coalition Formation

Coalitions are created and managed by national party chairs. This page covers the full lifecycle: creating, inviting parties, joining, leaving, and disbanding.

Creating a Coalition

Only a national party chair can create a coalition.

Required fields:

• Name — 3–60 characters, unique per country
• Abbreviation — 2–10 characters
• Hex color — for display on the coalition card and logo

On creation, your party automatically becomes the first member and the coalition chair party. As the chair, your character (chairCharacterId) holds the coalition chairmanship.

Navigate to /parties?country=X → Coalitions tab → "Create Coalition" button. Non-chairs see the button grayed out with a tooltip explaining the restriction.

Inviting Parties

As coalition chair, you can invite other parties by their party ID from the Chair's Office tab on the coalition detail page.

Invite flow:

1. Chair sends invite to target party
2. Target party's national chair sees an invite banner on the coalition page
3. Chair accepts → party joins | Chair declines → invite removed

Joining a Coalition

Any national party chair can request to join an existing coalition without waiting for an invite.

Join request flow:

1. National chair submits a join request from the coalition page
2. Coalition chair sees the pending request in their Chair's Office tab
3. Coalition chair accepts → party joins | Coalition chair declines → request removed
4. Requesting chair can cancel their own pending request at any time

Leaving and Kicking

• Leaving voluntarily: Any member party's national chair can leave using the "Leave Coalition" button
• Kicking: The coalition chair can kick any member party; the kicked party's chair receives a coalition_kicked notification

If the coalition chair party leaves voluntarily:

• If other members remain, the most senior member by join date automatically becomes the new chair party
• If no members remain, the coalition is deleted

Chair Mechanics

Key fields on the Coalition document type:

Note: coalitions use chairCharacterId, not chairId. This is different from PoliticalParty which uses chairId. Always check the type when reading coalition leader data.

Chair transfer: The coalition chair can voluntarily transfer chairmanship to any member party's national chair at any time from the Chair's Office tab.

Succession: If the chair party is deleted by the empty-party cleanup process, the next most senior member inherits the chair automatically.

Disband Votes

Any member party's chair can initiate a disband vote from the Chair's Office.

Rules:

• Duration: 24 hours from initiation
• Voting: each member party's national chair votes yes or no; votes can be changed before expiry
• Threshold: majority required — floor(totalMembers / 2) + 1 yes votes
• Only one disband vote can be active per coalition at a time

If the vote passes: the coalition is deleted, coalitionId is cleared from all member parties, and all chairs receive a notification.

If the vote fails: the vote is cleared and the coalition continues unchanged.

Disband votes are resolved during turn processing (not instantly) — votes expire at the next turn that runs after the 24-hour window.

Party Deletion Cascade

When a party is deleted by the empty-party cleanup (no members, no seats):

1. The party is removed from any coalition's members array
2. If the deleted party was the coalition chair, the next most senior member becomes the new chair
3. If no members remain after removal, the coalition is deleted entirely

Related

• Coalitions — What coalitions are and their gameplay effects.
• Party Leadership — National chair role and the chairId vs chairCharacterId distinction.
• Political Parties — How parties relate to coalitions.