Home
Creators
Search Recent Random
Posts
Search DMs Popular Hash Lookup Tags Random
Importer
Import FAQ
Register Favorites Keys Review DMs Logout
Community
Telegram ThePornDude
Home Creators Posts Import Register Favorites Logout

HF Patch for KKS v2.2 (mods up to 2026/09/19) (Patreon)

Published:
2026-09-18 22:00:00
Edited:
2026-09-18 22:26:53
Imported:
Tags:

Content

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:F94BD30606DD26361BC827F54BAF2B58DD8C8777

Direct download links

Light patch (Small size, only use if you regularly update with KKManager)

Direct download links

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

Add Mods_readme.txt and create a mods/MyMods folder

Mods added

StudioPseudoMaker v1.5.2.0 (Brings most maker functionality to studio)

Mods updated

BepisPlugins v21.1.3 -> v21.1.4 (Collection of essential plugins)

Modding API v1.47 -> v1.48 (API needed for many plugins)

XUnity Auto Translator v5.6.1 -> v5.6.2 (Translation loader)

Material Editor v4.0.3 -> v5.0 (Adds advanced material controls to maker and studio)

Image Embed v1.0.3 -> v1.0.4 (Embeds custom images in scene files so others can load them)

Skin Overlay Mod v7.1.2.1 -> v7.1.3 (Custom body, clothes and eye textures)

KKS_AssetImport v3.1 -> v4.0.1 (Lets you import 3D assets into the game)

Maker/Studio Browser Folders v4.0.1 -> v4.0.2 (Folder support in chara/scene select screens)

KKS_VR v2.7 -> v2.7.1 (Allows you to play both the main game and studio in VR)

The Bird of Hermes v5.5.1 -> v5.6.0 (Timeline addon, allows loading an audio file, and get a waveform of the audio)

RuntimeUnityEditor v6.3 -> v6.3.1 (Debugging and development tool)

Mods removed

TreeNodeNaming (Merged into TreeNodeOrdering)

Files

Comments

mado777

hey there, could you direct me to a kspLug link? I was installing this patch and it said it would uninstall my current ksPlug and I'll have to install that again

hrohro

General question: Should I be getting Honey Select 2 DX from DLsite or from Steam? Also, do we lose download access to removed games if we purchase them on DLSite after they are removed?

ManlyMarco

Get it from Steam, it's the same in the end with HF Patch.

ManlyMarco

You have to find it on your own, sorry.

Crow Hunter

Do the games update automatically?

ManlyMarco
>>117028521

You can update clothing and studio mods through the game launcher. Plugins and other updates need a new version of the patch to be installed (you can use light patch in that case).

Mr.Prom

Hello there, I know I just asked a question a few days ago. But now I just found a new problem. And that problem is, I can't mouse click to touch or interact with the character in the H-Sence, Both in Free-H and main game. It's happened just a 2-3 days ago. I don't know what happened, It's a bug or some thing? Can you help me?

ManlyMarco

Restart your PC. Reinstall HF Patch if it didn't help.

Mr.Prom

Reinstall the HF patch is worked! Thank! You saved my day, again...

Irrelevant

HF patch is install. Can play the story but the Character creation is censored. Whys that?

ManlyMarco

Yes, you only need the latest version.

ManlyMarco

Maybe you pressed some plugin's hotkey, look through plugin settings.

Squid

thats what i thought but ive looked but im not able to find something related to that but ill check more. thanks

Xauching (edited)

Comment edits

2026-09-05 04:00 After Updating, the Stiletto mod/plugin just completely disappeared. Pressing RShift does nothing and even searching for it in the plugins menu doesn't show anything. I still have my Stiletto Folder but it only has the parameters saved for the Stilettos, none of the actual functional files.
2024-01-07 16:39

ManlyMarco

Did you check stiletto during patch installation?

ManlyMarco

It asks if you want to remove old mods and plugins when installing. Some will always get removed if they are known to cause issues. It never removes cards or anything else inside the UserData folder.

Mr.Prom

I didn't want to rush, But just curious. How long will it be before we see some more type of pussies? Like that we have in Koikatsu party. Especially the BP version (It would be great if we could have many more of that) Although it doesn't have much effect on gameplay. But it's just felt like something is missing.

