Shared types

4-character chunk name, latin1. May contain junk in protected maps.

Byte offset of the chunk's name within the CHK.

Length field as written, which may disagree with data.length when truncated.

Set when the declared size ran past the end of the file.

Bytes after the last parseable chunk header, if any.

strings[i] is string index i; slot 0 is always null.

True when the source section was STRx (Remastered, 32-bit count and offsets).

Bit set of which "special properties" fields below are meaningful.

sprites.dat id for a pure sprite, units.dat id for a unit sprite (see SpriteFlag.PureSprite).

SpriteFlag bits. StarEdit writes a doodad's overlay sprite with the doodad's whole CV5 flag word here, so real maps carry the terrain bits (0x80, 0x100, …) too.

0 = enabled (every doodad in Blizzard's maps), 1 = disabled.

Bit 0 low ground, 1 medium, 2 high, 3 low air, 4 medium air, 5 high air.

Force index (0-3) each of the 8 playable slots belongs to.

String index of each force's name.

Bit 0 random start, 1 allied, 2 allied victory, 3 shared vision.

[r, g, b] for each of the 8 playable slots; only read when mode is Custom.

A ColorMode per slot.

1 = the game uses units.dat / weapons.dat for this type and ignores the columns below.

Fixed point: hit points × 256, like units.dat.

Game frames (15 per second at Fastest).

String index of the custom name, 0 for the default one.

Per weapons.dat id, always WEAPONS_BW long; UNIS only stores the first 100.

1 = the player can build the type; read only where playerUsesDefault is 0.

1 = the type is available to every player that uses the default.

1 = the player takes defaultAvailable for the type.

1 = the game uses upgrades.dat for this upgrade and ignores the columns below.

Game frames.

1 = the game uses techdata.dat for this ability.

Game frames.

CuwpValid bits.

CuwpField bits.

Unused by the game; StarEdit writes 0.

CuwpState bits.

The record's last four bytes, kept for fidelity.

1-based location number, 0 = none.

PlayerGroup.

Comparison for numeric conditions; SwitchState for Switch.

ConditionType.

ResourceType / ScoreType / switch number, per type.

ConditionFlag bits.

EUD mask word; 0 in ordinary maps.

1-based source location, 0 = none.

String index for text / comment / leaderboard label, 0 = none.

String index of the WAV file name, 0 = none.

Milliseconds for Wait / Transmission / Talking Portrait; WAV duration for Play WAV.

PlayerGroup (first).

Second player / destination location / amount / AI script code, per type.

Unit id / ScoreType / ResourceType / AllianceStatus, per type.

ActionType (or BriefingActionType in MBRF).

Unit count (0 = all) / SetModifier / SwitchAction / Order / UnitState, per type.

ActionFlag bits.

EUD mask word; 0 in ordinary maps.

TriggerFlag bits.

27 bytes, one per PlayerGroup; non-zero = the trigger runs for that group.

The game's bookkeeping byte (offset 2399); StarEdit writes 0.

TYPE, e.g. "RAWB" for Brood War.

VER: 59 original, 63 hybrid, 205 Brood War, 206 Remastered.

ERA value as stored; the meaningful tileset is tilesetId.

IOWN: StarEdit's own copy of the player types — what its Player Settings dialog shows, where the game reads OWNR. The editor keeps the two in step; a file where they differ (another tool wrote one and not the other) is flagged by Check Map. Null when the file has no section.

CRGB, Remastered's per-slot colour choice; null when the file has none (every client then reads COLR).

UNIx if the file has one, else UNIS; null when it has neither (every type on its dat defaults).

PUNI; null when the file has none (everything buildable by everyone).

UPGx if the file has one, else UPGS; null when it has neither (every upgrade on its dat costs).

PUPx else UPGR; null when absent (every player on the dat level caps, starting at 0).

TECx else TECS; null when absent.

PTEx else PTEC; null when absent (everything researchable, nothing researched).

WAV: 512 string indices of the map's sound paths; null when the file has no section.

UPRP: the 64 Create Unit with Properties slots (the action names one 1-based); null when the file has no section.

UPUS: StarEdit's "slot in use" byte per CUWP slot; null when the file has no section.

MTXM: what the game draws — terrain with the doodads stamped over it.

TILE: StarEdit's copy of the terrain without doodads (a doodad's cells hold the ground it was placed on). Terrain brushes write both arrays; placing a doodad writes only tiles, and removing one restores its cells from here. A file without TILE starts with a copy of MTXM.

TRIG, in execution order.

MBRF: mission briefings, same record layout with briefing action types.

SWNM: string index per switch (0 = unnamed); null when the file has no section.

Exclusive.

Rects that have tiles under them.

Rects whose tiles are not what their ISOM resolves to (doodad tiles are excused).

Output pixels per map tile. 32 matches the game's art 1:1; 1 is a minimap.

Whose fog is drawn (0-based player), when fog is on.

Grid spacing in map pixels (32 = one tile); 0 for no grid.

The part of the map to draw, in tiles (exclusive x1 / y1). The whole map when absent. Everything is drawn in map coordinates and the canvas is translated, so a region looks exactly like that part of the full picture — a unit half outside the region still leans in.

0-based; the chrome shows it as slot + 1.

COLR index; null for the four unplayable slots.

The colour the chrome shows for the slot (CRGB-aware).

The CRGB custom triple when one is in effect.

0-based force; null for the unplayable slots.

0-based.

0-based playable slots in the force.

The game's name (or the custom one when the map sets it).

The custom name the map sets, "" for the default.

Whole hit points.

Game frames.

The type's ground and air weapons (a turreted vehicle's are its turret's), with the effective damage.

units.dat / weapons.dat, null without the game data.

PUNI: whether the type can be built by default, and per player ("default" where the player follows the default).

Game frames.

upgrades.dat, null without the game data.

UPGR / PUPx: the default start and cap, and each of the 12 players' (effective, with usesDefault).

Game frames.

PTEC / PTEx: the default column and each of the 12 players' effective state.

The path as the string table has it.

Whether the archive carries a member at that path.

Bytes in the archive, 0 when absent.

The archive member's name as stored (case may differ from the path).

How many Create Unit with Properties actions name the slot.

Stable identifier (storage prefix, log prefix); derived from the name when absent.

Entry file relative to the manifest; plugin.ts by default, then plugin.js.

A built, self-contained JavaScript bundle of the plugin, relative to the manifest ("dist/plugin.js"). When there is one the editor loads it and never entry: one fetch, no TypeScript compiler, no import graph to walk — and the plugin may use npm dependencies, which the source path cannot (bundleModule refuses a bare specifier because it has no resolver).

entry stays the source of truth and stays in the manifest: it is what a person reads, what npm run typecheck checks, and what loads when there is no build. A repository that publishes one builds it in CI at the tag it is loaded from — see docs/plugins.md.

The plugin's face in Manage Plugins and on its own dialogs: an emoji ("🗺️"), a data:image/… URI, an https://… image, or an image file beside the manifest ("icon.svg"). Anything else is ignored — see resolveIcon in loader.ts.

The PLUGIN_API_VERSION the plugin was written against.

Manifest id (or slug of the name).

The spec the plugin was installed from (builtin:…, github:…, a URL).

The manifest's icon, resolved; absent when it declared none (or an unusable one).