Operations manual
Regions
Regions define named areas of space drawn across one or more sectors. They are used to overlay fill colours and borders on the starmap and can be shared with players or kept referee-only. Each region is defined by two sets of hexes: a clockwise-ordered border ring and a fill interior.
- Name
- The region's display name. Shown on the starmap if a label is configured.
- Label
- Optional text rendered on the starmap at the label position. If left blank the region is drawn without a name.
- Label Position
- The hex at which the label is anchored on the starmap, expressed as a sector name and four-digit hex coordinate (XXYY). The hex does not need to be inside the region.
- Fill Colour
- CSS colour value (hex code or named colour) used to flood-fill the interior of the region on the starmap. Use a colour with an alpha channel — e.g. rgba(100, 149, 237, 0.25) — to keep underlying hex content legible.
- Border Colour
- CSS colour value used to draw the outline of the region. The border follows the clockwise hex sequence defined in the uploaded CSV.
- Player Visible
- Controls whether the region is rendered in player mode on the starmap. Referee mode always shows all regions. Toggle directly from the region show page.
Hex Lists
A region's shape is defined by two sets of hexes: border hexes and fill hexes. The border ring is supplied via CSV upload; fill hexes are derived automatically.
- Border hexes — clockwise order
- The border is the ring of hexes that defines the outer edge of the region. They must be listed in clockwise order, and each hex must be adjacent to the next — including the last hex back to the first. The starmap traces a path along the outer edges of these hexes in sequence to draw the region outline. Providing hexes out of order or with gaps will produce a malformed border.
- Fill hexes
- Fill hexes are computed automatically from the border ring — you do not supply them in the CSV. The importer flood-fills the interior enclosed by the border and stores the result. Fill hexes determine which parsecs are considered part of the region for containment checks and are flooded with the fill colour on the starmap.
- CSV format
- The upload file lists the border hexes only, one per row, in clockwise order. The upload replaces all existing hexes for the region.
| Column | Description |
|---|---|
| sector_x | Sector X coordinate |
| sector_y | Sector Y coordinate |
| hex_x | Hex column within sector (1–32) |
| hex_y | Hex row within sector (1–40) |
Use the download icon on the region show page to export the current border as a correctly-formatted CSV.
REFERENCE 0417RG