Skip to content

Universe

Universe is the root container of the X4 galaxy. There is one universe per save β€” referenced as player.galaxy from MD/aiscript.

Universe (player.galaxy)
└── Cluster (cluster.*)
└── Sector (cluster.*.sector*)
└── Zone (sector.*.zone*)
└── Component (ships, stations, items, etc.)
<find_sector name="$X" space="player.galaxy" macro="..."/>
<find_object name="$Y" space="player.galaxy" macro="..."/>

Most arcs check the universe macro for main-galaxy filtering:

<check_value value="player.galaxy.macro == macro.xu_ep2_universe_macro"/>

The macro.xu_ep2_universe_macro is the main galaxy (Pirate DLC). Scenario games (Timelines) use different universe macros.

  • Cluster β€” top-level subdivision
  • Galaxy β€” same as universe in most contexts
  • Sector β€” main location unit

Stub page β€” full universe reference coming.