Link Studio is a native macOS editor and local trading client for Pokémon Legends: Z-A. Create a Pokémon, preview its encoded record, and trade with a nearby Switch using a Flipper Zero Wi-Fi Developer Board connected directly to your Mac by USB.
The repository also contains the standalone Python packet client, the ESP32-S2 radio
firmware, and documentation of the investigated local trading protocol. An experimental
browser editor is included under web/; browser trading and flashing
are not implemented yet. Use the native app for the documented hardware workflow.
- Searchable Pokémon and move catalogs, named forms, IVs/EVs, nature, gender, items and balls.
- Shiny/Alpha options and scale, height and weight controls.
- Paste an English Showdown/Poképaste team and load one Pokémon at a time.
- Optional editor limits and an advanced JSON editor with record overrides.
- Radio detection, firmware backup/flash, local trade controls and session logs.
Status: an earlier build completed a trade with a real Switch, and the user confirmed that the received Pokémon persisted in its save. Editor and protocol tests run offline; they do not establish that every generated combination or game version is supported. Record validation checks encoding, not encounter legality. See the verification report.
For the native app you need an Apple silicon Mac, macOS 26+, Xcode with the macOS 26 SDK, Git, and Python 3.12+. The local development build was tested with Xcode 27 and Python 3.14. The Python-only checks also run in Linux CI. No Git LFS or emulator installation is needed for the physical-board workflow.
git clone https://github.com/H644b/Pokemon-Spoofer.git
cd Pokemon-Spoofer
python3 scripts/bootstrap.py
bash scripts/test.sh
bash scripts/build-link-studio.sh
open "Link Studio.app"Bootstrap downloads the pinned protocol dependency, applies this project's compatibility
patch, and installs Python dependencies under .build/packet-venv. It does not install or
flash firmware. The app bundle uses this checkout; keep it here and rebuild if you move the
checkout to a different path.
To trade with a real Switch, also prepare the ESP32-S2 firmware, connect the board directly over USB, and select your own local console keys in Wi-Fi Board. Games, saves, console keys, firmware backups and session captures are not distributed. Editing Pokémon and running the offline tests do not require them.
- Open Pokémon and edit a record, or choose Paste Showdown Team… → Read Team → Load Pokémon.
- Use Size for scale/height/weight, and Provenance & appearance for held items and Ball ID.
- Save your editor state with Save Recipe. JSON import/export lives in Advanced.
- In Wi-Fi Board, connect/check the radio and choose your local
prod.keysfile. - In Trade, start a session. On the Switch, open Link Play → Link Trade → Nearby Players with the same eight-digit code. Offer a Pokémon in the app and confirm on the Switch.
- Let the trade and save synchronization finish before disconnecting the board.
The full app guide covers size values, import defaults, advanced overrides, limits, recovery and the session lifecycle. Try the sample Showdown team.
| Path | Purpose |
|---|---|
app/ |
SwiftUI interface, local Python bridge and app tests |
web/ |
Experimental React/Pyodide editor, radio protocol code and Cloudflare build configuration |
packet-client/ |
Record generation, protocol state machine, relay transport and analysis tools |
firmware/flipper-radio/ |
ESP32-S2 radio source and locked component dependencies |
scripts/ |
Dependency setup, builds, tests and source export |
patches/ |
Pinned upstream revisions and local compatibility patches |
research/pkhex-reference/ |
Small, pinned reference sources/data with checksums and original license |
examples/ |
Shareable sample input, without keys or captures |
docs/ |
Setup, development, publishing and dependency notes |
Generated .build/, app-data/, evidence/, emulator directories, downloads and .app
bundles stay local. Older emulator launchers are retained for research; they require the
original lab setup and are not the quick-start path.
- Setup, firmware build and troubleshooting
- Development and tests
- Architecture and data flow
- Scripts reference
- Browser editor setup and current limitations
- Publishing a clean source repository
- Upstream dependencies and licenses
- Semantic protocol: identities, Pokémon records, transport and save states
- Physical Switch verification
- Earlier Ryubing packet investigation
- Historical emulator attempts and Switch background
Historical reports reference private evidence/ files from the original experiments. Those
files are intentionally absent from public clones; the reports distinguish observations,
user confirmation and remaining unknowns.
Project source is distributed under AGPL-3.0. Retained third-party files keep their original notices and licenses; see THIRD_PARTY.md. This is an independent research project, not affiliated with Nintendo, Game Freak, Pokémon or Pokémon Showdown.