Skip to content
@scm-js

scmJS

Source code, plugins, and other resources for scmJS, a web-based Starcraft 1 map editor

scmJS

Latest release Build status Plugin API on npm MIT licensed

scmJS

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.

Where to find it

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)

Documentation

Game data

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.

Your data

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.

Contributing

Writing a plugin

A plugin is a JavaScript module that reads and edits the open map through the plugin API. To start:

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.

Working on the editor

Open a pull request against scm-js. These help:

The repositories

Main

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

Plugins

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.

License

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.

Pinned Loading

  1. scm-js scm-js Public

    A StarCraft and Brood War map editor that runs in the browser, modelled on StarEdit, SCMDraft 2 and StarForge

    TypeScript 7 3

Repositories

Showing 10 of 34 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…