This is a set of tools for creating Koikatsu Sunshine mods in Unity Editor.
Note: Very early WIP, at the moment it's only useful for creating map mods. I strongly encourage you to use KoikatsuModdingTools for creating any other type of mod, since Koikatsu mods are compatible with Koikatsu Sunshine but the reverse is not true.
- Download Unity 2019.4.9 which is the version that Koikatsu Sunshine uses.
- Download the repository by clicking the green "Clone or download" button on Github, up in the top right.
- Open the project in Unity.
- Try the example projects.
- Download the repository
- Copy your Mods folder from your old project to the newly extracted project
Included in this set of modding tools are some examples that should illustrate how to create your own mods. Each example comes with a readme file explaining how it works and how to create your own.
How to create a body paint mod. Creating any type of 2D texture mod such as suntans, eyeliners, etc. is a similar process.
How to create an accessory mod.
How to create hair as an accessory with KK_HairAccessoryCustomizer compatibility.
How to create a clothes mod.
How to compile a shader and configure it for use with KK_MaterialEditor.
How to override a vanilla asset, for example when fixing or improving an asset from the base game.
How to create an item for Studio.
How to create a color filter for Studio.
How to create a map for use in Free H and Studio, complete with H Points, map masking, lighting, etc.
To create your own mod, you can use an example project as a base. Copy an example project to the Mods folder, then edit the manifest.xml and insert your own information. Add your textures, select them, and set a path inside the chara folder, such as chara[your_name][mod_name].unity3d. Do the same for your thumbnails. Edit the list file with the correct category number, fields, and content.
Once you have assets assigned to the asset bundles, click Window->AssetBundle Browser to bring up the build menu. Click Build All Assets and then Build All Zipmods. Only mods within the Mods folder will be built this way to keep your stuff separate from the example projects.
Included in this project are a set of placeholder shaders with all the properties of a vanilla game shader. These shaders are replaced in edit mode by the functional game shaders, and after asset bundles are built the placeholders are replaced by a copy of the original game shaders by an SB3UGS script.
When .fbx files are imported by placing them within the project structure scripts run which:
- Automatically remove excess bones (improved Blender compatiblity)
- Automatically set the layer to Chara, the layer most items need to use
Normal map textures are converted to the transparent-red style instead of the transparent-grey style typically created by Unity 5.6.2. This improves compatiblity with EmotionCreators for all mods built using KoikatsuModdingTools.
Note: Generally, using High Quality compression for textures is prefered, except where textures extract from game files already used Normal Quality compression (DXT5, DXT1).
It is possible with the use of uTinyRipper to import the contents of asset bundles you've created in the past, in case you would like to convert your existing mods to a format KoikatsuModdingTools can use. See the guide on how to do so.
Koikatsu Modding Tools is a work in progress, please report any bugs you may find. If you are interested in contributing to development, these are the things that need to be done.
- Create a pretty UI for creating list files
- Write instructions and tutorials for all types of mods with pictures and explanations of all parts of the mod
- Option to apply color correction to textures
- Automatically generate textures for low poly
Enimaroah: SB3UGS and updating it to support shader replacement, and also for the script which removes excess bones from imported .fbx files (for Blender .fbx compatibility)
Marco: List file editor UI which I still have yet to finish
Essu: Coding help and advice
AmplifyColor
Unity Asset Bundle Browser