KK Library Scene & Card Manager
All guide pages

Character cards

KK Library reads and changes the profile saved in a Koikatsu character card, restores the original card and extracts its outfits.

Where to find it
The inspector in Character mode

What it is

#

A character card is a PNG file that contains a picture and a character's data. KK Library reads the profile when it syncs, so you can see it without opening the game. The labels match the character maker.

Changes go into the card file, so Koikatsu and CharaStudio load the updated card. Tags, author and rating stay in your library.

What it can do

#

Read and change a profile

#

The inspector shows a card's profile, and you can change all of it except Gender and the Outfits count.

  • Personality shows on female cards only, as in the game.
  • If you saved the card in the game since KK Library last read it, KK Library doesn't write over it. It says This card changed on disk. Run Sync and try again.

Get the original card back

#

Before your first change, KK Library saves an edit backup of the card.

  • Restore original replaces the whole file with that copy. Anything saved into the card since is lost, including saves from the game.
  • KK Library clears old edit backups after a while. To clear them all now, use Settings.

Outfits inside a card

#

A card holds an outfit for each game slot, such as School 1. Extract outfits saves each as a separate file.

  • The card is only read, and a new file never writes over another. A name that is taken gets (2) at the end.
  • Each outfit is for the card's gender. Its file name ends in (Female) or (Male), and its Gender is set to match (Set who an outfit is for).
  • Each file gets a plain female or male picture, because a card holds no picture of each outfit.

Where the new outfits go

#

Extracted outfits go in a folder named after the character, inside the folder you chose last time. Until you choose one, that is the game's UserData\coordinate folder.

How to do it

#

Read a card's details

#
  1. Choose Character at the top of the main window.
  2. Select a card in the grid.
The inspector with a card selected. The Name row is marked 1, its pencil 2 and the Outfits count 3
  1. Scroll the middle of the inspector to Name (1). The profile follows it, down to Outfits (3), which counts the outfits the card holds.
  2. Scroll further to see Club, Weak point and Voice pitch.

A pencil (2) beside a detail means you can change it.

Rename a character or change its profile

#
  1. Select a card in Character mode.
  2. Select the pencil beside the detail you want to change, or select the value itself.
The Nickname row open for editing, with its box marked 1
  1. Enter the new value in the box (1). Name opens two boxes, Last name and First name, and Birthday opens a month and a day. Voice pitch opens a slider and a box, and letting go of the slider writes the card at once.
  2. Press Enter. KK Library writes the card, and the status bar says Card updated.
  3. For Blood type, Personality, Club and Weak point, choose from the list instead. KK Library writes the card as soon as the list closes.

To stop without a change, press Esc while Panic key is off (Panic mode). KK Library doesn't save a change during a sync, so let it finish first.

Restore the original card

#
  1. Select the card you changed.
The More actions menu open, with Restore original marked 1
  1. Select More actions at the top of the inspector, then Restore original (1). It shows only while the card differs from its edit backup.
The Restore original card? question, with Restore original marked 1 and Cancel 2
  1. KK Library asks Restore original card? Select Restore original (1) to put the card back, or Cancel (2) to keep it as it is.

The status bar then says Original restored. The edit backup stays, so you can change the card and restore it again until the backup is cleared.

Extract outfits from cards

#
  1. Select a card in Character mode.
  2. Select More actions at the top of the inspector, then Extract outfits.
The Extract outfits window. The Destination box is marked 1, the Card cover mark 2, the first Saves to line 3 and Extract 4
  1. Check the folder in the Destination box (1). The box may be too narrow to show the whole path. To use another place, select Browse and choose where the character's folder goes.
  2. To leave an outfit out, select its row to clear its check box. Every outfit starts selected, and Card cover (2) marks the one on the card's picture.
  3. Read the Saves to line under each outfit (3). It names the new file, like Chikarin - School 1 (Female).png.
  4. Select Extract (4). KK Library writes the new files, and File Explorer opens on the folder. To leave without writing anything, select Close instead.

Show extracted outfits in the character maker

#
  1. Open Extract outfits for the card (Extract outfits from cards).
  2. In the Destination box, delete the character's folder name at the end, so the path ends at UserData\coordinate.
  3. Select Extract.
  4. Open the outfit list in the character maker. The new outfits are in it.

To fix outfits you already extracted, move them from the character's folder into UserData\coordinate.

Checked with KK Library 0.1.0-beta.9.1