Putting characters on maps
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 character has no location field. Their token on a place's map is what puts them there: they join the scene when the party arrives, and are found there when the story looks for them. A world whose characters have no tokens plays with empty rooms. A game start's opening scene is its own, though: a token placed after it was saved doesn't join it, so add the character to the scene too when they should be there as a game opens (game starts). This guide places them where the world's own files say they are, and reports the ones it couldn't place instead of guessing. What a token is and its fields are in map tokens; how maps work is in maps.
1. Decide what the job covers
- One map named: the characters who belong at that place.
- One character named: the one map they belong on.
- "All of them": every character and creature file, against every place that has a map. More than a handful of maps is bulk work: sample two maps, settle the rules below once, then do the rest in batches.
List the places that have a map of their own, the places that use their parent's map, and the places with no map at all. Only the first two can take a token.
2. Find where each character belongs
Take the answer from the files, in this order, and stop at the first that gives one:
- A reference on the character to a location: a home, a post, a workplace, a lair.
- A reference on a location to the character: its staff, its residents, who rules it.
- Text that says it plainly, on either file: "tends the bar at the Gilded Eel", a mention of the character in the place's description.
- A game start that names the character among its people.
A character the files place nowhere stays unplaced: list them in the report and ask. A character two files place in two different spots is a contradiction to report, not to settle. Don't place a character somewhere because it would suit them.
Where the place they belong has no map of its own:
- It uses its parent's map: put the token on the parent's map, at the place's pin or inside its area.
- It has no map and no parent that draws it: leave the character unplaced and say the place needs a map or a pin first.
3. Read each map before placing
- Tokens already there. A character with a linked token on the right map is done. Placing again makes a second copy, which the GM reads as two of them. Move a token that is in the wrong spot; never add another.
- Tokens with a label and no link. A token only puts a character in a place for the GM when it is linked to the character's file. Link the ones whose label matches a file, and report the rest.
- The grid and the scale. On a gridded map, positions are whole squares.
- What is drawn. The areas, the pins, the exits, and the features the picture shows (the bar, the forge, the gate).
4. Pick the spot
- Where they work or live on that map: inside the area, or beside the pin or pictured feature, that the files tie them to. The innkeeper goes behind the bar, the guard at the gate.
- Otherwise somewhere sensible and open in the room or the place's outline, and say in the report that the spot was a choice.
- Never on an exit, on top of another token, or on ground nobody can stand on (terrain and walls).
- Spread a group out. People who share a room each get their own square, close together.
- Look at the picture when you can. Pictures follow their prompt only roughly, so check that the bar is where the area says it is.
5. Place them
- Link every token to the character's or creature's file. Leave the label out so it shows the character's name.
- Several of one creature (four wolves from one file) are several tokens of that file. They become numbered copies; give each its own label only when the world names them.
- Size. Leave the footprint out unless the creature's real size matters and its sheet doesn't give it: the GM sizes a token from the character. A small creature (a cat, a rat) can take ½ or ¼ of a square (tokens).
- Many maps: do one map at a time, all of its tokens in one change.
6. Check and report
Read each changed map again and check that every new token is linked and sits where you meant. Then report, briefly:
- how many tokens were placed, by map;
- which characters already had one;
- which spots were a choice, not something the files said;
- every character left unplaced, with the reason: no place named, two places named, or a place with no map.
Tokens in a world reach new games from the next published version, and a game in progress when its owner syncs.