The game's own Link Play works between Pokopia Native on Windows, Mac, iPhone and Linux, in any mix, up to four players, on the same Wi-Fi or over the internet, and it never touches Nintendo's servers.
Back to the overview.
On this page
- Before you start
- Which versions play together
- What each device can do
- On the same Wi-Fi
- Online rooms: play with a short code
- Over the internet
- Through a VPN
- Interact everywhere (experimental)
- Story co-op (experimental)
- On Windows and Linux: the app's Link Play, and F1
- Good to know
- Known issues
Before you start
- In the game, always pick Link Play → Local connection. That's the one that works between our builds. Online connection in the same menu is Nintendo's own service: here it just goes back to the menu.
- Every device needs the same game version. 1.0.5 and 2.0.1 can't play together.
- Every device needs a matching pokopia-native version (the app's Help shows yours; on a Mac, the builder window's title): the next section has the rules.
- Each player needs their own save. The game refuses a second copy of the same save, so a save copied to a second device can't play with itself.
- The host has reached the point in the game where Link Play opens.
Which versions play together
Different pokopia-native versions can often play together, because the game's network code didn't change. The rules:
- On game version 2.0.1, 1.5.x plays with 1.4.x and 1.3.x, and with 1.2.x and 1.1.x as long as Interact everywhere and Story co-op are off.
- Mods (1.5.0 and newer): mods that change gameplay must be the same on every device, or a player can't join (the message names the mods). Mods that only change the look never matter.
- With Interact everywhere on (and Story co-op off), every device needs 1.2.0 or newer, with it on.
- With Story co-op on, every device needs 1.3.0 or newer, with it on.
- On game version 1.0.5, Interact everywhere and Story co-op need 1.3.3 or newer on every device. (The 1.0.5 dump's title screen says "Ver. 1.0.4": that's the same version.)
- The Linux beta (v1.3.3-linux-beta.5) is built on 1.3.3, so it counts as 1.3.3 here.
When in doubt, update every device to the newest release.
What each device can do
| Device | On the same Wi-Fi | Over the internet | Where you set it up |
|---|---|---|---|
| Windows (1.3.5) | finds hosts by itself | host or visit; the game asks the router to open the port | the app's Link Play, and F1 → Link Play |
| Mac and iPhone (1.3.5) | finds hosts by itself | host (with a port forwarded by hand, or a VPN) or visit | the app's launcher |
| Linux and Steam Deck (beta) | hosts, or joins a host by its address; doesn't find hosts by itself yet | host (with a port forwarded by hand) or visit | the Link Play choice before the game starts |
| Android (beta 3, experimental) | hosts, or joins a host by its address; doesn't find hosts by itself yet | host or visit, with a room code | Back → Link Play in the game |
On the same Wi-Fi
Windows: in the app's Link Play (or Change beside Play on Home), pick Same network, then Play. (Started on its own,
Play Pokopia <version>.exe asks in its own window: Link Play with players on this network.) The first time, Windows Firewall asks whether the game may use networks: allow Private networks. Your network must be
Private too (Settings → Network & internet → your connection → Network profile type: Private): on a Public network Windows keeps the
other devices out, and the game's log says so.
Mac and iPhone: in the launcher (the settings shown before the game starts), turn on Link Play on this network and allow local network access when asked. Leave Internet play off. With Link Play on this network off, the game's Link Play does nothing.
Linux and the Steam Deck: Linux doesn't find hosts on its own network yet. To host, choose "host here" and give the others this computer's address; to visit, choose "join a host on this network by its address" and type the host's address. The Linux guide has the details, including Game Mode on the Steam Deck.
In the game: Link Play → Local connection. One player hosts; the others look for towns, and the host's appears in a few seconds.
Online rooms: play with a short code
New in 1.6.0, on Windows. The host gets a short code such as KQ7M-2XHF; friends type it and join. There are no addresses, no router
settings and no port forwarding.
- Host: F1 → Link Play → Host online in the game (or Host online in the app's Link Play). Your code shows there, with Copy. Only people with the code find your room.
- The room list (optional): turn on In the room list (in the app: Show in the room list) and your room also appears in Open rooms, under a made-up name such as "Cedar Spring 3834". Anyone who sees it there can join, not only your friends. It lasts for this session only: the next time you host, the room starts unlisted again.
- Visitors: F1 → Link Play → Join with a code, type the code (or pick a room in Open rooms). It says "Room found" when it has it.
- Then in the game, everyone: Link Play → Local connection. The host invites others to visit; visitors look for towns.
Behind it:
- A small room service turns the code into the room. It only ever sees a scrambled form of the code and a sealed note that only someone with the code can open.
- The game itself runs through a relay: Recompia's public relay, which its makers let us use (thank you, Recompia). Its program is a port of our own relay tool, so the two speak the same language.
- Everything the players send each other is encrypted end to end (except in cross-play rooms, below). The relay sees only how much is sent and when, never what. Like any server it sees your internet address, and Recompia's relay keeps a log of addresses.
- If something goes wrong, the page says it in plain words: "No room with that code: check it, or ask for a new one.", "That room is full", "That room plays game 1.0.5", "That room has different mods on", "Couldn't reach the room service: check the internet connection."
Cross-play with Recompia players
New in 1.6.3, on Windows. Recompia's players host and find rooms in a list kept by Recompia's relay, without codes. Pokopia Native can show that list and put a room in it, so the two can play together over the internet.
- Joining one of their rooms: Open rooms (F1, or the app's Join with a code) also shows the rooms in Recompia's list, marked via Recompia's relay: public, not encrypted. Pick one, then Link Play → Local connection as usual. Rooms with another game version or other mods are greyed.
- Letting Recompia players join yours: when hosting online, turn on In the room list (in the app: Show in the room list). Cross-play is on by default, so your room then goes in Recompia's list instead of ours. The room list lasts for this session only; Cross-play stays as you set it (F1 → Link Play → Host online, or the app's Cross-play switch).
- What that means: a room in Recompia's list is public and not encrypted. The list shows its code and the game's own room details, which include your in-game name. Anyone who reads the list can join it, and the relay (or anyone who read the list) could read what the game sends, because Recompia's builds don't speak our encryption. Friends you give the code to join it the same way. The game's own Link Code doesn't make such a room private. If you want a listed room that stays encrypted, turn Cross-play off: it then goes in our own room list instead.
Over the internet
The way by address, for every device (on Windows, online rooms are simpler). Tested: a Windows PC hosting at home, with an iPhone visiting on mobile data. Visitors connect straight to the host, so the host's router has to let them in.
1. The host's router
The host's router must pass Link Play's port, 47600, TCP and UDP, to the computer that hosts.
- A Windows host asks the router itself. While you host, the game asks your router to open the port (through UPnP, NAT-PMP or PCP, the ways a router lets a program open a port for itself), and closes it again when you stop. F1 → Link Play says whether it worked, and what to do if it didn't. Your router needs UPnP (or NAT-PMP or PCP) turned on, and Windows Firewall still asks the first time you host. This is new in 1.3.5 and was tested against simulated routers only, so tell us how it goes with yours.
- By hand, if the router doesn't do it, or when a Mac, an iPhone or a Linux PC hosts: open the router's "Port forwarding", "NAT" or
"NAT/Gaming" page and forward port 47600, TCP and UDP, to the computer that hosts. Check it points at the right device. A Linux PC with
a firewall (
ufw,firewalld) must allow that port too. - When your internet provider shares one internet address among many homes, no router setting helps; F1 → Link Play says so. Only a VPN helps then: Through a VPN.
2. The host gets a room code
The room code is a 16-character password for the session, written XXXX-XXXX-XXXX-XXXX. Every visitor needs it.
- Windows: pick Host over the internet in the app's Link Play. It shows your room code with Copy the code; the code stays the same from one session to the next until you press New code. In the game, F1 → Link Play shows it too, with Copy invite: your address and the code in one line, ready to paste in a chat.
- Mac: in the launcher, turn on Link Play on this network and Internet play, leave Room code empty and start the game once.
The log (
~/Library/Logs/nxnative) says "this session's room code is …". Type that code into Room code to keep it. - Linux: see the Linux guide.
Give the visitors the room code and your internet address (search "what is my IP" on the host's network). On Windows, Copy invite has both.
3. The visitors
- Mac and iPhone: in the launcher, turn on Link Play on this network, type the host's internet address into Join address, turn on Internet play and type the room code into Room code.
- Windows: pick Visit over the internet in the app's Link Play, and type the host's address and the room code.
- Linux: see the Linux guide.
4. In the game
Link Play → Local connection, then look for towns.
Through a VPN
No access to the router, or an internet provider that shares your address? A VPN app such as Tailscale (free for personal use, on Windows, Mac and iPhone), Radmin VPN or Hamachi puts your devices on one private network across the internet, with no port forwarding.
Pokopia Native counts a VPN's addresses (Tailscale's 100.x.y.z, Radmin VPN's 26.x.y.z, Hamachi's 25.x.y.z) as internet addresses, so play over the internet:
- The host hosts with Internet play: on Windows, Host over the internet in the app.
- The visitors use the host's VPN address as the address, with Internet play and the room code: on Windows, Visit a host over the internet in the app.
- Link Play with players on this network (Same network) doesn't reach through a VPN. If you give
Play Pokopia <version>.exe's own window a VPN address without internet play, it says so before the game starts, and the log names the VPN. - On Windows, if the visitors can't get in, set the VPN's network to Private as well (Settings → Network & internet).
Interact everywhere (experimental)
Outside Palette Town the game puts everyone in a Link Play session in Spectator Mode: visitors can walk around and watch, but certain moves and items can't be used, and visitors can't build. Interact everywhere lifts that: in every town, a session gets the rules Palette Town has with Spectator Mode off, so visitors can water, pick up and place things, and build alongside the host.
- Turn it on on every device. Mac and iPhone: Interact everywhere in the launcher (under Link Play). Windows: Interact everywhere (experimental) in the app's Link Play. Linux: the Link Play choice asks for it. A device with it on only sees hosts that have it on too.
- The game still shows its own words: the host's settings show Spectator Mode On (greyed out), and the visitor is told everyone will be restricted. The session is not restricted.
- As in any Link Play visit, the town and its progress (challenges, building) belong to the host, and what a visitor picks up goes home with them.
- It works on game versions 2.0.1 and 1.0.5 (on 1.0.5, every device needs 1.3.3 or newer).
- It is experimental: keep a copy of your save before a long session.
Story co-op (experimental)
In a story town the game lets only the host talk to the town's story characters, such as Professor Tangrowth: a visitor gets the "Talk" prompt, and nothing happens. Story co-op lifts that, on top of Interact everywhere: visitors talk to the story characters and hear the same story as the host, including the host's current requests.
- What counts for the host: what visitors do in the world, as with Interact everywhere: building, watering, placing and picking up, and the host's challenges (habitats too, we expect, but that isn't tested end to end yet).
- What doesn't: story requests count only for the host. A visitor can hear a request, but their conversation doesn't complete it; the host has to do that part. A visitor's shop purchases go to their own town, so for a building request the host buys the kit and drops it for the visitor.
- Turn it on on every device. Mac and iPhone: Story co-op in the launcher (under Link Play). Windows: Story co-op (experimental) in the app's Link Play. Linux: the Link Play choice asks for it. It turns Interact everywhere on with it. A device with it on only sees hosts that have it on too.
- It works on game versions 2.0.1 and 1.0.5 (on 1.0.5, every device needs 1.3.3 or newer).
- It is experimental: it was tested with two players in Withered Wasteland. Keep a copy of your save before a long session, and tell us what does or doesn't work.
On Windows and Linux: the app's Link Play, and F1
Before you play, the app's Link Play (or Change beside Play on Home) sets how you play from the next start: Play alone,
Same network, Host over the internet, Visit over the internet or Split screen (two players on one PC; Windows only for now),
with Interact everywhere (experimental) and Story co-op (experimental) under them. It remembers your choice. Without the app,
Play Pokopia <version>.exe in your build folder's out folder asks the same in its own window first (Pokopia Settings
While you play, press F1 (or Minus + Plus together on a controller) and open the Link Play tab. It shows:
- how you're playing, and who is connected;
- the addresses to give your friends. It lists every network adapter's address, virtual ones too (WSL, Hyper-V, VirtualBox, VMware). The first one is the one your PC uses for the internet: give your friends that one, or your VPN address for VPN play;
- the room code, with Copy and Copy invite;
- when you host over the internet, whether the router opened the port, and what to do if it didn't.
Change how you play, in the same tab, switches the way to play, the host's address and the room code without going back to the app. These apply at once while the game's Link Play is closed. Turning Link Play on or off, Interact everywhere and Story co-op apply from the next start. The app remembers your choice.
The switches for starting the game from a terminal (-LinkPlay, -Join, -Internet, -Room, -Interact, -Story and more) are in the
Windows guide.
Good to know
- Internet play must match on every device. With Internet play on, a device only sees hosts that have it on too, with the same room code. For players on the same Wi-Fi, turn Internet play off everywhere; otherwise the game says the destination cannot be found.
- The iPhone app reads its settings when it starts. After changing them, close the app completely (swipe it away in the app switcher) and open it again.
- Several network adapters on a Windows PC (Wi-Fi and Ethernet, an iPhone plugged in by USB, a virtual machine's adapter) are fine: the game tells the others all its home-network addresses, and they pick the one they can reach.
- Security: every connection must prove the room code, and every message is protected against changes, but the traffic is not encrypted. If you forwarded the port by hand, remove the forward when you're done hosting.
- Something not working? The logs say what happened, in the lines about
coop: who connected, a wrong room code, a different pokopia-native version on the other side. Windows: the folder its console window names (%LOCALAPPDATA%\Pokopia Native\<game version>\logs); Mac:~/Library/Logs/nxnative; iPhone: the Files app → On My iPhone → the app →log.txt. Since 1.3.5 the Windows log holds only the first group of your room code, so it's safe to attach to a report (Troubleshooting).
Known issues
- Story co-op: while a Link Play session is open, a Pokémon with a "Time to get chatty!" request can ask the host to "bring" themselves over. That's the game's own line; end the session and talk to it again alone. A fix is being worked on.
- Interact everywhere and Story co-op on 1.0.5 were checked in the game's code and started on Windows, but not yet played in a session with two players. Please report how they go.
- The in-game Link Play tab and automatic port forwarding are Windows only for now. The Mac and iPhone get their own settings window in a later update; until then, hosting over the internet from them needs a port forwarded by hand, or a VPN.
- Link Play on Android is experimental (beta 3): the phone joins a host by its address, and has no automatic port forwarding.