Subsystem

Read

Write

Notes

Workspace staging

✅

✅

Unpacked document directories only

Component inventory

✅

⚠️

ComponentList is read-only; DocumentInfo fields and the dependency chain are writable

GameData catalogs

✅

✅

Search, inspect, resolve inheritance, find references, patch/clone/create/delete. Own document only — dependencies are not loaded

MPQ archives (.SC2Map, .SC2Mod)

✅

✅

Byte-identical round trips on real ladder maps, and maps packed here open in the editor — see docs/native-helper.md

Galaxy scripts

✅

✅

Parse, symbols, syntax diagnostics, safe text patching. No type checking — needs the game's natives. Requires the vendored toolkit to be built

Triggers

✅

⚠️

Structure, names, search. Renaming only — structural editing deliberately not implemented

Localization

✅

✅

Text tables, preserving BOM and CRLF exactly

SC2Layout

❌

❌

Phase 10

Placed objects / regions

✅

✅

Both are XML, not binary. Place, move, delete — round-tripped through the editor. Terrain height is not consulted

Terrain

⚠️

❌

Descriptor only (tile set, dimensions, cliff sets). Bulk data reported by magic/version/size, never decoded

Editor launch

✅

n/a

Opens a document in the Galaxy Editor; reads its logs. Automatic test-map launching is not provided — no reliable mechanism verified

Tool

Read-only

Purpose

sc2_get_server_info

yes

Versions, configuration, capability matrix, limitations

sc2_detect_installations

yes

Find StarCraft II without scanning the disk

sc2_open_document

no

Stage a document, get a workspace_id

sc2_get_document_summary

yes

Kind, counts, components, dependencies, diagnostics, known gaps

sc2_list_workspaces

yes

Recover a workspace_id after a reconnect

sc2_list_components

yes

Parse ComponentList.SC2Components; resolve each entry to real files

sc2_get_document_info

yes

Name, author, mod type, icon, screenshots, dependencies

sc2_get_dependencies

yes

Dependency chain in resolution order

sc2_list_component_types

yes

Reference table of component type codes

sc2_list_catalog_domains

yes

Catalog domains present, with entry counts

sc2_search_catalog

yes

Find catalog objects by id, filtered by domain

sc2_get_catalog_object

yes

One object's own declaration, plus verbatim XML

sc2_resolve_catalog_object

yes

Effective values with inheritance, and where each came from

sc2_find_catalog_references

yes

What refers to an object, and whether it is shared

sc2_patch_catalog_object

no

Field-level edits by path, with shared-object warnings

sc2_clone_catalog_object

no

Copy an object under a new id, byte-for-byte

sc2_create_catalog_object

no

Add a new object, ideally with a parent

sc2_delete_catalog_object

no

Remove an object; refuses while referenced

sc2_list_locales

yes

Locales and text tables present

sc2_search_text_keys

yes

Search a text table by key or value

sc2_get_text_value

yes

Read one localized string

sc2_set_text_value

no

Create or update localized strings

sc2_delete_text_key

no

Remove localized strings

sc2_copy_text_key

no

Copy strings between keys or locales

sc2_find_missing_localization

yes

Catalog objects with no display name

sc2_launch_editor

no

Open a document in the Galaxy Editor to confirm it loads

sc2_get_editor_logs

yes

List or read the editor's own logs

sc2_get_user_maps

yes

The user's Maps folder, resolved through the registry

sc2_list_galaxy_files

yes

Scripts in the document; flags the generated MapScript

sc2_get_galaxy_file

yes

Read a script, optionally by line range

sc2_get_galaxy_symbols

yes

Functions, variables, structs, includes

sc2_get_galaxy_diagnostics

yes

Syntax errors with line and column

sc2_apply_galaxy_patch

no

Exact-text edit, refused if it breaks the parse

sc2_create_galaxy_file

no

Add a library, syntax-checked first

sc2_list_triggers

yes

The trigger tree with names resolved

sc2_get_trigger

yes

One element: type, name, contents, referrers, raw XML

sc2_search_triggers

yes

Find trigger elements by name

sc2_rename_trigger

no

Rename an element (edits TriggerStrings only)

sc2_list_placed_objects

yes

Units, doodads, and points on the map

sc2_place_object

no

Place a unit, doodad, or point with the next free id

sc2_update_object

no

Move, rotate, or rescale a placed object

sc2_delete_object

no

Remove a placed object

sc2_list_regions

yes

Regions with their shapes

sc2_create_region

no

Add a region with the next free id

sc2_update_region

no

Move or rename a region

sc2_delete_region

no

Remove a region

sc2_add_dependency

no

Append a dependency; later entries win in load order

sc2_remove_dependency

no

Remove a dependency, matched by its file: half

sc2_set_document_info

no

Set a single-valued DocInfo field such as ModType

sc2_get_terrain_summary

yes

Terrain descriptor plus binary component headers

sc2_create_unit_from_template

no

Clone a unit with a name, stats, and its own weapon

sc2_set_unit_weapon_damage

no

Change one unit's damage without touching units that share it

sc2_isolate_shared_object

no

Give one owner its own copy of something shared

sc2_check_shared_object

yes

Would editing this reach beyond one owner?

sc2_validate_document

yes

Every check this build has, per category, with unchecked ones named

sc2_commit_document

no

Write the staged document out, with backup and preflight

sc2_diff_workspace

yes

Unified diff against the source, or against a snapshot

sc2_get_changes

yes

Change history, with the snapshot taken before each

sc2_revert_change

no

Undo the most recent change

sc2_create_snapshot

no

Pin a known-good state

sc2_list_snapshots

yes

Snapshots held for a workspace

sc2_restore_snapshot

no

Roll the staging tree back to a snapshot

sc2_list_files

yes

Paginated listing of the staged tree

sc2_read_file

yes

Read one staged file (text, or base64 for binary)

sc2_search_files

yes

Literal substring search across staged text files

sc2_discard_workspace

no

Delete the staging copy; source untouched