Skip to content

Configuration

Chris Feger edited this page Mar 28, 2019 · 21 revisions

The configuration screen (aka Settings) allows you to modify certain behaviors of PKSM.

This screen is only navigable by the touch screen except to exit, which can be done by pressing B.

Each screen has it's own settings:

Screen 1: Language

This screen is used to set the language of PKSM.

To change the language tap the box next to the language you wish to use.

Screen 2: PKSM Defaults

On this screen, you are able to configure the default settings for some fields when you generate new Pokemon.

The fields can you set are the following:

  • TID (Trainer ID)
  • SID (Secret ID)
  • OT (Original Trainer)
  • Nationality (country of Pokemon) (note: this cannot still be edited from the UI itself, so you need to do that manually)
  • Day (caught/hatched day)
  • Month (caught/hatched month)
  • Year (caught/hatched year)

Screen 3: Miscellaneous Settings

On this screen, you're able to change miscellaneous functions.

  • Automatically backup on load:
    • This will back up your game's save file when you first load it into PKSM.
    • This will also back up PKSM's bank storage when you load the bank.
    • This setting is turned on by default.
  • Storage size:
    • This allows you to specify how many boxes the PKSM bank should have
    • This defaults to 150 boxes.
  • Edit during transfers:
    • When transferring Pokemon from your bank to your game, PKSM will edit it to make sure that the Pokemon's information is compatible with the game.
    • This setting is turned off by default.
    • Note: this setting is required to be true if you want to perform a bulk swap o Pokemon from a generation to another.
  • Use Save info:
    • Instead of using some information like the TID or SID from the defaults settings, PKSM will attempt you pull the information from your save file and use it for generating Pokemon.
    • This setting is turned off by default.
  • Randomize music:
    • If you have music on your SD card located under sdmc:/3ds/PKSM/songs it will play the songs in a random order, rather than playing it in order of title.
    • If you have no music on your SD card, this setting will not do anything.
    • This setting is turned on by default.

Extra Saves

There is no interface for this advanced feature. In order to make use of it, you will have to use Checkpoint (version 3.6.0 or later) to dump your configuration file.

Once your configuration file has been dumped, open it in a text editor.

You will see a blank JSON field called extraSaves. Inside of that, you will need to put the "Checkpoint prefix" of your game. A Checkpoint prefix is what is appended to the game name in the backup folder. A 3DS game's prefix will be 0xXXXXX, with the X's replaced by hexadecimal digits. Pokémon X, for example, has the prefix of 0x0055D, whereas Ultra Sun has the prefix 0x01B50.

A DS game's prefix will be a four-letter code. The final letter of the code does not matter, as long as it is 'E', 'S', 'K', 'J', 'I', 'D', 'F', or 'O'. The one I use for Platinum, for example, is CPUE.

Once you have created a blank JSON field with that name, create two JSON arrays named files and folders. In the files array, you can put filesystem paths to save files. In the folders array, you can put filesystem paths to folders that follow the same general scheme as Checkpoint: a folder, with subfolders that hold the contents of the save.

An example extraSaves field is provided below.

"extraSaves": {
  "CPUE": [
      "/roms/nds/POKEMON_PL.sav",
      "/path/to/file.save"
  ],
  "0x0055D": [
      "/3ds/PKSM/backups/0x0055D/date/main"
    ]
  }
}

Using an automatic extra saves editor

If you want an easier way of modifying your config.json for NDS games, use our extra save tool found here.

Issues

If you are having issues with the above, try using a tool such as https://jsonlint.com/ to validate that your JSON is correct. If it is, check to make certain that you have Checkpoint 3.6.0+.

Clone this wiki locally