Faction Lore¶
The seven factions of Sectorwars 2102. 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 behavior and missions (see factions-and-teams.md).
The canonical list (codified in models/faction.py:FactionType and the seed data) is six allyable factions plus Pirates:
- Terran Federation
- Mercantile Guild
- Frontier Coalition
- Astral Mining Consortium
- Nova Scientific Institute
- Fringe Alliance
- Pirates (hostile-only — cannot be allied with)
✅ Shipped — Faction model, six factions seeded plus Pirates, reputation per faction, trade-modifier table, territory access checks.
🚧 Partial — full mission generators per faction (cargo / combat / exploration / diplomatic templates exist but lore-tuned variants are sparse).
📐 Design-only — dynamic patrol behavior reading sector influence percentages, faction-specific ship skins, faction-issued bounties.
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 Sol — 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 missions are abundant — patrol runs, pirate hunts, escort duty.
- High-reputation perks: 15% station discount at Federation ports, fast-track customs (no inspection delay).
- Low-reputation penalties: 30% markup, denied station access, automatic patrol response in Federation sectors.
- High
personal_reputationplayers (Heroic / Legendary) gain a +5 reputation bonus with the Federation per legitimate trade.
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 (planned faction) | 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¶
- Cargo delivery missions — bread and butter. High volume, moderate reward.
- Trade specialties: bonus pricing on bulk commodities (ore, organics, equipment).
- High reputation: bulk-discount tier — buy and sell in volume at improved rates.
- Mercantile reputation grows naturally from trading; combat actions have minimal effect.
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 missions — survey, prospecting, mapping warp tunnels.
- Combat missions — bounty hunts on pirates harassing Frontier territory.
- High reputation: access to Frontier-only ports with low-cost outfitting.
- Low reputation: denied refueling at Frontier outposts, hostile patrols.
Astral Mining Consortium¶
Type: Resource Corp
Theme: Monopolistic mining
FactionType code: (commonly grouped under MERCHANTS for trade-modifier purposes; lore subtype is Mining)
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¶
- Cargo delivery missions for refined metals.
- Combat missions — protect Astral mining ops from "claim jumpers."
- High reputation: buy raw resources at favored rates.
- Trade specialties: raw ore, rare metals, refined fuel.
Nova Scientific Institute¶
Type: Research Org
Theme: Quantum / exotic-tech focus
FactionType code: (commonly grouped under EXPLORERS; lore subtype is Research)
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 (the foundations of ARIA's market intelligence — see aria-companion.md), 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 missions — scan unusual phenomena, map warp tunnels, recover xeno-artifacts.
- High reputation: access to experimental ship upgrades and prototype tech.
- Trade specialties: high-tech components, exotic matter, research data.
Fringe Alliance¶
Type: Outlaw Coalition Theme: Black market, smuggling FactionType code: shares enum slot with general "outlaw" — lore-named Fringe Alliance. 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 missions — carry contraband while avoiding Federation patrols. 📐 Design-only.
- Combat missions — hit Federation patrols or rival Pirate gangs.
- High reputation: Fringe-only ports sell illegal goods (advanced weapons, hacking tools, etc.).
- Trade specialties: contraband, stolen tech, illegal upgrades.
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.
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) |
| Faction-issued missions | services/gameserver/src/models/faction.py (FactionMission) |
Related¶
factions-and-teams.md— reputation system, tier table, rivalry caps.missions.md— faction-issued missions.bounties.md— Federation Bounty Board mechanics.SYSTEMS/bounty-and-reputation.md— personal reputation that overlays the per-faction system.