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