ManlyMarco

At the moment there's no work being done on it. Anyone can learn how to convert the KK uncensors into KKS, ask on the discord server in the mod-modelling channel.

Mr.Prom

Sad....And I didn't have a discord but Understoond, I'll try it someday. Thanks!

Mr.Prom

"Problems with skirts" Hello again ManlyMarco. I just updated HF Patch to v.1.18. But now I'm having a little problem about the skirt that some of it was "dipping" into character thighs and butt cheeks (too bad that I can't post the Pictures to show these bugs in here or anywhere eles). In fact, These problems have been show up since v.1.16, But I think they might be fixed later, So I didn't respond for it. Maybe I can take some advice? or I need to wait until the next patch update? Thank you

ManlyMarco

I can't say much without seeing a screenshot of it. It'd be best if you could ask on discord in the #help channel since it's easy to send pictures and reply quickly.

Mr.Prom

Well, I think it's time to create my own discord account. Thanks for your reply. See you soon.

Jenn Caplan

Seems like the light patch for 1.18 is corrupted. The installation program says it's incomplete.

ManlyMarco

Make sure you downloaded all parts and file names weren't changed.

ManlyMarco

Never mind, confirmed that the light patch is borked, will fix in a bit.

Jenn Caplan

Well i downloaded the light patch and its 3 files multiple times and the installation keeps saying right at the end: "File verification failed, some of the files are corrupted or missing...". I've installed HFpatch with every updates for years, i've never had that problem. Guess i'll skip this one...

ManlyMarco

The light patch downloads are fixed now. Redownload the exe file and it should work.

ManlyMarco

Were these options added by a previous version of the patch or by outside plugins?

Muffinboy127

It seems studio vr is messed up know though, I can't adjust the FK or IK of characters anymore, when I try to move it nothing happens, and I can't save a default character or scene parameter anymore either, the option is just gone (even the options for character lighting are overlapping each and I can't access some of the options) some eye textures/overlays are missing from some of my characters now too (and I've only ever used mods that came from the patch or were given out by you like the public vr patch) On a related note are the older versions of the patch still available? I would love to re-download those

ManlyMarco

You can download older versions of the plugin on its github page https://github.com/IllusionMods/KKS_VR/releases It sounds like your game is borked in some way since there should be no real difference in the latest patch compared to previous. Post your output log file in the help channel on the discord server with an explanation of the issue.

Muffinboy127

Thank you! I redownloaded the version 1.13 version of the patch I had before and now everything is working just fine again!

LostDVayne

None of the links are working. Pixel link downloads upto 3.6 gb and crashes. can you please advice

ManlyMarco

Sounds like the link is working but your internet is cutting off. Try again later.

Landooze

Hey, I’ve got a question not exactly related to this specific update, just for KKP in general, I noticed in the character creator there’s a bunch of sprites for a couple Hoyoverse games and Vtubers but there’s no premade cards or character preset or whatever it’s called for them, is there somewhere I can go to find them so I don’t have to put the characters together myself?

ManlyMarco

Hello, check card sharing channel on the discord server or bepisdb.

Landooze

I don’t think I’m in the discord, what’s the link to it?

ManlyMarco

Link in post above and in game launcher.

正幸 小林

When you load a costume, the skin of the costume disappears and becomes the original state.

ManlyMarco

Not sure what you mean, I suggest asking in the help channel on the discord server.

Hexmaller

I cannot edit any cards in character config but can still read the cards in free H mode, what should i do to fix this issue?

ManlyMarco

I don't know what you mean by this, can you ask in the help channel on the discord server?

Squid

Im using a patch from 1 or 2 updates ago. Is there a fix for VR when in a postion the chara doesnt transition the position only stays static? if that makes sense.

Лол Лол

Why can't I download even though I bought a membership?

ManlyMarco

What is the problem exactly? Read the direct download post for solutions to common issues. DM me here or ask in the #help channel on the discord server if you can't get it to work.

Adam Crawley

Is there a way to still get KK Sunshine? I noticed steam doesnt have it

