Alliances
No solo empire can be everywhere at once. Alliances are how you coordinate with others - shared intelligence, a collective treasury, coordinated strikes, and weekly objectives that reward everyone who contributed. An active alliance turns five separate empires into something that moves as one. Each alliance has a unique name and a short tag (3–5 characters) displayed alongside member names.
Creating and Joining
Any player can found an alliance by choosing a name and tag. The founding player automatically holds the Founder role. New members join by accepting an invitation sent by a Founder or Officer.
Invitations expire after a fixed window. A player can hold at most one pending invitation per alliance at any time.
Roles
Alliances have three roles with different permissions:
| Role | Permissions |
|---|---|
| Founder | All permissions; cannot be removed |
| Officer | Send invites, manage members |
| Member | Participate in objectives; access alliance chat |
Alliance Treasury
The alliance holds a shared treasury of Metal, Crystal, and Deuterium. Treasury funds are drawn upon to pay out rewards when weekly objectives are completed.
Auto-Tithe
Founders can configure an optional tithe rate on the alliance. When enabled, a percentage of each member's resource income is periodically contributed to the treasury automatically. The titheRate field (a decimal, e.g. 0.05 for 5%) and titheLastApplied timestamp are stored on the Alliance record.
Alliance Chat
All alliance members share a persistent chat channel. Messages are stored and displayed in chronological order, capped at the 200 most recent entries per session. Each message records the sender's name and a timestamp.
Weekly Objectives
Each week, alliances receive one or more Alliance Objectives - shared goals that all members contribute toward collectively. Progress is tracked against a target value, and completing an objective pays out resources to all contributing members.
Objective Types
| Type | Goal |
|---|---|
| Construction Drive | Complete building upgrades |
| Fleet Expansion | Build ships across alliance planets |
| Knowledge Surge | Complete research technologies |
| Fleet Mobilization | Launch fleets on any mission |
| Resource Campaign | Gather resources from construction and research |
| Full Mobilization | Have all members take at least one action |
| Market Masters | Complete trade offers within the alliance |
| Grand Construction | Complete a large number of building upgrades |
| Armada Assembly | Build a massive fleet across the alliance |
| Scientific Breakthrough | Achieve major research milestones |
Objectives reset weekly. Progress from previous weeks does not carry over.
Objective Rewards
Completing an objective distributes resources to all players who contributed at least one unit of progress:
- Smaller objectives award roughly 30,000–90,000 resources split across Metal, Crystal, and Deuterium.
- Harder objectives (larger target ranges) award 120,000–350,000 resources.
Fog of War
The galaxy map uses a fog-of-war system. Systems fall into three visibility states:
| State | Appearance | Information shown |
|---|---|---|
| Visible | Fully lit | Real-time planet ownership, fleet movements, resource activity |
| Discovered | Dimmed | System geometry and name; planet owners hidden |
| Unknown | Dark / blip | Position only - no details |
A system becomes visible when one of your fleets or planets is within sensor range. Sensor range is extended by Scanner Range research (Astrophysics branch) - each level adds a +0.15 flat range bonus. Once discovered a system stays in your discoveredSystems list permanently; it will dim but never disappear from the map.
The server computes visibility on every state load and persists newly discovered systems back to your player record automatically.
Alliance Shared Vision
Members of the same alliance share fog-of-war vision over each other's planets. Allied planet IDs are synchronized to the store so members can see each other's planetary positions on the galaxy map without needing to scan individually. Sending an Expedition fleet to an unknown region can also reveal nearby systems via the Navigation expedition outcome.
Coordinated Attacks
Alliances can launch coordinated attacks where multiple members send fleets to the same target with a shared arrival window. A coordinated attack is created by a leader and other members attach their fleets to the same coordinationId. All fleets in the group are expected to arrive within the specified window.