Skip to content

Items & upgrades

Discoverable items are collected in space and applied through the upgrade system, all driven by a data registry — so adding a new pickup is data, not code.

  • Items — spawn pickups; collecting one applies its effect. See the items API.
  • Upgrades — apply effects to a ship, shown in a generic Upgrades GUI. upgrade_add emits an upgrade_activated signal (UPGRADE_AGENT, UPGRADE_AGENT_ID, UPGRADE). See the upgrades API.
  • Modifiers — upgrades often adjust ship data_set coefficients through modifiers (flat / additive / multiplicative).
//signal/upgrade_activated
    log(f"Upgrade collected")