ManlyMarco

It cannot be purchased any more. You'd have to find it second hand on disc.

Dark Lone Wolf

quick question is there a way to get the patch to work on the steam deck?

Jackal Black

Hi, I wanted to ask you. During the installation of the HF patch, you're asked if you want to reset the plugins, but I'm not sure if choosing to reload the plugins will also delete any plugins downloaded from other creators that aren't in your HF patch. Forgive the stupid question, but I'm afraid to give the OK to reset it, since I have several plugins recovered from various Patreons, Pixiv, and so on. I'd tear my hair out if I lost one, but only because I don't remember where to get it :P

ManlyMarco

Check readme on github, there's a proton section.

ManlyMarco

Yes it will remove already existing plugins if checked. A backup will be created in game directory first so you can restore what you need from there later.

ねこ トマト

Hello. After the update for HF Patch for KKS, the separate loading of the scene folder is no longer displayed. What should I do about this?

ManlyMarco

I don't know what you're referring to. If it was a feature added by a plugin that is not included in the patch, you can restore it from the bacup zip file that the patch created in the game directory. For further help you'll have to send me a screenshot of what you mean, ideally in the #help channel on the discord sever.

Charlie

is there a way to have Kplug work with the patch?

ManlyMarco

You can install it like into any other game install, check its readme.

Blake Regulus

Hey! Thank you for the hard work! A bit unrelated question but, will you be making an HF patch for Illgame's upcoming Aikomi game?

Jian Tan

I cant click on girls during H before and after the update, mouse can click all else, why is that?

Mr.Prom

Go to H scene and try press the "A" button and then try again. If that doesn't work, you may need to reinstall the HF Patch, avoiding the keyword "hotkeys...(something)..." and the "console...(something)..." mods, I don't remember the full name of those mods. But I think that the case of your problem

Jian Tan

Yeah I just tried, pressed A fixed it and idk how lol, thanks anyways.

ManlyMarco

This will be fixed in the next version.

Zenkusan

does this patch have the full unlock included? or is there a need for a 100% save file

ManlyMarco

It has a full save + you can unlock anything you want with cheat tools, press F12.

gagap

Hello. After updating the HF Patch for KKS, I get the message "KKS_BrowserFolders cannot be loaded because they are incompatible with KKS_StudioDefaultData". What should I do?

ManlyMarco

Remove KKS_StudioDefaultData or install HF Patch again and tell it to remove all old plugins.

gagap

thank you. Removing KKS_StudioDefaultData resolved the issue.

c

There were two KKSUTS mods installed, and they did not work properly in my environment. Removing either one fixed the issue. {kks_root}\mods\Sideloader Modpack - KK_MaterialEditor\[Pizdatyi] KKUTS 2.5.1B.zipmod {kks_root}\mods\Sideloader Modpack - Exclusive KKS\nHaruka[nHaruka] KKSUTS v2.2.zipmod

ManlyMarco

This should be fixed, did you install v2.0 of the patch? You may need to tell it to remove old zipmods or update the modpack from launcher.

Squid

im using the latest patch, is there a problem with male privates when in h scenes?

Stmotion

After the update, my save file is no longer at 100%, and even changing the save file doesn't solve the problem.

Stmotion

H mode 100% pose >>> about 50%pose(after update)

ManlyMarco

Maybe the "All animations in free H" setting is turned off in plugin settings.

薙 嵐

Hello, I'm using the recommended installation, but when I try to change the language, it always displays the message: "This language may contain untranslated texts. In this case, they will appear in the original language for a few seconds and then be translated online by Google Translator." How can I resolve this?

Utamaru

いつもありがとう

Anime fan

Do you plan to release an HF patch for the new game Amanatsu Location?

花火

May I ask if the "Amanatsu Location" translation is ready for use?

Vena.Sera423

your best bet is getting the better repack

Vena.Sera423

I just switched over to Linux Mint on my main system and managed to get the main game to work, however it does not load my HF patch and mods. Any pointers?

XboxLegend

Hello, lately for a few months I've been having issues with accessory clothing's not working and I'm hoping a patch like this has fixed that since I hadn't been around here in a few months or so since last time.