Skip to content

README.md

Latest commit

 

History

History
63 lines (43 loc) · 2.85 KB

README.md

File metadata and controls

63 lines (43 loc) · 2.85 KB
Raw

KK Personality Changer

A Windows GUI & CLI tool to change the personality of Koikatsu / Koikatsu Sunshine (KK / KKS) character cards, with batch mode, random personality, backup and restore.

Features

  • Detect the current personality of a character card
  • Change personality of a single card or a whole folder (batch mode, subfolders included)
  • Random personality: one random value per card (Random (Single)) or one fixed random value for the whole batch (Random (Batch))
  • Darkness filter: limit choices to the 6 personalities supported by the Darkness gameplay mod, and optionally skip cards that already have a Darkness personality
  • Backup & Restore: originals are copied to an original folder before modification and can be restored with one click
  • Supports KK cards (personality 0–38) and KKS cards (0–39, Island Girl)

Supported card formats

【KoiKatuChara】, 【KoiKatuCharaS】, 【KoiKatuCharaSP】 (Koikatsu / Party) and 【KoiKatuCharaSun】 (Koikatsu Sunshine).

Usage

GUI

  1. Run KK_personality_changer.exe.
  2. Choose Single or Batch mode, then select a card file or a folder.
  3. (Optional) Adjust the backup (original) folder path.
  4. Pick a personality (or Random) and click Change.
  5. Modified cards are renamed name_{old}to{new}.png; click Restore to bring back the originals.

CLI

KK_personality_changer.exe <card.png> <personality 0-39>

Note: the executable is built as a Windows app, so CLI mode produces no console output; the card is still modified.

Personality list

# Name # Name # Name # Name
0 Sexy 10 Delusional 20 Timid* 30 Friendly*
1 Ojousama* 11 Motherly 21 Typical Schoolgirl* 31 Willful
2 Snobby 12 Big Sisterly 22 Trendy 32 Honest
3 Kouhai 13 Gyaru 23 Otaku 33 Glamorous
4 Mysterious 14 Delinquent 24 Yandere 34 Returnee
5 Weirdo 15 Wild 25 Lazy 35 Slangy
6 Yamato Nadeshiko 16 Wannabe 26 Quiet 36 Sadistic
7 Tomboy 17 Reluctant 27 Stubborn 37 Emotionless
8 Pure* 18 Jinxed 28 Old-Fashioned 38 Perfectionist
9 Simple 19 Bookish 29 Humble* 39 Island Girl (KKS only)

* = supported by the Darkness mod.

Building

Open KK_personality_changer.sln with Visual Studio 2022 (.NET Framework 4.7.2) and restore NuGet packages (MessagePack).

How it works

Koikatsu cards are PNG files with character data appended after the PNG IEND chunk. The tool locates the end of the PNG stream, parses the block header (MessagePack), rewrites the personality field inside the Parameter block in place, and pads the block to keep the original size so all other data stays untouched.

License

MIT — see LICENSE.