Empyrean Challenge — Entities

Extracted from baseline.adoc and extended by project-defined rules. Each entity lists its key fields, constraints, and relationships.

Game

A Game is the top-level game instance. It contains exactly one Cluster. It is also associated with Empire entities. This describes the domain relationship only and does not fix the in-memory ownership or storage layout.

Empire

An Empire is the in-game faction that participates in a game. Empire IDs are assigned in creation order. Exactly one Empire is created for each player input record. The Empire name is taken from the corresponding player record. Each Empire is assigned a home world when it is created. An Empire belongs to a Game, not to the Cluster as a physical-world entity. An Empire may exist without a Player. If a Player quits, the Empire remains in the game and simply has no associated Player.

Player

Player is an out-of-game/controller entity rather than the in-game faction itself. Player-to-Empire assignment is optional and one-to-one when present. A Player controls at most one Empire. An Empire has at most one Player.

Race

Race is determined by origin. All Empires assigned to the same home world belong to the same Race.

Cluster

A single cluster exists per game (one game per database).

prng.IntN(n) produces [0, n-1]. To generate a coordinate in [0, 30] use prng.IntN(31) (i.e. IntN(clusterAxisSize) where clusterAxisSize = 31). The Cluster is the physical world of stars, systems, and planets within a Game.

Star

In orders, XX-YY-ZZ/A is accepted as an alias for a single-star system but reports never emit the /A suffix for single-star systems.

System

Systems are formed after all stars are placed in the cluster (per § 5). System IDs are assigned 1 to N in the order systems are first encountered iterating stars 1–100. A system’s coordinates equal those of its member stars (all members share the same point). Stars in the same system occupy each other’s orbit 11. A system with 2 stars is binary; 3 stars, trinary. Interstellar jumps within a binary/trinary system are treated as 0.2 light years.

Orbit

An orbit is a numbered slot within a star system. It is not itself a planet. Planet rules that depend on orbit use the orbit number of the slot the planet occupies.

Planet

A planet is the occupant of an orbit, not the orbit itself. If an orbit is empty, there is no planet for that orbit. Planet attributes such as habitability, deposits, colonies, and derived limits belong to the planet.

Type notes:

• Gas Giant — surface colonies on moons only; habitability from 1 to 20
• Terrestrial — spherical; not necessarily earth-like; habitability from 0 to 25
• Asteroid — represents an entire belt; habitability always 0

Habitability effects:

• Max open farms on surface = habitability × 100,000
• Max population without increased rebellion risk = habitability × 10,000,000
• Applies to open colonies only
• A terrestrial planet is habitable when habitability > 0

Home world rules:

• An eligible home world must be a terrestrial planet in orbit 3, 4, or 5
• A designated home world may host up to 25 Empires
• Multiple home worlds may exist in the same system
• Home world eligibility is determined per planet, not per system

Planet assignment algorithm (per star, orbits 1–10):

// Step 1 — Random assignment
for n := 1 to 10:
    r := rnd(1, 100)            // uniform integer, inclusive
    if   r <= 29: planetType[n] = TERRESTRIAL
    elif r <= 34: planetType[n] = ASTEROID
    elif r <= 41: planetType[n] = GAS_GIANT
    else:         planetType[n] = EMPTY

// Step 2 — Cap gas giants at 3; demote excess to ASTEROID, innermost first
for n := 1 to 10:
    if count(planetType[1..10], GAS_GIANT) <= 3: break
    if planetType[n] == GAS_GIANT: planetType[n] = ASTEROID

// Step 3 — Cap asteroids at 2; demote excess to TERRESTRIAL, innermost first
for n := 1 to 10:
    if count(planetType[1..10], ASTEROID) <= 2: break
    if planetType[n] == ASTEROID: planetType[n] = TERRESTRIAL

// Step 4 — Sort non-empty orbits by type (TERRESTRIAL < ASTEROID < GAS_GIANT),
//           preserving which orbit indices are occupied. Empty orbits do not move.
occupied := [n for n in 1..10 where planetType[n] != EMPTY]  // ascending
types    := sort([planetType[n] for n in occupied])          // ascending by type value
for i := 0 to len(occupied)-1:
    planetType[occupied[i]] = types[i]

// Step 5 — Create planets in the occupied orbit slots.
for n := 1 to 10:
    if planetType[n] == EMPTY: continue
    planet[n] = Planet{
        Orbit: n,
        Type:  planetType[n],
    }

Deposit

Natural resource deposit located on a planet surface (terrestrial), asteroid, or gas giant moon.

Mines may only be assigned to a deposit by a surface colony.

Quantity by type:

• Asteroid Gold: 100,000–5,000,000 units
• Terrestrial Gold: 100,000–1,000,000 units
• Fuel: 1,000,000–99,000,000 units
• Metallics: 1,000,000–99,000,000 units
• Non-metallics: 1,000,000–99,000,000 units

Per-planet caps:

• Terrestrial: max 1 Gold deposit
• Terrestrial: max 5 Fuel deposits
• Gas Giant: max 2 Fuel deposits

Cap resolution:

• If Gold is selected after the Gold cap is reached, convert the deposit to Fuel.
• If Fuel is selected after the Fuel cap is reached, convert the deposit by rolling 1d2: 1 = Metallics, 2 = Non-metallics.

Yield by planet type:

• Asteroid Gold: 1d3
• Asteroid Fuel: 3d6 - 2
• Asteroid Metallics: 3d10 - 2
• Asteroid Non-metallics: 3d10 - 2
• Gas Giant Fuel: 10d4 - 2
• Gas Giant Metallics: 10d6
• Gas Giant Non-metallics: 10d6
• Terrestrial Gold: 1d3, or 3d4 - 3 if habitability > 0
• Terrestrial Fuel: 10d4 - 2, or 10d6 if habitability > 0
• Terrestrial Metallics: 10d6, or 10d8 if habitability > 0
• Terrestrial Non-metallics: 10d6, or 10d8 if habitability > 0

Resource

Natural resource units each have a mass of 1 mass unit.

Colony

Up to one colony of each type per player per planet.

Units in storage count as ½ their mass toward structural limits. Structural mass of the colony/ship itself is not counted.

Trade Station — a special orbiting colony with trade as its only function. Minimum: 3,000 structural units + 500 life support units + 100 professional units. Charges a 1% commission (paid by seller) on completed trades.

Home Planet Market — one per race’s home planet; same rules as a trade station, but independent of player control.

Ship

Population

All population units represent 100 people. All units have a death rate of 0.0625% per turn (non-combat).

Starvation rule (when ration < 1/16 food unit per pop unit per turn):

S = (M - R) / M
// M = 1/16 (minimum food per pop unit without starvation)
// R = rationed amount (< M)
// S = fraction of colony population that starves

Farm

• TL 1: open-colony farm (surface only)
• TL 2–5: hydroponic; surface colonies in orbits 1–5, or orbiting colonies
• TL 6–10: hydroponic with artificial sunlight; ships or colonies beyond orbit 5

Mine

Mines are organized into mine groups; each group mines one deposit.

Factory

Factories are organized into factory groups; each group manufactures one unit type. Manufacturing cycle: 1 year (4 turns). Resources consumed in turn 1; units delivered after turn 4.

Factory group labor (unskilled workers and professionals per factory unit):

Unskilled workers may be replaced by automation units.

Manufacturing costs (metallics + non-metallics per unit):

Research: A factory group ordered to do research produces 1 research point per factory unit × TL per year.

Research points required for TL advancement:

Weapons Units

Assault Weapon

Assault Craft

Military Robot

Missile

Missile Launcher

Anti-missile

Energy Weapon

Energy Shield

Military Supplies

Propulsion Units

Hyper Engine

Space Drive

Support Units

Sensor

Transport

Life Support

Structural Unit

Light Structural Unit

Automation

Consumer Goods and Food

Consumer Goods

Food

Spy Unit

Composed unit: 1 soldier + 1 professional. One function per unit per turn; continues until re-ordered.

Turn

Turn 0 is the setup turn and displays as 0.0.

For report display, turns after setup map to year and quarter as follows:

• Turn 1 = 1.1
• Turn 2 = 1.2
• Turn 3 = 1.3
• Turn 4 = 1.4
• Turn 5 = 2.1

The mapping is:

• For turn 0, display 0.0
• For turn n > 0, display ( ((n - 1) / 4) + 1 ).( ((n - 1) % 4) + 1 )

Empire Assignment

Empire creation before game start uses a current home world. The first current home world is chosen at random from all eligible planets. New Empires are assigned to that home world until it reaches capacity. When a new home world is needed and none is available, Empire creation returns an error and setup terminates. Given the same seed and the same player input, Empire creation must produce the same results.

Turn Sequence

Executed in this order each turn:

1. Mining and farming production
2. Manufacturing production
3. Combat
4. Set up orders
5. Dis-assembly orders
6. Build change orders
7. Mining change orders
8. Transfers
9. Assembly orders
10. Market and trade station activity
11. Surveys
12. Probe and sensor reports
13. Espionage
14. Ship movement
15. Draft orders
16. Pay and ration orders
17. Rebellion
18. Rebel increases
19. Naming and control orders
20. Population increases
21. News service reports

General Rules

• Mass unit = 17,000 lbs (≈ 100 people)
• All fractions truncated (no rounding)
• 1 turn = 1 quarter of a galactic standard year
• Operational units must be assembled to function and dis-assembled for transfer. Dis-assembly causes a 10% loss (except spy and construction units). Units requiring assembly: space drives, sensors, automation, life support, energy weapons, energy shields, mines, factories, farms, hyper engines, structural units, light structural units, missile launchers.
• Victory: control ≥ 100 planets with no other player controlling ≥ 50 planets, for 4 consecutive turns.