How to Create a Custom Hansa Teutonica Map: A Beginner’s Guide

A step-by-step walkthrough of the map editor on playhansa.app, using a space-themed demo board that took me about 30 minutes to build.

The Astral League board with ten destinations, trading posts, route spaces, upgrade scrolls and scoring tracks.
The Astral League: familiar trading decisions, a very different sky.

You can make your own Hansa Teutonica map on playhansa.app: upload a board image, place cities, draw routes, add upgrades, validate it, test it against a computer opponent, and submit it for review. This guide covers each step in the online map editor. It's for the digital game, not a printable board.

To show it, I built a demo board called The Astral League: ten planets joined by trade routes, against a starfield background. It's here to teach the editor and isn't headed for the community map list. The demo took about 30 minutes to build. Give yourself more time for your first map, especially if you're creating the artwork and working out the layout as you go.

01Plan your custom Hansa Teutonica map layout

Start with circles and lines. The artwork can come later.

The Astral League has ten locations: Sol, Altair, Vega, Deneb, Nova, Rigel, Orion, Sirius, Lyra and Polaris. I spread them irregularly so some journeys are long and some are short, with Rigel and Orion acting as links between parts of the network.

Before placing anything, decide where you want players to compete, and make sure a blocked route always leaves another way across. Treat the first layout as a draft; you'll see what's wrong with it once you play on it.

Not sure what to map? A real region, your home town, a fantasy continent or a fictional galaxy all make good boards. Whatever the theme, you'll be building the same things: cities, routes, upgrades and a few starting bonuses.

02Prepare your board artwork

Your uploaded image is the background. Cities, trading posts, route spaces, upgrades and bonus slots are added in the editor. A line in the artwork looks like a route, but the game still needs to know which cities it connects and where pieces can sit.

The Astral League background is AI-generated, and you can use it to follow along or for your own map. It's already sized for a landscape board.

The Astral League background with ten planets and thin lavender paths, before adding playable elements.
Before: a background image and an idea.
The same background with playable posts, routes, scrolls and tracks added.
After: the playable board.

Get the image size right

Required dimensions for custom map backgrounds
FormatImage dimensions
Landscape3912 × 2720 pixels
Portrait3912 pixels high, 2726–2755 pixels wide

Keep uploads within 15 MB. Images must match the chosen format; they aren’t automatically resized to fit.

Leave space around cities for posts and pieces. Keep the edges clear for the VP track and the upper-left area clear for the default completed-cities track. The editor can draw both overlays for you.

If you make your own artwork, use images you own or have permission to use and share. A scan of a commercial board isn’t suitable for submission.

03Create your map in the editor

  1. Open playhansa.app in a desktop browser and sign in.
  2. Open your profile menu and choose My Maps.
  3. Select + New map, enter The Astral League, and choose Landscape.
  4. Create the map, then select Upload board image and choose your background.
My Maps empty state with the Create your first map heading and New map button.
Your first map is included on the free plan.
New map dialog with The Astral League entered and Landscape selected.
Name your map and choose its board format.

The tools sit on the left, the board occupies the centre, and the inspector and rules settings sit on the right. Use Select / move to select and reposition elements.

Map editor after uploading the Astral League background, with tools at left and inspector at right.
Artwork uploaded. Now define the places where the game can happen.

04Add cities and trading posts

They’re trading stations in our story, but they’re still cities in the editor and follow the familiar game rules.

  1. Choose City and click at Sol’s position.
  2. Name it Sol.
  3. Choose Select / move, select Sol, and configure its trading posts in the inspector.

In this early step, Sol has two cube-shaped posts: white, then orange. Set each post’s privilege colour and piece shape independently. The + Post control adds another space; the arrows change their order.

Sol selected on the board, with a white cube post followed by an orange cube post.
Start with Sol and two trading posts.
Sol inspector showing two trading posts with colour options, shape controls and order arrows.
Set privilege colour and piece shape in the inspector.

I added the other nine the same way, varying the posts as I went. A merchant-only space or a higher privilege requirement changes when a city is worth taking. I'm not listing every city's posts: look at the finished board above and copy what you like, or better, invent your own. Leave room around each city for its row of posts and its label, and use Undo and Redo freely.

05Connect your cities with routes

Begin with Sol → Altair:

  1. Choose Route.
  2. Click Sol, then Altair.
  3. Click along the path to place three connection points, working from Sol toward Altair.
  4. Select Finish route.
Route tool active with three connection points placed between Sol and Altair and Finish route available.
Click the endpoints, place the spaces, then finish the route.

Connection points are the spaces players occupy. You must place them even when the background already contains a line between the cities.

Do the same for the rest of the network. Every city needs at least one route, and the whole network must be connected. Vary route lengths and piece requirements instead of making every connection match the first.

All ten Astral League cities connected with playable route spaces, before adding upgrades.
The connected network, ready for upgrades and bonus slots.

06Add upgrades, bonus slots and board rules

Give players a reason to travel

Choose Upgrade scroll, select an ability and its city, then drag a rectangle for its clickable area. For the first scroll, choose Actions at Sol.

Actions upgrade selected at Sol with ability and city controls and its clickable rectangle visible.
Choose an ability and city, then draw the upgrade’s clickable area.

