• Stars
    star
    105
  • Rank 326,648 (Top 7 %)
  • Language Inno Setup
  • License
    GNU General Publi...
  • Created about 3 years ago
  • Updated 6 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Automatically translate, uncensor and update Koikatsu Sunshine!

preview

HF Patch for Koikatsu Sunshine!

An unofficial patch for Koikatsu Sunshine with fan-made English translations and essential mods. It will allow you to load all character cards and scenes and give you countless content creation and gameplay improvements while still keeping the original, uncluttered feel of the game. All content is tested and fixed (or removed) as needed before each update, providing a stable platform for further modding. HF Patch can also repair many common issues, try it if you have issues.

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 can be 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. You can buy the Japanese version on DMM (English/Steam release not announced yet). You can watch a guide on how to buy and install games from DMM here.

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.

You can support development of HF Patch and many of the included plugins through my Patreon page: https://www.patreon.com/ManlyMarco

What's included?

HF Patch includes and installs by default:

  • All free updates (no need to install any updates manually)
  • Fan-made translations and automatic machine translations to fill in gaps
  • Most commonly used plugins and mods, which allows you to load most character cards and scenes available online
  • Fixes for common issues with the game and mods like botched mod installs
  • Full uncensor with multiple different models You can see a full list of what HF Patch contains here and/or by checking contents the .iss files. Note that HF Patch does not contain the full game, paid expansions or any other pirated content. The full game needs to be already installed for the patch to work. If you want to use the VR module, also install it before patching!

Download

Check the Releases page for download links. The magnet links need to be downloaded with a torrent client like qBittorrent. To get mail updates for each new release you can watch this repositiory (top right) or watch the linked patreon page.

How to install the patch?

Here's a video guide that might be useful. The guide is mostly universal between different games, but there might be some differences.

Text guide

  1. Install Koikatsu Sunshine to a directory with no Japanese characters in its path (e.g. D:\Games\KKS)
  2. (Optional) Install any DLCs* you have. You don't have to install all of them, you can pick only some DLCs or don't install any DLCs at all.
  3. Download the latest HF Patch release from Releases. You should get a single .exe file along with a few .bin files. You can place these files anywhere you want (except the folder where the game is located), but they HAVE to be in the same folder together. DO NOT download any .zip files from GitHub - they contain source code for the patch, not the patch itself.
  4. Install the latest HF Patch by running the .exe and following the wizard. The default settings should work well for most users.
    • During the installation the patch may appear stuck, unless you get an error wait for it to finish.
    • If you use the light version of the patch its a good idea to update your Sideloader Modpack separately, you can do this by selecting update in the launcher or using the look for mods option in KKManager.
  5. Done! You can now start the game launcher as usual and you will notice some new options straight away. You can remove the downloaded patcher files now if you want to save some space. Special patch is included in HF Patch, you don't have to install it manually. It won't hurt anything if you have it installed already, the patch will figure itself out. Just to be safe you can verify game files in Steam before installing the HF Patch if you messed with your installation folder before doing this.
    • Keep in mind that the first launch of the game after patching could take a couple minutes on slower systems and the game window might not appear immediately.
  6. (Optional) You can update the modpacks by clicking the update button within the launcher. You can leave out Sideloader Modpack - Studio if you don't plan on using studio.

Note: If you want to run the game under Wine/Proton (Linux, SteamOS, macOS, etc.), read this and this.

How to install DLCs

DLCs are extra paid content and are all fully optional. Here's a simple way to install any downloaded DLCs (JP versions):

  1. Extract the DLC/expansion with 7zip (or similar) until you find a "setup" folder that contains an "abdata" folder and some other files.
  2. You need to copy all of these folders and files into your game's install directory (you should see our own abdata folder and other files similar to what's in the DLC). Replace files when asked.
  3. Install HF Patch, even if you already have it installed. (Optional, but if you replaced any files then you should reinstall it) DLCs for Koikatu and EmotionCreators will not work with Koikatsu Sunshine, trying to install them is likely to break your game (you might need to fully reinstall the game to fix it afterwards).

