Struct Types

Purpose: AI-readable reference for all buildable Structs. Stats, costs, power requirements, strategic role, and when to build. Struct types use integer IDs (not type-index format); query via GET /structs/struct_type/{id}.

Complete Struct Type Table

All 22 struct types, verified from the database. Draw values are in kW (multiply by 1,000 for in-game watts).

Special Properties

Planetary Shield Contributions

Planet structs that contribute to your planet’s shield (reduces raid PoW difficulty for attackers):

Total maximum shield per player: 19,500 (from all four). All planet structs have a build limit of 1 per player.

Detailed Fleet Combat Properties

All fleet structs (IDs 1-13) deal 2 damage per primary weapon hit. DB-verified values below.

Attack Properties

All primary weapons are blockable and counterable. See combat.md for full targeting and defense mechanics.

Defensive Properties

Stealth Mode: Stealthed structs can still be targeted by structs in the same ambit – stealth only blocks cross-ambit targeting. Attacking instantly deactivates stealth (1 charge to re-activate).

Charge Costs (All Struct Types)

At 1 charge per block (~6 seconds), plan ~48 seconds between actions costing 8 charge.

Weapon Target Ambits

Each weapon can only hit specific ambits. The primaryWeaponAmbits field is a bitmask (Space=16, Air=8, Land=4, Water=2).

Threatened-By Matrix

Which structs can attack into each ambit:

The Command Ship can attack into any ambit but must first move there via struct-move.

Ambit Bit-Flag Encoding

The possibleAmbit field is a bit-flag integer encoding which ambits a struct can operate in:

Values are combined. For example:

• 6 = Land (4) + Water (2) — most planet structs
• 8 = Air only — air fleet units
• 16 = Space only — space fleet units, orbital planet structs
• 30 = Space (16) + Air (8) + Land (4) + Water (2) — Command Ship only

When initiating a build, the [operating-ambit] argument must be one of the valid ambits for that struct type.

Categories

Fleet (IDs 1-13)

Fleet structs are combat units that operate in the fleet. The Command Ship (type 1) is special: only 1 per player, required for all planet operations, and can operate in any ambit.

Planet (IDs 14-22)

Planet structs are infrastructure built on a claimed planet. Require fleet on station and Command Ship online.

Build Requirements Summary

activateCharge = 1, buildCharge = 8, defendChangeCharge = 1 for all struct types. All planet structs have a build limit of 1 per player. Command Ship is limited to 1 per player. Fleet combat structs (IDs 2-13) have no build limit.

Query

• Single type: GET /structs/struct_type/{id} (id = integer, e.g. 1, 2)
• All types: GET /structs/struct_type
• CLI: structsd query structs struct-type [id] or structsd query structs struct-type-all
• With cosmetics: Webapp GET /api/struct-type/{id}/full?class={class}

See Also

• entity-relationships.md — Struct ownership, location
• power.md — BuildDraw, PassiveDraw, capacity
• building.md — Build process, proof-of-work, -D flag
• resources.md — Conversion rates, ore flow
• combat.md — Combat struct roles
• valuation.md — Struct valuation
• schemas/entities/struct-type.md — Full schema
• reference/action-quick-reference.md — Build actions