Hacking Homebrew Homebrew app PKHeX-NX — native Switch Pokémon save editor (Scarlet/Violet) [Devlog / Sneak Peek]

  • Thread starter Thread starter cbreezy210
  • Start date Start date
  • Views Views 951
  • Replies Replies 6
  • Likes Likes 1

cbreezy210

Active Member
Newcomer
Joined
Nov 15, 2022
Messages
25
Reaction score
8
Trophies
0
Age
33
XP
332
Country
United States
[Last Updated: Sept 7 — v0.9.4 Hardening Sprint LIVE! + Full PKHeX SpeciesConverter Port]

[Devlog] PKHeX-NX — v0.9.4 Hardening Sprint (Species #917 Fix + Crypto Sanity + SD Space Check)

Hey everyone,

I've been working on a passion project for a few months and wanted to share a sneak peek and get early feedback. PKHeX-NX has now hit its v0.9.4 Hardening Sprint, making it safer and more robust than ever.

What is it?

PKHeX-NX is a 100% native Nintendo Switch homebrew app that edits Pokémon Scarlet & Violet save files directly on the console. No PC, no pulling the SD card, no dumping tools. It's a from-scratch C++ port of the core concepts behind the legendary PKHeX (not affiliated with the PKHeX team).

🚀 Community Traction:
• Rapid adoption with downloads across both Standard and DBI install packages
• Active discussions and feedback on GitHub and GBATemp
• Featured in Nintendo Homebrew Discord #dev channel

⚠️ CRITICAL: LAUNCH VIA TITLE OVERRIDE

You MUST launch PKHeX-NX via Title Override (hold the [R] button while launching Pokémon Scarlet or Violet from the home menu).

Do NOT launch this app from the Album / Applet Mode, or it will safely block itself and prompt you to relaunch correctly due to memory restrictions.

What already works (v0.9.4):

🛡️ v0.9.4 Hardening Features:
• Species #917 Audit: Full PKHeX SpeciesConverter port fixing the Paldean ID divergence (Tarountula #917+ now display correctly, eliminating the "Dunsparce imposter" bug)
• Round-Trip Crypto Sanity Check: Boot-time verification that encrypt(decrypt(x)) == x before touching any save data
• SD Space Validation: Pre-backup space check to prevent mid-write corruption on full cards

Core Features:
• Full save crypto: SHA256 footer verification, xorpad decryption, SCBlock/SCXorShift32 parsing
• Box viewer (32×30 grid) with inject / clone / delete / export to .pk9
• Stat & trait editor: IVs, EVs, Natures, Tera Types, Force Shiny — with automatic checksum healing
• Trainer edits: Name, TID/SID, Money
• Legality-aware generator:
- Real abilities (Ability 1 / 2 / Hidden)
- Manual legal move picker (hand-pick the 4 equipped moves from the species' real learnset)
- Level-accurate moves from each species' real level-up learnset, with correct max PP
- Growth-correct EXP across all 6 experience curves
- Egg generation (valid egg flag, hatch cycles, level-1 moveset)
- 26-ball picker with correct in-game ball IDs
• Scarlet + Violet support with a boot-time game selector
• Safety net: byte-verified SD backup before every write, dual-file commit, one-button rollback

Everything is hardware-validated with photographic proof — generated mons render cleanly in-game with correct stats, abilities, and moves.

What's next (v1.0 / v1.1):

• SDL2 graphical UI (current build is a text console)
• More titles (Legends: Z-A, then Gen 8 codecs)
• Bag editor, Living-Dex automator, and more

Why post now?

Public Beta is live and docs are overhauled! I'm actively gathering feedback on safety architecture and C++ implementation. Check the GitHub Issues/Discussions tabs for ongoing devlogs.

🔗 Links & Resources:

GitHub (Source & Beta Download):
https://github.com/cbreezy210/PKHeX-NX/releases

GameBrew (Install Guide & Documentation Mirror):
https://www.gamebrew.org/wiki/PKHeX-NX

The boring-but-important part:

This is an educational project. Modifying save data always carries risk. The app has a robust backup system, but always keep your own manual backups. Use offline and at your own risk. Not affiliated with PKHeX, Nintendo, or The Pokémon Company.

Screenshots attached: homebrew icon, box viewer, Charmander stat screen, generated Charmander summary, and the new move picker UI.

Thanks for reading — feedback welcome!




Edit (Aug 28): Just shipped the Manual Legal Move Picker (M11) and updated the repo! See my reply below for details and screenshots.

Edit (Aug 30): Public Beta v0.9.3 is live! Also added the full install guide, supported games table, and backup documentation to GameBrew. You can view the wiki mirror here: https://www.gamebrew.org/wiki/PKHeX-NX

Edit (Aug 31): Bumping thread to share massive documentation overhaul & safety architecture updates. Thanks for the continued support! 🍻

Edit (Sept 7): 🚀 v0.9.4 Hardening Sprint is LIVE! Fixed the Gen 9 Species #917+ ID divergence (Tarountula+ now display correctly), added boot-time crypto sanity checks, and pre-backup SD space validation. Download the latest zips on GitHub!
 

Attachments

  • 20260824_232910.jpg
    20260824_232910.jpg
    161.1 KB · Views: 1
  • 20260824_233029.jpg
    20260824_233029.jpg
    502.6 KB · Views: 2
  • 20260824_233121.jpg
    20260824_233121.jpg
    517.6 KB · Views: 1
  • 20260824_233657.jpg
    20260824_233657.jpg
    470.2 KB · Views: 2
Last edited by cbreezy210,
  • Love
Reactions: Freyjadour
do you plan on implementing support for the other pokemon games like bd sp sword and sheild and z-a oh and lets go pikachu and lets go evee?
 
  • Like
Reactions: cbreezy210
please keep working on this!
Thanks so much, that means a lot! 🙂 The manual legal move picker just landed (v0.9.3), and the next big milestone is the graphical UI. I'll keep the updates coming in this thread!
Post automatically merged:

do you plan on implementing support for the other pokemon games like bd sp sword and sheild and z-a oh and lets go pikachu and lets go evee?
Great question! Short version: yes to most of those, in stages. 🙂

• Legends: Z-A — planned first, since it reuses the same PK9 structure as Scarlet/Violet (just different save block keys).
• Sword/Shield and BDSP — next on the roadmap after Z-A (PK8 and PB8 codec ports).
• Let's Go Pikachu/Eevee — those saves use a different Pokémon format entirely, so that one's a bigger port. It's not on the roadmap yet, but I'd love to look into it once the Gen 8/9 core is solid. No promises!

I'm hardware-validating every port on-console before calling it done, so it'll be a gradual rollout. Thanks for the interest! 🙂
Post automatically merged:

[Devlog] PKHeX-NX Update — Manual Legal Move Picker + v0.9.3 Polish

Hey everyone,

Quick progress update on PKHeX-NX (the native Switch Pokémon SV save editor). Thanks for all the feedback and clones on the initial sneak peek!

**What's new since the last post:**

🎯 **Manual Legal Move Picker (M11)**
Previously, the generator auto-assigned the last 4 level-appropriate moves. Now, you can hand-pick them.
• Press [Y] in the generator menu to open the Move Picker.
• Browse every legal move the species can learn at or below your chosen level (pulled directly from PKHeX's learnset data).
• Scroll through real move names (no more raw hex IDs!) and assign up to 4 custom slots.
• Perfect for building competitive sets or specific legacy movesets directly on the console.

🔧 **Housekeeping & Polish**
• Bumped the on-console title screen to **v0.9.3** (it was stuck on 0.1.0 from early testing).
• Added author credit to the NACP metadata.

**Screenshots attached:**
1. The new v0.9.3 title screen.
2. The Move Picker UI in action (showing real move names).
3. A generated Pikachu with a custom moveset.

**What's next:**
The core Gen 9 legality engine is now feature-complete. Next up is either tackling the Bag Editor / item tables, or starting the long journey toward the SDL2 graphical UI (v1.1.0) to replace this text console.

Repo is public if you want to follow along or review the C++:
https://github.com/cbreezy210/PKHeX-NX

As always: offline use only, keep your backups, and this is an educational project. Not affiliated with PKHeX or Nintendo.

Thanks for reading!
 

Attachments

  • 20260826_233050.jpg
    20260826_233050.jpg
    193.3 KB · Views: 2
  • 20260826_233205.jpg
    20260826_233205.jpg
    290.9 KB · Views: 1
  • 20260826_233413.jpg
    20260826_233413.jpg
    335.7 KB · Views: 1
Last edited by cbreezy210,
🎉 PUBLIC BETA IS LIVE!

The v0.9.3 Public Beta just dropped — no building required, just a drag-and-drop .zip:

Download: https://github.com/cbreezy210/PKHeX-NX/releases/tag/v0.9.3-beta

Extract to the root of your SD card, then launch via Title Override (hold [R] while launching Pokémon Scarlet/Violet). The zip includes the app, all required data assets, and a README with full instructions.

Feature votes and feedback: GitHub Discussions. Bug reports: GitHub Issues.

As always: offline use, keep your backups, educational project. 🙂
 
Last edited by cbreezy210,
[BUMP] Massive Documentation & Safety Architecture Overhaul! 📚

Hey everyone! Just wanted to bump this thread to let you know I've completely overhauled the project documentation and safety systems based on community feedback.

What's New:

• Gold Standard Docs: Full IS/IS NOT scope tables, ASCII install guides, and transparent "Known Gaps" sections.

• Safety-First Architecture: Byte-verified backups, dual-file commits, and hard Applet-mode guards to prevent save corruption.

• GameBrew Wiki Sync: Permanent SEO billboard live at gamebrew.org/wiki/PKHeX-NX

Current Status: Public Beta v0.9.3 is live with 8+ downloads and 4 GitHub stars!

If you've been waiting to try it, now is a great time. All docs are updated to be super transparent about what the tool can/can't do.
Thanks for the support! 🍻
 
[UPDATE] v0.9.4 Hardening Sprint — Species #917 Fix + Crypto Sanity + SD Space Check

Hey everyone!

Quick update with v0.9.4, which dropped last night with three major safety enhancements:

What's New in v0.9.4:
🛡️ Species #917 Audit — Full PKHeX SpeciesConverter port fixing the Paldean ID divergence (Tarountula #917+ now display correctly, eliminating the "Dunsparce imposter" bug)
Round-Trip Crypto Sanity Check — Boot-time verification that encrypt(decrypt(x)) == x before touching any save data
💾 SD Space Validation — Pre-backup space check to prevent mid-write corruption on full cards

Download: https://github.com/cbreezy210/PKHeX-NX/releases
- Standard install: PKHeX-NX-Beta-v0.9.4.zip (187 KB)
- DBI install: PKHeX-NX-DBI-v0.9.4.zip (136 KB)

Early traction: Already seeing downloads in the first few hours — thanks to everyone following along!

What's Next:
Still targeting v1.0 for the SDL2 graphical UI and Bag Editor. Your feedback continues to shape the roadmap!

As always: offline use only, keep backups safe, and this is an educational project. Happy editing!
— cbreezy210
 
Last edited by cbreezy210,

Site & Scene News

Popular threads in this forum