§5 — Social Systems
Friends, alliances, alliance research, alliance chat, alliance wars, reputation, combat log, leaderboard, and gifts.
Friends System (GDD §17.2)
Features
- Send / accept / decline friend requests
- Remove friends
- Online presence indicator
- Friend list in Social tab
- Gift credits to friends (max 5,000/day per sender)
Socket Handlers
add_friend— by usernameaccept_friend,remove_friendget_friends— list with online statussend_gift— credit transfer, daily cap enforced
Alliance System (GDD §12)
Core Features
- Create alliance (name, tag, description)
- Search alliances by name/tag
- Join / leave alliances
- Alliance warehouse — deposit / withdraw resources
- Alliance tag displayed on leaderboard
Alliance Research
3-tier tech tree with 8 technologies. Costs paid from alliance warehouse resources. 1-hour timers. Researched techs broadcast bonuses to all alliance members. Client renders a tile-grid grouped by tier.
Alliance Chat
Private Socket.IO room per alliance. 7-day message persistence (max 200 entries, rolling). History loaded on Alliance tab open. Embedded panel in Alliance tab.
Alliance Wars
72-hour scheduled wars declared by alliance leaders/officers. 24-hour declaration phase followed by 72-hour active war. War score = fleet battles (ranked PvP) won while both players are in opposing alliances. Territory bonus for winning alliance: +10% resources, +5% XP for 7 days. AllianceWar MongoDB documents persist with full lifecycle. Client Alliance Wars tab with live scorecard.
Reputation System (GDD §15.3)
Factions (5)
- 🌐 Federation — lawful, research bonuses
- ☠️ Pirate Syndicate — raiding bonuses
- 💰 Merchant Guild — market fee discounts
- 🤖 Rogue AI — tech / crafting bonuses
- 🌀 Void Cult — dark matter bonuses
Standing Scale
Range: -2000 to +2000
- Exalted (+1500), Honored (+750), Friendly (+250)
- Neutral (0), Unfriendly (-250), Hostile (-750), Hated (-1500)
Sources
Faction missions award rep. Dungeons, quests, and events also modify standing.
NPC Faction Missions (GDD §15.1)
8 missions across 5 factions. Each requires fleet ships, returns credits + XP + faction reputation.
| Mission ID | Faction | Difficulty | Rewards |
|---|---|---|---|
| fed_patrol_alpha | Federation | Easy | Credits + Fed rep |
| fed_escort_convoy | Federation | Medium | Credits + Fed rep |
| fed_hunt_pirate | Federation | Hard | Credits – Pirate rep |
| mg_trade_run | Merchant Guild | Easy | Credits + Guild rep |
| mg_rare_cargo | Merchant Guild | Medium | Materials + Guild rep |
| pir_raid_outpost | Pirate Syndicate | Hard | Loot + Pirate rep – Fed rep |
| rog_ai_recon | Rogue AI | Medium | Tech items + AI rep |
| void_offering | Void Cult | Hard | Dark Matter + Void rep |
Leaderboard (GDD §17.3)
Categories
- Level — top players by XP level
- Credits — richest players
- Kills — PvE + PvP kills
- Dungeons — dungeons cleared
- Quests — quests completed
Season Leaderboard
Separate seasonal board updated per season. Score formula weights level + credits + mission count. Top 50 shown with rank.
Refresh
Leaderboard fetched on tab open. get_leaderboard supports category param.
Chat & Social Feed
Real-time global chat relayed to all players in the same server room via chatMessage. Combat log shows last 50 PvE/PvP results.