Set up once

City Mapper

Teach Evonex where every building in your city stands, so tasks can walk to it.

Where

Open City Mapper.

Use it to

Map each city once, so tasks can walk to a building and tap it.

You need

An open emulator with the game running, set to 540x960.

Evonex finds a building by looking at your city on the screen. City Mapper is where it learns where each building stands. You map a city once. After that, every task that visits a building walks there on its own and taps it — the Keep, the Tavern, the Walls and more.

123456789123456789123456789

1. 1Map by hand Starts a new map that you build yourself, building by building.
2. 2Auto map Maps the cities on your open emulators for you.
3. 3Summary Counts your maps, and how many are ready or need you.
4. 4All · Ready · Needs attention Shows every map, only the ready ones, or only the ones that need you.
5. 5Search maps or emulators Finds a map by its name, its emulator or an instance that uses it.
6. 6Sort Orders the maps by Name or by Last mapped.
7. 7Select Lets you tick several maps to scan or delete them together.
8. 8A ready map Shows its emulator and the instances that use it. Click the card to open the map. A map with no emulator yet reads Not linked on this PC, with a Link button to pick one.
9. 9⋯ Opens the map’s menu: Open, Auto map, Map by hand, Link…, Rename, Delete and Select.

A map holds one city. It is linked to one emulator on this PC, and every instance on that emulator uses it by itself. You have nothing to assign.

• The ring counts the ready buildings. Green means every building Evonex needs is ready. Orange means some are. Empty means none. Blue and turning means a scan is mapping the city.
• The emulator line says where the map lives. MuMu #0 · open · 16448 is an emulator that is open, with its port. Not linked on this PC · Link means no emulator is chosen yet.
• Under it you see the instances on this PC that use the map, or No instance uses it.
• The foot says when the map was last mapped, or what is missing — for example Research Factory missing.

Map your cities with Auto map

Auto map reads each city from the game’s own pictures of its buildings. It zooms the city out and slides it around, but it taps nothing. This is the fastest way to map, so start here.

1. Start your emulators. Open the game on every city you want to map. Set each emulator to 540x960.
2. Open City Mapper and click Auto map.
3. Tick the emulators to scan. The ones under NO CITY MAP YET are ticked for you. Tick one under HAVE A MAP to update its map.
4. Check the PREVIEW. Each ticked emulator becomes a New map. Click a name to change it.
5. Click Scan 3 emulators. The number is how many you ticked. Nothing starts until you press it, and every ticked city is read at the same time.
6. When the run ends, open a map and check its tiles.

123456789101234567891012345678910

1. 1Open Lists the emulators that are open on this PC. Tick the ones to scan.
2. 2NO CITY MAP YET Groups the open emulators that have no map. They start ticked.
3. 3HAVE A MAP Groups the emulators whose city already has a map. Tick one to update that map.
4. 4STOPPED Shows emulators that are off. Start one to scan it.
5. 5Rescan Looks for open emulators again.
6. 6Name new maps after Chooses how new maps are named. Click a name in the table to type your own.
7. 7New map Shows what an emulator becomes: a new map, or an update of the map it already has.
8. 8Buildings: Change Opens the list of buildings every city needs. Recommended is 15 buildings.
9. 9Scan Chooses how much to map: Only what's missing or Everything again.
10. 10Scan 3 emulators Starts the run. The button counts the emulators you ticked.

While it runs, a bar above your maps counts the cities, like Scanning 4 cities · 1 ready · 2 mapping · 1 waiting. It has Stop all and Details ▾. A map fills in while its city is still being read.

Each city ends ready, incomplete (a building was not found), failed or stopped. On an incomplete city, Retry and Map by hand wait on its row.

• Auto map places only what it recognises clearly. A building it cannot see is reported as not found and left unplaced. It never guesses.
• After every scan it checks the whole map. It looks for each building where the map has it, and taps nothing. A building it cannot see there reads Not seen in last scan.
• Only open emulators can be scanned. A busy emulator, where an instance runs, waits until it is free.

If Auto map says no

Auto map checks the emulator before it starts. It can stop with one of these messages:

• “Emulator must run at 540x960 (540p) …” — Auto map reads the city at one size only. Set the emulator’s resolution to 540x960, then try again. Emulator setup has the settings Evonex expects.
• “This emulator can't pinch to zoom out …” — Auto map reads the city fully zoomed out, and it zooms by pinching. Scan with an emulator that can pinch, or place the buildings with Map by hand.
• “Couldn't get the game to its city view — open the city and try again” — Evonex tries to open your city itself. If the game is stuck somewhere else, open the city yourself, then press Scan again.

Check a map

Click a card to open its map. A map opens at once, even when its emulator is off or the map is not linked on this PC. The page only talks to an emulator while Map by hand or an Auto map run is working.

123456789101234567891012345678910

