Sector Metadata File Format

Traditional Traveller sector data is a list of UWPs, describing the systems in the sector. While this is adequate for most adventuring and exploration, it only represents a portion of the information presented in maps. Details such as borders and routes provide extra flavor to the visual presentation of sectors, and important details such as subsector names also need to be captured. Together, this extra detail is described by J. Greely as sector metadata.

Greely defines a plain text metadata file format by example: SpinwardMarches.txt This format is used by his sec2pdf tool for generating PDF sector maps. The Traveller Map site supports MSEC files in both the "MSEC" format in the Poster Maker and other tools, but also supports an XML format specific to the site that gives more options.

For details on the non-meta data file format, see the Sector Data File Formats page.

XML Metadata File Structure

The XML metadata format is formally described by a W3C XML Schema file; validation tools can be used to ensure that files conform to the schema. The schema defines far more detail than is presented here, as it also allows for annotations regarding the source of the data, relevant era, and so on to be added to practically any element.. This is primarily of interest only for managing the dataset of the entire map, and is the reasoning behind an extensible XML-based format.

The basic XML metadata file structure is as follows:

Subsectors

Subsector names are specified using one Subsector element each, with the subsector name as the text content.

Attributes

Index
subsector position A - P

Examples

Routes

Routes - representing the Imperial X-boat network, trade routes, rift-crossing routes, and so on - are listed with each connection requiring one Route element:

Attributes

Start
route start hex as XXYY
End
route end hex as XXYY
StartOffsetX
StartOffsetY
EndOffsetX
EndOffsetY
(optional) 1, -1, or 0 (default)
Allegiance
(optional) Used with stylesheets. e.g. ZhCo or Aq
Type
(optional) Used with stylesheets. e.g. Trade, Communication, etc
Style
(optional) one of Solid, Dashed or Dotted
Color
(optional) an HTML color name or code #RRGGBB
Width
(optional) a scaling factor, relative to the default width e.g. 1.5

Examples

Routes that extend past the bounds of a sector can use either otherwise invalid 4-digit hex codes (e.g. 0000, 3341) or indicate a sector offset x or y for the start or end hex, with negative x being spinward and negative y being coreward. For example, these two routes are identical:

Examples

Routes can be styled either through direct use of the Style and Color attributes, or by Stylesheet definitions, referencing the Allegiance or Type attributes in style selectors.

Use the Route Maker to assist in authoring routes for your sectors.

Borders

Borders are the most complex metadata type. Following the "MSEC" format, borders are defined by listing the hexes around the perimeter. Each Border element contains the hexes as a list, e.g. 0101 0201 0102 0101. The start hex must be the uppermost (Coreward) hex in the leftmost (Spinward) column. The path then follows each hex clockwise around the bounded region until it returns to the start hex again.

Borders support regions that extend beyond the edges of a sector. This is done by using otherwise invalid 4-digit hex codes (e.g. 0000, 3341), for a one-hex buffer zone around the edge of the sector representing adjacent sectors. The borders on these hexes are not drawn, but are necessary to specify to satisfy the algorithm above.

It's easy to make a mistake when hand-coding borders following the above rules. This will result in sometimes subtle, but often dramatic visual glitches when rendering maps. Consider using the Border Maker.

If a border specifies an Allegiance attribute which matches a known allegiance code, or an explicit Label is given, a label is shown (by default) at the approximate center of the bounded region.

Attributes

Allegiance
(optional) Used with stylesheets and for automatic labels. e.g. ZhCo or Aq
ShowLabel
(optional) Must be true (default) or false (to suppress the automatic label)
WrapLabel
(optional) Must be false (default) or true (to wrap the label text onto multiple lines)
LabelPosition
(optional) Label hex position, as XXYY
Label
(optional) Label text to use, regardless of a matching allegiance
Style
(optional) one of Solid, Dashed or Dotted
Color
(optional) an HTML color name or code #RRGGBB

Examples

Borders can be styled either through direct use of the Style and Color attributes, or by Stylesheet definitions, referencing the Allegiance in style selectors.

Use the Border Maker to assist in authoring borders for your sectors.

Allegiances

Although there are common allegiance codes in use, e.g. Im for the Third Imperium, custom allegiances may be necessary. These are defined using Allegiance elements.

Attributes

Code
The abbreviation for the allegiance. This is matched by Border elements to produce automatic labels.

Although the Traveller5 Second Survey project is defining canonical four-character allegiance codes (e.g. ZhCo) for polities in the Official Traveller Universe, two-character allegiance codes (e.g. Aq) should continue to be used for custom data. This is because the Traveller Map site enforces that four-character codes are from the T5SS list, and rejects unknown codes as errors to assist in the project. Since all T5SS allegiance codes are known by the site already, it is not necessary to define them using Allegiance elements.

Examples

Since allegiances are not directly displayed, they can be used for other book-keeping, e.g. to conveniently annotate routes with a shipping company.

Labels

In addition to the labels generated automatically for borders, labels can be explicitly added using Label elements. These can be used for labelling rift-crossing routes, navigation hazards, and so on.

Attributes

Hex
label position as XXYY
Color
an HTML color name or code #RRGGBB
Size
(optional) one of small or large
Allegiance
Currently unused

Examples

Regions

Regions are just like borders but they are filled rather than outlined. They can be used to represent regions of space other than political boundaries, such as nebulas.

The format and options are exactly the same as borders, although Allegiance is not typically used and Style is ignored.

Examples

Stylesheet

Just as CSS provides a convenient way to define styles for HTML documents, you can specify a Stylesheet element to easily control the appearance of borders and routes The syntax is intentionally similar to the CSS language used in web pages. The basic structure is a list of rules:

selector, selector, ... { property: value; property: value; ... }

Selectors (the bit up front)

Declarations (the bit in the back)

Properties/Values

color
HTML color name or code #RRGGBB
width
integer or floating point number
style
one of solid, dashed, or dotted

Application Rules

Examples

The following allegiance codes are recognized and matching routes and borders are automatically styled, although a Stylesheet definition will take precedence.

Im SoCf ZhCo As HvFd Kk JuPr

Since T5SS codes are focused on the allegiance of a specific world to a polity or domain, they don't precisely match the needs for metadata elements such as routes or borders which implicitly span multiple worlds. HvFd, SoCf, and ZhCo are T5SS allegiance codes for those homogenous polities (Hive Federation, Solomani Confederation and Zhodani Consulate, respectively). JuPr is the generic code for Julian Protectorate worlds although some may be aligned to a member state of the protectorate. Imperial worlds are marked with the allegiance e.g. ImDd for worlds in the Domain of Deneb, so a generic Im code is used for Imperial routes and borders. Similarly, Aslan worlds are associated with specific clans, but As is retained as a code for the Hierate as a whole. No T5SS codes have been defined for the Two Thousand Worlds so Kk continue to be used.

The Traveller game in all forms is owned by Far Future Enterprises. Copyright © 1977 – 2017 Far Future Enterprises. Fair Use Policy