01Step by step
Getting started
- Download. For the Ultimate 64 or Ultimate-II+, hanse.prg is all you need. The package also has the VICE version and a printable guide (README in LIESMICH.txt).
- Start. The Ultimate needs a network connection (LAN or Wi-Fi). Run hanse.prg from the Ultimate file browser – or load it from USB/SD and type RUN. The C64 connects to the game server by itself.
- Choose a language. D for German, E for English. You can switch any time later in the menu.
- Create an account. 2 for a new account. A name of 3 to 8 characters (A–Z, 0–9, starting with a letter) and a 6-digit PIN, twice. Next time, press 1 to log in. RUN/STOP goes back one step.
- Off you go. You stand below the fountain at the market, with 100 gold in your pocket. Klaas will greet you. Good first steps: buy a frying pan at the general store, beat up the straw dummy on the training ground, ask Fiete for work at the harbour.
Don’t use your bank card PIN or any PIN you already use elsewhere. Only a check value is stored, but a PIN of its own is still better.
What you need
| Machine | Program | Music | Note |
|---|
| Ultimate 64 / Ultimate 64-II | hanse.prg | yes | network on; “Command Interface” enabled |
| C64 with Ultimate-II+ | hanse.prg | yes (PAL) | as above |
| VICE 3.x | hanse-swiftlink.prg | no | SwiftLink settings see below |
| Commodore 64 Ultimate (C64U) | hanse.prg | ? | not tested yet – let us know! |
| MERIDIAN 816 (MiSTer) | HANSE.MER | yes | core from 30 Oct 2026, network service 2.2 or later – see below |
Plus a joystick in port 2 – or just the cursor keys. The C64 plays the music itself; that only works on PAL machines and not via SwiftLink. Without music you only miss the quiz and SID guessing, everything else works.
VICE with SwiftLink
Start VICE with this line, then load hanse-swiftlink.prg:
x64sc -acia1 -acia1base 0xDE00 -acia1irq 1 -acia1mode 1 -myaciadev 0 \
-rsdev1 retro-modern.net:6464 +rsdev1ip232 hanse-swiftlink.prg
In the settings that means: ACIA at $DE00, interrupt NMI, mode SwiftLink, RS232 device 1 = retro-modern.net:6464, IP232 off.
On the MERIDIAN 816
On the MERIDIAN on the MiSTer you play in the same town as on the C64 – with the same people, the same accounts and the same chat. The server sends the MERIDIAN tiles of its own: 16 colours per tile instead of four and twice as fine, with day and night, glowing lanterns and glittering water. The characters cast shadows.
- Prepare. You need the MERIDIAN core ↗ from 30 Oct 2026 or later and the network service version 2.2 or later – it connects to the game server and plays the music. If yours is older: unzip the new package over the old one and restart the MiSTer.
- Load. Put HANSE.MER into
games/MERIDIAN/ on the SD card and load it in the OSD with Load program. The game starts by itself.
- Log in as on the C64: D or E, then 1 to log in or 2 for a new account. An account from the C64 works here too. Esc goes back one step.
Walk with the joystick or the arrow keys, interact with Fire or F1, Esc goes back in windows – everything else as in the controls below. The music comes from SID JAM as on the C64; on the MERIDIAN the network service plays it with reSID, like “Original” in SID JAM. You can switch it off in the menu.
02Joystick and keyboard
Controls
| What | How |
|---|
| Walk | Joystick or cursor keys, diagonals too. Walk into a door to enter. |
| Interact | Fire or F1 next to a person, a sign, the dummy, the water … |
| Your menu | Fire on an empty spot |
| Talk | Just type, RETURN sends. Up to 50 characters, everyone can read it. |
| In windows | up/down picks, Fire or RETURN takes, left or RUN/STOP goes back, 1–9 picks directly |
| Entering numbers | up/down ±1, left/right ±10 |
The menu “Your pouch”
- Stats and gear – strength, dexterity, stamina, hit points, gold, rank, reputation, what you wear
- Backpack – equip and unequip items (8 slots)
- Who’s here? – who is playing and where; you can ignore someone here
- Chat history – the last 30 lines
- Mailbox – letters, e.g. when your caravan is back
- Language, music on/off, In the web cinema: shown/hidden
Fighting
Fights go in rounds. Both secretly choose ATTACK, BLOCK or FEINT: block beats attack, attack beats feint, feint beats block. If both attack, both hit. Whoever doesn’t choose hesitates – does nothing and loses to everything; hesitate twice and you give up. You have 6 seconds to choose.
Damage = 1 + strength÷3 + weapon + a little luck − the opponent’s armour, at least 1. More dexterity than your opponent means dodging more often (up to 30 %).
If the connection drops, the C64 logs back in by itself – after 2, 5, 10, then 30 seconds. RUN/STOP cancels that.
03Who does what where
Lübyte
| Place | Who | What you do there |
|---|
| Market with fountain | Klaas | Market crier. Fire on him: all daily prices, tax, toll and when the council meets. Ask “KLAAS, …” in chat. |
| General store | Knut | Buy weapons, armour and lucky charms, sell them back at half price |
| Blacksmith | Hinnerk | Improve items, +1 to +7 |
| Scholar’s study | Magister Kurbelwitz | The Aetherophone: what’s on SID JAM, change the cylinder, request a tune |
| Town hall | the council | Buy a rank, run for office, taxes, town projects, ledger |
| Church | | Prayer, donations – first for the consecration, then for church projects; letter of indulgence |
| Houses (14) | | Buy a room of your own |
| Workshops (11) | | Lease a weaving mill, smokehouse or brewery |
| Training ground | | Three straw dummies to beat up |
| Arena (gate in the training ground’s south fence) | Dietmar | Duels for honour and gold, hall of fame |
| Trading house (warehouse at the harbour) | | Buy raw goods, sell finished goods, send caravans |
| Harbour, quay and pier | Fiete | Haul crates, catch herring, deliver letters, find gull coins |
| Tavern “Zum Krummen Kiel” (green gabled house at the harbour) | Gesche | Dice cup, hangman, SID guessing, word game – alone or against each other |
Klaas and Fiete answer when you address them in chat (“FIETE, HOW IS THE WEATHER?”). Klaas calls out news: new prices, candidacies, election results, duels, lucky winners at the tavern, successful smithing, the next tune on the radio. Whether he names you is up to the cinema switch in your menu.
Harbour life
| Event | how often | what happens |
|---|
| A cog docks | every 40–80 min, never at night, for 15 min | carry crates to the trading house |
| Thunderstorm | every 2½–6 h, 4 min | lightning – and the herring bite better |
| Fog | every 3–7 h, 8 min | everything grey |
| Flock of gulls | every 1–2½ h, 6 min | more gull coins |
Everyone starts the same: strength 5, dexterity 5, stamina 5, so 20 hit points (10 + 2 × stamina), and 100 gold. Base stats never rise – you only get stronger through gear. You wear one weapon, one piece of armour and one lucky charm.
| Type | Item (value · price in gold) |
|---|
| Weapons | Wooden Spoon (1 · 10), Rusty Frying Pan (2 · 35), Cod on a Stick (3 · 80), Big Cheese Knife (4 · 150), Folding Halberd (6 · 400), Joystick of Wrath (8 · 900) |
| Armour | Potato Sack (1 · 12), Leather Apron (2 · 40), Cooking Pot Helmet (3 · 90), Chainmail, pre-owned (4 · 200), Plate Armour XXL (6 · 500) |
| Lucky charms | Rubber Chicken of Courage (strength +1 · 60), Datasette of Wisdom (dexterity +1 · 60), Lucky Herring (stamina +1 · 60), Enchanted Pork Roll (strength +2 · 250), 5¼-inch Warding Disk (dexterity +2 · 250) |
At the blacksmith
Hinnerk improves items from your backpack up to +7. Weapons and armour get 1 better per level, lucky charms at +1, +3, +5 and +7. Up to +3 it always works, then it gets tight: +4 at 80 %, +5 at 65 %, +6 at 50 %, +7 at 35 %. If it fails, the gold is gone, and from +4 the item drops back a level – but nothing breaks. Whoever makes +7 is announced all over town.
Costs rise with every level – taking the Wooden Spoon to +7 costs 882 gold in total, the Joystick of Wrath 2,254. Knut only pays half the base price when you sell, not the smithing levels.
Gold comes in three ways: from work with a fixed wage (with daily limits, so nobody does nothing but haul crates), from trading and workshops (fluctuating prices) and from games against others. The game day ends at midnight German time.
| Work | Pay | per day at most |
|---|
| Beat the straw dummy (training ground) | 5 | 10 wins · 50 gold |
| Carry a crate from the cog to the trading house | 3 | 8 crates · 24 gold |
| Catch herring (fire on the pier towards the water) | 2 | 8 catches · 16 gold |
| Deliver a letter from Fiete (to Knut, Hinnerk or Gesche) | 5 | 3 letters · 15 gold |
| Gull coin (found by chance on quay and pier) | 1 | 3 coins |
| Hangman alone (tavern) | 5 | 10 words · 50 gold |
| SID guessing alone (tavern, music only) | 3 | 20 hits · 60 gold |
| Radio quiz (2 points title, 1 point composer) | 10 per point | 60 |
| Council seat | 10 a day | |
| Office (mayor 30) | 20 a day | |
Tips: the straw dummy loves to attack – Fiete advises “ALWAYS BLOCK!”. Herring bite better in a thunderstorm. You lose a crate or letter if you leave the game before delivering it.
If you want more than day wages, lease a workshop. There are three chains: wool → cloth (weaving mill), herring → smoked herring (smokehouse), barley → small beer (brewery). You buy raw goods at the trading house, the workshop processes them – even while your C64 is off – and you sell the finished goods back at the trading house.
| Level | pieces per hour | storage | wages per day | upgrade |
|---|
| 1 | 1 | 36 | 0 | – |
| 2 | 2 | 72 | 20 | 600 |
| 3 | 3 | 108 | 45 | 1 500 |
- Lease 15 gold a day, in advance. The first week is lease-free once. Citizens can also buy a workshop for 800 gold.
- Newcomers can run one workshop, citizens two, merchants three.
- If you lack the gold for costs, the workshop stands still; after 14 days of debt the lease ends.
- Trading prices are shared by everyone and change daily – depending on what all players produce and sell, between half and double the base price. Sales pay the market tax set by the chamberlain.
Caravans
At the trading house you send a caravan with up to 20 pieces of one good – no workshop needed. It returns by itself, result by letter. The further, the better the price, but also the more pirates on the way. Each town especially wants one good every day (+20 %) and has a surplus of another (−20 %).
| Destination | Duration | pays of base price | pirate risk | travel fee |
|---|
| Hamborg | 10 min | 105 % | 3 % | 5 |
| Visby | 30 min | 115 % | 8 % | 15 |
| Nowgorod | 90 min | 130 % | 15 % | 30 |
A raid costs half the cargo. The harbour toll set by the harbourmaster is deducted from the proceeds.
07For honour or gold
Duels & games
Arena
In the ring, stand next to someone and press fire; they have 30 seconds to accept. Anyone may fight for honour. Citizens with accounts at least a day old can fight for gold (10 to 250) – the stakes are held safely by the arena, the winner gets the pot minus a 10 % arena fee for the town treasury. Gold duels start on 11 November. At most 3 duels per pair and day.
Tavern
- Dice cup against Gesche: stake 5 to 50, three dice, one reroll. Three of a kind beats straight beats pair beats points – Gesche wins ties. Win double, three sixes pay fivefold. (The landlady wins a little in the long run. Of course.)
- Hangman alone or for two
- SID guessing: a 15-second sample, who composed it? Alone or as a race for two (music only)
- Dice for two
- Word game for 2 to 6: one letter, four silly questions, 60 seconds. An answer nobody else has scores 10 points.
Games against others are for honour or for 5 to 50 gold; 10 % goes to the town as a tavern fee. As with duels, there are daily limits on winnings so nobody empties the town in one evening.
08From newcomer to mayor
Rank, council & offices
Reputation and rank
You gain reputation by praying in church or sleeping in your own bed (+1 a day each), by donating (+1 per 20 gold, at most +5 a day), from a running workshop (+1) and from council work. Stay away for more than 14 days and you slowly lose some again. With enough reputation, buy a higher rank at the town hall:
| Rank | Fee | Reputation | also |
|---|
| Newcomer | – | – | everyone starts here |
| Citizen | 200 | 20 | own room, account at least 7 days old |
| Merchant | 1 000 | 100 | a workshop at level 2 |
| Pepper sack | 3 000 | 300 | 8 weeks as merchant |
A room costs 300 gold plus 5 gold property tax a week. It comes with a chest with 8 more slots, a bed and a shelf of honours.
The council
The council meets every Sunday at 7 pm (German time). Each session elects one seat and, in turn, one office. At first only old councillors like Albrecht Altgeld or Diederich Datasette sit there – they need convincing first. Running costs 50 gold: for a seat as a citizen with a room, for an office with a council seat and as a merchant (mayor only as a pepper sack).
Councillors vote by reputation, rank and their own tastes – some like the pious, some the rich, some the modest. And by favour: a gift helps. Too many gifts in one week can cause a scandal, though – 20 reputation lost and a two-week ban on running. A letter of indulgence from the church lifts the ban.
| Office | What it does |
|---|
| Chamberlain | sets the market tax at the trading house (0–10 %) |
| Harbourmaster | sets the harbour toll on caravans (0–10 %) |
| Mayor | proposes town projects, requests grants from the treasury, breaks ties |
| Churchwarden | the same for church projects |
An office lasts four weeks and pays 20 gold a day. While a non-player councillor holds it, tax and toll are 5 % each.
Projects
Lübyte grows with its people. First the church consecration is funded – then the nave opens. Next come town projects (colourful market stalls, golden fountain, grand façade, harbour crane) and church projects (stained-glass windows, golden spire, new bell). Finished projects show in town right away; the harbour crane even lets caravans load 30 instead of 20 pieces. Donors go on the benefactors’ board. The treasury fills from taxes, tolls, leases and fees – and the council votes on how much goes into projects.
09The radio in town
Music & cinema
Lübyte listens along to SID JAM. The C64 plays the current tune itself on its SID, the MERIDIAN via the network service with reSID – so you hear the same as people in the browser. You can switch it off in the menu.
- Aetherophone (scholar’s study): shows what’s playing and what’s next. Changing the cylinder currently costs 50 gold and changes the tune for everyone – on the net too. If it can’t be done right now (quiz, closedown …), you get the gold back.
- Request show: currently 100 gold for a requested tune – search, pick from the charts or as a surprise. The request appears on SID JAM with your name and “(Lübyte)”.
- Radio quiz: SID JAM runs a quiz now and then. In the game you guess by typing “?” before your answer in chat – title 2 points, composer 1 point, 10 gold per point.
- Lübyte cinema: on the SID JAM page you can watch the town outdoors live – characters with names, Fiete and Klaas with speech bubbles, a ticker. No in-game chat, no interiors. If you don’t want to be shown, set “In the web cinema: hidden” in the menu.
- Greetings to Lübyte: anyone logged in to the forum can send a greeting from the cinema to the market – it appears for everyone in the game.
10So it’s fun for everyone
Rules & privacy
- No trading between players. Gold and items can’t be handed over. Gold only changes hands through duels and games – with daily limits.
- One account per person. Secondary accounts that only feed a main account may be banned.
- Be nice. Everyone can read the chat. Troublemakers can be ignored, muted or banned.
- The game is fresh. Prices and rules are still being tuned – tell us what you notice.
Stored are your name, a check value of your PIN (not the PIN), language and game progress. Not stored are the chat and IP addresses. Accounts nobody has logged into for 12 months are deleted; on request right away. Everything else is in the privacy policy.
11When something’s wrong
Trouble?
| Message | What to do |
|---|
| “NO ULTIMATE COMMAND INTERFACE” | In the Ultimate menu, under C64 and Cartridge Settings, set Command Interface to Enabled. |
| No connection | Is the Ultimate on the network? Check under Network in the Ultimate menu that it has an IP address. |
| “NEW VERSION: RETRO-MODERN.NET” | Your hanse.prg is too old – download it again here. |
| No music | Music needs a PAL machine with hanse.prg (not the SwiftLink version), or on the MERIDIAN HANSE.MER version 3 and network service 2.2 or later. Does the menu say “MUSIC: ON”? |
| “NO NETWORK SERVICE ON THE MISTER.” (MERIDIAN) | The network service isn’t running or is older than 2.1. Unzip the package from the downloads over the old one and restart the MiSTer. |
| Forgot your PIN | Write via Report a problem – with your character’s name. |
Questions, ideas, favourite item? Head to the forum topic ↗ – or use Report a problem. See you at the market!