a simple deserializer / serializer for Koikatu / EmotionCreators data.
Project description
KoikatuCharaLoader
A simple deserializer / serializer for Koikatu / EmotionCreators character data.
Installation
You can install this module from PyPI.
$ pip install kkloader
If this does not work, try the following command (for Windows users, maybe).
$ python -m pip install kkloader
Basic Usage
$ python
>>> from kkloader import KoikatuCharaData # Load a module.
>>> kc = KoikatuCharaData.load("./data/kk_chara.png") # Load a character data.
>>> kc.parameter["nickname"] # Print character's nickname.
'かずのん'
>>> kc.parameter["nickname"] = "chikarin" # Renaming nickname.
>>> kc.save("./kk_chara_modified.png") # Save to `kk_chara_modified.png`.
that's it :)
Export to JSON file
from kkloader import KoikatuCharaData
k = KoikatuCharaData.load("sa.png")
k.save_json("sa.json")
sa.json
{
"product_no": 100,
"header": "\u3010KoiKatuChara\u3011",
"version": "0.0.0",
"custom": {
"face": {
"version": "0.0.2",
"shapeValueFace": [
0.5403226017951965,
1.0,
0.2016129046678543,
0.0,
0.22580644488334656,
0.0,
0.0,
0.1794193685054779,
0.0,
...
Recipes
Rename Character's Name
from kkloader import KoikatuCharaData
k = KoikatuCharaData.load("sa.png")
k.parameter["lastname"] = "春野"
k.parameter["firstname"] = "千佳"
k.parameter["nickname"] = "ちかりん"
k.save("si.png")
Set the Height of Character to 50
from kkloader import KoikatuCharaData
k = KoikatuCharaData.load("sa.png")
k.custom["body"]["shapeValueBody"][0] = 0.5
k.save("si.png")
Remove Swim Cap
from kkloader import KoikatuCharaData
k = KoikatuCharaData.load("sa.png")
for i,c in enumerate(k.coordinate):
for n,p in enumerate(c["accessory"]["parts"]):
if p["id"] == 5:
k.coordinates[i]["accessory"]["parts"][n]["type"] = 120
k.save("si.png")
Remove Under Hair
from kkloader import KoikatuCharaData
k = KoikatuCharaData.load("sa.png")
kc.Custom.body["underhairId"] = 0
k.save("si.png")
Member Variables
KoikatuCharaData.* | |
---|---|
png_data | raw png image |
face_png_data | raw face image |
face, body, hair | shape values |
coordinates(List) | contains seven coordinates corresponding to situation. |
parameter | personal data (i.e. name, birthday, personality, ..etc) |
Acknowledgements
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
kkloader-0.1.2.tar.gz
(9.1 kB
view hashes)
Built Distribution
kkloader-0.1.2-py3-none-any.whl
(11.0 kB
view hashes)