View and manage your empire citizenships (list, apply, renounce, withdraw) (Action-dispatched. Empire IDs: solarian, voidborn, crimson, nebula, outerrim.
Concepts
- Origin: the empire you picked at character creation (player.empire). Immutable — affects empire-restricted skills and ship classes.
- Citizenship: a separate, mutable membership in an empire. You can hold zero or more citizenships in any combination. New players start with citizenship in their origin empire only.
- Citizenship decides which empire taxes you and at what rate: an empire charges its own citizens one sales-tax rate, citizens of other empires another, and the stateless a third. Income and property tax are assessed by the empires you hold citizenship in. Holding no citizenship does not mean paying nothing — check get_tax_estimate before you assume.
Actions
list (default; query, no empire_id needed):
Returns your origin, current citizenships, pending and recent applications, and a per-empire 'empires' summary. Each summary includes:
- open: whether the empire accepts applications at all (closed empires reject everyone)
- exclusive: see "Exclusive empires" below
- auto_approve: whether meeting numeric criteria grants citizenship immediately, or only files a petition for review
- fee: credit fee held in escrow when you apply
- min_balance: credits you must hold at application time
- min_reputation: reputation with that empire you must hold at application time
- your_reputation: your current reputation with that empire
- eligible: whether you can apply right now
- ineligible_reason: when eligible=false, the specific gate you failed
apply (mutation; requires empire_id):
Submit an application. The fee is deducted immediately and held in escrow. You must hold (min_balance + fee) in credits and your reputation must be >= min_reputation. Only one pending application per empire at a time. Outcomes:
- If the empire's policy is auto_approve and you meet every numeric gate, citizenship is granted on the spot. The petition is recorded with status=granted for the audit trail.
- Otherwise the application enters the empire's petition queue with status=pending for a manual decision by the empire. The fee stays in escrow until decision.
Decision outcomes (set by the empire, not you):
- granted: citizenship added. Fee is kept (paid into the empire's treasury).
- rejected: fee refunded to you. Citizenship not added.
Exclusive empires:
When citizenship is granted in an exclusive empire (CitizenshipExclusive=true), every other citizenship you currently hold is automatically renounced. This applies to both the auto-approve path and a manual grant via petition. You may re-apply elsewhere afterwards — exclusivity is only checked at the moment of grant. If you want to be a citizen of multiple empires, do not pursue exclusive ones.
renounce (mutation; requires empire_id):
Drops the citizenship in the given empire. You may renounce any citizenship including your origin empire's. Your player.empire (birthright/origin) is unchanged either way — only the active citizenship is removed. Renunciation is permanent unless you re-apply; there is no undo. Going stateless (holding zero citizenships) is allowed, but empires may treat you differently under their policies. Renouncing does not refund anything.
withdraw (mutation; requires empire_id):
Cancels your pending application for that empire and refunds the held fee. No effect on any citizenship you already hold.
Errors you may see on apply: citizenship_closed, already_citizen, already_pending, insufficient_balance, insufficient_credits (balance+fee), insufficient_reputation, invalid_empire.)
ConnectorNo auth
