Koikatsu Sunshine: Technical Help

From Hgames Wiki
Jump to: navigation, search

all characters are at least 18

Koikatsu Sunshine [edit]

Install Guide

FAQ & Technical Help



Most commonly asked questions and their answers, search for keywords to find your issue quickly. If your question isn't answered here or you can't seem to fix your issue, visit the #help channel on the Koikatsu Discord server. Check the Koikatsu FAQ as well, since many of the answers also apply to KKS.

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 FAQ

  • Q : Where can I buy the game?
    A : You can buy The Japanese version at DMM\FanzaGames or at the Official Illusion Online Service (only for customers in Japan). There's no information about an eventual western/Steam release, but one is likely sometime next year.
  • Q : How do I buy/download the game from DMM?
    A : Check this guide.
  • Q : I can't install it / I get a data cab error during install
    A : Move the install files to a folder with no Japanese characters like "D:\KKS_installer" and run the .msi file from the setup folder.
  • Q : The game breaks when going to different maps or characters are in fast forward
    A : You need to install IllusionFixes (specifically the CultureFix). Saves made without the fix will have corrupted character data, so after installing the fix you will have to start a new game or remove all girls and re-add them.
  • Q : Where to download the latest updates, mods and translations?
    A : You can use HF patch here : https://github.com/ManlyMarco/KKS-HF_Patch/releases/latest (make sure you don't download the source code by mistake).
  • Q : I am trying to install the HF patch, but I have a bunch of files. Which of them do I use?
    A : None of them. You may have clicked the green button and downloaded the source files and not the actual program. HF Patch is an executable and can be found by following the link on this page here: https://github.com/ManlyMarco/KKS-HF_Patch/releases
  • 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 : Can I run Koikatsu in Windows 1.0/95/XP?
    A : No, Koikatsu will only run on Windows 7 and above due to the use of DirectX 11 graphics API.
  • Q : Can I run Koikatsu on the 32-bit Windows?
    A : No, Koikatsu will only work on the 64-bit version of Windows. If you have a 64-bit processor but are running the 32-bit version of Windows, it is highly recommended you switch to 64-bit Windows.
  • Q : Can I run Koikatsu on Windows 10?
    A : Yes, it can run on Windows 10 as long as it's the 64-bit version.
  • Q : Do I have to use a locale emulator?
    A : You don't have to use an locale emulator as long as you install IllusionFixes.
  • 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.
  • Q : What engine does Koikatu run on?
    A : Koikatu uses Unity 3D game engine v2019.4.9.
  • 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.
  • Q : Does it supports 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 will need to edit manually 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 : The game won't launch with WINE on Linux, what do I do?
    A : Try running KoikatsuSunshine.exe directly.
  • Q : The game runs in WINE, 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.
  • 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

To check In game Manual, Press F5. It covers a lot of the gameplay.

  • Q : How do I save the game?
    A : You can save the game in your room, or from the middle-click menu on the right when walking around.
  • Q : How do I end the day quickly?
    A : Press Middle mouse Button and chose the option to go to your room, or progress time in top right corner.
  • 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 Girl's cards in "UserData\chara\female" folder and Male cards in "UserData\chara\male". 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 : Do Koikatsu cards work on Koikatsu Sunshine?
    A : Koikatsu cards can be converted into Koikatsu Sunshine cards. When you place a Koikatsu card on "UserData\chara\female" it will be converted into a Sunshine card in the next time you open the game. WARNING: The other way around does NOT work, that is, Sunshine cards does NOT work on the old Koikatsu game. Also cards with mods may have issues.
  • Q : Where can I get more girls cards?
    A : If you play the unmodified (vanilla) Japanese game and you are in Japan you can go to the ingame network option. If you are playing a modified version (in other language than Japanese or with mods) or outside Japan you cannot use the network option, instead there are many sites that share cards such as:
Illusion Booru
WARNING: These sites have cards for lots of games, be sure to download for Koikatsu or Koikatsu Sunshine!
  • 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 : 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 : 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 : Check to see 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 it has a logo, it is most likely a screenshot. Make sure you have your game updated to the latest version too.
  • Q : My character's skirt is acting weird in character maker (boxy/sticking out corners)! Is this normal?
    A : Unfortunately, that is normal behavior when you set your character hips slider too thin, (usually below 0), you need to figure out how to avoid such limitation yourselves, like making your characters wear pants instead, it's nothing we can do.
  • 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 ManlyMarco's 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 the latest IllusionFixes or remove the offending mod.
  • 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 the latest IllusionFixes or change personality of the character card.
  • Q : My menu UI is messed up, what do I do?
    A : It might be time to update your UI translation. 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.
  • 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 : 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 : You can instantly warp to any location from the middle click menu, or by pressing F3.
  • 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 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 : 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 KKS_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.
  • 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, the dicks included with KKS_UncensorSelector all match body color.
  • 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 mostly fixes it.
  • Q : How to make Futa?
    A : KKS_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 : 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!
  • Q : Where do I place plugins / dll files?
    A : Plugins mostly go to the BepInEx\plugins folder inside your game directory. If you don't have it, you have to install BepInEx and BepisPlugins first.
  • Q : Is there any recommended plugin? where do I get this useful plugin?
    A : Yes, it's recommend to get mandatory core plugins that basically everyone uses to be able to load shared characters and scenes, which is : 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 : 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 : 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 : Yes, use the CharaReader program to extract them.
  • 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 /KoikatsuSunshine_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 for many parts of the game, mods and modding.