pokemon/gen1recomp
1
0
Fork 0
mirror of https://github.com/bryanthaboi/gen1recomp.git synced 2026-08-28 18:06:09 +02:00
Code Issues Packages Projects Releases Wiki Activity
Page: Guide Link Play
Pages
Concepts Compatibility Concepts Data Model Concepts Events And Hooks Concepts Lifecycle Concepts Registries Concepts Save Model Cookbook Audio Cookbook Battle And Mechanics Cookbook Items And Balls Cookbook Species And Moves Cookbook Tweaks Cookbook UI And Infrastructure Cookbook World And Scripting Cookbook Getting Started Guide Art Pipeline Guide Audio Authoring Guide Cartkit Guide Custom Carts Guide Developer Setup Guide Link Compatibility Guide Link Play Guide Modkit Guide Preparing Your Mod For Gen 2 Guide Publishing Guide Save Editor Guide Style Guide Total Conversions Guide Translations Home Reference Commands Reference Events Reference Hooks Reference Manifest Reference Mod Object Reference Registries Tutorial 01 Sprite And Text Tweak Tutorial 02 Balance Patch Tutorial 03 New Species Tutorial 04 New Item Tutorial 05 New Move Tutorial 06 NPC And Dialogue Tutorial 07 New Map Tutorial 08 Quest Tutorial 09 Custom Music Tutorial 10 New Mechanic Tutorial 11 Custom UI Screen Tutorial 12 Mini Total Conversion Tutorials
Clone
2
Guide Link Play
bryanthaboi edited this page 2026-08-15 23:44:59 -04:00
Table of Contents

Link play

Two copies of the game connect directly over UDP for battles and trades.

Connecting

START > LINK opens the link menu (a party is required). One player chooses HOST A GAME and shares the shown address; the other chooses JOIN A GAME and enters it. The default port is 7777; override it with the POKEPORT_LINK_PORT environment variable.

Compatibility

The handshake compares engine versions and a content fingerprint before anything else happens:

  • Matching games (same engine, same link-relevant mods) get full battles and trades.
  • A modified game meeting a differently-modded one falls back to a negotiated strict-vanilla trade subset — only mons both sides rebuild identically — and refuses battles rather than desyncing.
  • An incompatible pairing is refused with a clear message, never a corrupted session.

The details, and how mod authors keep their mods link-safe, are in Link Compatibility.

Gold

Link play is a Gen 1 feature today: Red, Blue and Yellow can host and join, and Gold's START menu has no LINK entry. The handshake knows about generations anyway, so a Gold build meeting a Gen 1 build (or any build from before Gold existed) is refused with a clear wrong-game message rather than misread as an outdated version. Cross-generation trading, the cart's Time Capsule, is not built yet.

Troubleshooting

  • Both machines must reach each other on the UDP port — on separate networks that usually means a port forward for the host.
  • "Are both games running the same mods?" after a desync means exactly that: align the mod sets (and versions) on both sides and reconnect.
  • Trades that keep being refused under the subset verdict involve modded species or moves; trade vanilla mons, or install the same mods on both sides.
  • Two unmodified games that trade but refuse to battle are on different engine releases; battles run both machines in lockstep, so update both sides to the same version and reconnect.

Home

Start here

Concepts

Tutorials

Reference

Guides

Playing

Engine 1.0.0 · mod API 2 · repository · Discord

This project ships no ROM data. All game content is decoded on the player's machine from their own verified Pokemon Red ROM; mods ship recipes and original assets, never extracted content.