Faction Lore¶

The nine factions of Sectorwars 2102 (seven allyable + two hostile-only). Each is an NPC organization with its own ideology, territorial footprint, ally / rival matrix, and gameplay implications. Players don't join factions — they accrue standing through emergent behavior (combat, trade, exploration, social acts, resource flows). There are no missions or quests. See factions-and-teams.md#reputation-triggers for the full action-delta canon.

The canonical list (codified in models/faction.py:FactionType and the seed data) is seven allyable factions plus two hostile-only adversary factions:

Terran Federation
Mercantile Guild
Frontier Coalition
Astral Mining Consortium
Nova Scientific Institute
Fringe Alliance
Shadow Syndicate
Pirates (hostile-only — cannot be allied with)
The Cabal (hostile-only — endgame antagonist; single fixed HQ)

✅ Shipped — the canon faction roster (six allyable factions plus Pirates) seeds at startup via auth/admin.py:create_default_factions, alongside the Faction model, reputation per faction, the trade-modifier table, and territory access checks. 🚧 Partial — Shadow Syndicate is not yet seeded (see below).

🚧 Partial — Shadow Syndicate is referenced in faction_service.py rivalry table (paired with Mercantile Guild, combined-rep cap 600) but not yet seeded as a fully-fledged faction with territory and lore-driven gameplay. The Syndicate fence venue type that anchors emergent rep triggers lives in ../economy/black-market.md#syndicate-fence-venues.

📐 Design-only — dynamic patrol behavior reading sector influence percentages, faction-specific ship skins, faction-issued bounties, the emergent reputation action set (ADR-0032) including rivalry cascades and anti-symmetric matrix.

Terran Federation¶

Type: Lawful Government Theme: Order, security, prosperity FactionType code: FEDERATION Aggression: 4 / 10 Diplomacy: friendly

Ideology¶

Earth's parliamentary government, scaled to the entire Sol-aligned settled volume. Believes order is the precondition for prosperity. Maintains a standing navy, runs the Federation Bounty Board (the system that auto-attaches bounties to extreme-low-reputation players), and operates a galaxy-wide credit currency.

Territory¶

Inner clusters around the Capital Sector — high station density, well-patrolled warp lanes. Federation-controlled sectors are safe and slightly expensive (bias against bargain hunters).

Allies / Rivals¶

Relationship	Faction	Note
Rival	Fringe Alliance	Combined-rep cap 800 — climbing one limits the other
Cool	Frontier Coalition	Frontier resents Federation paternalism
Cordial	Mercantile Guild	Trade interests aligned
Cordial	Nova Scientific Institute	Research grants flow Federation → Nova
Hostile	Pirates	Open enemies

Gameplay implications¶

Combat-driven rep is abundant — pirate kills, Wanted-target hunts, and system-bounty kills all credit Federation rep. Heavily weighted in Fed-Controlled sectors.
Low-reputation penalties: 30% markup, denied station access, automatic patrol response in Federation sectors.
High personal_reputation players (Heroic / Legendary) gain a +5 reputation bonus with the Federation per legitimate trade.

Honored / Exalted perks¶

📐 Design-only — non-ship perks at the high reputation tiers (the Exalted-tier ship reward for each faction is documented in factions-and-teams.md):

Honored: 5% discount at Federation-flagged stations (stacks with the trade-modifier bucket); fast-track customs (no inspection delay in Federation-controlled sectors).
Exalted: 10% discount at Federation-flagged stations; safe-passage flag through Federation military zones (Federation patrols ignore the player even in restricted-access sectors).

Mercantile Guild¶

Type: Trade Consortium Theme: Profit-neutral, infrastructure-heavy FactionType code: MERCHANTS Aggression: 2 / 10 Diplomacy: neutral

Ideology¶

A merchant cartel that built the inter-sector trade network the Federation now polices. Officially neutral on every conflict. Charges the same prices to Federation marshals and Fringe smugglers — the manifest is the only thing that matters.

