Building a map
Note
Written for AI agents. Orbit and coding agents follow this page when they work on your world. You don't need it to use Craft, but it shows how an agent will approach the job.
A map is built to be played on. The GM never sees the picture the way a player does: it reads the map's kind and scale, what the picture shows and where, the ways out, the places on it, the named spots and who is there (how the GM uses maps). Build each of those, in this order, and the GM can run a scene on the map without guessing.
Build a world's maps as a tree. The root travel map is at the top, and it is the world's root map (Choose it in the Maps view, or under Root map in the current root map's Map settings.); the places on it are below, and each leads down to the scene maps where play happens. Interiors are scene maps. A place in between (a village, an island, a castle yard) is both: scenes play on its ground, and its buildings lead down to their own maps (scene and travel maps).
Adding a place to a world
Asked for one new place in a world that already has maps (the inn's second floor, the next city over, a cave below the cliffs), find where it hangs in the tree first, then build its map with the steps below.
- A part of a place: an upper floor, a cellar, a back room. It is a location inside that place, linked as inside it and not drawn on its map. Its own scene map matches the building's scale and grid: the inn is 60 ft across with 5 ft squares, and so is its second floor. The way between them is an exit on each map where the pictures draw it, stairs up on the inn's map and stairs down on the floor's, paired. When the inn's picture shows no stairs, link the two as linked locations with stairs as the way. Either way, the floor is linked as inside the building, so it never hangs on its own. Give it its map (scale and grid) in the same go, and offer its picture. A way's direction is said from the place it is on: from the upper floor, the stairs go down to the inn; from the inn, up.
- A part of a larger area: a region of a country, a district of a city. It is drawn on the parent's map where the picture shows it (an area for a region, a pin for a town): a link says what it is part of, not where. A country's regions all go on its map in the same go.
- A place beside another: the next city over, the next village down the road. It is drawn on the same parent map as its neighbour, at a spot the parent's picture shows (a town, a crossing, open country by the road) a believable distance away. Its own map is drawn at its size: a town plan for a city. The road between them is a way with a distance or a time, measured on the parent map.
- Take the obvious reading. A place the user has open is the one they mean: "the next city over" is next to it. Choose the direction and the spot from the parent's picture, say in the reply what you chose, and ask only when the world gives two very different answers.
Before you start
- Read the map first. Its scale and grid, whether it is a scene map or a travel map, what its picture shows and where, its exits, linked locations, terrain, walls and tokens.
- Find its place in the tree. The place it is inside, the places drawn on it, and the places it leads to. Read their files: the location's own description says what the map must hold. A map's exits and pins point at those files, so they must exist first.
- Know what the user wants. A new map, a new picture for an old one, or one part (the exits, the walls). Change only that, and keep what the user drew by hand.
1. Pick the kind and the scale
Every map is one of two kinds (scene and travel maps):
- A scene map is ground a scene is played on: inside the inn, the town square, a camp, a cave. It is drawn top-down like a battle map and has a square grid, so people stand in squares.
- A travel map is a town, a city, a region or a kingdom: places and the ways between them. Scenes aren't played on it; the party travels across it to the places pinned on it. It has a scale and no grid.
Give the map the width of the place itself, as the GM sizes places it makes:
| The place | Kind | Width |
|---|---|---|
| A room, a cell, a cabin, a small shop | Scene | 30 ft (10 m) |
| A tavern's common room, a hall, a house, a ship's deck | Scene | 60 ft (20 m) |
| A camp, a clearing, a courtyard, an inn and its yard | Scene | 150 ft (50 m) |
| A market square, a keep, a ruin, a temple complex | Scene | 300 ft (100 m) |
| A hamlet, a village, a castle and its grounds | Travel | 0.25 mi (0.4 km) |
| A town, or a city's district | Travel | 1 mi (1.6 km) |
| A city | Travel | 4 mi (6 km) |
| A valley, a forest, a coast, an island | Travel | 20 mi (30 km) |
| A region, a kingdom, a sea | Travel | 200 mi (300 km) |
A scene map gets a square grid of 5 ft (1.5 m) squares. Set the scale and the grid before the picture: the picture is drawn for the scale. Use the world's units: feet and miles unless the world measures in metres. A new place gets its scale when it is made, even before it has a picture. Never use exactly 1 mile for a map that isn't a mile across; it was the old default and the GM distrusts it.
To set it, use Scale in Map settings. To set it, use Grid in Map settings, which has presets for common systems.
A place too small to need its own view (a waystone, a stall) can use its parent's map instead. A place people fight, sneak or explore in room by room gets its own scene map.
2. Get a picture that fits
The picture is most of a map. To set it, use Map image in Map settings: upload one, pick one from the Studio, Generate one, or make one From parent.
- Ask for a map, not a scene. A scene map is one connected floor plan seen from directly above with the roof off: its rooms, furniture, doors and stairs, at one scale. A travel map is a plan or a regional map: streets, walls and roofs, or land, rivers and roads. Never a vista, a perspective view, or a collage of rooms.
- Draw the ways out into the picture. Say where each one is, so there is something to put the exit on: "stairs up in the north-east corner", "the front door in the middle of the south wall", "a trapdoor behind the bar". On a travel map, say where the four to seven places that matter sit ("the walled town lower left, the ford in the middle").
- Leave the look to the art direction. The world's art direction and the location type's style are added for you (setting a world's image style). Say what is in the map, not how it is painted, and don't ask for a grid: the map's own grid is laid over the picture.
- Keep or redo. A picture that already fits stays: build on what it shows. Make a new one when the map has none, when it is the wrong kind (a vista for a tavern's interior, a town plan for one room), or when the user asks. A new picture leaves pins, exits, walls and terrain where they were, so check each against it.
When a map gets a new picture, its features are worked out in about a minute: read the map again before placing anything on it.
3. Mark the ways out
The GM moves the party along a map's exits and its linked locations (map exits, linked locations). Every scene map needs at least one way out, or the party is stuck.
- An exit where the picture draws one. A door, a staircase, a gate, a ladder, a trapdoor, a road off the edge: put a pin or an area on it and make it an exit to the place it leads to. An exit is never linked to a location. The inn's stairs lead to its upper floor; the front door leads out to the street. Use the picture's features to find the spot. To set it, use the Exit switch in the pin's or area's panel.
- Both sides of each door. Pair an exit with the spot it comes out at on the other map, so the party arrives at the bottom of the stairs, not in the middle of the room: pick the spot in Arrives at, or click empty space there for a new pin, and leave Leads back here on.
- Named for where it sits. "Stairs Up", "South Door", never the place behind it: players see the labels.
- One way per door. A door or stairs made an exit is the way between the two places: don't also keep a linked location saying the same way. If you linked the two places with that way before you made the exit, take the way off the link. Keep the place's inside link.
- A pin holds a place. The inn pinned on the town's map is in the town. A part with no pin (a floor, a cellar) needs its inside link.
- Ways back. Pair each exit with its spot on the other map; when that place has no map yet, give it a way back in the same go.
- The place behind an exit isn't drawn here too. The inn's upper floor is reached by its stairs, so it gets no pin on the inn's map.
- No clear way out in the picture? Link the locations. When the picture draws no door or road to put an exit on, or the way isn't a spot (the path on to the next village, a dream back to the waking world), link the two places as linked locations with the way between them. The GM reads it as where the next scene usually goes, and moves the party there when they leave: click Add Linked Location and answer its three steps: which location, how they are related, and how you get there.
- Travel times on travel maps. On a travel map, the ways between the places pinned on it are roads and routes: give them a distance or a time when the world says how far it is.
4. Give the places on it maps of their own
A building drawn on the map (the inn on the square, the smithy, a hut in a camp, a warehouse on the quay) is somewhere the party can go in: the next level down the tree. On a travel map, the same goes for each town, camp and ruin on it. Make each a nested location:
- A location file for it, inside this place, if the world doesn't have one. A line of what it is and who is there is enough to start.
- An area over the building, linked to that file, labelled with its name. The GM then knows the building is here, how far it is, and that going in moves the scene to it.
- Its inside is its own scene map, drawn when play needs it, the same way as this one. Until then the GM can still play a scene in it.
- Only the buildings that matter. A row of houses nobody visits stays part of the picture.
5. Name the spots that matter
The GM already knows every feature the picture shows. Add an area or a pin only for what the picture doesn't name, or where the story needs a spot of its own: the throne dais, the stage, the ritual circle.
- Name it as players say it. "The Throne Dais", not "Area 3". Each name once per map.
- Only what the scene uses. A handful on a scene map. A map with more than about 50 things on it is hard for the GM to use.
- On a travel map, pin each place where the picture draws it, linked to its location, and check each pin against the picture.
To add or change one, use the Area tool: Polygon (P), Rectangle (U), Circle (C) or Hexagon (X). To add or change one, use the Pin tool (M).
6. Put people where they are
A character's token on a place's map says where they live or work: they are there when the party arrives (putting characters on maps). Put a token for each character who belongs here, on a free square by the spot they use (the barkeep behind the bar), about six or fewer on a scene map. To add or change one, use the Token tool (T).
- Sized by the creature. A Large creature takes 2 by 2 squares, a Huge one 3 by 3, a Gargantuan one 4 by 4.
- Several of one kind are numbered: Goblin 1 to Goblin 4.
- On free floor. Not on a table, a wall, a bar or another token (a bench is not the tabletop). Moving someone moves their token.
7. Check it and report
Read the map again and check:
- It is the kind you meant, with a real scale (and a grid on a scene map).
- Every exit leads to a place that exists, and each door's other side comes out at a spot.
- A scene map has a way out: an exit or a linked location.
- Exits, areas and pins sit on what the picture draws there.
- Each building or place on it that play will go into is a place of its own, linked here, with a scene map or one still to make (say which).
Then tell the user what the map has now, in a few lines: its kind and scale, the picture, the ways out and where they lead, and what you left for them (a picture still being drawn, a place behind an exit that doesn't exist yet). Offer the next map, if there is one. Say where things are as the user sees the map: by what the picture draws there and its squares ("by the hearth, G4"), never raw numbers or setting names. Say only what you checked: a size or a count you didn't read back is a guess.