§7 — Content & Data
464+ JSON files across items, recipes, quests, enemies, dungeons, skills, and missions. ContentLoader serves it all.
100%
Complete
Content Overview
238
Item Files
146
Recipe Files
35+
Quest Files (+ 2000+ datapack)
15
Skill Files
15
Enemy Templates
8
Dungeon Definitions
All content is loaded at server startup by ContentLoader.js, which walks the GameServer/data/gso/ directory tree. Systems receive the loader as a dependency and query it by ID. This means new content can be added by dropping JSON files into the right folder — no code changes needed.
Items (GameServer/data/gso/items/)
| Category | Files | Status | Notes |
|---|---|---|---|
| weapons | items/weapons | ✅ Complete | 25 files — Assault rifles, pistols, snipers, plasma, lasers — all rarities |
| armours | items/armours | ✅ Complete | 19 files — Body, helmet, boots, hands/gloves, backpack, pants — common/rare/epic (v3.4 datapack) |
| hullPlating | items/hullPlating | ✅ Complete | 18 files — Ablative, voidsteel, phase alloy, titanium — ship armour layers |
| materials | items/materials | ✅ Complete | 146 files — Raw crafting ingredients (metals, crystals, organics) |
| consumables | items/consumables | ✅ Complete | 9 files — Health packs, fuel cells, energy boosts, credit multiplier |
| ships | items/ships | ✅ Complete | 8 files — 6 playable ships + 2 NPC hulls |
| decorations | items/decorations | ⚡ Partial | 13 files — Starbase room unlocks; more cosmetics needed |
Item metadata completeness100%
All 238 files have name, type, rarity, price, categories
Shop items tagged100%
Full audit: all items with prices tagged shop (v3.9)
Loot table integration100%
ID validation; merchant rooms; boss guaranteed rare (v3.9)
Item balance pass100%
Damage/defense formula applied; prices normalised (v3.9)
Recipes (GameServer/data/gso/recipes/)
| Category | Count | Status | Notes |
|---|---|---|---|
| alloys | recipes/alloys | ✅ Complete | 18 recipes — Titanium, voidsteel, phase alloy, chronoalloy, etc. |
| armours | recipes/armours | ✅ Complete | ~12 recipes — Armour piece recipes referencing alloy inputs |
| circuits | recipes/circuits | ✅ Complete | ~15 recipes — Electronic components for ship upgrades |
| consumables | recipes/consumables | ✅ Complete | ~10 recipes — Health packs, stims, fuel cells |
| hulls | recipes/hulls | ✅ Complete | ~12 recipes — Ship hull components |
| hull_sections | recipes/hull_sections | ✅ Complete | ~8 recipes — Structural hull assembly parts |
| smelting | recipes/smelting | ✅ Complete | ~15 recipes — Raw ore → refined metal |
| organics | recipes/organics | ✅ Complete | ~8 recipes — Bio-materials processing |
| food_organics | recipes/food_organics | ✅ Complete | ~6 recipes — Crew consumables |
| weapons | recipes/weapons | ✅ Complete | ~15 recipes — Weapon crafting recipes |
| spacesuit_parts | recipes/spacesuit_parts | ✅ Complete | ~8 recipes — EVA suit components |
Recipe completeness100%
Battleship hull + advanced_circuit_board + void_capacitor + quantum_hull_plate; smelting IDs fixed (v3.9)
Quests (GameServer/data/gso/quests/)
Quest Types
- Main Story — narrative quests, high XP
- Daily — resets daily, quick goals
- Weekly — longer, higher rewards
- Monthly — major goals, rare rewards
35 built-in quest files + 4 category index files. External datapack provides 2,000+ additional quests (daily/weekly/monthly/main_story) loaded via the same ContentLoader pipeline.
Quest Objectives
Types include: craft_items, dungeon_clears, explore_sectors, login_streak, purchase_items, decorate_base, kill_enemies, fleet_missions.
Quest data files100%
35 built-in + 2000+ datapack quests; daily/weekly/monthly/main_story categories all loaded
Quest system wiring100%
complete_quest, get_quests, server tracking
Localisation (GDD §24)
Supported Languages
- 🇬🇧 English (en.json) — complete (136 keys)
- 🇩🇪 German (de.json) — complete (136 keys)
- 🇫🇷 French (fr.json) — complete (136 keys)
- 🇪🇸 Spanish (es.json) — complete (136 keys)
- 🇯🇵 Japanese (ja.json) — complete (136 keys)
- 🇨🇳 Chinese (zh.json) — complete (136 keys)
- 🇰🇷 Korean (ko.json) — complete (136 keys)
- 🇧🇷 Portuguese (pt.json) — complete (136 keys)
English locale100%
136 keys across nav, resources, dungeons, quests, crafting, alliance, market, inventory, shop, settings, a11y
Non-English locales100%
v3.4: all 7 locales fully translated (136 keys each)
GSO_i18n module100%
v3.4: fetch-based loader, t() helper, data-i18n binding, language selector in Settings
ContentLoader Architecture
All JSON content is loaded once at server boot via GameServer/systems/ContentLoader.js. Data is stored in Map instances keyed by ID for O(1) lookup.
ContentLoader ├── skills Map<id, skill> — 15 entries ├── enemies Map<id, enemy> — 15 entries ├── dungeons Map<id, dungeon> — 8 entries ├── items Map<id, item> — 238 entries ├── recipes Map<id, recipe> — 146 entries ├── quests Map<id, quest> — 35 + datapack entries └── questCategories Map<tabId, category> — 4 entries
ContentLoader100%
Walks all subdirectories; hot-reloadable in development