Territory¶

Owns the largest stations along major trade routes; runs many of the Class-3+ stations between regions. Few sectors are Mercantile-controlled in the territorial-access sense, but Mercantile stations exist almost everywhere.

Allies / Rivals¶

Relationship	Faction	Note
Rival	Shadow Syndicate	Combined-rep cap 600
Cordial	Terran Federation	Trade infrastructure shared
Cordial	All factions	Profit doesn't pick sides
Hostile	Pirates	Pirates raid Guild convoys

Gameplay implications¶

Trade volume is bread and butter — every transaction at a Guild-flagged port awards rep linearly with credit value (+1 / 5,000 cr); arbitrage round-trips and toll-gate participation layer additional rep.
Trade specialties: bonus pricing on bulk commodities (ore, organics, equipment).
Mercantile reputation grows naturally from trading; combat actions have minimal effect. Buying insurance is a meaningful Guild-rep faucet (BASIC +2 / STANDARD +5 / PREMIUM +10 per hull) since the Guild underwrites it.

Honored / Exalted perks¶

📐 Design-only:

Honored: tiered trade-fee reduction at Mercantile stations (3% / 2% / 1% as reputation climbs through Honored sub-tiers — i.e. the fee approaches zero at the top of the band).
Exalted: a flat +15% sale price on commodities sold at any Mercantile-flagged station (stacks on top of the Exalted trade-modifier bucket discount), plus access to bulk-buy contracts that Mercantile only writes for top-tier customers.

Frontier Coalition¶

Type: Independent Colonies Theme: Anti-Federation autonomy FactionType code: INDEPENDENTS Aggression: 6 / 10 Diplomacy: neutral

Ideology¶

Loose alliance of outer-rim colonies that broke from Federation oversight a generation ago. They want the Federation gone and Mercantile prices fair. Self-sufficient where possible, prickly where not.

Territory¶

Outer clusters — frontier sectors, asteroid belts, marginal habitable worlds. Patrols are lighter; pirate activity is higher; resources are richer.

Allies / Rivals¶

Relationship	Faction	Note
Rival	Terran Federation	Cool but not openly hostile
Rival	Astral Mining Consortium	📐 Design-only — Astral muscles in on Frontier mining claims
Cordial	Fringe Alliance	"Enemy of my enemy"
Hostile	Pirates	Pirates prey on isolated Frontier colonies

Gameplay implications¶

Exploration drives rep — first-discovery of distant sectors (≥10 hops from any Capital), first-arrival in isolated clusters via Quantum Jump, and establishing colonies in Frontier zone are the load-bearing emergent triggers.
Combat-driven rep — pirate kills in Frontier-influence sectors and defending Frontier outposts under siege.
Towing a stranded non-team-mate to safety is a unique Frontier-emergent good-neighbor signal (+15 per cross-sector tow chain).
Low reputation: denied refueling at Frontier outposts, hostile patrols.

Honored / Exalted perks¶

📐 Design-only:

Honored: 10% reduction on colonization costs (Genesis-device-deployment downstream costs and colony-establishment fees) in Frontier-tagged sectors; access to Frontier-only outposts that sell low-cost outfitting.
Exalted: one free Frontier planet claim redeemed at a Frontier outpost — bypasses the standard claim-fee flow and pre-flags the planet as Frontier-aligned.

Astral Mining Consortium¶

Type: Resource Corp Theme: Monopolistic mining FactionType code: MINING (🐛 — promoted from MERCHANTS per ADR-0033) Aggression: 5 / 10 Diplomacy: neutral

Ideology¶

The galaxy's largest extraction conglomerate. Owns mining rights on most uninhabited resource-rich planets and asteroid belts. Treats independent miners as competition, not colleagues.

Territory¶

Resource-extraction sectors and the orbital infrastructure around them. Claims rights to many uncolonized planets through purchased licenses.

Allies / Rivals¶