The example board uses this assignment. Place exactly one scroll for each of the five abilities:

CityUpgrade
SolActions
VegaBook of knowledge
NovaBank
OrionCity keys
LyraPrivilege

The editor draws the standard scroll illustrations over your background, so leave room for them and keep each clickable rectangle clear of posts and route spaces. If your artwork already includes its own scrolls, you can line the rectangles up with those instead.

Add three starting bonus slots

Choose Starting bonus slot and place a slot on a route. You need three slots on three distinct routes. Our example uses Sol–Altair, Vega–Deneb and Lyra–Polaris. Drag the white handle to adjust a slot’s rotation.

A starting bonus slot placed below the route between Lyra and Polaris.
The third slot completes the required set on three distinct routes.

Set the rules for your first test

  • Player counts: 2 only.
  • Completed cities to end the game: 5.
  • Special prestige city: off.
  • East–west route bonus: off.
  • Victory-point track: on.
  • Completed-cities track: on.

These suit a compact ten-city board. Custom maps can support 2–5 players, but only enable a count once you've played it.

The completed-city setting controls that particular ending condition; it doesn’t replace the other normal game endings.

Check that the track overlays sit well on your artwork, and use Move tracks to nudge them. If you painted the tracks into your image, turn the overlays off.

Rules panel with two players selected, five completed cities to end, optional bonuses off and both track overlays on.
The settings used for the first two-player test.

07Validate and test your custom map

Select Validate map and read the results. Errors identify required fixes before testing or submission. Warnings highlight issues worth inspecting.

This is the one thing validation caught on my board: I'd placed only two starting bonus slots, and it asked for a third. Adding it on another route cleared the error.

Validation error reading Exactly 3 starting bonus slots are required, found 2, with a density warning below.
Before: one more starting bonus slot is required.
Green Local checks passed result with four warnings still reported.
After: the blocking error is resolved. Warnings still need attention.

Green doesn't mean silent: four warnings remain. These screenshots were taken while the map was still set to five players, so the density warning refers to that setting; after changing player counts, validate again. A small network like this one may be too sparse for five.

See it with pieces on the board

Open Preview to check how posts, tracks, markers and sample pieces sit on your image. Turn Overlay off to hide the editor’s city outlines and labels for a cleaner view.

Then select Test play, choose 2 players and Easy computer difficulty, and start a private test game. I only played enough turns on The Astral League to check that everything displayed and worked, but for a map you plan to release, play it properly.

Test play dialog with two players and Easy computer difficulty selected.
Start a private, unranked game against a computer opponent.
An actual two-player test game on The Astral League with pieces placed on routes.
Play the board as well as inspecting it. Notice what is clear, crowded or overlooked.

While you play, watch the board as well as your moves. Can you tell the pieces from the background? Are posts, route spaces and upgrades easy to click? Is there a sensible alternative when someone takes your preferred route? Change one thing at a time, then test again. Games against people will turn up problems the computer won't.

08Submit your map for community review

This last step is optional. I went through it to capture the screens, but The Astral League is a teaching example and I'm not releasing it. When you have a map you're happy with, and have played the player counts it supports, select Submit for review.

Confirm that you own the image rights or have permission to use it, and that it isn’t a scan of a commercial board. You can leave an optional note for the reviewer, including where the artwork comes from.

Submit for review dialog with image rights confirmed and an optional note for the reviewer.
Confirm your image rights and add any useful context for the reviewer.

Submitting freezes your draft while it's reviewed. You can withdraw it if you need to make changes.

My Maps card for The Astral League marked In review with Edit map and Withdraw controls.
Waiting for review, with Withdraw available.

Check My Maps for the status and review feedback. If changes are requested, revise and submit again. Once approved, your board becomes available in the community map picker, where signed-in players can choose it for games with friends or computer opponents.

That's the whole process. If you build something, I'd like to see it.

Custom map questions

Do I need Premium to create a custom map?

No. A free account covers creating, testing and submitting one custom map. Premium lets you create more.

Can I create maps on my phone?

Creation and editing require a desktop browser. Playing approved community maps is available on supported mobile app versions.

Can custom maps support two players?

Yes. Creators can choose supported counts from two to five. Each board specifies its own supported counts, which should be tested before submission.

Why can’t I start a test game?

Upload a board image, fix blocking validation errors, and resolve save errors. Warnings can remain, but read them before proceeding.

What if my background image won’t upload?

Check its dimensions against the chosen template and keep the file within 15 MB. Landscape images must be exactly 3912 × 2720 pixels.

Do players need Premium to play my approved map?

No. Playing approved community maps is free with an account.

Can I put the victory-point track and upgrade scrolls in my own artwork?

Yes. You can paint them into your board image and turn the editor's overlays off or line them up. Token images, bonus-marker images and the names of non-city elements can't be replaced yet.

Can I use AI-generated artwork?

The Astral League background is AI-generated. Whatever you use, you must own it or have permission to use and share it, and it can't be a scan of a commercial board.

New to the game itself? Start with the Learn to Play page or the beginner’s walkthrough. For ideas to consider while testing, explore the illustrated strategy guide.

Ready to try it?

Build your own Hansa Teutonica map

One map is free with an account. You'll need a desktop browser.

Create Your First Map