Map editor - Revision history

4shveil: Match the released editor: Your maps is a list, and there is no comment tool or AI assistant yet

2026-10-09T14:04:16Z

Match the released editor: Your maps is a list, and there is no comment tool or AI assistant yet

← Older revision		Revision as of 14:04, 9 October 2026
Line 11:		Line 11:

	== Your maps ==		== Your maps ==
	The first thing you see is ~~the editor window, open on~~ '''Your maps'''. ~~It stays open until you open a map~~.		The first thing you see is '''Your maps''', a list of the maps you've saved. You can come back to it at any time with '''Open''' (Ctrl+O).

	[[File:Map editor your maps.png\|thumb\|none\|700px\|Your maps, with one map. Click ~~a card~~ to open it.]]		[[File:Map editor your maps.png\|thumb\|none\|700px\|Your maps, with one map. Click its name to open it.]]

			* Click a map's name to open it. The buttons beside it download it as a map file or delete it.
	* '''New map''' starts a blank map.		* '''New map''' starts a blank map.
	* Each of your maps is a card with a picture of it. Click one to open it. You can also download or delete it from here.
	* Type in '''Find a map''' to find a map by name.
	* '''Open file''' adds a map file (<code>.sg</code>) that you or someone else downloaded.		* '''Open file''' adds a map file (<code>.sg</code>) that you or someone else downloaded.
			* '''Back to the map''' returns to the map you have open.

	You can keep up to 25 maps.		You can keep up to 25 maps.
Line 55:		Line 55:
	\|-		\|-
	\| B \|\| Draw zone border \|\| Click corners to outline a zone.		\| B \|\| Draw zone border \|\| Click corners to outline a zone.
	\|-
	~~\| C \|\| Add a comment \|\| Pin a note to the map. Only the editor shows comments; they are never published.~~
	\|}		\|}

Line 113:		Line 111:
	* If your sign-in runs out while you work, the map stays open. Sign in again in another tab, then save.		* If your sign-in runs out while you work, the map stays open. Sign in again in another tab, then save.
	* '''Download''' saves the map as last saved as a <code>.sg</code> map file. Only signaller.org can read inside it, but anyone can open it in their own editor with '''Open file'''.		* '''Download''' saves the map as last saved as a <code>.sg</code> map file. Only signaller.org can read inside it, but anyone can open it in their own editor with '''Open file'''.

	~~== AI assistant ==~~
	People who boost the signaller.org Discord server can use an AI assistant. It sits in the bottom-left corner of the map as '''Ask the assistant'''. It can explain how to set up signals, next signals, conflicts and routes, and can make changes to your map if you let it.

	~~The first change it makes marks the map as '''AI-assisted''', for good. In the workshop, AI-assisted maps are labelled and listed after maps made without one. Asking it questions never marks a map.~~

	== Guides ==		== Guides ==

4shveil: Add screenshots of the editor screen, Your maps and Preview

2026-10-09T13:44:10Z

Add screenshots of the editor screen, Your maps and Preview

← Older revision		Revision as of 13:44, 9 October 2026
Line 13:		Line 13:
	The first thing you see is the editor window, open on '''Your maps'''. It stays open until you open a map.		The first thing you see is the editor window, open on '''Your maps'''. It stays open until you open a map.

	* '''New''' starts a blank map.		[[File:Map editor your maps.png\|thumb\|none\|700px\|Your maps, with one map. Click a card to open it.]]

			* '''New map''' starts a blank map.
	* Each of your maps is a card with a picture of it. Click one to open it. You can also download or delete it from here.		* Each of your maps is a card with a picture of it. Click one to open it. You can also download or delete it from here.
	* Type in ~~the filter~~ to find a map by name.		* Type in '''Find a map''' to find a map by name.
	* '''Open file''' adds a map file (<code>.sg</code>) that you or someone else downloaded.		* '''Open file''' adds a map file (<code>.sg</code>) that you or someone else downloaded.

Line 21:		Line 23:

	== The screen ==		== The screen ==
			[[File:Map editor screen.png\|thumb\|none\|700px\|The editor with a signal selected: the tools on the left, the map in the middle, and the signal's settings in the Inspector on the right.]]

	* '''The toolbar''' runs along the top: New, Open, Save, Save copy, Publish, Download, undo and redo, view settings, and '''Test'''.		* '''The toolbar''' runs along the top: New, Open, Save, Save copy, Publish, Download, undo and redo, view settings, and '''Test'''.
	* '''The tools''' are down the left side. Each has a key, shown below.		* '''The tools''' are down the left side. Each has a key, shown below.
Line 99:		Line 103:
	* '''Preview''' (the ` key) hides everything the editor adds, such as ids and selection marks, and shows the map exactly as the game draws it.		* '''Preview''' (the ` key) hides everything the editor adds, such as ids and selection marks, and shows the map exactly as the game draws it.
	* '''View''' in the toolbar shows the map as one zone's player sees it: that zone's borders, labels and controllable signals.		* '''View''' in the toolbar shows the map as one zone's player sees it: that zone's borders, labels and controllable signals.

			[[File:Map editor example map.png\|thumb\|none\|700px\|The example map in the editor, with ids shown (I).]]
			[[File:Map editor preview.png\|thumb\|none\|700px\|The same map in Preview (`): exactly what players see.]]

	== Saving ==		== Saving ==
Line 113:		Line 120:

	== Guides ==		== Guides ==
			The guides use one small example map throughout, '''Example Junction''': two lines and a branch that crosses one of them on the flat.

	# [[Building a map]]: the order to work in, and drawing the track		# [[Building a map]]: the order to work in, and drawing the track
	# [[Signals in the map editor]]: placing signals, their settings and next signals		# [[Signals in the map editor]]: placing signals, their settings and next signals

4shveil: New guide: a tour of the map editor (signing in, your maps, tools, shortcuts, saving)

2026-10-09T13:15:12Z

New guide: a tour of the map editor (signing in, your maps, tools, shortcuts, saving)

New page

<p class="sg-lede">The map editor is where you build your own signalling maps for signaller.org: draw the track, place the signals, tell them how they work together, and test them with trains before you share the map in the workshop.</p>

This page shows you around the editor. To build a map step by step, start at [[Building a map]].

== Getting in ==
Open '''Map Editor''' from signaller.org's main menu.

* You sign in with Discord. The editor uses your Discord account to keep your maps, so only you can see, open or delete them.
* You need to be in the signaller.org Discord server. If you are not, a box asks you to join, and nothing else works until you do. Select '''Join server''' and the editor adds you.
* You stay signed in for 30 days.

== Your maps ==
The first thing you see is the editor window, open on '''Your maps'''. It stays open until you open a map.

* '''New''' starts a blank map.
* Each of your maps is a card with a picture of it. Click one to open it. You can also download or delete it from here.
* Type in the filter to find a map by name.
* '''Open file''' adds a map file (<code>.sg</code>) that you or someone else downloaded.

You can keep up to 25 maps.

== The screen ==
* '''The toolbar''' runs along the top: New, Open, Save, Save copy, Publish, Download, undo and redo, view settings, and '''Test'''.
* '''The tools''' are down the left side. Each has a key, shown below.
* '''The map''' fills the middle. Scroll or pinch to zoom; drag with the Pan tool to move around.
* '''The side panel''' on the right has four tabs:
** '''Inspector''': the settings of whatever you have selected. With several things selected it becomes '''Selection'''.
** '''Map''': the map's name, description and authors, and how much traffic turns round at termini.
** '''Routes''': the services trains run. See [[Routes in the map editor]].
** '''Check''': problems the editor has found. See [[Testing a map]].

When you select a signal, the signals it is connected to are ringed in colour, with a key in the corner of the map. See [[Signals in the map editor#Seeing how signals connect|Seeing how signals connect]].

== Tools ==
{| class="wikitable"
! Key !! Tool !! What it does
|-
| V || Select and move || Click to select; drag to move. Track joined to what you move stretches to stay connected.
|-
| H || Pan || Drag to move around the map.
|-
| T || Draw track || Click points to lay track. Ending on another track makes a junction.
|-
| S || Place signal || Click on a track to place a signal facing along it. Shift-click faces it the other way.
|-
| P || Place platform || Click beside a track to place a platform.
|-
| E || Place termination || Click a track end to place a buffer stop.
|-
| X || Place label || Click to place text, such as a station name.
|-
| B || Draw zone border || Click corners to outline a zone.
|-
| C || Add a comment || Pin a note to the map. Only the editor shows comments; they are never published.
|}

== Keyboard shortcuts ==
{| class="wikitable"
! Keys !! Does
|-
| Ctrl+S || Save
|-
| Ctrl+Shift+S || Save copy: save as a new map and carry on with the copy
|-
| Ctrl+O || Open one of your maps
|-
| Ctrl+Z || Undo
|-
| Ctrl+Y or Ctrl+Shift+Z || Redo
|-
| Ctrl+A || Select everything
|-
| Ctrl+D || Duplicate the selection
|-
| Ctrl+F || Search for a signal, platform, station, buffer stop or label
|-
| Delete || Delete the selection
|-
| R || Turn the selection 45° (Shift+R turns it back)
|-
| F || Flip the selection round (180°)
|-
| Arrow keys || Nudge the selection one grid step (with Shift, five)
|-
| G || Show or hide the grid
|-
| I || Show or hide signal, platform and buffer stop ids
|-
| ` || Preview: see the map exactly as the game draws it
|-
| Home || Fit the whole map on screen
|-
| Esc || Finish drawing, stop picking, or clear the selection
|}

While you draw, hold '''Shift''' to keep to 45° angles and '''Alt''' to ignore snapping.

== Seeing the map as players will ==
* '''Preview''' (the ` key) hides everything the editor adds, such as ids and selection marks, and shows the map exactly as the game draws it.
* '''View''' in the toolbar shows the map as one zone's player sees it: that zone's borders, labels and controllable signals.

== Saving ==
* '''Save''' (Ctrl+S) stores the map on the editor's server under your Discord account. A dot next to the map's name means there are unsaved changes.
* '''Undo''' covers every change since you opened the map.
* If you saved the same map from another browser tab, the editor asks whether to overwrite it or keep both.
* If your sign-in runs out while you work, the map stays open. Sign in again in another tab, then save.
* '''Download''' saves the map as last saved as a <code>.sg</code> map file. Only signaller.org can read inside it, but anyone can open it in their own editor with '''Open file'''.

== AI assistant ==
People who boost the signaller.org Discord server can use an AI assistant. It sits in the bottom-left corner of the map as '''Ask the assistant'''. It can explain how to set up signals, next signals, conflicts and routes, and can make changes to your map if you let it.

The first change it makes marks the map as '''AI-assisted''', for good. In the workshop, AI-assisted maps are labelled and listed after maps made without one. Asking it questions never marks a map.

== Guides ==
# [[Building a map]]: the order to work in, and drawing the track
# [[Signals in the map editor]]: placing signals, their settings and next signals
# [[Conflicts in the map editor]]: keeping trains apart at junctions
# [[Routes in the map editor]]: the services trains run
# [[Testing a map]]: running trains on your map before you share it
# [[Publishing a map]]: sharing it in the workshop

[[Category:Map editor]]
[[Category:Guides]]