Difference between revisions of "Koikatu/Technical Help"

From Hgames Wiki
Jump to: navigation, search
(Sync with kks faq)
m (Added more technical information regarding Windows)
 
(6 intermediate revisions by 2 users not shown)
Line 14: Line 14:
 
* '''Q : How do I manually install updates and DLCs?'''<br>A : (Japanese release) Unpacking the paid DLC (the afterschool DLC) must be done in Japanese locale, either by setting your machine to it, or via a locale emulator. Unpacking the Xmas update should work in any locale. Once unpacked, you should see a folder named setup. Copy and paste the contents of the setup folder over your game folder, and overwrite. First install both paid expansions, then latest game patch, then yoyaku/darkness.<br>If you have the game on Steam you don't need to do anything special, just install any DLC you want from your library.<br>'''Warning:''' After manually updating the game you will probably have to reinstall HF Patch if you use it. You also need to reinstall HF Patch when Steam updates your KK Party and after you add or remove DLC.
 
* '''Q : How do I manually install updates and DLCs?'''<br>A : (Japanese release) Unpacking the paid DLC (the afterschool DLC) must be done in Japanese locale, either by setting your machine to it, or via a locale emulator. Unpacking the Xmas update should work in any locale. Once unpacked, you should see a folder named setup. Copy and paste the contents of the setup folder over your game folder, and overwrite. First install both paid expansions, then latest game patch, then yoyaku/darkness.<br>If you have the game on Steam you don't need to do anything special, just install any DLC you want from your library.<br>'''Warning:''' After manually updating the game you will probably have to reinstall HF Patch if you use it. You also need to reinstall HF Patch when Steam updates your KK Party and after you add or remove DLC.
 
* '''Q : What is a Koisona?'''<br>A : Koisona was coined on the Koikatsu Discord server to mean yourself made in the game.
 
* '''Q : What is a Koisona?'''<br>A : Koisona was coined on the Koikatsu Discord server to mean yourself made in the game.
* '''Q : What versions of Windows will Koikatsu run on?'''<br>A : Koikatsu will only run on 64 bit versions of Windows 7 and above due to the use of DirectX 11 graphics API. If you have a 64-bit processor but are running the 32-bit version of Windows, you will need to switch to 64-bit Windows.
+
* '''Q : What versions of Windows will Koikatsu run on?'''<br>A : It runs on Windows 7 64-bit and newer, but it will also work on Windows Vista 64-bit with Service Pack 2 installed as it supports DirectX 11.0. It will not run on 32-bit versions of Windows or under other 3D APIs such as Vulkan, OpenGL, or older versions of DirectX. Using an unsupported 3D API such as DirectX 9.0c to play the game will result in a never-ending pink screen, which happens on Windows XP 64-bit (x64). If you have a 64-bit processor but are running the 32-bit version of Windows, you will need to switch to 64-bit Windows.
 
* '''Q : Do I have to use a locale emulator or change my system locale?'''<br>A : You don't have to do anything with system locale to run the game (might only apply to modded games). You might need to use a locale emulator or change system locale to install/extract the Japanese release and updates, however.
 
* '''Q : Do I have to use a locale emulator or change my system locale?'''<br>A : You don't have to do anything with system locale to run the game (might only apply to modded games). You might need to use a locale emulator or change system locale to install/extract the Japanese release and updates, however.
 
* '''Q : Does Koikatsu require Steam to be running or the game DVD image to be inserted in order to play?'''<br>A : No, Koikatsu doesn't have any DRM so you can play the game without Steam started or the DVD inserted. If you run the game .exe directly then Steam will not show you as playing the game.
 
* '''Q : Does Koikatsu require Steam to be running or the game DVD image to be inserted in order to play?'''<br>A : No, Koikatsu doesn't have any DRM so you can play the game without Steam started or the DVD inserted. If you run the game .exe directly then Steam will not show you as playing the game.
Line 29: Line 29:
 
* '''Q : My game hangs on start after installing mods!'''<br>A : Wait for a while, first start after installing mods can take a long time, especially if the game is installed to a slow HDD. If you want to see loading progress you can turn on system console in the BepInEx/config/BepInEx.cfg file.
 
* '''Q : My game hangs on start after installing mods!'''<br>A : Wait for a while, first start after installing mods can take a long time, especially if the game is installed to a slow HDD. If you want to see loading progress you can turn on system console in the BepInEx/config/BepInEx.cfg file.
 
* '''Q : My maker starts very slowly!'''<br>A : Normally it varies between PC specs too, can took around 40-50 secs for average PC. Make sure you run the latest BepInEx and plugins, also check if you don't have too many cards in the root of character folders as it is also has impact in maker load times. You can put them in subfolders instead and use the browser folders plugin found here : https://github.com/ManlyMarco/KK_BrowserFolders/releases . Putting the game on SSD will also help to cut the load time a bit.
 
* '''Q : My maker starts very slowly!'''<br>A : Normally it varies between PC specs too, can took around 40-50 secs for average PC. Make sure you run the latest BepInEx and plugins, also check if you don't have too many cards in the root of character folders as it is also has impact in maker load times. You can put them in subfolders instead and use the browser folders plugin found here : https://github.com/ManlyMarco/KK_BrowserFolders/releases . Putting the game on SSD will also help to cut the load time a bit.
* '''Q : Mods/translations aren't loading!'''<br>A : Try moving the game to a simple directory like "D:\Games\KK", special characters in the game path or very long paths can cause issues.
+
* '''Q : Mods/translations aren't loading!'''<br>A : Try moving the game to a simple directory like "D:\Games\KK", special characters in the game path or very long paths can cause issues. If you're running under Wine on Linux, make sure you've added the winhttp DLL override (see https://github.com/Mantas-2155X/illusion-wine-guide/blob/master/parts/setup-wineprefix.md)
 
* '''Q : Title screen is partially black or has missing options, why?'''<br>A : This can be caused by KK Party being updated by Steam. Install the latest hf patch, or reinstall the special patch manually. When you're done, go to KK Party properties in your steam library and turn off automatic updates to prevent this from happening in the future.
 
* '''Q : Title screen is partially black or has missing options, why?'''<br>A : This can be caused by KK Party being updated by Steam. Install the latest hf patch, or reinstall the special patch manually. When you're done, go to KK Party properties in your steam library and turn off automatic updates to prevent this from happening in the future.
* '''Q : The game won't launch with WINE on Linux, what do I do?'''<br>A : Run Koikatu.exe directly instead of a launcher.
+
* '''Q : The game won't launch with WINE/Proton on Linux, what do I do?'''<br>A : Run Koikatu.exe directly instead of a launcher.
* '''Q : The game runs in WINE, but no mods/translations will load. How do I fix it?'''<br>A : Run 'winecfg' in a terminal. Select the Libraries tab. Under "New override for library:" type or select "winhttp (native,bulitin)". Add it, and hit Apply & OK.
+
* '''Q : The game runs in WINE/Proton, but no mods/translations will load. How do I fix it?'''<br>A : Run 'winecfg' in a terminal. Select the Libraries tab. Under "New override for library:" type or select "winhttp (native,bulitin)". Add it, and hit Apply & OK. For more info check https://github.com/Mantas-2155X/illusion-wine-guide and https://docs.bepinex.dev/articles/advanced/proton_wine.html
 
* '''Q : Gray boxes are missing text/are empty when the game is run with WINE, how do I fix it?'''<br>A : Run 'winetricks corefonts' in a terminal. You need to have winetricks installed.
 
* '''Q : Gray boxes are missing text/are empty when the game is run with WINE, how do I fix it?'''<br>A : Run 'winetricks corefonts' in a terminal. You need to have winetricks installed.
  
 
= Main game / Character maker FAQS =
 
= Main game / Character maker FAQS =
 
* '''Q : Are there any official manuals?'''<br>A : To check thein game manual, press F5. It covers a lot of the gameplay. There is also a separate manual inside your game directory, you can open it through the game launcher.
 
* '''Q : Are there any official manuals?'''<br>A : To check thein game manual, press F5. It covers a lot of the gameplay. There is also a separate manual inside your game directory, you can open it through the game launcher.
 +
* '''Q : I can't play the game? Missing Story button?'''<br>A : Assuming you have KK Party, you need to either install the official Special Patch (unlocks story mode and some other things), or the unofficial HF Patch (unlocks everything including studio, and installs commonly used mods).
 +
* '''Q : School is empty! No girls. I am alone. How to add girls?'''<br>A : Add characters in the roster screen (you can do it when starting a new game, or at the end of every day in the night menu).
 
* '''Q : How do I save the game?'''<br>A : You can save the game at the end of each day in your room, and only there.
 
* '''Q : How do I save the game?'''<br>A : You can save the game at the end of each day in your room, and only there.
 
* '''Q : How do I end the day quickly?'''<br>A : Press Middle mouse Button and click Home Icon to end the day and go to your room.
 
* '''Q : How do I end the day quickly?'''<br>A : Press Middle mouse Button and click Home Icon to end the day and go to your room.
 +
* '''Q : What are the blue shadows? Everyone is blue? Blue ghosts?'''<br>A : They are added by a plugin to give more life to the school environment (they are not interactable). To turn them off, open the settings (F1) and click on Plugin settings, search for "mob" and turn off the relevant setting.
 
* '''Q : What are Character cards?'''<br>A : Character cards are special images in the format .png that contains data from the character to be loaded in the game. With this system you can pick up character from internet and load on your game and vice versa. Put cards in the appropriate UserData folder. '''Note''': Be sure to download the original card image file, not a miniature or a photo of a card, otherwise it will not work!
 
* '''Q : What are Character cards?'''<br>A : Character cards are special images in the format .png that contains data from the character to be loaded in the game. With this system you can pick up character from internet and load on your game and vice versa. Put cards in the appropriate UserData folder. '''Note''': Be sure to download the original card image file, not a miniature or a photo of a card, otherwise it will not work!
 
* '''Q : Where do I place character cards?'''<br>A : \Userdata\Chara\male or female
 
* '''Q : Where do I place character cards?'''<br>A : \Userdata\Chara\male or female
 
* '''Q : Do Koikatsu Sunshine cards work on Koikatsu?'''<br>A : No, KK Sunshine can load KK cards but not the other way around.
 
* '''Q : Do Koikatsu Sunshine cards work on Koikatsu?'''<br>A : No, KK Sunshine can load KK cards but not the other way around.
 
 
* '''Q : Where can I get more girls cards?'''<br>A : Other than the built-in network share feature there are many sites that share cards. Here's a brief list:
 
* '''Q : Where can I get more girls cards?'''<br>A : Other than the built-in network share feature there are many sites that share cards. Here's a brief list:
 
** #card-sharing channel on the Koikatsu Discord server
 
** #card-sharing channel on the Koikatsu Discord server
 
** In-game network option (only works for unmodded games, your IP needs to be located in Japan)
 
** In-game network option (only works for unmodded games, your IP needs to be located in Japan)
** https://db.bepis.io/koikatsu
+
** https://db.bepis.moe/koikatsu
 
** https://kenzato.uk/booru/category/KK
 
** https://kenzato.uk/booru/category/KK
 
** https://illusioncards.booru.org/index.php?page=post&s=list&tags=koikatsu
 
** https://illusioncards.booru.org/index.php?page=post&s=list&tags=koikatsu
Line 53: Line 55:
 
* '''Q : Why I can't connect to the servers to check out/download characters through ingame menus?'''<br>A : The official server blocks non JP ips. There was a mirror server for westerners, but it's been down for months now, most likely forever.
 
* '''Q : Why I can't connect to the servers to check out/download characters through ingame menus?'''<br>A : The official server blocks non JP ips. There was a mirror server for westerners, but it's been down for months now, most likely forever.
 
* '''Q : My maker starts very slowly!'''<br>A : Normally it varies between PC specs too, can took around 40-50 secs for average PC. Make sure you run the latest BepInEx, BepisPlugins and IllusionFixes. Also check if you don't have too many cards in the root of character folders as it is also can impact maker load times. Putting the game on SSD will also help to cut the load time a bit.
 
* '''Q : My maker starts very slowly!'''<br>A : Normally it varies between PC specs too, can took around 40-50 secs for average PC. Make sure you run the latest BepInEx, BepisPlugins and IllusionFixes. Also check if you don't have too many cards in the root of character folders as it is also can impact maker load times. Putting the game on SSD will also help to cut the load time a bit.
 +
* '''Q : Story mode starts very slowly or has bad performance! (low FPS / lags / stutter)'''<br>A : Try reducing the maximum number of characters loaded (you can do it in the NPC list or in game settings). Turn off the "force high poly" setting in plugin settings to let the game use lower quality character models (might cause graphical issues with characters using modded items). Putting the game on SSD will reduce load time a bit but it won't affect FPS and stutter. Make sure your IllusionFixes are fully updated to reduce stutter and improve FPS.
 
* '''Q : The card I downloaded isn't loaded correctly?'''<br>A : This usually means you don't have the correct mods for the card, it's hard to determine which mods the creator use so to save your time you can download either latest HF Patch (link above). Alternatively, you can manually update modpacks from game launcher > Update (assuming your game is already modded). If after updating the card still does not load correctly it might have been made in old version of the game or with conflicting hardmods. In either case you will most likely need to fix the card yourself in character maker.
 
* '''Q : The card I downloaded isn't loaded correctly?'''<br>A : This usually means you don't have the correct mods for the card, it's hard to determine which mods the creator use so to save your time you can download either latest HF Patch (link above). Alternatively, you can manually update modpacks from game launcher > Update (assuming your game is already modded). If after updating the card still does not load correctly it might have been made in old version of the game or with conflicting hardmods. In either case you will most likely need to fix the card yourself in character maker.
 +
* '''Q : The card I downloaded loads correctly in maker/studio but doesn't load correctly in story mode?'''<br>A : Try turning on the "force high poly" setting in plugin settings. Note that it will increase memory and graphics usage by a decent amount so you might need to reduce the maximum amount of characters loaded at once. Also make sure that showing all accessories is turned on in game settings (near the bottom) - some characters use accessories as hair so this should fix bald heads.
 
* '''Q : How do I take a screenshot?'''<br>A : Take a screenshot with background by using F9, and a transparent background shot with F11. To change the settings for better screenshots and see more features search for "Screenshot" in Plugin settings window (press F1). Screenshots are by default created inside \Userdata\cap
 
* '''Q : How do I take a screenshot?'''<br>A : Take a screenshot with background by using F9, and a transparent background shot with F11. To change the settings for better screenshots and see more features search for "Screenshot" in Plugin settings window (press F1). Screenshots are by default created inside \Userdata\cap
 
* '''Q : My card/scene isn't loading, what should I do?'''<br>A : You might have a thumbnail of the card with the character info stripped out. This can happen when posting the card on some websites and on Discord - make sure that you download the original png file (on discord click the "Open Original" button). Check if the card/scene you are using is a .png and about the same size as the cards/scenes you have that do load (if not, it might be missing the character data). If it has a logo, it is most likely a screenshot. Make sure you have your game updated to the latest version too.
 
* '''Q : My card/scene isn't loading, what should I do?'''<br>A : You might have a thumbnail of the card with the character info stripped out. This can happen when posting the card on some websites and on Discord - make sure that you download the original png file (on discord click the "Open Original" button). Check if the card/scene you are using is a .png and about the same size as the cards/scenes you have that do load (if not, it might be missing the character data). If it has a logo, it is most likely a screenshot. Make sure you have your game updated to the latest version too.
Line 113: Line 117:
 
* '''Q : I got a broken character shoulder in the Maker, How do I fix it?'''<br>A : This is caused by incompatibility between Stiletto and MakerOptimizations plugins. Press F1, go to Plugin Setting on top right, Disable the "Disable Maker IK" on there and restart the game. This setting should automatically get disabled if Stiletto is detected in latest versions.
 
* '''Q : I got a broken character shoulder in the Maker, How do I fix it?'''<br>A : This is caused by incompatibility between Stiletto and MakerOptimizations plugins. Press F1, go to Plugin Setting on top right, Disable the "Disable Maker IK" on there and restart the game. This setting should automatically get disabled if Stiletto is detected in latest versions.
 
* '''Q : I broken eyes with KKVMDPlayPlugin after updating the game?'''<br>A : This is caused by a bug in VMD plugin in versions not updated for Darkness/Yoyaku. To fix this go to your BepInEx/config.ini file, find the [VMDPlay] section, and change the CacheGagEyesTexture setting to False.
 
* '''Q : I broken eyes with KKVMDPlayPlugin after updating the game?'''<br>A : This is caused by a bug in VMD plugin in versions not updated for Darkness/Yoyaku. To fix this go to your BepInEx/config.ini file, find the [VMDPlay] section, and change the CacheGagEyesTexture setting to False.
 +
* '''Q : Will Koikatsu Sunshine or Emotion Creators' assets work in Koikatsu?'''<br>A : Not without modifications. Both games utilize a newer version of the Unity game engine that doesn't have the same shader codebase used in Koikatsu. Any attempt to add them into Koikatsu will result in 'D3D shader blob is empty' errors in the log and a completely pink model of the original asset.
  
 
= Studio FAQs =
 
= Studio FAQs =

Latest revision as of 23:05, 16 September 2024

Illusion

all characters are at least 18


Koikatu [edit]

Install Guide

FAQ & Technical Help

Gameplay

Chara Studio

Modding


Most commonly asked questions and their answers, search for keywords to find your issue quickly. These FAQs have been in large part taken from the Koikatsu Discord server. If your question isn't answered here or you can't seem to fix your issue, visit the #help channel on the server. Note that if you just want to get the game working it might be easiest to install HF Patch (search below for more info).

If you have found an answer to your question and it is missing from here, please consider adding it! You can do it by clicking on the "Edit" tab in the top right part of the page.

General FAQs

  • Q : Where can I buy the game?
    A : The game is available in English on Steam (with DLC): https://store.steampowered.com/app/1073440/__Koikatsu_Party/
    The Japanese release and DLC can be bought here: https://dlsoft.dmm.co.jp/list/article=maker/id=30012/ or here: https://www.illu-member.jp/shop/products/detail.php?product_id=183
  • Q : What is the difference between the Steam release, Fakku release and original Japanese releases?
    A : The original Japanese release is called Koikatu! and is only intended for the Japanese market. Steam release is called Koikatsu Party (KKP) and is very similar to the Japanese version pre-darkness (assuming that the Special Patch that unlocks features is installed). All DLC older than Darkness and Yoyaku are available in English as the "AfterParty" DLC on Steam (The JP DLC can also be installed to KK Party, in that case only abdata folder has to be copied, and when asked to replace files you should select No to all). The Fakku release is basically the same as the Steam release except you can't get VR and AfterParty DLCs.
  • Q : How do I buy/download the game from DMM?
    A : Check this guide: https://youtu.be/WLoY5WCqTSw
  • Q : What is Paid DLC? Where to download it?
    A : Paid DLC, refers to expansion packs that have to be bought separately. There are currently two expansion available for purchase: Additional personality summer expansion (adds 3 new personalities and some clothes) and After School expansion DLC (it adds new features like new dating system and 3P sex). They can be bought separately or as a bundle with the full game here: https://dlsoft.dmm.co.jp/list/article=maker/id=30012/ (Japanese release only).
    If you have Koikatsu Party, both of these expansions were localized as the AfterParty DLC. You can buy it from your Steam library (find Koikatsu Party and it will be in the DLC column).
  • Q : Can I install Japanese paid DLC to the Steam version?
    A : All Japanese DLC older than Darkness and Yoyaku can all be installed to the English version (only abdata folder has to be copied, and when asked to replace files you should select No to all). That being said, you should get the AfterParty DLC instead. It contains all DLC compatible with Party at a lower price and with English and Chinese translations.
  • Q : Where to download the latest updates, mods and translations?
    A : You can use HF patch here : https://github.com/ManlyMarco/KK-HF_Patch/releases/latest (make sure you don't download the source code by mistake, follow the Download link around the center of the page). You'll need a torrent client to download torrent link. qbittorrent is an example of free and good ones, but you can use any other client. For Direct Download, you need to be a patron.
    If you want to find latest mods not yet included in the patch, check the mod release channel on the Koikatsu discord server.
  • Q : What is HF Patch?
    A : HF patch is install wizard, helps to ease you to install translations and mandatory mods and also can attempt to fix broken installs. Check the readme for more info: https://github.com/ManlyMarco/KK-HF_Patch
  • Q : What's All in One (AIO) update pack?
    A : It was a drag/drop update that contained the updates + default bepinex/plugins + translation. It is no longer supported and has been superseeded by HF patch. HF Patch is more involved install wizard that contains AIO and has more plugins + more mods. It can also automatically fix a lot of broken game/mod installations. The AIO is no longer maintained.
  • Q : How do I manually install updates and DLCs?
    A : (Japanese release) Unpacking the paid DLC (the afterschool DLC) must be done in Japanese locale, either by setting your machine to it, or via a locale emulator. Unpacking the Xmas update should work in any locale. Once unpacked, you should see a folder named setup. Copy and paste the contents of the setup folder over your game folder, and overwrite. First install both paid expansions, then latest game patch, then yoyaku/darkness.
    If you have the game on Steam you don't need to do anything special, just install any DLC you want from your library.
    Warning: After manually updating the game you will probably have to reinstall HF Patch if you use it. You also need to reinstall HF Patch when Steam updates your KK Party and after you add or remove DLC.
  • Q : What is a Koisona?
    A : Koisona was coined on the Koikatsu Discord server to mean yourself made in the game.
  • Q : What versions of Windows will Koikatsu run on?
    A : It runs on Windows 7 64-bit and newer, but it will also work on Windows Vista 64-bit with Service Pack 2 installed as it supports DirectX 11.0. It will not run on 32-bit versions of Windows or under other 3D APIs such as Vulkan, OpenGL, or older versions of DirectX. Using an unsupported 3D API such as DirectX 9.0c to play the game will result in a never-ending pink screen, which happens on Windows XP 64-bit (x64). If you have a 64-bit processor but are running the 32-bit version of Windows, you will need to switch to 64-bit Windows.
  • Q : Do I have to use a locale emulator or change my system locale?
    A : You don't have to do anything with system locale to run the game (might only apply to modded games). You might need to use a locale emulator or change system locale to install/extract the Japanese release and updates, however.
  • Q : Does Koikatsu require Steam to be running or the game DVD image to be inserted in order to play?
    A : No, Koikatsu doesn't have any DRM so you can play the game without Steam started or the DVD inserted. If you run the game .exe directly then Steam will not show you as playing the game.
  • Q : What engine does Koikatu run on?
    A : Koikatu uses Unity 3D game engine v5.6.2 (instead of Illusion's depreciated Yayoi engine). Check properties of the .exe file or read the log file for the exact engine version.
  • Q : How to change the game resolution or make the game full-screen?
    A : Open up the launcher (Initial Settings.exe or InitSetting.exe), there should be a dropdown to change your resolution and an option to run in full-screen. You can also toggle full-screen in-game by pressing Alt+Enter (might only apply to modded games).
  • Q : Can I run lower than 1280x720 for full-screen?
    A : Yes, as long as your Graphics Card supports widescreen with a lower resolution (e.g. 640x400) however you might need to manually edit setup.xml file located under the UserData folder in your game directory, otherwise you will have to opt into windowed mode. To Enable windowed mode, uncheck the box just below the resolution dropdown
  • Q : Where do I go for more comprehensive help?
    A : If this FAQ has not provided you with the tools or information to help you help yourself and you have exhausted absolutely all your options, please feel free to bring your problems to #help channel on the Koikatsu Discord server. Have your output_log.txt file ready (it's in the game root if your game has recent mods, or in /Koikatu_Data/output_log.txt, if you have some technical knowledge you might be able to use to to get a clue what your problem is). There are also many guides available on the server in the #guides channel on the server for many parts of the game, mods and modding.

Issues installing and starting the game

  • Q : My game is broken/won't run, what do I do?
    A : Try installing HF Patch, if that doesn't help ask in #help on the Discord server.
  • Q : When installing the game I get a cab/corruption error?
    A : Move the installation files to a simple directory like "D:\setup\" and run the .msi file.
  • Q : I am trying to install the HF patch, but I have a .zip file with a bunch of small files and folders inside. Which of them do I use?
    A : None of them. You may have downloaded the source files from GitHub instead of the compiled patch. HF Patch is an executable (.exe + a few .bin files) and can be found by following the link on this page here: https://github.com/ManlyMarco/KK-HF_Patch/releases
  • Q : My game won't start, and I use Citrix software?
    A : Citrix can crash the game on startup, check this for a fix: https://steamcommunity.com/discussions/forum/1/1743358239830363122/
  • Q : My game hangs on start after installing mods!
    A : Wait for a while, first start after installing mods can take a long time, especially if the game is installed to a slow HDD. If you want to see loading progress you can turn on system console in the BepInEx/config/BepInEx.cfg file.
  • Q : My maker starts very slowly!
    A : Normally it varies between PC specs too, can took around 40-50 secs for average PC. Make sure you run the latest BepInEx and plugins, also check if you don't have too many cards in the root of character folders as it is also has impact in maker load times. You can put them in subfolders instead and use the browser folders plugin found here : https://github.com/ManlyMarco/KK_BrowserFolders/releases . Putting the game on SSD will also help to cut the load time a bit.
  • Q : Mods/translations aren't loading!
    A : Try moving the game to a simple directory like "D:\Games\KK", special characters in the game path or very long paths can cause issues. If you're running under Wine on Linux, make sure you've added the winhttp DLL override (see https://github.com/Mantas-2155X/illusion-wine-guide/blob/master/parts/setup-wineprefix.md)
  • Q : Title screen is partially black or has missing options, why?
    A : This can be caused by KK Party being updated by Steam. Install the latest hf patch, or reinstall the special patch manually. When you're done, go to KK Party properties in your steam library and turn off automatic updates to prevent this from happening in the future.
  • Q : The game won't launch with WINE/Proton on Linux, what do I do?
    A : Run Koikatu.exe directly instead of a launcher.
  • Q : The game runs in WINE/Proton, but no mods/translations will load. How do I fix it?
    A : Run 'winecfg' in a terminal. Select the Libraries tab. Under "New override for library:" type or select "winhttp (native,bulitin)". Add it, and hit Apply & OK. For more info check https://github.com/Mantas-2155X/illusion-wine-guide and https://docs.bepinex.dev/articles/advanced/proton_wine.html
  • Q : Gray boxes are missing text/are empty when the game is run with WINE, how do I fix it?
    A : Run 'winetricks corefonts' in a terminal. You need to have winetricks installed.

Main game / Character maker FAQS

  • Q : Are there any official manuals?
    A : To check thein game manual, press F5. It covers a lot of the gameplay. There is also a separate manual inside your game directory, you can open it through the game launcher.
  • Q : I can't play the game? Missing Story button?
    A : Assuming you have KK Party, you need to either install the official Special Patch (unlocks story mode and some other things), or the unofficial HF Patch (unlocks everything including studio, and installs commonly used mods).
  • Q : School is empty! No girls. I am alone. How to add girls?
    A : Add characters in the roster screen (you can do it when starting a new game, or at the end of every day in the night menu).
  • Q : How do I save the game?
    A : You can save the game at the end of each day in your room, and only there.
  • Q : How do I end the day quickly?
    A : Press Middle mouse Button and click Home Icon to end the day and go to your room.
  • Q : What are the blue shadows? Everyone is blue? Blue ghosts?
    A : They are added by a plugin to give more life to the school environment (they are not interactable). To turn them off, open the settings (F1) and click on Plugin settings, search for "mob" and turn off the relevant setting.
  • Q : What are Character cards?
    A : Character cards are special images in the format .png that contains data from the character to be loaded in the game. With this system you can pick up character from internet and load on your game and vice versa. Put cards in the appropriate UserData folder. Note: Be sure to download the original card image file, not a miniature or a photo of a card, otherwise it will not work!
  • Q : Where do I place character cards?
    A : \Userdata\Chara\male or female
  • Q : Do Koikatsu Sunshine cards work on Koikatsu?
    A : No, KK Sunshine can load KK cards but not the other way around.
  • Q : Where can I get more girls cards?
    A : Other than the built-in network share feature there are many sites that share cards. Here's a brief list:
  • Q : Why I can't connect to the servers to check out/download characters through ingame menus?
    A : The official server blocks non JP ips. There was a mirror server for westerners, but it's been down for months now, most likely forever.
  • Q : My maker starts very slowly!
    A : Normally it varies between PC specs too, can took around 40-50 secs for average PC. Make sure you run the latest BepInEx, BepisPlugins and IllusionFixes. Also check if you don't have too many cards in the root of character folders as it is also can impact maker load times. Putting the game on SSD will also help to cut the load time a bit.
  • Q : Story mode starts very slowly or has bad performance! (low FPS / lags / stutter)
    A : Try reducing the maximum number of characters loaded (you can do it in the NPC list or in game settings). Turn off the "force high poly" setting in plugin settings to let the game use lower quality character models (might cause graphical issues with characters using modded items). Putting the game on SSD will reduce load time a bit but it won't affect FPS and stutter. Make sure your IllusionFixes are fully updated to reduce stutter and improve FPS.
  • Q : The card I downloaded isn't loaded correctly?
    A : This usually means you don't have the correct mods for the card, it's hard to determine which mods the creator use so to save your time you can download either latest HF Patch (link above). Alternatively, you can manually update modpacks from game launcher > Update (assuming your game is already modded). If after updating the card still does not load correctly it might have been made in old version of the game or with conflicting hardmods. In either case you will most likely need to fix the card yourself in character maker.
  • Q : The card I downloaded loads correctly in maker/studio but doesn't load correctly in story mode?
    A : Try turning on the "force high poly" setting in plugin settings. Note that it will increase memory and graphics usage by a decent amount so you might need to reduce the maximum amount of characters loaded at once. Also make sure that showing all accessories is turned on in game settings (near the bottom) - some characters use accessories as hair so this should fix bald heads.
  • Q : How do I take a screenshot?
    A : Take a screenshot with background by using F9, and a transparent background shot with F11. To change the settings for better screenshots and see more features search for "Screenshot" in Plugin settings window (press F1). Screenshots are by default created inside \Userdata\cap
  • Q : My card/scene isn't loading, what should I do?
    A : You might have a thumbnail of the card with the character info stripped out. This can happen when posting the card on some websites and on Discord - make sure that you download the original png file (on discord click the "Open Original" button). Check if the card/scene you are using is a .png and about the same size as the cards/scenes you have that do load (if not, it might be missing the character data). If it has a logo, it is most likely a screenshot. Make sure you have your game updated to the latest version too.
  • Q : The card I downloaded isn't loaded correctly?
    A : This usually means you don't have the correct mods for the card, it's hard to determine which mods the creator use so to save your time you can download either latest HF Patch (link above). Alternatively, you can manually install the Sideloader Modpack through KKManager (refer to Modding FAQs below for more info for installing mods manually). If after updating the card still does not load correctly it might have been made in old version of the game or with conflicting hardmods. In either case you will most likely need to fix the card yourself in character maker.
  • Q : The character I downloaded has really high/low voice pitch, what happened?
    A : This could mean the card is created before slider unlocker was fixed for voice pitches outside of 0-100 range People put the sliders outside of the range but before the actual value was clipped to the normal range, now it works "as expected"
  • Q : Why I can't connect to the servers to check out/download characters through ingame menus?
    A : The official server blocks non Japanese IPs. There was a mirror server for westerners, but it's been down for months now, most likely forever.
  • Q : My character's skirt is acting weird in character maker (boxy/sticking out corners)! Is this normal?
    A : Skirt issues can happen when you set your character hips slider too thin, (usually below 0), you need to test to see what the exact limit is (or wear pants instead). Skirt issues can also be caused by outdated BetterPenetration, make sure you are using the latest version.
  • Q : My character's skirt is vibrating rapidly?
    A : You can fix this by turning off vsync and limiting your FPS to 60.
  • Q : How can I change the height of my male character?
    A : There is no way to change the male height without using the ABMX plugin, but be advised that changing male height commonly leads to breaking certain animations.
  • Q : My game crashes every time this cutscene finishes/at the same point at the start of the day!
    A : Certain badly configured mods don't handle loading into cutscenes properly and will crash the game. Get latest version of IllusionFixes to fix this.
  • Q : My game freezes whenever I add certain girls to my class. What's causing it?
    A : This is probably caused by the girls using a modded personality. These modded personalities can only be used in Free H, and will break the story mode. Get latest version of IllusionFixes to fix this.
  • Q : My menu UI is messed up, what do I do?
    A : Your UI translation might be outdated. get the latest HF Patch to fix it automatically. Check if your game resolution / window size is in 16:9 aspect ratio.
  • Q : Why is the translation so poor? / Why did the translation get so bad all of a sudden?
    A : The vast majority of the translation is done automatically through machine translations, rather than a human. If you don't use a translation pack then you will get even worse translations since a worse machine translation service will be used. Get the latest HF Patch to make sure you have the latest translations.
  • Q : How do I unlock all the H animations without having to play the game?
    A : Assuming you have CheatTools installed, press the Pause key and look for the unlock settings in the left window.
  • Q : How do I access the new date locations?
    A : These locations will unlock after multiple regular dates beforehand. Once they do, continue to raise your affection stats by using the new locations, and inviting the girl home/to a hotel afterwards. More locations will unlock the higher your affection gets - and at higher affection, each location has a love event. Trigger all 4 love event to unlock the church.
  • Q : How do I access 3P?
    A : Both girls must be in lewd state or higher. Begin H with one girl while the other is in the same room. The option will appear in the bottom left. Alternatively, you can find two girls engaged in lesbian sex and ask to join in.
  • Q : How to get nicknames for each other?
    A : Spam Small Talk option while being a lover until you get the nicknames-giving chat. It's pure random chance.
  • Q : Help! My waifu got upset, something to do with date? How to get her back to love me?
    A : Spam Apologize option till her forgive you. And yes, you just left her beautifully dressed on Saturday for nothing.
  • Q : I kept H her but I don't see her sex state changing from Unfamiliar/Inexperienced state?
    A : Max out all her sensitive parts (chest, nipple, pussy teasing, vagina-piston, butt, anal teasing, anal-piston, service), she will instantly become a nympho. Familiar state is used when she is not horny (H<100) otherwise she went nympho.
  • Q : Duh! I accidentally made my waifu refuse anal on creation and after I do a lot of grinding with her without knowing. Will she give up soon?
    A : Don't worry, friend. Max out her other things beside anal teasing and anal penetration, after 1-2 periods or the next day, she'll let you do her anal play. But before you can penetrate her anal, you must max out anal teasing first. That way you will able to create your nympho waifu (who refuses anal play at first). Visit H Guide section.
    Additional note: even if at first anal is not available, later on it will become selectable for caressing. After a few more H sessions it will become possible to insert as well.
  • Q : How to grind fast for her sensitive parts?
    A : Look for Special H locations (library, pool, rooftop) you can get her addicted fast without having her exhausted for each school period. Having her cum outside the special H locations counted as a total (4 cums in total), she will be exhausted and no longer feel horny in having "intimate relationship" thus receiving less exp on maxing the circles. You will still need to normally H her to grind for anal-piston, cumming together inside anal twice increase the anal-piston by 45%. With Afterschool update you can increase H exp gains at the bottom of the settings.
  • Q : How to get quickly around the map? (e.g. avoiding horny girls)
    A : Press F3 to instantly access any locations. You can disable girls bothering you with options at the bottom of the settings (available since AfterSchool update).
  • Q : If I change her chest size (or butt, or fatness.., or height) while she's already in my class, will the dialogue change if she asks for her size?
    A : Yes! It will change. Make sure to answer accordingly (I like it big for big chest.. etc.) Cherish! Banzai!
  • Q : Sometimes this annoys me, How to maintain her Nympho state?
    A : At least talk to her once in a school period, and cum a lot (cumming together once is a must), don't worry about making her tired, her nympho power is limitless*. The after-dialogue will guarantee maintains her horny state. Remember, after a total of 4 cums**, she won't feel horny anymore, so you can at least have sex twice in a school period (1-2 cums on first sex, infinite cums on second sex) with the intent on maintaining nympho state. But in some rare cases, cumming twice may decrease her horniness (.. so if you invite her home, don't hold back, fill her up in every nook and cranny). For extra caution, you can save up some chat interactions so you can interact with her later by touching her just in case her horniness drop. Also note, finishing activities together like lunch, study, exercise, and date will also lower their horniness by 1. (H=99) For more info about H, visit H Guide wiki section.
    • Additional note 1: If she initiates H question (Yes/No) without you talking to her at least once, accepting her invitation will result on losing her nympho state (H drops), this could be a bug in the game, an annoying one that is.
    • Additional note 2: If you closely listen to the girl's dialogue after cumming, you will get the gist if she wants more or not, sometimes 1 cum is enough to turn her on, but cumming a lot will always do the trick.
    • Additional note 3: the 4 cums total if she's the one who invites you.
  • Q : How to unlock all sex positions?
    A : Different positions are unlocked in different ways. Here's what you can do to unlock positions:
    • Max out all of the stats during H for a single character (F6 to check, at least one girl must have full 100% experience).
    • Find H training spots (little pink heart icons scattered around the school) while a girl is following you.
    • Increase your club rank by interacting, having H and adding new club members.
    • Finish story events (yellow stars) for all 4 girls.
    • Alternatively you can cheat and use the CheatTools plugin to unlock all positions.
  • Q : How to get a scene when they are having showers or taking a pee or masturbating?
    A : The easiest way is to follow her. Girls will masturbate alone when they are feeling horny (H<100). Three types of masturbation, they can masturbate using the corner of a table, standing masturbation, and sitting masturbation. (What a lovely sight to behold upon!) More students = more chances to encounter them to do the manly tradition of peeking at girls.
  • Q : How to make her do H with me in the morning?
    A : First house visit is always a memo, second house visit she takes a shower, third house visit she wakes up with you, fourth house visit - you get what you want. A house visit before the weekend is always starts with H in the morning.
  • Q : How to get close to the teachers? Do H with them?
    A : When you spot a teacher in a school period, talk to her repeatedly until an event occurs (e.g. asking for a help to move things), it may or may not work provided that you talk to them each individually. Stop if it doesn't work after 10+ tries, try another teacher first, they may have something for you. Do this frequently you will do her eventually.
  • Q : How to get the Yuri Scene? Girls go at it?
    A : Much like masturbation, the girl needs to be horny (100% H) and one of them should have "I like Girls" trait for the scene to trigger. Follow the girl, if she enters a room, and another girl comes in, the yuri scene will be triggered. Some girls are going to be embarrassed when found out, so use that handy new update sneak button. (default is CTRL) Good luck.
  • Q : How to get the Darkness MMF scene in story mode?
    A : First of all, make sure you have all 3 parts of the Darkness expansion installed. Then go to the 3rd floor and look for the Darkness icon near one of the doors. Conditions for the icon to appear are: The girl has to have a supported personality and a relationsship with you, and she can't be a virgin. Supported personalities: typical schoolgirl, ojousama, pure, friendly, timid, humble.
  • Q : Some of the clothes, accessories and hair don't appear in the game world, but they are there during one-on-one conversations and during h-scenes?
    A : Make sure to enable showing of all accessories in game settings. If that doesn't help, try turning on high poly mode in plugin settings (needs the ForceHighPoly plugin). This can also be affected by async clothes loading and clothes persistence settings, try turning them off if the previous doesn't help. After changing any of these setting you have to restart the game to see the effects.

Uncensor FAQs

  • Q : How do I uncensor the game?
    A : Download UncensorSelector from https://github.com/DeathWeasel1337/KK_Plugins#readme and make sure to carefully read the instructions. Once it's installed, you can select individual uncensors on a per-character basis in the character maker body tab, or select an uncensor (or random uncensor) for all characters to use in the F1 plugin settings. This is the best uncensor because you can choose the genitals as it fits to each character compared to the classic way to uncensor, which you need to choose one from some selections and be satisfied with it. For best results, install the BetterPenetration plugin as well to get dynamic uncensors with better animations. You can get the latest uncensor pack from KKManager updater (BetterPenetration uses separate uncensors that are bundled with the plugin).
  • Q : What are my options for uncensoring only one gender, or both at once? (Without Uncensor Selector)
    A : A number of single gender uncensors are available for both genders, as well as a few that uncensor both at the same time. You cannot mix hardmod uncensors, but some sideloader uncensors are compatible with uncensors of the opposite gender. For instance, you can use the KK_LO pussy uncensor with the "whatsadick" dick uncensor, assuming both are sideloader.
  • Q : Is it possible to make the dick match the body colour?
    A : Yes, UncensorSelector will automatically match body color of all parts.
  • Q : Why does the dick stretch so strangely during animations?
    A : Due to the way Illusion programmed the game, they didn't plan for it to ever be uncensored, so the underlying animations look weird when the censor is removed. The BetterPenetration plugin fixes this issue.
  • Q : How to make a Futa?
    A : UncensorSelector allows you to select a female body for the male character in the character maker body tab or select a dick for a female character.

Modding FAQs

  • Q : What does plugin x do? Where can I download it?
    A : Look here: https://github.com/Frostation/KK-Plugins-Compendium/
  • Q : What is KKManager?
    A : KKManager is a card, plugin and mod manager. It includes an automatic zipmod updater that downloads latest Sideloader Modpacks (clothing/accessories/textures/items/maps/animations/uncensors) into your "mods" folder within your main game directory.
  • Q : How do I update my mods with KKManager?
    A : If you have a custom game launcher, click the Update button. Otherwise open KKManager and click Update in the top menu.
  • Q : Where do I place zips and zipmods? How are they different from hard mods?
    A : Zipmods, or any zip with a manifest.xml in it, are specifically for the use of the Sideloader, and belong in a mods folder in the game directory. Please create a mods folder if not already present, and do not extract zipmods unless you know what you are doing! If you have a zip file, check if it has a manifest.xml file inside of it, if it doesn't then it is not a zipmod and does not go inside the mods folder!
  • Q : Where do I place plugins / dll files?
    A : Most plugins are made for BepInEx 5.x and go inside the BepInEx\plugins folder in your game directory. If you don't have it, you have to install BepInEx and BepisPlugins first.
    Some plugins (mostly from Japanese makers) might be made for IPA - an obsoleted mod launcher - you will need the IPALoaderX plugin to use these. Usually the download page will mention if a plugin is for IPA, otherwise it's most likely a normal BepInEx plugin.
    Some old plugins might be made for BepInEx 4.x - in that case you will need the BepInEx4Upgrader plugin.
  • Q : Are there any recommended plugins? Where do I get this useful plugin?
    A : Check the mod release channels on the Koikatsu discord server. At the moment, it's recommend to get mandatory core plugins that basically everyone uses to be able to load shared characters and scenes, which is : BepisPlugins, IllusionFixes, KKAPI (framework for modded UI), KKABMX, KSOX, MoreAccessories, KK_GUID_Migration, and KKPE. You can automatically install all of the recommended plugins and mods by getting HF Patch, which is recommended for beginners over manually installing separate mods.
  • Q : Where do I put Overlays?
    A : You don't need to put them anywhere specific (as long as they aren't in a .zip/rar etc). When you press load overlay, it will open a Windows Explorer window and you can navigate to the file yourself. Then, the overlay gets saved to the card data, so you don't need to keep a copy of the overlay after saving (unless you want to reuse it).
  • Q : Is there a way to load male character on female maker or vice versa?
    A : You can use the Drag and Drop plugin. Drag a Male card from your windows explorer and drop it into the game while female maker is running, windowed mode recommended. The reverse is just the same process.
  • Q : Where do I find a POV mod?
    A : Get RealPOV from https://github.com/IllusionMods/KeelPlugins.
  • Q : Why is KKVMDPlayPlugin not working?
    A : Check if it is in the BepinEx folder, and that FaceData.txt and a vmd file are in the KKVMDPlayPlugin folder. It will not run otherwise.
  • Q : I got a broken character shoulder in the Maker, How do I fix it?
    A : This is caused by incompatibility between Stiletto and MakerOptimizations plugins. Press F1, go to Plugin Setting on top right, Disable the "Disable Maker IK" on there and restart the game. This setting should automatically get disabled if Stiletto is detected in latest versions.
  • Q : I broken eyes with KKVMDPlayPlugin after updating the game?
    A : This is caused by a bug in VMD plugin in versions not updated for Darkness/Yoyaku. To fix this go to your BepInEx/config.ini file, find the [VMDPlay] section, and change the CacheGagEyesTexture setting to False.
  • Q : Will Koikatsu Sunshine or Emotion Creators' assets work in Koikatsu?
    A : Not without modifications. Both games utilize a newer version of the Unity game engine that doesn't have the same shader codebase used in Koikatsu. Any attempt to add them into Koikatsu will result in 'D3D shader blob is empty' errors in the log and a completely pink model of the original asset.

Studio FAQs

  • Q : What is Studio/CharaStudio?
    A : Studio/CharaStudio is a separated application from the main game that let you create a totally unrelated scene and get screenshot that you can't achieve in main games. You can pose your characters, create gundams, or whatever limited only to your imagination (and the game engine). Screenshot functionality is the same as the main game.
  • Q : Where do I place scenes?
    A : Koikatsu\Userdata\Studio\scene
  • Q : My downloaded scene doesn't load?
    A : Read answer above about character cards not loading, it's the same deal.
  • Q : Can I replace a character in scene with my character?
    A : Yes, Choose the character you want to replace on the Work window on the right, and then choose the character you want as replacement on Add>Girl or Boy, and click Change Character
  • Q : How do I make character dance/moving?
    A : You can load a stock animation provided with the game by selecting the character first, go to Anim>Animations, and select one of them.
  • Q : How do I create custom poses?
    A : Choose the character first, and then you can turn on one of the two methods available on Anim>Kinematics>Forward Kinematic (FK) or Inverse Kinematics (IK). You'll see adjustable bone point and start working from there. IK is easier to control, but FK can get a better detailed result. you can work on both of them by using the Copy to FK/IK menu. You can instantly copy poses from current animation loaded with Animation Reference menu.
  • Q : The scenes only contains items? Can I add that to my current scene?
    A : Use Import Button menu instead of Load while loading scenes. It will add all object of chosen scene to the current work.
  • Q : The initial graphic of Studio is bad!
    A : This is because the default of the Studio setting somehow turned shadow density to 0. you can change it from System>Scene Effects>Shadow Density and see the difference immediately. There's alot of thing to tweak there too! Experiment with it for best results.
  • Q : The scenes I loaded is static!
    A : Most of them are, main studio purpose is to take screenshot. Only a few scenes are animated and it will need a lot more advanced skills to create one.
  • Q : Is there any way to get characters out of scenes?
    A : You can use the Character export plugin or the MakerBridge plugin to extract them.

Darkness/Yoyaku FAQs

  • Q : What is Darkness and what does it do?
    A : It's an expansion for Koikatsu. It adds "dark" content to the game, mostly forced MMF with a janitor. It is split into three parts, the 3rd one is released on June 21st 2019.
  • Q : Do I need to get Darkness to use new mods?
    A : No, at the moment it's fully optional and most commonly used mods will work with either version of the game. Some less common mods might be incompatible with Darkness or on the contrary might require it to be installed.
  • Q : How do I get Darkness?
    A : It was a preorder exclusive for people who bought EmotionCreators and can no longer be bought.
  • Q : What is the yoyaku DLC and do I need it for Darkness?
    A : Darkness doesn't need yoyaku, yoyaku adds some outfits and the extra two heads. It should be installed before Darkness but is fully optional (although recommended). If someone installs yoyaku after Darkness they will downgrade their game version, so they will have to install Darkness once more.
  • Q : Can I use HF Patch with Darkness installed? Does it include Darkness?
    A : HF Patch doesn't include Darkness. You can install HF Patch v2.7 or higher if you have Darkness installed (it will work if it's not installed too). If you install HF Patch v2.6 or earlier it will disable Darkness content.
  • Q : What personalities are supported by darkness?
    A : Only 6 personalities are supported by the expansion, you won't be able to start the Darkness H scene with any other personality (since scripts and voice clips don't exist). Supported personalities: Typical Schoolgirl, Ojousama, Pure, Friendly, Timid, Humble. (Darkness DLC was split into parts, each part came with only some of the personalities)
  • Q : How are Darkness DLC part actually delivered?
    A : Darkness updates are total of 3 parts. Part 1 is the base for h scene and dark content. Each part adds 1 new cloth and 2 personality supports for darkness content. There's a total of 3 new clothes and 6 personality support.
  • Q : Is Koikatsu Party (Steam Ver) Support Darkness Content?
    A : No, it has no support for darkness and yoyaku because of large differences in the codebases of the Japanese and Steam releases.