Solutions to common issues with the patch

  • If after installing the patch you have issues running the game, restart your PC and try to install the patch again with default settings.
  • If after installing the patch Studio hangs when loading, start KKManager (it's in a folder in game directory) and click "Look for updates" at the top, then tell it to update the Studio modpack. Or press the update button in the launcher.
  • If you have trouble downloading by using the magnet link, try updating your torrent client or use the latest qBittorrent (it's known to work well).
  • Make sure you downloaded ALL parts to the same folder and that the parts all have the same name. You need ALL parts for the patch to work. If the installer asks you for another disc it means that your download was not extracted correctly and is missing files, or you renamed or removed some of the extracted files.
  • If you see any messages about corrupted files you'll have to re-download the offending part (or all of the parts). If you downloaded the torrent, most torrent clients can "force recheck" the downloaded files so you don't have to re-download the whole thing.
  • If your antivirus is flagging the .exe file make sure that you've downloaded the patch by following links in this post. If you are sure the download came from the right place, it's most likely a false positive (it's a common issue with non-signed application installers).
  • On slower drives it can take a few minutes to finish verifying the files since it has to read and hash a lot of data. If you can see it's doing something in task manager then just let it run.

Discussion and help

There is an extensive FAQ on the wiki and in the Koikatsu! discord server. There are also some guides available on the server.

If you need further help, feel free to ask in the #help channel on the server. Try to search for your issue first by using the Discord's search box at top right, it might have been already answered before. Please don't ask for help under this guide because I rarely check the comments here.

General FAQ / Notes

  • Koikatu and Koikatsu Party (KK/KKP) are 2 versions of the same game and both work with the KK HF Patch. Koikatsu Sunshine (KKS) is a completely separate sequel that works with the KKS HF Patch (this distinction is important!).
  • KKS shares many common parts with KK/KKP, but it is not directly cross-compatible in most cases - you can't use DLC or plugins for one game in the other (with some exceptions of course).
  • You can configure many plugins by Pressing F1 and then "Plugin settings". You can also see most of the plugin hotkeys in this menu (and change them).
  • You only need to install the latest version of the patch. If you installed a previous version you don't have to do anything, just install the latest version as normal.
  • Installing HF Patch will add free updates, which contain Studio (separate exe file). For many people this is the only mode they use (apart from character maker to make characters for use in studio), so it is highly recommended that you check it out. All of Koikatu and Koikatsu Sunshine HF Patch preview images were made in studio. You can see other people's creations and download their studio scenes from the Discord server and various card sharing boorus.
  • HF Patch does not contain the full game, paid expansions or any other pirated content. The full game needs to be already installed for the patch to work. If you want to use the VR module, also install it before patching! All paid DLC are optional and not required, you can skip them and the patch will still work fine (some features might be disabled/unavailable).
  • You can install HF Patch over almost any game install and have it work perfectly, and you can run it again to enable/disable some plugins. This patch will automatically fix many broken game/mod installs and common issues. Just make sure to let it remove all old mods when asked.
  • You can see other people's creations and download their studio scenes from the Discord server, bepisdb and the booru. You might need to run Update from game launcher to load some cards and scenes if they use mods not included in the patch.
  • It's recommended to install all content mods if you plan to download character cards (Studio modpack is optional in case you won't use studio) - they are required by many cards and scenes. If you find a card that is showing mod missing warnings try updating Sideloader Modpacks. This can be done by simply pressing the update button in the launcher or by launching KKManager and using the look for mods option.
  • The mods included in the patch don't modify any game files and can be easily disabled by removing the "winhttp.dll" file from your game directory. Official patches are applied permanently.
  • Please leave the modders some positive feedback or help them in some other way!
  • There is no warranty on this patch or on any of the included mods. You are installing this patch at your own risk. That being said, we try our best to help in case of issues. If you find any bugs, do let us know so they can be fixed.

How to build the source

At least Visual Studio 2017 is needed for the helper library and latest unicode Inno Setup compiler is needed for the patch itself. All necessary mods have to be placed inside correct subfolders of the Input directory to compile. Because of massive size, they are not included here.

More Repositories

1

RuntimeUnityEditor

In-game inspector and debugging tools for applications made with Unity3D game engine
C#
763
star
2

KK-HF_Patch

Automatically translate, uncensor and update Koikatu! and Koikatsu Party!
Inno Setup
681
star
3

AI-HF_Patch

Automatically translate, uncensor and update AI-Shoujo!
Inno Setup
225
star
4

HS2-HF_Patch

Automatically translate, uncensor and update HoneySelect2!
Inno Setup
153
star
5

UniversalUnityDemosaics

A collection of universal demosaic BepInEx plugins for games made in Unity3D engine
C#
148
star
6

ABMX

Adds more character customization settings to games by Illusion
C#
103
star
7

Illusion-Overlay-Mods

Adds overlay texture (tattoo) support to games by Illusion
C#
97
star
8

KoikatuGameplayMods

Mod that tweaks and (hopefully) improves Koikatu gameplay
C#
81
star
9

IllusionCheatTools

Trainer for games by Illusion
C#
81
star
10

VRK-HF_Patch

Automatically translate, uncensor and update VR Kanojo!
C#
40
star
11

HC-HF_Patch

Automatically translate, uncensor and update HoneyCome!
Inno Setup
33
star
12

FPSCounter

FPS counter plugin for BepInEx - measure frame time and plugin performance
C#
32
star
13

Illusion_BrowserFolders

Add folder support to file browsers in games made by Illusion
C#
30
star
14

Illusion_ClothColliders

Plugin that lets mods with cloth components add their own colliders
C#
25
star
15

QuickAccessBox

Plugin for quickly searching through studio items in games by Illusion
C#
24
star
16

Illusion_SkinEffects

Additional Skin Effects mod for Koikatu and Koikatsu Sunshine!
C#
22
star
17

IllusionTrapMods

Mods for Illusion games that add traps or new trap features
C#
21
star
18

Illusion_HeightBar

Plugin for measuring character height in Koikatu! and AI-Syoujyo chara maker
C#
20
star
19

MoreAccessoryParents

Mod for Koikatu! that adds additional attachment points for accessories
C#
15
star
20

EC-HF_Patch

Automatically translates, uncensors and updates EmotionCreators!
Inno Setup
15
star
21

Illusion_ClothingStateMenu

Toggle state of clothes and accessories in character makers of some games made by Illusion
C#
12
star
22

EC_CorePlugins

Collection of essential plugins for Emotion Creators
C#
10
star
23

Illusion_BetterColorPicker

Plugin that adds ability to pick color from anywhere on desktop in character maker and studio
C#
8
star
24

KK_ImageSeriesRecorder

Records Koikatsu! to a series of images in high quality and frame rates
C#
8
star
25

KK_PantyFairy

A custom side quest for Koikatsu with some new gameplay features
C#
7
star
26

RG-HF_Patch

Automatically translate, uncensor and update RoomGirl!
Inno Setup
7
star
27

Illusion_RemoveToRecycleBin

Plugin for games by Illusion that moves overwritten cards to recycle bin
C#
6
star
28

IL_SliderHighlight

Plugin that highlights the area affected by sliders in character maker
C#
4
star
29

VRKanojo_Plugins

A collection of BepInEx plugins for VRKanojo
C#
4
star
30

KK_GamepadSupport

Adds support for gamepads and keyboard UI navigation to Koikatu!
C#
4
star
31

1room-English-Translation

Full English transaltion for the game 1room -Runaway Girl- by Akari Blast!
C#
4
star
32

KKLB-HF_Patch

Automatically uncensor and update KoiKoi Love Blossoms (恋ζ₯い温泉物θͺž)!
Inno Setup
4
star
33

KoikatuPlugins

Koikatu plugins
C#
3
star
34

InsultOrderDemosaic

Demosaic for the game Insult Order
C#
3
star
35

AGH-HF_Patch

Automatically translate, uncensor and update Houkago Rinkan Chuudoku!
Inno Setup
3
star
36

IO-HF_Patch

Automatically translate, uncensor and update Insult Order!
Inno Setup
3
star
37

IllusionSFW

Plugin that disables NSFW parts of some Illusion games (leaving SFW maker and studio)
C#
2
star
38

OniBoku_Demosaic

Demosaic for the game OniBoku (γ‚ͺγƒ‹γƒœγ‚―ο½žι¬Όε¨˜ζ·«ε§¦ο½ž)
C#
2
star
39

StudioExtraMoveAxis

Plugin for studio in Illusion games that adds extra move gizmo in bottom right corner
C#
2
star
40

DatsuiJanken-HF_Patch

Automatically translate and uncensor Undressing Rock-Paper-Scissors with Girl Next Door!
Inno Setup
1
star
41

INIfier.Bepin

Replace TextAssets of games made in Unity3D without modifying the asset files themselves
C#
1
star
42

MOMIJI_Demosaic

Demosaic for the game VR Futanari Sexaroid MOMIJI
C#
1
star