Skip to content

About

PKForge for Mac. A Pokémon save editor and bank for macOS, ported from sofianeelhor/PKForge.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Latest commit

 

History

181 Commits

Folders and files

Repository files navigation

PKForge

PKForge for Mac

A Pokémon save editor and bank, running natively on macOS.
A port of PKForge by @22sh.

Download for macOS Beta License


Open a save from your emulator, edit your team and boxes, and move Pokémon between games. Built on PKHeX.Core, with the Auto Legality Mod built in, so legality checks and one-tap legalize work offline.

Warning

This is a beta and it needs testers. It works, but it hasn't been used by many people yet. Back up any save you care about before editing it, and check your edits in the emulator. PKForge also keeps its own backup of every save it writes. Found a problem? See Help test.

Not affiliated with Nintendo, Game Freak, or The Pokémon Company.

Features

  • Edit anything on a Pokémon: stats, IVs/EVs, moves, nature, ability, item, origin, Tera type, shininess and more, with a live legality check
  • Move Pokémon between games, across generations
  • A cross-game Bank with unlimited boxes, and a Living Dex tracker for all 1025
  • The full Mystery Gift database, offline
  • Bag, trainer, Pokédex, Day Care and game-specific editors
  • RNG tools, batch editing, Showdown import/export
  • Restore points for every change

Home Editor

Bank Living Dex

Getting started

  1. Install. Download PKForge-mac.zip from Releases, unzip it, and drag PKForge into Applications. Needs macOS 13 or later.
  2. Save in your game, then quit the emulator. PKForge edits the save file, so the emulator shouldn't have it open.
  3. Link your emulator. In PKForge, open Settings ▸ Link an emulator, pick your console and emulator, and choose the folder your saves are in. Your games appear on the shelf. (No emulator? Settings ▸ Open a save file works with any save.)
  4. Edit. Click a game to open its boxes, click a Pokémon, change what you like, and hit Save changes.
  5. Play. Start the game normally in your emulator. Don't load an older save state, or you'll undo your edits.

Made a mistake? Settings ▸ Restore points puts any earlier version of the save back.

Emulators

Supported in Link an emulator:

Platform Emulators
Game Boy, GBC, GBA mGBA, OpenEmu, RetroArch
DS melonDS, DeSmuME, OpenEmu, RetroArch
GameCube Dolphin
3DS Azahar / Lime3DS
Switch Eden

Not sure where your saves are? The folder picker opens in the emulator's usual save folder when it can find one. melonDS, mGBA and DeSmuME keep saves next to your ROMs by default.

Supported games
  • Gen I–II: Red, Blue, Green (JP), Yellow, Gold, Silver, Crystal
  • Gen III: Ruby, Sapphire, Emerald, FireRed, LeafGreen, Box, Colosseum, XD
  • Gen IV: Diamond, Pearl, Platinum, HeartGold, SoulSilver
  • Gen V: Black, White, Black 2, White 2
  • Gen VI: X, Y, Omega Ruby, Alpha Sapphire
  • Gen VII: Sun, Moon, Ultra Sun, Ultra Moon, Let's Go Pikachu, Let's Go Eevee
  • Gen VIII: Sword, Shield, Brilliant Diamond, Shining Pearl, Legends: Arceus
  • Gen IX: Scarlet, Violet
  • Romhacks: Unbound, Radical Red, GS Chronicles, Luminescent Platinum, Compass

Help test

The most useful things to try:

  • Your own saves, from the emulators and games you actually play
  • Moving Pokémon between two games, and in and out of the Bank
  • Editing, saving, then loading the save in your emulator
  • Keyboard and controller navigation

If something breaks, open an issue with the game, the emulator, your Mac and macOS version, and what happened. A screenshot helps. Don't attach save files you want to keep private.

Controls

Mouse, keyboard or a controller (Xbox, PlayStation, Switch, MFi).

Keyboard
D-pad Arrow keys
A / B Return / Esc
X / Y S / A
L / R Q / W
Start / Select Tab / right Shift

Right-click does what a long press does. The lower screen opens as its own window; Window ▸ Show Second Screen (⌘2) brings it back.

Your Bank and backups live in ~/Library/Application Support/PKForge.

Building

Needs Xcode and the .NET 10 SDK with the maui-maccatalyst workload.

git clone --recursive https://github.com/macprotips/PKForge-Mac.git
cd PKForge-Mac
tools/build-mac.sh

The app lands in dist/. To sign and notarize a release, set PKFORGE_SIGN_IDENTITY to your Developer ID and PKFORGE_NOTARY_PROFILE to a notarytool keychain profile first.

Credits

License

GPLv3 or later, inherited from PKHeX.Core. See LICENSE.

About

PKForge for Mac. A Pokémon save editor and bank for macOS, ported from sofianeelhor/PKForge.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages