Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Link Studio · Pokémon Z-A local trading

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.

Features

  • 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.

Quick start

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.

Using the app

  1. Open Pokémon and edit a record, or choose Paste Showdown Team… → Read Team → Load Pokémon.
  2. Use Size for scale/height/weight, and Provenance & appearance for held items and Ball ID.
  3. Save your editor state with Save Recipe. JSON import/export lives in Advanced.
  4. In Wi-Fi Board, connect/check the radio and choose your local prod.keys file.
  5. 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.
  6. 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.

Repository map

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.

Documentation

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.

License

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.

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages