github.com/FlagBrew/PKSM @10.3.0
Chat with this repoBrowse by type
What it actually does AI analysis from the code graph — generated when you open this
README
Multipurpose and portable Pokemon save manager and editor for generations I to VIII, programmed in C++.
- Supports original cartridges and digital copies of games from FrLgRSE to SwSh
- Allows on-the-fly modifications to all of your data
- Allows internal and resizable offline storage to store your Pokémon
- Capable of running custom scripts to allow injection of arbitrary data into your saves
- Capable of scanning QR codes to inject both .pkx files or event wondercards
- Contains an offline wondercard database to get events from old distributions
- Capable of automatic verification and legalization of all your data (internet connection and local hosting required)
- Requires you to run your own local-gpss (or to use one hosted by someone else in the future)
We do not support or condone cheating at the expense of others. Do not use significantly edited Pokémon in battle or in trades with those who are unaware edited Pokémon are in use.
Screenshots
Documentation
Please refer to the PKSM wiki for detailed documentation.
Installation
This software works on CFW and Rosalina-based Homebrew Launchers. An internet connection is required when first launching PKSM.
| Entrypoint | Instructions |
|---|---|
| CFW | Install the PKSM.cia file provided in the release page with your favourite installer. You can now launch the application from the Home Menu |
| Rosalina HBL | Copy the PKSM.3dsx file provided in the release page into your SD card. You can now launch PKSM from a Rosalina-based Homebrew Launcher |
Initial launch will require your system to be connected to the internet. This is needed to download the additional assets required for the application to launch. If your system is not connected to the internet, PKSM will close.
Applications compatible with PKSM
- PKHeX: Generates .pk7, .pk6, .wc7, .wc6 QR codes scannable from PKSM. Runs on PC.
- MysteryGiftBot: Generates .wc7 QR codes scannable from PKSM. Runs on Twitter.
- PKSM-Scripts: A toolkit to develop and compile .pksm and .c scripts.
- Local GPSS: A local hostable version of GPSS with (Auto)Legality functionality
Working path
- Additional assets are located at
/3ds/PKSM/assets - Automatic save backups are located at
/3ds/PKSM/backups - Extra storage data is located at
/3ds/PKSM/banks - .pkx and .wcx dumps are located in
/3ds/PKSM/dumps - Custom scripts are located in
/3ds/PKSM/scripts - Custom background songs are located in
/3ds/PKSM/songs
Troubleshooting
Before submitting an issue, have a look through the issue tracker, as your question or bug request may have already been answered in the past.
Please only submit consistent issues (submitting your environment and which version of PKSM you're running, for example). Duplicate issues will be closed.
Issues that are opened concerning releases other than the latest stable release will also be closed. Please do not report bugs with old software.
You can get real-time support by joining FlagBrew's discord server:
Building
PKSM has the following dependencies:
libctru, citro3d, citro2d, 3ds-curl, 3ds-pkg-config, 3ds-bzip2, 3ds-mpg123, 3dstools, tex3ds and the devkitARM toolchain with their dependancies.
All of these should be installed from devKitPro pacman.
Package Tested version devkitARM r68.1 devkitarm-gcc 16.1.0-1 devkitarm-rules 1.6.0-4 libctru 2.7.0-1 citro3d 1.7.1-2 citro2d 1.7.0-1 3ds-curl 8.4.0-1 3ds-pkg-config 0.28-5 3ds-bzip2 1.0.8-1 3ds-mpg123 1.31.3-3 3dstools 1.3.1-3 tex3ds 2.3.0-4
- rsync (tested with 3.2.7)
- Your system's pkg-config (tested with 1.8.1)
- 3dstool,
bannertool and
makerom, if you want to be
able to compile a
.ciabuild of PKSM. - Python 3.x (tested with 3.12) and the GitPython library.
- node.js, pandoc, wkhtmltopdf and github-wikito-converter to be able to build the HTML documentation.
To compile, clone the repository with all submodules (git clone --recursive
https://github.com/FlagBrew/PKSM.git if initially cloning, git submodule init
and git submodule update if running from an existing clone) and run make
all.
Credits
- Bernardo for creating PKSM
- piepie62 and Admiral-Fish for the immense amount of dedication they put into the project
- dsoldier for the gorgeous graphic work
- SpiredMoth, trainboy2019 and all the scripters for making PKSM-Scripts great
- Archit Date for CoreConsole and PKHeX AutoLegalityMod
- Allen (FM1337/FMCore/Sigkill) for the GPSS (2019-2025), CoreConsole's successor: CoreAPI and GPSS Mobile (2020-2025) and Local GPSS
- LiquidFenrir for the PoC of session stealing that led to Gen 3 support and GPSS Mobile (2019-2025)
- The whole FlagBrew team for collaborating with us
- kwsch and SciresM for PKHeX, memecrypto and documentation
- fincs and WinterMute for citro2d and devkitARM
- kamronbatman and ProjectPokemon.org for EventsGallery
- nayuki for QR-Code-generator
- jpoirier, zsaleeba, and Jan Švejda for the base and most improvements in our picoC fork
- dlbeer for quirc
- Griffin For FlagBot and all the help it has been on the server.
- SNBeast For Generation 1 and 2 support.
- All the translators
- Subject21_J and all the submitters for PKSM's icon
- Allen, piepie62, SpiredMoth and all the contributors for the documentation
- All the past contributors to the project
- All the patrons and the huge amount of supporters that this project has gained over the year
Without you, this project wouldn't have existed. Thank you.
License
This project is licensed under the GNU GPLv3. Additional Terms 7.b and 7.c of GPLv3 apply to this. See LICENSE for details.