1. 1City Mapper Goes back to every map.
2. 2The map’s name Rename the map by clicking its name. Press Enter to save.
3. 3Emulator chip Shows the emulator this map is linked to. Click it to link or relink.
4. 4Used by Lists the instances that use this map.
5. 5Auto map ▾ Scans this map: Only what's missing, Everything again or Check all buildings, which changes nothing.
6. 6Map by hand Switches this page to Map by hand.
7. 7Buildings to map · Change Opens the list of buildings this map must have ready.
8. 8A Placed tile Has a spot and a picture, but is not tested yet.
9. 9A selected tile Reads Not seen in last scan. Click a tile to select it.
10. 10Scan this building Scans only the selected building. Ctrl+click more tiles to scan them together.

A map has a tile for each of the 30 buildings it can hold. The first tiles are the buildings Evonex needs — Buildings to map. The rest are marked extra. A map is ready when every needed building is ready. Each tile shows one of these states:

Change, next to Buildings to map, opens a checklist. Recommended goes back to the 15. A map’s ring, its ready count and its Needs attention label are measured against this list. A task only ever needs its own buildings.

A small bin on a tile is Clear. It removes that building’s spot and your own pictures, after it asks. A hand mark means you placed the building yourself. A new scan keeps it, unless you tick Redo them too.

Place a building by hand

Use Map by hand for a building Auto map could not find, or when you want a picture of your own. You click the building on the live city, and Evonex remembers the spot. Art is the picture of a building that Evonex looks for on the screen.

1. Open the map and click Map by hand. To start a new map instead, click Map by hand on the library, pick the open emulator, give the map a name and click Create.
2. In the emulator, open your city and zoom it all the way out.
3. Pick a building in the list. Its card says what comes next, and one big button does it.
4. Place pin: click the building on the live city.
5. Capture art: drag a box around the building. A building the app already has a picture of needs no capture of your own.
6. Test: go to it: Evonex walks to the building and opens it.
7. Mark ready. When you are finished, click Done.

123456789101234567891012345678910

1. 1Re-align Finds where the live view is on your city and lines every pin up with it.
2. 2Live | Frame Shows the live screen under the pins, or only its outline.
3. 3100% Shows the zoom. Click it to go back to the live view.
4. 4Pad Shows or hides the swipe pad.
5. 5Move the city here or in the emulator Reminds you that the map follows the emulator, whichever you move.
6. 6The swipe pad Moves the city in eight directions. The middle button swipes to the spot you click next.
7. 7Search buildings Finds a building in the list.
8. 8The building list Shows each building with three dots: pin, art and test.
9. 9The big button Does the next step for the selected building. Here it is Test: go to it.
10. 10Art and navigation Opens each picture with its own delete, Add another art state, Go to and Navigate by this art.

• A building the live screen shows, but your map lacks, wears a + on the city and + on screen in the list. Click Add it here and it is ready at once. An Undo button shows while the building is as the click left it.
• Move the city with the pad, the arrow keys, or the emulator itself. The map follows, and Re-align finds your place again from anywhere in the city.
• Navigate by this art lets Evonex use a building’s picture to tell where the view is. The Keep always does. Turn it off for a picture that repeats around the city.
• If the picture is weak or looks like another building, the big button sends you back to Capture art. If the test opens something else, it asks you to move the pin.

A map lives on its emulator

Each map is linked to an emulator on this PC, or to a port. Every instance on that emulator uses that map by itself. Auto map links the maps it makes. Map by hand links the map you create. You can change a link at any time.

• Not linked on this PC · Link — the map has no emulator here. Maps made on another PC arrive like this: the buildings and pictures sync, the link does not. Click Link and pick the emulator. One click links it, and a message offers Undo. Several maps to link? Click Link them above the cards.
• not found on this PC · Relink — the emulator is gone. Click Relink and pick the one the city is on.
• Port — for an emulator Evonex can’t name. Type its address, like 127.0.0.1:16448, and press Enter.
• Unlink — takes the link away. The map and its buildings stay.

Two maps on one emulator? Evonex never guesses, so the instance’s City map cell reads Choose…. An instance that drives another city on the same emulator picks its map by name instead. Do it in the Instance Manager, column City map, or in Instance settings ▸ City map. The default is Follows its emulator. A change counts from the instance’s next trip into the city.

Rename, delete or act on several maps

• Rename: click the name on a map’s page, or choose ⋯ ▸ Rename. A name must be unique, so a taken name becomes “City map 1 (2)”. Every instance that chose the map by name follows the new name.
• Delete: choose ⋯ ▸ Delete. It asks first and tells you who loses the map. An instance that chose the map by name then shows Missing. One that follows its emulator is left with no map. A message offers Undo, and nothing is removed until it goes away, after a few seconds.
• Several maps: click Select, press and hold on a card, or press Ctrl+A. Tick the maps. A bar then offers Select ▴ to tick a group, Auto map ▴ to scan the ticked maps in one run, and Delete. Esc ends select mode.

When your city changes culture

A map fits the culture your city had when it was mapped, such as Japan or Korea. If you change the culture in the game, a task that walks to a building notices. It maps the city again by itself, taps nothing, and carries on. That takes about a minute. If it cannot, it tells you to run Auto map on that emulator.

What tasks use the map for

A task that walks to a building needs that building to be Ready on its instance’s map. Until it is, the readiness check says what is missing and Start stays blocked. Recommended is a list of 15 buildings. These are the buildings, and the tasks that use them:

Problems?