Game Data API Documentation
The Game Data API provides public access to static game configuration data for Galactic Tycoons. This endpoint returns a comprehensive JSON file containing all materials, recipes, buildings, and other game data.
Endpoint
GET https://api.g2.galactictycoons.com/gamedata.json
Response Structure
The JSON file contains the following root-level properties:
{
"materials": [...],
"recipes": [...],
"buildings": [...],
"workers": [...],
"systems": [...],
"baseBuildingCost": [...],
"shipEmitters": [...],
"shipReactors": [...],
"achievements": [...],
"medalTypes": [...],
"buildProjects": [...],
"galaxyConfig": {...}
}
Data Structure
materials
Array of all material types available in the game.
Fields:
- id - Unique material identifier
- sName - Short display name
- name
- description
- type - Material category enum
- weight - Weight per unit in tonnes
- source - 1=extraction, 2=crafting/farming
- reqTech - Required technology level to produce (0=none)
- tier
- cp - Calculated base price in cents
recipes
Array of all crafting recipes.
Fields:
- id
- producedIn - Building type ID where this recipe can be crafted
- type - Recipe category enum (1=Extraction, 2=Production, 3=Farming)
- reqTech - Technology level required to produce
- timeMinutes - Production time in minutes
- inputs - Array of required input materials:
- id - Material ID
- am - Amount required
- output - Resulting material:
- id - Material ID produced
- am - Amount produced
buildings
Array of all buildings in the game.
Fields:
- id
- name
- description
- cost - Unused
- constructionMaterials - Array of materials required to build
- workersNeeded - Worker requirements by type [Worker, Technician, Engineer, Scientist]
- workersHousing - Housing capacity by type
- specialization - Building specialization
- tier
- requiredResearch - Unused
- recipesIds - Array of recipe IDs this building can produce
workers
Array of worker types.
Fields:
- type - 1=Worker, 2=Technician, 3=Engineer, 4=Scientist
- adminCost - Administration overhead (Expansion Burden) per 100 workers
- consumables - Array of daily consumable requirements:
- matId - Material ID consumed
- amount - Daily consumption per 1,000 workers
- essential
systems
Array of star systems.
Fields:
- id
- name - System name
- x, y - Galaxy map coordinates
- v - Visual variation identifier
- planets - Array of planets (null for empty systems):
- id - Planet ID
- sId - Parent system ID
- name - Planet name
- type - Planet classification enum (visual only)
- mats - Available materials with abundance:
- id - Material ID
- ab - Abundance rating (affects extraction speed: 50=half speed, 200=double)
- fert - Fertility (100 is standard, 0=no farming)
- x, y - Coordinates
- size - Planet size (visual only)
- tier - Planet tier
baseBuildingCost
Array of materials required to establish a new base. Each entry contains material ID and amount.
shipEmitters
Array of FTL emitters for ships.
Fields:
- type - Emitter identifier
- acceleration - ly/h² at full power
- maxSpeed - ly/h
- fieldCapacity - Warp field capacity for cargo
- weight - Component weight
- energyDraw - Power consumption requirements
- cost - Construction material ID
shipReactors
Array of reactor types ships.
Fields:
- type - Reactor identifier
- name - Reactor name
- weight - Reactor weight
- energy - Power output
- fuelConsumption - Fuel usage per hour
- fuelCapacity - Base Fuel Capacity
- fuelTanksUsed - Fuel tanks cost per one reactor
- fuelId - Fuel material ID
- cost - Construction material ID
achievements
Array of achievement definitions with progression milestones.
Fields:
- type
- otherId
- name
- description
- milestones - Array of progression thresholds:
- milestone - Target value to reach
- rewardAmount - Reward quantity
- pr - Prestige points earned
- rewardType - Reward category enum (1=stars, 2=Cash, 3=Material)
medalTypes
Array of competitive ranking medals for leaderboards.
Fields:
- eventType
- otherId
- period
- pe - Array of prestige rewards by rank (unscaled)
buildProjects
Array of large-scale construction projects for communities.
Fields:
- id
- name
- description
- ownerType - (4=Guild)
- cost - Array of costs for level ranges:
- from - From level
- to - To level
- cost - Material required for this level range ({id, am})
- cons - Array of consumables for level ranges; same format as cost
- maxLevel - Maximum level
- buff - Bonus effect per level
- pr - (not used)
Notes
- All prices are in cents (divide by 100 for actual currency values)
- The file is regenerated when the games server restarts
- Data may vary between different game servers