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).

How the text is written to bytes; guessed on open, a setting afterwards.

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.

Flat index into scenario.tiles.

What scenario.editorTiles (TILE) held before a terrain change, when that differs from before (the cell was under a doodad). Filled in by applyChanges the first time a change is applied, so undo can put the ground back rather than the doodad tile.

Exclusive.

A string slot the edit adds (a name no existing string matched); removed again on undo.

The changed tables as JSON text (packed).

String slots that changed: [index, before, after].

The archive's files, when the commit changed them too (the Sound Editor).

The isometric brush's changes to scenario.isom, undone together with the tiles.

Set when the edit gave a map an ISOM section it did not have (Rebuild ISOM). Undo removes the section again rather than leaving an all-zero one behind.

Set when the edit rebuilt an existing lattice from the tiles, which is the one edit to isom the ISOM health is re-measured after: a brush stroke keeps the two in step by construction and is deliberately not measured (useIsomStatus), and measuring costs a second rebuild.

Unit placements, moves and deletions (see editor/units.ts).

Doodad tiles stamped into or lifted off MTXM alone — TILE keeps the ground beneath (see editor/doodads.ts). Applied after changes, so a terrain stroke that removes the doodads it painted over restores their remaining cells on top of its own edit.

DD2 record insertions, removals and replacements.

THG2 record changes: the Sprites layer's edits, and a doodad's overlay sprite coming and going with it.

MRGN slot replacements — create, move, resize, rename, delete (see editor/locations.ts); a rename may carry a string.

Fog of war edits to scenario.mask (see editor/fog.ts); at indexes the MASK byte.

Set when the edit gave a map a MASK section it did not have (the first fog stroke on such a map). Undo removes the section again.

What a dialog wrote — settings, triggers, the briefing, strings (editor/tableHistory.ts). An entry with this part has no other: applyEntry leaves it alone, and the undo and redo atoms apply it with applyTables.

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.

Bounds in map pixels relative to the clip's origin (an inverted box keeps its inversion).

Size in tiles.

ERA of the source map: tile ids mean nothing on another tileset.

MTXM ids, row-major, or null when terrain was not included.

TILE ids (the ground under the doodads), alongside tiles.

Records with positions relative to the origin in map pixels.

MASK bytes, row-major, or null when fog was not included.

Objects the paste cleared out of the way (replace mode) or that a new tile stranded.

Things that could not be pasted, in words.

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.

Plugins this one needs running, as the specs Manage Plugins takes ("github:owner/repo", "github:owner/repo@v1.2.0", a URL to a plugin.json, "builtin:name"). Adding this plugin installs them first, enabling it enables them, and the editor starts them before it; a required plugin cannot be turned off or removed while something enabled needs it.

Which version of the required plugin is enough is not said here. The two plugins meet through api.services: the required one provides a service with a version (ServiceOptions), and this one checks ServiceInfo.version in its watch and says so in its own words when it is too old. A version range in the manifest would have the editor arbitrate a contract it never reads.

True once dispose has run, or once the plugin that made the scope was turned off.

Over what clipboard.parts() says.

Over clipboard.mode().