Relationship	Faction	Note
Rival	Frontier Coalition	📐 Design-only
Rival	Nova Scientific Institute	📐 Design-only — Nova wants research access to Astral-claimed sites
Cordial	Mercantile Guild	Astral sells through Mercantile channels
Neutral	Terran Federation	Lobbying relationship

Gameplay implications¶

Mining the loop — actually mining asteroid sectors with a Mining Laser equipped is the canonical AM rep faucet (+1 / harvest cycle); selling raw ore to AM-flagged refineries doubles down (+2 / 5,000 cr); paying claim-license fees voluntarily signals legitimacy (+15 / license). See ../economy/mining.md.
Defending Astral platforms under siege is a high-impact one-shot trigger (+25 per successful defense).
Trade specialties: raw ore, rare metals (precious_metals at +1 / 8,000 cr), refined fuel.

Honored / Exalted perks¶

📐 Design-only:

Honored: ore-purchase discount at Astral-flagged refineries (favored-rates pricing on raw ore and rare metals); ore-price notification feed (Astral pings the player when local ore prices spike).
Exalted: 15% passive income from Astral-claimed mining operations the player has actively defended in-sector; effectively turns the player into a stakeholder in Astral's extraction yield.

Nova Scientific Institute¶

Type: Research Org Theme: Quantum / exotic-tech focus FactionType code: EXPLORERS Aggression: 3 / 10 Diplomacy: friendly

Ideology¶

A multi-discipline research institute funded by Federation grants and private endowment. Studies warp tunnel mechanics, quantum trade dynamics, and exotic-matter applications.

Territory¶

Few sectors directly controlled — Nova prefers research stations attached to other factions' territory. Operates the Nexus research outpost in Central Nexus.

Allies / Rivals¶

Relationship	Faction	Note
Rival	Astral Mining Consortium	📐 Design-only — Nova wants access; Astral charges rent
Cordial	Terran Federation	Federation funds Nova
Cordial	Frontier Coalition	Field research collaborations
Neutral	Mercantile Guild, Fringe Alliance	Both trade Nova-developed tech

Gameplay implications¶

