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 (price of material calculated by internal algorithm, the actual market price may vary)

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 enum (Construction = 1, Manufacturing = 2, Agriculture = 3, ResourceExtraction = 4, Metallurgy = 5, Chemistry = 6, Electronics = 7, FoodProduction = 8, Science = 10)
• 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