SpudManTwo / KPT

S-KPT
18 stars 2 forks source link

S-KPT Patcher

S-KPT Patcher is a C-Sharp tool designed solely for the purpose of applying a fan-translated English patch to the game Kokoro Connect: Yochi Random for the PSP. It is a fork of the original KPT. The patch is distributed separately in the Releases section of this project.

It is possible, but not advisable, to use this tool to patch other PSP ISOs. This tool is specifically designed for use with the fan translation patch for Kokoro Connect: Yochi Random.

Prerequisites

Installation

  1. Download the latest release of S-KPT Patcher and the English patch from the Releases section.

  2. Extract the .zip archive into wherever you'd like to store the patcher. You can delete the patcher after you've finished patching your ISO.

Usage

  1. Start S-KPT Patcher by launching KPT.exe from the folder where you extracted the patcher. Your antivirus may throw up a flag, but ask it to trust the patcher.

  2. Click the "Easy Patch" Button.

  3. Select the path to the Kokoro Connect Yochi Random ISO file and where you would like the patched ISO contents to be placed in the next dialog box.

  4. The patcher will unpack the ISO's contents and replace them with the English patch. It will NOT overwrite your original ISO copy; the Japanese ISO will still be there after the new patched one is created.

  5. Wait a few seconds while the patcher does the rest of the work.

  6. When it is complete, you may close the patcher.

Developers Only

  1. Start S-KPT Patcher by launching KPT.exe from the folder where you extracted the patcher.

  2. Create a new Project.

  3. Open the newly created project.

  4. Dump the contents of your Kokoro Connect: Yochi Random ISO.

  5. Unpack the ISO contents.

  6. Dump the strings.

  7. Extract the images.

  8. Go into the directory of your newly created project and navigate to the Editable Game Files.

  9. Replace the image files with English translated/edited ones.

  10. Add the English translation to the the specified column in all the CSV files in the "St000" folder.

  11. Select the Repacking tab in the patcher.

  12. Load the strings.

  13. Load the images.

  14. Repack the ISO.

  15. Copy the Repacked folder to wherever you'd like to store the translated game's contents.

  16. (optional) Use a tool such as UMDGen to master the translated game's contents into a single ISO file.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

If you'd like to help with translating the game, please reach out to myself, defan752, or ask about helping out in the Kokoro Connect Discord.

Acknowledgements

Nuget Packages:

DiscUtils SharpYAML CSVHelper

Other Code Repos

LibCPK/CPKTools Pgftools

dl471's code (Thank you, you are a hero!)

DLL for pgftools C# Wrapper for DLL KPT

Tools:

GimConv

Github CI:

shindouj