¤ Introduction ¤
- Installation -
This Mod dll is designed for Ipa Plugin, though it
can work with BepInEx.
Current build is made for Koikatsu verions 5.0 or 5.1, this won't work
with older ones.
METHOD 1- JUST with BepInEx
Assuming BepInEx is there, just drag and drop archive
contents in Koikatsu's game folder.
If the plugin is not working at all in story, you're probably using
an old IPALoader.dll, in that case, use the one from the archive,
just remove the ".workOnMySide" extension.
METHOD 2- PATCHING WITH IPA
Do not do that if you choose the method one !
here we need IPA, you can find it there https://github.com/Eusth/IPA/releases
In the archive, you will find a folder named IPA, and two files,
IPA.exe and Mono.Cecil.dll, put those in "Koikatu"
folder then drag and drop Koikatu.exe and CharaStudio.exe ( one by
one ) on IPA.exe.
Now a "Plugins" folder should be created in "Koikatu"
directory, put KoikPlugins.dll inside.
To make it work along bepInEx with that method, get rid of "Koikatu/BepInEx/IAPLoader.dll"
( move it elsewhere or change the extension )
- About the uncensors -
kPlug use its own uncensors for both male and
female.
Female uncensor have some additional bones for a fleshy effect and
Male uncensor color fit the body's one.
Uncensor isn't required to use other kPlug's functions!
kPlug's uncensor isn't a sideloaded mod, you have to replace original game files
Two files are concerned
"abdata/chara/oo_base.unity3d" (
main body and skeleton)
"abdata/studio/base/00.unity3d" (
studio skeleton )
If BepInEx side loaded uncensors are
there
SideLoaded uncensors override kPlug's one on scene load.
To avoid this, move "Uncensor" folder outside "Koikatu/mods",
to restore that, drop back "Uncensor" folder in "Koikatu/mods".
- Compatibility -
The good news is kPlug is compatible with almost
all bepInEx mods you will find!
though, almost all means some of them are not...
Using a lot of bepInEx side loaded mod will deeply
impact loading and saving time. That will also slow down a lot
invitation and swap function during free H.
More you are using, worst it will be... Those issues aren't coming
from kPlug.
So far, list of Known mods that creating issues
Koikatu
Additional_Positions_v0.03
clash with this mod appears on shower and toilet peep
scene. kPlug can't define properly H context and will try to invite
girl around but failed.
It can be easily removed, delete all abdata/h/list/13_00_PH*.unity3d
files
( both version, normal and big
boobs )
First issue, this mod is using a side loaded character's skeleton
with extra colliders, this skeleton override original one when game
is loading a character .
Since atari's skeleton don't contains the additional bones used by
kPlug's uncensor, you will face a nasty bug where girl's pelvis will
stick on scene origin if you try to run kPlug's uncensor with
atari...
That part is fixable ! ( see below )
Once atari is fixed on the bones issue you can fully enjoy it in
free h ! However, here come the second and unsolvable issue...
If you're playing in story mode your game will most probably end by
an infinite loading screen.That will definitely happen after H with
multiple girls and may occur in some other undetermined case(s).
Loading screens subject to infinite loop are, from morning
H to school from after school to Go back
together and from home to next day
Those are particular loading times where the game destroy and
re-create an environment, bepInEx seems to failed on ending a
process after kPlug have load something that have a sideloaded mod
on it, here, the skeleton.
It seems some other mods could creates this infinite loading loop
bug
Don't know what's this mod for, but it's reported to creates bugs
It's just a clothes mod, but weirdly, it have been reported to create freeze bug.
This mod is reported to mess-up when swapping characters
Seems that older versions are working
Things we can fix
Since Atari is not my work, I will not redistribute a
fixed version of the whole mod, you have to work a little bit.
In kPlug"s archive folder "_fixForAtari", you will
find the two version of atari's skeleton but with the additional
bones.
Unzip your original atari mod archive and, in the unpacked folder,
replace the file oo_base.unity3d by the tweaked
one, depending if you use normal or oversized version.
Then just repack the archive in .zip and that's all.
Missing bones are issues but useless bones are
not. So, once you patch your atari version you can still use it
with other uncensors.
- Use or Create a Translation for kPlug -
Using a translation
By default, kPlug archive contain the English translation
"Plugins/kPlugLanguage/English_message.txt"
"Plugins/kPlugLanguage/English_ui.txt"
When translation are found, kPlug's settings will contain an option to
enable it.
English is the native language, English translation is exactly the
same, it's provided for the purpose of creating translation, if you
don't need translation, remove the kPlugLanguage directory from
Plugins, language option will disappear from settings.
Create and Edit a translation
To recognize a language kPlug need to find two corresponding files in
folder "Koikatu/Plugins/kPlugLanguage", these files
must match the following naming convention, Language_message.txt
and Language_ui.txt
example: 日本語_message.txt and 日本語_ui.txt
kPlug only search for translation files when game start, avoid to create or removed these files when game is running
To create a new translation, simply use or duplicate
the 2 files in English and replace "English" with the target language
on their names.
Then, to translate these files open them and replace the text between
"" with another one. When the text line in indexed do not remove or
translate the index part
( example "0:This is the best! )" > "0:これは最高です!"
Do not use those character in translation " : { } =
Translation files can be edited while the game is running!