Skip to content

⚠️ WORK IN PROGRESS

This wiki is under active development. Information may be incomplete or inaccurate.

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:

json
{
  "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