§6 — Economy

Rules

• 2% transaction fee on all sales
• Max 10 active listings per player
• Listing durations: 24h / 48h / 72h
• Expired listings — item returned to seller
• Both items and resources can be listed

Socket Handlers

• list_item, list_resource
• buy_listing
• cancel_listing
• get_market — filter by item/category
• get_my_listings

Market Tick

Server runs expiry check every 15 minutes. Expired listings are removed and items returned to seller inventory.

Price History

30-day rolling OHLC data stored in MarketPriceHistory MongoDB collection. SVG sparkline popup per listing row — median, high, low stats. Offline seller credit delivery on buy. Wired in v3.2/v3.3.

Categories

• Ships — 6 blueprints with credit prices
• Weapons — assault rifles, pistols, snipers, etc.
• Armours — body, helmet, boots, backpack
• Cosmetics — wallpapers, room unlocks for starbase
• Consumables — health packs, XP boosters
• Materials — raw crafting ingredients

Cosmetics (Starbase)

Wallpapers and room unlocks are purchasable from the shop and earnable from dungeon loot. Applied instantly to the isometric Starbase World canvas.

Gem Earning

• Daily login streak — day 3: 1💎, day 7: 3💎, day 14: 5💎, day 30: 10💎
• Dungeon completion — difficulty-scaled gem drops
• Galaxy event and quest rewards

Gem Spending (9 items)

• Utility — +5 inventory slots, +1 craft queue slot, +1 fleet slot
• Cosmetics — gold nameplate, neon nameplate, blue ship trail, fire ship trail
• Boosts — 24h XP +50%, 24h resource +25%
• Instant — 3💎 speed-up any craft queue job

Season Structure

• 90-day seasons with theme and bonus modifiers
• Season 1: "Dawn of the Void" — Jan 1 – Apr 1 2026
• +25% dark matter production
• +50% Void Cult reputation gain

Score Tracking

Season score = weighted sum of level, credits, fleet mission count, and dungeon clears. Top 50 on season leaderboard.

Implementation

• SeasonSystem.js — getCurrentSeason(), getSeasonScore()
• Dashboard banner shows season name + time remaining
• get_season emitted 1 second after auth
• get_season_leaderboard — top 50 by score

Event Types (4)

• 🛸 Alien Invasion — 24h, bonus XP from combat
• 🌀 Void Surge — 12h, dark matter multiplier
• 🤖 Rogue AI Boss — 48h, rare tech drops
• 🏳️ Sector Domination — 720h (30 days), persistent control

Dashboard Banner

Active events shown on dashboard with icon, name, description, ETA countdown, and participant count.

Implementation

• GalaxyEventSystem.js — event rotation, ETA
• get_galaxy_event + claim_event_reward handlers
• Client dashboard banner — icon, name, timer
• Multipliers applied during active event window

Credit Sources

• Dungeon loot (difficulty-scaled)
• Quest completion rewards
• Fleet mission returns
• Player market sales (minus 2% fee)
• Offline idle income
• PvP win reward
• Galaxy Events

Credit Sinks

• Building construction + upgrades
• Ship construction + repair
• NPC shop purchases
• Research start cost
• Market listing fee (2%)
• Gifts to friends (capped 5,000/day)

Gem Sinks

• Gem Store purchases (cosmetics, utility, boosts)
• 3💎 craft queue speed-up
• Expanded inventory / fleet / queue slots