Repository navigation
GS Map Editor 0.4.0 (preview)
Pre-releaseGS Map Editor makes your own version of Golden Sun: The Broken Seal without writing code. Repaint towns, hide chests, write new dialogue, add people and doors, reshape the world map, then press ▶ Play and walk around in your change.
New in 0.4.0
- Stairs, ramps and any height you like. The Height tool now builds the square you paint: Flat, Ramp, Steps or Diagonal, which way it rises, and its levels. A small picture shows it from above and says whether the party can walk across it. Heights are counted in levels, the game's own unit: the party walks up or down one level at a time, and two or more is a wall. You're no longer limited to the heights a place already has; new ones are added when you save. Tick Stairs and one drag lays a whole staircase, each square climbing on from the last. On the map, darker blue now really means higher ground.
- The atlas. Every place on one canvas, grouped by area near its world map icon and joined by lines from each door to where it leads. Drag to pan, scroll to zoom, click a place to open it, and drag places to arrange them.
- Battles. See and change which enemies appear where and how often: per region on the world map, and in each place through Battles….
- World map: new step spots and town icons. Make a spot that leads anywhere, several squares wide if you like, or a new town icon with its own picture. Spots and icons you added can be removed.
- Fill. Tick Fill (F) in Paint, Walkability or Height and one click fills the whole connected area.
- Remove a person you added, along with everything they say.
- Faster. Check runs about 7 times faster, drawing a place about 2.5 to 3 times, Where people can stand about 8 times, and the world map about 3 times.
- Alchemy
5ca23b1fe1(2026-11-12). New installs download that version. If you already set up 0.3.0, your copy keeps working.
Which download?
- Windows 10 or 11 (early test):
Install-GS-Map-Editor.cmd - Mac with Apple Silicon (M1, M2, M3, M4 and later):
GS-Map-Editor-0.4.0-AppleSilicon.dmg - Mac with Intel:
GS-Map-Editor-0.4.0-Mac-Intel.dmg
Not sure which Mac? Apple menu → About This Mac. "Chip: Apple M…" means Apple Silicon, "Processor: … Intel …" means Intel.
Everyone needs about 3 GB of free space, an internet connection for the first setup, and mGBA, a free emulator, to play. On Windows, use mGBA's Windows installer.
Installing and opening it the first time are the same as before, and are in the README. On a Mac, the app still isn't signed: the first time, open it, press Done, then System Settings → Privacy & Security → Open Anyway. Updating keeps your mods and settings.
What's most useful to test
- Stairs and ramps: do they walk in the game the way the editor says they will?
- Battles: do the enemies you set turn up where you put them?
- The atlas on your own mod, with doors you've added.
- New world map step spots and icons.
- Windows: the folder window for an existing copy, and exports landing in Documents.
Known issues
- Places opened by Psynergy or the story can show as unreachable in Where people can stand.
- The Height tool's buttons make flat squares, ramps, steps and diagonals; curved and other shaped squares can only be copied from the map (⌥-click).
- English edition of The Broken Seal only.
Full changelog
Height
- The Height panel builds the square to paint: Flat, Ramp, Steps (half a square at one level, half at the next) or Diagonal (two levels split corner to corner, as at a cliff edge), a rising direction and its levels, with a picture from above and whether the party can walk across it.
- Any level can be painted. A height the place doesn't have yet is added to it when you save, only if you painted it, and reusing an identical one where there is one (at most 256 per place, the game's limit).
- Stairs: with Ramp or Steps, one drag lays a staircase, each square climbing on from the last (a ramp square climbs two levels, steps one level each half).
- Heights are shown in levels, the game's own unit (8 pixels, half a square): in the panel, the status line, the "level squares to the path's height" button and walking problems. Advanced still shows pixels.
- The list is now a tally: how many squares sit at each level, plus one line for ramps, steps and other shapes. Advanced lists every height in the place's table.
- ⌥-click copies a square's exact height, including curved and shaped ones the buttons don't make.
- The Height overlay's blue follows the real height, from none on the place's lowest ground to darkest on its highest. Before, its shade came from the height's position in a list and could make high ground look low.
- Walking checks (Where people can stand, Check, adding a person) see heights you haven't saved yet.
Places
- Fill (F) in Paint, Walkability and Height fills the connected area matching the square you click, among the squares the place shows. One Undo takes it back.
- Remove a person you added, with everything they say. The game's own people stay, since scenes move them and talk to them by number.
- Battles… shows a place's battle zones with when they apply (arrival point, story flag) and which places share them, and lets you change how often battles come and which enemy groups appear.
- Doors: Go there opens where a door leads, and Back returns.
- Events and Move people draw people as their sprites, and hovering over one shows what they say.
- Events describes scene scripts in plain words; Advanced still shows the full text.
- People the game keeps waiting off the map (at 0,0) are counted in the Events panel and drawn once with a count (×6), instead of piled in the corner.
- A place's own temporary flags read "this place's own flag (cleared on entering)".
- The status line shows square numbers, as doors, chests and Check do.
- The Chest tool counts only chests and Psynergy Stones toward the 10 per scene, as the game does.
- Check's Show circles the square it jumps to for a few seconds.
- ▶ Play skips arrival points where the party could barely move (13 places across the game).
- Copying an area and pasting it into another place keeps its heights, instead of row numbers that meant different heights there.
World map
- Make and remove step spots: a spot can lead anywhere and cover several squares.
- New town icons, with a picture the game's own icons use, leading wherever you pick. Icons you added can be removed.
- The Regions tool shows each region's battles (how often they come, which enemy groups, their chances) and lets you change them. Reset world map puts them back.
Atlas
- A new page with every place on one canvas, grouped by area near its world map icon, laid out from each area's entry, joined by lines from each door to where it leads.
- Drag to pan, scroll to zoom, click a place to open it, drag a place to move it; Reset layout puts them back.
- Thumbnails and the layout are kept on disk, so the atlas opens at once after the first time; missing thumbnails are drawn in the background.
Check
- Reports world map step spots and icons that lead nowhere or to a missing arrival point.
- Counts chests per scene, as the game does: no more false alarms on maps that hold several houses.
Export, Reset and Windows
- Exporting again under a name you've used asks first: OK replaces the earlier patch, Cancel saves the new one as
<name>-2.bps. - Export clears an old
.ips, and long or reserved names are made safe. - Reset and Export take the game's original from the editor's pinned version of alchemy, so Reset no longer restores files that don't build.
- Reset place also restores that place's battle zones; Reset world map only the world map's.
- Windows: "I already have a copy" opens a folder window instead of asking you to type a path, and exported patches and patched games go in Documents\GSMapEditor.
Speed
- Check about 7 times faster, and a second Check in a row about twice as fast again.
- Drawing a place about 2.5 to 3 times faster; pictures of people and chest items arriving together redraw the map once, not once each.
- Where people can stand about 8 times faster, and instant when you come back to a place or scene whose ground hasn't changed.
- The world map draws about 3 times faster, and so does its walkability.
- Painting with an overlay on redraws once a frame instead of once per square.
- Starting up and reading the game's scenes and maps is quicker.
- Every result was compared before and after each speed-up and is unchanged.
Fixes
- Painting or undoing while a save was still running could be lost, and pressing ⌘S twice quickly saved twice. Saves now happen one at a time, and the map waits for the save to finish.
- A quick drag left gaps between squares; strokes are now unbroken lines.
- Clicking two places quickly could open the first one, or mix in its chests, doors and walkability names.
- Saving a chest, door or event now refreshes the other places that share its map, and a failed save can no longer leave old pictures behind.
- Reset place keeps the heights you added that other places sharing its height set still use.
- Ground below level 0 now reads as below 0 in the status line, the map and where ▶ Play starts.
- People the game keeps waiting at 0,0 show whole in the corner, with their count beside them.
- A chest you've moved keeps its item picture; search spots show their codes only in Advanced.
- Hovering over a line shows the hero's name instead of a gap.
- Undo clears the status line, so a "Move to the nearest good spot" button from before can't undo your Undo.
- Starting Export or the Patcher twice runs it once, and their progress stops with an error if the editor stops answering.
- Narrow windows: the side panels shrink so the map keeps its room, the event editor no longer jumps as you type, and the build log only shows in Advanced.
- Using the Stamp tool in many places no longer slowly uses up memory.
- Removing an added person only touches their own story stage, not other rooms sharing the same scene (Goma Cave, Bilibin).
- Undo that takes away a file clears the build's stale dependency lists.
- World map: instructions no longer vanish on hover, widening a spot can't spill onto another one, a code that leads nowhere no longer crashes, and the selection follows saves and Undo.
- Place editor: Go there and Back switch the scene properly, a person's whole picture can be clicked, and the Battles dialog ignores late answers.
- The top bar wraps between buttons instead of running off screen; the language menu shows each language in its own name.
Under the hood
- Alchemy
5ca23b1fe1(2026-11-12): mods link through its newld_script.ld. A checkout set up before keeps working. - About 60 new automated checks (
tests/features.py), plus tests for saving new heights and for bad input to the new height saving, all run in CI. The safety tests now run in CI too, on a fresh copy of the game. - The app's licence notices now list every library it ships (PyObjC, Bottle, proxy_tools, typing_extensions, and those inside Python and Pillow), with their licence files in the app.
- The guides, spec and developer notes are updated in all six languages.
How to use everything is in the README. Golden Sun belongs to Nintendo and Camelot; this project isn't affiliated with them. Please don't share ROMs, original or modified: share the patch the editor exports.