Play on an original Game Boy Advance against RetroArch players. The free GB-Link Netplay Bridge app connects a real GBA, plugged in through a GB-Link USB adapter, to a RetroArch netplay session. To the network it looks like a regular RetroArch + gpSP player, so the other players need no extra software, and any mix of real GBAs and emulator players can share a session.
Use your own legally obtained copy. We recommend that you use your own legally obtained copy of the game. ROM does not condone illegally downloading ROMs.
Which games work
- Pokémon Ruby, Sapphire, Emerald, FireRed and LeafGreen, over a link cable or the GBA Wireless Adapter. Wireless sessions take up to five players.
- Advance Wars and Advance Wars 2: Black Hole Rising, VS link over a link cable, strictly 2 players.
The project documents no other games for this route.
What you need
- A Game Boy Advance, a cartridge of the game and a link cable. For the cable games a GBA or a GBC link cable works; with a GBA cable, plug its small (master) connector into the adapter. Wireless Adapter mode needs a Game Boy Color link cable.
- A GB-Link USB adapter from gblink.io (or a DIY build) with firmware 3.0.0 or newer for the cable games, or 2.2.7 or newer for the Wireless Adapter. Update it from the GB-Link launcher.
- The bridge app from the releases page, for Windows, macOS, Linux or Android 8+ (Android needs a USB OTG adapter or cable). On macOS, allow the app the first time under System Settings > Privacy & Security > Open Anyway. On Linux, install the udev rule the app offers.
- Every RetroArch player runs the same RetroArch version and the gpSP core (not mGBA), with its Link Cable Connectivity option set to match the session:
Link Cable - Pokemon Gen3 modefor Pokémon by cable,GBA Wireless Adapterfor wireless sessions, orLink Cable - Advance Wars 1/2 modefor Advance Wars. gpSP reads this option only when a game loads, so after changing it, close the content and load the game again. Automatic picks the right mode for most Pokémon and US/EU Advance Wars carts; Japanese Advance Wars carts need the mode set by hand. - Everyone has their own copy of the same game.
Connect
- Plug in the adapter and open the bridge app. Pick Game Boy Advance and the game on the play card.
- Join a session with the host's address or from the public lobby, or host one (direct, announced in the lobby, or through a relay).
- Follow the steps for your game below.
Pokémon over a link cable
Both players go to the Cable Club upstairs in any Pokémon Center and talk to the attendant, in either order. If one game stops waiting before the other player arrives, talk to the attendant again. Between activities the link reconnects by itself, so brief "Linking..." messages are normal.
Pokémon over the Wireless Adapter
Open the Direct Corner (the Wireless Communication menu) at any time during the session, then lead a Trade Center or Colosseum group or join one another player leads. Up to five players can share a session. Wireless sessions must not go through a relay: play on the same network or connect straight to the host's address, with their port forwarded or over a virtual LAN such as Tailscale or ZeroTier. A RetroArch player hosting a wireless session turns off Use Relay Server.
Advance Wars
- Start the bridge session before opening the Link screen on the GBA. If the GBA is already on the VS Link screen, back out and open it again once the session is up.
- The RetroArch player joins the session before opening their own Link screen.
- Host from the bridge when you can, so your GBA is player 1 and presses Start. If a RetroArch player presses Start, RetroArch can close.
- This is strictly 2 players. When joining, the bridge must be the first and only joiner.
Notes
- On Android, keep the app on screen while you play. On mobile data other players cannot reach your phone directly, so join their session or host through a relay (cable games only).
- If a game desyncs, check that every emulator player runs the same core version and the same game file.
- For the emulator side, see RetroArch Netplay on GBA (RetroArch).