Skip to content
X4 Modding Wiki

World

The X4 world is organized as a tree:

Universe
└── Cluster
    └── Sector
        └── Zone

Plus traversal infrastructure: Highway and Gate.

Spatial containers

Section titled “Spatial containers”
  • Universe — root. Vanilla has one main galaxy (xu_ep2_universe_macro) plus DLC-specific universes for Timelines maps.
  • Cluster — group of sectors with shared encyclopedia info (planets, music, ambient).
  • Sector — main spatial unit. Contains objects, has economy/security values, owned by a faction.
  • Zone — sub-sector area for region-specific positioning.

Traversal infrastructure

Section titled “Traversal infrastructure”
  • Highway — fast-travel within a sector (local highway loop).
  • Gate — connects sectors.
  • Superhighway — fast-travel between sectors in the same cluster.

Common questions

Section titled “Common questions”
  • “How do I find sector economy/security value?” → Sector properties.
  • “How do I get all stations in a sector?” → Sector → .stations.
  • “How do I detect sector ownership change?” → Sector → Events → event_contained_sector_changed_true_owner.