scmJS is a map editor and replay viewer for StarCraft, Brood War and StarCraft: Remastered, modelled on StarEdit, SCMDraft 2 and StarForge. It runs in a browser tab or as a desktop app, draws maps with the game's own graphics, classic or Remastered, and saves maps the game plays.
Around the editor:
- Replays open on the map they were played on, and at scmjs.dev they play back and are analysed: fights, economy and tech.
- The play page at scmjs.dev/play runs StarCraft 1.16.1's own engine in the browser, from your own StarCraft files: test a map, play a mod, or play against a bot.
- Mods such as Cosmonarchy BW play there with their own code, and the editor makes maps for them with their units and tilesets.
scmjs, the command line, looks inside maps and replays, checks maps in CI, plays a map's triggers in the game, keeps a mod as a folder of text, and runs bots.- AI apps (Claude Desktop, Claude Code, Cursor and others) read and change maps through
scmjs mcp, with each change arriving in the open editor as one undo step. - TrigScript writes triggers in TypeScript, with tests, and builds programs that run inside StarCraft: Remastered.
- Bots in JavaScript or BWAPI C++ play on the same engine as the play page.
Plugins add to the editor. The plugins page lists the current ones, and you install them in the editor from Plugins ▸ Browse Plugins….
The editor is in English and Korean. The Korean translation was machine-generated, and we are looking for a native speaker to review it. The editor picks the language from your browser, and you can change it in Preferences.
The main site is scmjs.dev.
| Release | Link |
|---|---|
| Web editor (stable) | https://scmjs.dev/editor/ |
| Web editor (nightly) | https://scmjs.dev/nightly/ |
| Desktop app | Windows, Mac, Linux |
| Play page | https://scmjs.dev/play/ |
| Command line | brew install scm-js/tap/scmjs, Scoop, or npm install -g @scm-js/cli (how) |
The editor does not include any of Blizzard's files. The first time you open it, it asks for your StarCraft folder, classic (1.16) or Remastered, and reads the graphics from there. The desktop app finds an installed game by itself. Without StarCraft, Blizzard's free map editor download is enough to edit maps and watch replays; testing a map or playing needs the game. Installing has the details.
Maps and game data stay on your computer. Nothing is uploaded unless you ask for it: keeping maps or replays in your scmjs.dev account, sharing one by link, editing a map with others, using scmscx.com, or using the AI tools, which send what they read of the map to the AI you chose.
A plugin is a JavaScript module that reads and edits the open map through the plugin API. To start:
- plugin-hello-world is a working example to copy.
- The plugin guide explains how plugins load and what they can do.
- The API reference lists every call.
While you work on it, the editor can load your plugin straight from your git repository. When it is ready for others, submit it to the registry.
Open a pull request against scm-js. These help:
- Map files, the format reference.
- Game data, what the editor reads from the game's archives.
- Development, how to build and run it.
| Repository | Description |
|---|---|
| scm-js | the editor itself, the guides, the scmjs command line (@scm-js/cli), the editor's map code as a library (@scm-js/core) and the types for JavaScript bots (@scm-js/bot) |
| plugin-api | @scm-js/plugin-api, the type definitions a plugin builds against |
| registry | the list behind Plugins ▸ Browse Plugins… |
| site | scmjs.dev, the landing page |
| docs | docs.scmjs.dev, built from the editor's own documents |
| nightly | last night's build of main, served at scmjs.dev/nightly |
| replay | @scm-js/replay, which reads StarCraft replays from 1.16 to Remastered |
| mod | @scm-js/mod, which reads a Brood War mod (a folder, an MPQ, an MPQDraft or FireGraft exe, a zip) without running it |
| scmbot | builds a BWAPI bot into a .scmbot file to play against on scmjs.dev/play |
| ai-engine | the prompt recipes behind scmjs.dev's AI features |
| homebrew-tap | brew install scm-js/tap/scmjs, the command line for macOS and Linux |
| scoop-bucket | scoop install scmjs, the command line for Windows |
| Plugin | Description |
|---|---|
| scm-scx | search scmscx.com and open a map straight from it |
| repair | checks a map as it opens and offers to rebuild what is missing or broken |
| walkability | where ground units can actually go, and how wide the chokes are |
| image-to-terrain | paints a picture into terrain |
| paint | lines, shapes, text and sprays made of units, sprites, doodads, terrain or fog |
| trigscript | a TypeScript-like language, and its editor, compiled to triggers |
| stamp-library | named terrain pieces kept across maps and shared as JSON |
| trigedit | SCMDraft 2's text trigger editor |
| scmjs-dev | a scmjs.dev account: maps kept online, shared editing, and the AI assistant |
| melee-wizard | symmetric start locations and mineral lines for a ladder map |
| section-explorer | an annotated hex editor over the map's own sections |
| trigger-map | the map's triggers as a graph: who sets and who reads each switch, counter and location |
| timelapse | records the map as you build it and exports the recording as a GIF or video |
| aftermath | plays a replay back over its map: heat maps, build orders, APM |
| magenta | a trigger editor where each trigger reads as a sentence, with Remastered EUD conditions and actions |
| mods | the Mod Editor: a mod's tables, strings, pictures, sounds and scripts, with the map drawn from the mod as you change it |
| scm-sim | lets other plugins use the game engine behind scmjs.dev/play, and adds Tools ▸ Test in Browser |
| api-playground | try the plugin API in a panel without writing a plugin |
| hello-world | the smallest plugin there is, to copy |
Retired: eudplib, replaced by TrigScript's own builds, and ai, whose features moved into scmjs-dev.
MIT. StarCraft and Brood War are trademarks of Blizzard Entertainment. This project is not affiliated with Blizzard and does not include any of the game's data.
ATTRIBUTION.md credits the algorithms and libraries the editor uses.