An unofficial patch for Koikatsu Sunshine that installs the latest fan-made English translations and essential mods. It also fixes many common issues with the game. It will allow you to load all character cards and scenes and give you countless content creation and gameplay improvements.
Read the full HF Patch manual to learn more about what it is, what it does, how to use it, and how to solve common issues.
Koikatsu is split into two parts: character and scene creation tools (character maker and Studio), and an adventure game with story mode (it can use your custom characters, but not scenes). You can see preview videos of the game and some of the mods here.
HF Patch does not contain the full game, paid expansions or any other pirated content. You have to buy the game and expansions separately. Unfortunately there is no English/Steam release and the game is no longer being sold, so the only way to get it is to buy it second hand.
The base game (Koikatsu Sunshine), and by extension this patch are not suitable for minors. If you are under 18 years old you can not use this patch. The base game and this patch contain only characters of age 18 or higher. The creator of this patch is not responsible for creations of its users and prohibits any unlawful use of this software.
Downloads
This download contains the entire HF Patch and can be used offline. You can use qBittorrent or a similar torrent client to open the magnet link. Old patch versions are available in direct download links.
Full patch (Everything is included, most people should use this)
magnet:?xt=urn:btih:290C168F23BF80237B0E820BD8EB4C2B0519CF0F
Light patch (Small size, only use if you regularly update with KKManager)
Read before installing
Before installing check this installation guide and FAQ.
If you have problems with installing the patch, check the solutions to common issues and the rest of the readme.
The EX expansion is entirely optional and can be skipped. It adds 4 new personalities with new type of events unique to them (old characters can't use these events). Remember that if you add the expansion later you will have to install HF Patch again afterwards.
If you need any further help check the wiki first, and if that doesn't help then ask in the #help channel of the Koikatsu Discord server. The #help channel is the fastest way to get help, you can even search it for your issue to see if someone already answered it. There are also chat and card sharing channels on the server!
To keep the download size reasonable, some rarely used and very old content mods or studio mods might not be included. If you have trouble loading characters or scenes, you can download the missing mods by clicking on the Update button in the game's launcher.
You can see the source code here and information about included plugins here.
Changelog
This changelog is only for the current version of HF Patch. To see changes made in previous versions of the patch, check the releases page on GitHub.
Patcher changes
Updated branding: new banners, icons and other assets
Updated info page
Updated patch binary license
Various minor fixes and improvements to the patch
Mods added
MuneRestoration v1.0.0 (Restores the Mune00 bones which are the root FK handles for breasts in studio)
RenameStuff v1.2.0 (Allows renaming anything in your workspace window (right click))
ClickToSelect v1.2.0 (Allows selecting items in studio by clicking on them)
Random Status v1.0.0 (Randomly changes the statuses of heroines in each period (Permanently))
Breath (Kokyu) v1.0.0 (Adds a breathing effect to characters)
Blink v1.0.0 (Modifies character's blinking (aimed at VR))
Compositor v1.2.0 (A Blender-like node compositor, that runs insideStudio)
Auto Keyframe v1.3.0.0 (Automatically updates any keyframes in Timeline that you change)
Mods updated
Sideloader Modpacks up to 2026/06/17)
IllusionLaunchers v3.4.1.69 -> v3.5.1.0 (Custom game launcher)
KKManager v1.8 -> v1.11.0.0 (Manage and update mods, browse cards)
BepisPlugins v21.1.2.1 -> v21.1.3 (Collection of essential plugins)
XUnity Auto Translator v5.5.1 -> v5.6.1 (Translation loader)
KKSPE v2.21.4 -> v2.21.5 (Advanced studio controls(Has issues))
Accessory Clothes v1.0.3 -> v1.0.4 (Necessary to load some accessories)
Material Editor v4.0.2 -> v4.0.3 (Adds advanced material controls to maker and studio)
Skin Overlay Mod v7.1.2 -> v7.1.2.1 (Custom body, clothes and eye textures)
NodesConstraints v1.6.2 -> v1.6.3 (Create custom animations in studio(possible issues)
Timeline v1.5.5 -> v1.5.5.1 (Advanced animation editor for Studio (Ctrl+T, read the Help)(possible issues))
Acc Mover v1.3.2.11 -> v1.3.3.11 (Revamps the Transfer tab of the accessories panel, letting you copy, move, or compact accessories)
IllusionFixes v22.1 -> v22.2 (A collection of important fixes)
KKSUS v1.15 -> v1.15.0.1 (Search boxes, studio and maker improvements)
KKS_VR v2.5 -> v2.7 (Allows you to play both the main game and studio in VR)
VideoExport v2.0.1 -> v2.0.3 (Video and gif recorder, press Ctrl+E(possible issues))
QuickAccessBox v3.4 -> v3.4.1 (Search all studio items, LeftCtrl+Space)
The Bird of Hermes v4.1 -> v5.4.0.0 (Timeline addon, allows loading an audio file, and get a waveform of the audio)
Custom intro voices v34 -> v35.0 (Satana perkele)