Exploration drives rep — first-scan of NEBULA / BLACK_HOLE / ANOMALY / WARP_STORM sectors awards +15 each. Quantum Shard harvesting in nebulae and refining at Nova-flagged stations are the steady-state faucets (see ../galaxy/quantum-resources.md).
Long-range Quantum Jump scans report data to Nova at +1 / scan (capped 5/day) — the WJ's signature ability is a Nova-loyalty signal.
First-scanning a Genesis-formed planet within 7 days of formation awards +15 (Genesis biology is Nova's research substrate).
Trade specialties: high-tech components, exotic matter, research data. Donating xeno-artifacts to Nova stations awards +30 (rare event).

Honored / Exalted perks¶

📐 Design-only:

Honored: early access to experimental ship upgrades and prototype tech sold only at Nova-flagged stations; Quantum Field Harvester yield bonus +10%.
Exalted: research-patent share — a recurring credit dividend whenever Nova publishes a discovery the player meaningfully contributed to (first-scans, anomaly investigations, and Quantum Shard handoffs that fed Nova research datasets).

Fringe Alliance¶

Type: Outlaw Coalition Theme: Black market, smuggling FactionType code: OUTLAWS (🐛 — clarified per ADR-0033) Aggression: 7 / 10 Diplomacy: hostile

Ideology¶

Loose confederation of smugglers, ex-pirates, refugees, and political dissidents who reject Federation jurisdiction outright. Not the same as the Pirates — Fringe operates on a (loose) honor code. Pirates do not.

Territory¶

Hidden bases in fringe regions — abandoned stations, deep nebulae, uncharted clusters. Sector access requires reputation; visitors with low Fringe rep are turned away or attacked.

Allies / Rivals¶

Relationship	Faction	Note
Rival	Terran Federation	Combined-rep cap 800
Cordial	Frontier Coalition	Mutual anti-Federation alignment
Cordial	Pirates	Fringe and Pirates overlap, but Fringe still has rules
Neutral	Mercantile Guild	Black market is still a market

Gameplay implications¶

Smuggling drives rep — black-market transactions at Fringe-controlled ports (+25 each), evading Federation contraband scans (+10 / evasion), surviving Suspect Status cycles (+15 per cycle).
Combat against Federation — defeating Federation patrol ships in Frontier or uncontrolled space awards Fringe rep, especially when the patrol initiated combat.
Trade specialties: contraband, stolen tech, illegal upgrades.

Honored / Exalted perks¶

📐 Design-only:

Honored: access to Fringe-only ports stocking illegal goods (advanced weapons, hacking tools, contraband upgrades); stealth-module discounts.
Exalted: Fringe citizenship-immunity — Fringe networks shield the player from Federation Bounty Board placement for low-grade infractions (the player can lose this protection by openly attacking Fringe assets); access to a Fringe black-market intel network that pings high-value contraband opportunities.

Shadow Syndicate¶

Type: Criminal Syndicate Theme: Organized black-market trade FactionType code: SYNDICATE (🐛 — reserved enum value per ADR-0033; seed pending) Aggression: 6 / 10 Diplomacy: hostile (rival of Mercantile Guild)

Ideology¶

A coordinated criminal trade network — fences, racketeers, money-launderers, traffickers in stolen tech and contraband. Where the Mercantile Guild runs the legitimate trade infrastructure, Shadow Syndicate runs the illicit shadow of it: counterfeit-goods rings, stolen-cargo redistribution, smuggling logistics, fraud-as-a-service. Distinct from the Fringe Alliance (broad-spectrum frontier rebels, smuggler-refugees, anti-Federation outlaws) — Syndicate is organized-crime corporate, not anti-establishment ideological. Distinct from Pirates (raiders who take by force) — Syndicate is the fence who buys what the Pirates steal.

Territory¶

No sectors openly controlled — Syndicate operations hide inside other factions' territory. A fence in the back room of a Mercantile Guild station; a smuggler's depot in Frontier Coalition space; an unregistered cargo hold attached to an Astral Mining Consortium platform. Syndicate "territory" is operational, not geographical.

Allies / Rivals¶

Relationship	Faction	Note
Rival	Mercantile Guild	Combined-rep cap 600 — the canonical legitimate-vs-illegitimate trade rivalry
Cordial	Pirates	Pirates raid; Syndicate fences. Symbiotic.
Cordial	Fringe Alliance	Overlapping client base — Fringe-tagged players are Syndicate's natural customers
Cool	Terran Federation	Federation tolerates Syndicate operations beneath the radar; the moment ops surface, Federation prosecutes
Neutral	Frontier Coalition, Astral Mining Consortium, Nova Scientific Institute	Syndicate works inside their territories without picking sides

Gameplay implications¶

Black-market access at high reputation — illegal goods (contraband upgrades, stolen tech, fenced cargo, fake registration documents).
Counterfeit / stolen-goods fencing — fencing Cargo Wreck cargo at Syndicate fence venues (+5 / 5,000 cr fenced), selling stolen-flagged commodities through Syndicate channels, and laundering credits across multi-hop chains are the canonical Syndicate rep faucets. See ../economy/black-market.md#syndicate-fence-venues.
Anti-investigation gear — Syndicate-only modules that obscure ship registration, defeat scanner queries, mask your wake.
Reputation grows through fencing stolen cargo, completing smuggling jobs, helping Syndicate operations evade Federation patrols.
Trade specialties: contraband, stolen tech, fraud kits, counterfeit equipment.

🚧 Partial — Shadow Syndicate is referenced in faction_service.py:FACTION_RIVALRIES (paired with Mercantile Guild, cap 600) but is not yet seeded as a fully-fledged faction. Fence-venue spec, territory mechanics, and Syndicate-only inventory all pending — see ../economy/black-market.md#syndicate-fence-venues for the venue spec.

Pirates¶

Type: Hostile NPC Theme: Predation FactionType code: PIRATES Aggression: 10 / 10 Diplomacy: hostile (cannot be friendly)

Ideology¶

Anarchic raiders. Not a faction in the standing sense — Pirates exist as antagonists. Players cannot accumulate positive reputation with Pirates; the lower bound for Pirates reputation is the same as elsewhere but the upper bound is effectively zero.

Territory¶

Concentrated in pirate-controlled sectors near the fringe. Pirates also spawn opportunistically in low-traffic warp lanes.

Allies / Rivals¶

Relationship	Faction	Note
Hostile	All allyable factions	Universally hated
Cordial-ish	Fringe Alliance	Some shared bases, but separate command

Gameplay implications¶

Killing Pirates: +reputation with most allyable factions, +personal reputation.
Pirate sectors can only be entered if the player's Pirates reputation is ≥ −200 (less hostile means less likely to be attacked on entry). High-reputation players are violently engaged immediately.
Pirate NPCs spawn dynamically as encounters and as fleet-battle adversaries.

Spawn, encounter, and drop mechanics¶

📐 Design-only — numbers are launch balance targets.

Spawn

5–15% spawn probability per sector entry in Frontier-zone and uncontrolled-territory sectors. The spawn weight scales inversely with the dominant faction's SectorFactionInfluence.
Federation-controlled and high-influence Mercantile-route sectors are skipped.
Pirates favor ambush points adjacent to known trade routes (as inferred from recent MarketTransaction density).

Encounter behavior

Cargo scan on engagement; Pirates prioritize high-value commodities and heavy holds.
Flee if the defender's combat rating exceeds the Pirate's by ≥ 2×.
Tribute branch: with some probability the Pirate demands tribute (50% of cargo value in credits) instead of opening fire. Player choice is fight / pay / flee:
Pay: lose the credit equivalent; no reputation change; safe passage.
Fight: combat resolves normally; victory grants the drop table below; defeat costs the ship plus a Federation-reputation penalty (see below).
Flee: success rate is a function of relative ship speed; failure transitions to combat.

Reputation effects of pirate interactions

Killing a Pirate: +5 Terran Federation reputation, −5 Fringe Alliance reputation, +personal_reputation tick.
Paying tribute: no reputation change.
Being destroyed by Pirates: −10 Terran Federation reputation (failed-to-defend signal).

Drop table (on Pirate destruction)

Drop	Quantity / probability
Credits	500 – 5,000
Stolen commodities	1–3 commodity slots from the Pirate's prior raids
Quantum shards	10% drop chance
Pirate intel data	100% drop, sells to Federation contact for credits + Federation reputation

These numbers are tuned at launch and live alongside the procedural pirate spawner; ship-class loadouts (which Pirate hulls roll which drop weights) are out of scope here.

The Cabal¶

Status: 📐 Design-only — not yet seeded as a Faction row; encounter scripts and HQ-sector population are launch-target work.

Type: Hostile NPC (endgame antagonist) Theme: Conspiracy, occult tech, hierarchical malice FactionType code: CABAL (🐛 reserved enum value) Aggression: 10 / 10 Diplomacy: hostile (cannot be friendly)

Ideology¶

A clandestine power broker — neither anarchic like Pirates nor ideological like the allyable factions. The Cabal pursues forbidden technology, manipulates markets and politics from behind front companies, and treats violence as one tool among many. Players don't accrue Cabal reputation through ordinary play; encounters scale into endgame challenges culminating at the HQ.

Territory¶

Single fixed Cabal Headquarters in Terran Space, randomly placed at universe creation in a sector between 101 and 200 (Border Zone — per the canonical zone boundaries in ../galaxy/generation.md). The HQ sector is generated as a defended station hub with high-tier NPC ships, restricted access, and unique loot tables. The Cabal does not hold territory across player regions — it is a Terran-Space singleton, not a per-region presence.

Allies / Rivals¶

Relationship	Faction	Note
Hostile	All allyable factions	Universally targeted by the Federation Bounty Board
Hostile	Pirates	The Cabal disdains pirate disorder; not allies of convenience

Gameplay implications¶

HQ raid is an endgame objective — heavy ship + Genesis-capable fleet recommended; clearing the HQ rewards rare tech and prestige cosmetics (📐 Design-only).
Cabal encounters seed sparsely in Border-zone Terran sectors (rare random spawns; not Frontier-zone like Pirates).
Reputation is unidirectional: killing Cabal NPCs grants standing with Federation / Nova Scientific Institute, but Cabal reputation cannot rise above zero.
The Cabal does not run a regular Federation-zone economy; their "ports" exist as raid objectives, not trade venues.

Open questions (📐 Design-only)¶

Cabal-specific ship taxonomy (custom hull variants? recolored standard hulls?)
HQ defense composition (drone tier, station HP, NPC fleet size)
Whether the HQ is destructible, or simply respawns after a long cooldown
Whether the HQ placement is per-universe singleton or also placed in any newly-attached player region's Border Zone

These resolve closer to launch when endgame content takes shape.

Faction matrix at a glance¶

                  TF   FC   AM   NS   MG   FA   PI
  TF (Federation) --   ~    o    o    o    R    H
  FC (Frontier)   ~    --   R    o    o    o    H
  AM (Astral)     o    R    --   R    +    o    H
  NS (Nova)       +    o    R    --   o    o    H
  MG (Mercantile) o    o    +    o    --   o    H
  FA (Fringe)     R    o    o    o    o    --   ~
  PI (Pirates)    H    H    H    H    H    ~    --

  + cordial    o neutral    ~ cool    R rival   H hostile

R-pairs enforce combined-reputation caps (FACTION_RIVALRIES in services/faction_service.py).

Source map¶

Concern	Path (target)
Faction model + types	`services/gameserver/src/models/faction.py` (`Faction`, `FactionType`)
Reputation model	`services/gameserver/src/models/reputation.py`
Faction service (rivalry, decay, trade modifier)	`services/gameserver/src/services/faction_service.py`
Seed data	`services/gameserver/src/scripts/seed_factions.py` (target)
Emergent action wrapper	`services/gameserver/src/services/faction_service.py` (`apply_emergent_action`, target)

factions-and-teams.md — reputation system, tier table, rivalry caps, full emergent trigger canon.
bounties.md — Federation Bounty Board mechanics.
SYSTEMS/bounty-and-reputation.md — personal reputation that overlays the per-faction system.

Faction Lore¶

Terran Federation¶

Ideology¶

Territory¶

Allies / Rivals¶

Gameplay implications¶

Honored / Exalted perks¶

Mercantile Guild¶

Ideology¶

Territory¶

Allies / Rivals¶

Gameplay implications¶

Honored / Exalted perks¶

Frontier Coalition¶

Ideology¶

Territory¶

Allies / Rivals¶

Gameplay implications¶

Honored / Exalted perks¶

Astral Mining Consortium¶

Ideology¶

Territory¶

Allies / Rivals¶

Gameplay implications¶

Honored / Exalted perks¶

Nova Scientific Institute¶

Ideology¶

Territory¶

Allies / Rivals¶

Gameplay implications¶

Honored / Exalted perks¶

Fringe Alliance¶

Ideology¶

Territory¶

Allies / Rivals¶

Gameplay implications¶

Honored / Exalted perks¶

Shadow Syndicate¶

Ideology¶

Territory¶

Allies / Rivals¶

Gameplay implications¶

Pirates¶

Ideology¶

Territory¶

Allies / Rivals¶

Gameplay implications¶

Spawn, encounter, and drop mechanics¶

The Cabal¶

Ideology¶

Territory¶

Allies / Rivals¶

Gameplay implications¶

Open questions (📐 Design-only)¶

Faction matrix at a glance¶

Source map¶

Related¶