Honey Select 2: Installing Mods

From Hgames Wiki
Jump to: navigation, search

all characters are at least 18

Honey Select 2 [edit]


Install Guide

FAQ & Technical Help



MODs it’s a short for "modifications", with them you can introduce new features to the game such as new functions, parameters, clothes and hairstyle.

If you have installed a mod, never use the official cards uploader thereafter. Access will be prohibited, and the official uploader will not be available.

Please understand that modifying your game is risky by nature and requires some safeguards such as backing up the game data. Also always read carefully what each thing does before using it.

If you are coming from Honey Select 1

Modding structure is pretty different in Honey Select 2 since it uses the softmod method, differently from Honey Select 1 that used the HardMod method. Please read the Terminology bellow to understand what is happening.

In short: Never touch games folder such as abdata. Now we have a better modding system that do not mess with abdata and do not make id conflicts at all, making HSResolveMoreSlotID obsolete. Also never extract .zipmod files, read bellow for more instructions.


  1. Vanilla
    • It's a game without introducing any MOD. It’s like an ice cream (game) without toppings (MODs)
  2. HardMod
    • This method of modding overwrites game files, which was the main method used in Honey Select 1 but is not used anymore in Honey Select 2. This approach is likely to introduce errors and if any mod breaks your game it’s hard to seek the problem and its more likely that you'll need to reinstall everything again. It also leads to ID conflicts making harder assets management.
  3. Softmod
    • This method introduces new features to the game without any modifications to the game files. With this method Mods are installed in different files and folders from the original game, making easy to troubleshooting and mods management overall. This is the method used in Honey Select 2.
  4. Plugin
    • Plugins modifies the game code and behavior, proceed with caution when installing them. Luckily in Honey Select 2 the plugins are also softmoded, so it’s easy to troubleshoot if something goes wrong. In Honey Select 2 they are installed in BepInEx\Plugins folder
  5. Zipmod
    • A file with extension .zipmod it’s a .zip file packed without compression. It’s a softmod that contains a folder structure that imitates the game original folders, but without in fact changing them. Zipmods are made in a way that never needs to be extracted, you just need to copy the .zipmod file to the mods folder and the modded game will automatically recognize it in the next launch. In Honey Select 2 they are installed in mods\MyMods folder
  6. Sideloader
    • Sideloader is the plugin used by the modded game to load .zipmod files. It comes with the Base Mods listed below.
  7. Sideloader Modpack
    • Sideloader Modpack is an package of assets made in .zipmod format. This package is made and maintained by the community and contains mods that are open to distribute. In an modded Honey Select 2 there are several "Sideloader Modpack" subfolders in "mods" folder and are managed with the update tool. Note that when you update the Sideloader Modpack all mods that are different from the community list are excluded, so don’t put your own mods in Sideloader Modpack folders.

Installing mods and plugins

  • Zipmods files have .zipmod extension and must be copied to "mods\MyMods" folder. If the folder don't exist, create it. NEVER EXTRACT A ZIPMOD!
  • Plugins have .dll extension and must be placed in "BepInEx\Plugins" folder. Some good hearted developers put the right folder inside their packages, so if a plugin file have BepInEx folder you just need to extract to the game main folder.

A quick guide to zipmods

In order to you game reads .zipmod files you need to have a properly modded game such as BetterRepack, HF Patch, or your own self managed modded game with sideloader.

To install a .zipmod file you need just to put the file in "mods\MyMods" folder. DO NOT EXTRACT!

Some zipmods must have a HS2-specific version like Roy12 ones, others you can try to port from AI-Girl with this workaround, but do it at your own risk:

Open the .zipmod file with 7-zip, right click on manifest.xml and select Edit, remove the line <game>AI Girl</game>, save and close notepad, select OK to update the file

For more information go to https://github.com/IllusionMods/BepisPlugins/wiki/1-Introduction-to-zipmod-format

HF Patch: The easiest way to install mods

By far the easiest way to install mods in a vanilla game is by using HF Patch. This package includes all free illusion DLCs, the base mods and essential plugins. Also, the extra plugins are cautiously selected to not generate any conflicts.

HF Pacth also comes with Sideloader Modpack, including over 500 .zipmod assets such as clothes, accessories and items. It’s The ideal package if you intend to open character cards from Illusion Booru, Kenzato or yuki-portal.

  • Note: Do not Install HF Path if you use any kind of Repack.

To install HF Patch, follow this page and read carefully the "Readme, help and download" link: https://github.com/ManlyMarco/HS2-HF_Patch/releases/ . You can also copy the magnet link and paste on your torrent client, such as qBittorrent.

Advanced way to install mods

If you want to install each mod one by one, you must first install the base mods. Without then your modded game will not even launch. Its highly recommended to also install the essential mods since several other plugins and .zipmods rely on them to work.

Base mods

This mods are the very base to all plugins and zipmods works. Be careful with them. Read carefully each site before downloading.

  1. BepInEx: The base of everything. All plugins rely on him to work. Install the version 5.1 for x64 machines (BepInEx_x64_5.1.0.0) Link: https://github.com/BepInEx/BepInEx/releases/tag/v5.1
  2. XUnity.AutoTranslator: Translate the game texts. Uses human translations if available, otherwise use GoogleTranslator. Its also required to run BepisPlugins. Download BepisInEx version (XUnity.AutoTranslator-BepIn). https://github.com/bbepis/XUnity.AutoTranslator/releases
  3. TextResourceRedirector: Provide tools for translator works properly in HS2. Install HS2 version (HS2_TextResourceRedirector). https://github.com/IllusionMods/TranslationTools/releases/
  4. BepisPlugins: The very base set of plugins to make other plugins to work. It also includes Sideloader that is what makes zipmods work. Install HS2 version (HS2_BepisPlugins). https://github.com/IllusionMods/BepisPlugins/releases
  5. Illusion Modding API: API designed to make writing plugins easier and less bug prone. Most plugins use it. Downlaod HS2 Version (HS2API). https://github.com/IllusionMods/IllusionModdingAPI/releases
  6. IllusionFixes: A set of fixes for Illusion Games. Without this your modded game will not even launch. Install the Honey Select 2 version (IllusionFixes_HoneySelect2). https://github.com/IllusionMods/IllusionFixes/releases

Essential Plugins

Now that you have a working modded game, its highly recommended to also install these plugins that are essential to make some cards, plugins and zipmods to work properly, otherwise you may get distorted faces and clothes, cards with missing accessories, etc.

  1. BepInEx.ConfigurationManager: configuration menu for plugins. https://github.com/BepInEx/BepInEx.ConfigurationManager/releases
  2. GraphicsSettings: Includes a menu with graphics settings in plugin settings. https://github.com/BepInEx/BepInEx.GraphicsSettings/releases
  3. Bones Framework: Adds extra bones to clothes. Without it some modded faces and clothes (like Roy12 ones) will load in a horrendous distorted way. Install HS2 version (HS2 BonesFramework). https://www.patreon.com/posts/hs-kk-ai-hs2-1-4-38056126
  4. More accessories: increase the limit of 20 accessories per character. Install HS2 Version (HS2 MoreAccessories). https://www.patreon.com/posts/38995704
  5. BonemodX: Adds more character customization settings to character maker. These settings are saved inside the card. Use the HS2 version (HS2ABMX). https://www.patreon.com/posts/hs2abmx-v4-3-for-37819916
  6. Illusion Overlay Mods: Allows adding overlay textures (tattoos) to character's face, body, and clothes. All overlays are saved inside the card. Use HS2 version (HS2_OverlayMods). https://github.com/ManlyMarco/Illusion-Overlay-Mods/releases
  7. MaterialEditor: Manage overlays, maps, materials, and shaders of the characters. These settings are saved inside the card. Lots of cards use it. Download HS2 version (HS2_MaterialEditor). https://www.patreon.com/posts/materialeditor-0-37972906
  8. Heelz: Make modded High Weels shoes works correctly. https://github.com/hooh-hooah/IL_Heelz/releases
  9. UncensorSelector: Removes the mosaic censor and allows you to specify which uncensors individual characters use. Use HS2 version(HS2_UncensorSelector). https://www.patreon.com/posts/uncensorselector-38666838

Feature Game Plugins

These plugins add extra features to the game.

  1. Subtitles: Adds subtitles when characters speak in the scenes. Use HS2 version (HS2_Subtitles). https://www.patreon.com/posts/subtitles-v1-6-1-38662379
  2. Bepis Fix: Fix the rotating penis issue. https://cdn.discordapp.com/attachments/715932300382044170/722498293640462428/Bepis_Fix_for_HS2.7z
  3. ColorPanelX: Lets you select colors using numeric input as well as to toggle between HSV and RBG color silders in Chara Maker. https://mega.nz/file/AJkgSAga#yRyIxYkjBFIWgs2ZdK5nuIpBL8q7V8T51Pg0kRLP8nY
  4. MuteInBackground: Adds an option to mute a game when it loses focus, i.e. when alt-tabbed. Must be enabled in the plugin settings Download BepInEx.MuteInBackground version. https://github.com/BepInEx/BepInEx.Utility/releases
  5. InputHotkeyBlock: Blocks hotkeys from triggering when typing in text fields. Use HS2 version (HS2_InputHotkeyBlock). https://www.patreon.com/posts/inputhotkeyblock-29761547
  6. MaleJuice: Enables juice textures (aka cum) on males. Use HS2 version (HS2_MaleJuice). https://www.patreon.com/posts/malejuice-v1-2-2-38142772
  7. BrowserFolders: Adds folder support to card browsers in main game and studio. Download HS2 version (HS2_BrowserFolders). https://github.com/ManlyMarco/Illusion_BrowserFolders/releases
  8. HideAllUI: Hide the interface with the press of space button. Use HoneySelect2 version (HideAllUI.HoneySelect). https://github.com/IllusionMods/HideAllUI/releases
  9. CheatTools: Powerful Trainer that allows control over player, heroines, and most other aspects of the game. Hit F12 in an scene. Use HS2 version (HS2_CheatTools). https://github.com/ManlyMarco/IllusionCheatTools/releases
  10. Simple Cheater: An basic cheater designed for simplicity. It adds a box with girl stats in selection screen. https://cdn.discordapp.com/attachments/715932300382044170/717803833874448415/FPI.zip
  11. HS2US: various optimizations and quality of life improvement for HS2. Download HS2 version (HS2US). https://www.patreon.com/posts/hs-kk-ai-hs2-1-9-38675642
  12. DragAndDrop: Drag cards, scenes and outfits to the game window to load them. Use HoneySelect2 version (DragAndDrop.HoneySelect2). https://github.com/IllusionMods/DragAndDrop/releases
  13. HeightBar: Allows measuring of the character's height in centimeters. Use HS2 version (HS2_HeightBar). https://github.com/ManlyMarco/Illusion_HeightBar/releases
  14. RemoveToRecycleBin: Moves removed/overwritten cards and scenes to the recycle bin to prevent accidentally losing your work. Use HS2 version (HS2_RemoveToRecycleBin). https://github.com/ManlyMarco/Illusion_RemoveToRecycleBin/releases
  15. BetterHScenes: Adds some extra features in scenes. Use HS2 version (HS2_BetterHScenes). https://github.com/Mantas-2155X/BetterHScenes/releases
  16. UnlockPlayerHClothes: allows you to undress each clothing part of your player during scenes. Use HS2 version (HS2_UnlockPlayerHClothes). https://github.com/Mantas-2155X/UnlockPlayerHClothes/releases
  17. HLightControl: allows you to change some light settings during a scene. Some configs can improve performance. Use HS2 version (HS2_HLightControl). https://github.com/Mantas-2155X/HLightControl/releases
  18. UnlockPlayerHeight: enables the male height slider and unlocks the players (or male chara) height hard lock of 75. Use HS2 version (HS2_UnlockPlayerHeight). https://github.com/Mantas-2155X/UnlockPlayerHeight/releases
  19. PushUp Plugin: makes the bras in shape and hold the breast while worn. Also hide inner accesories when an outfit is on top, so piercings wont clip through clothes. Use HS2 version. https://mikkemods.blogspot.com/2020/07/pushup-plugin-v21-corset-effect.html
  20. Beaver: Automatically hide accessories in lower abdomen if panties are dressed, so piercings wont clip through clothes. https://mikkemods.blogspot.com/2020/06/honey-select-2-plugin-releases.html
  21. Gravure plugin: Adds a button to overwriting a character card while keeping the image, brings a menu when pressin "G" with pose options and adds a button to set every piece of clothing in the same color. Install HS2 versuin (GravureHS2.zip). https://mikkemods.blogspot.com/2020/07/bugfixes-and-ai-girl-updates.html
  22. PovX: In-Game POV Add-On. https://github.com/FairBear/HS2_PovX/releases/
  23. BetterAA: Add a temporal Anti-aliasing for the game. Much better than vanilla. https://cdn.discordapp.com/attachments/715932300382044170/717337805726154802/HS2_BetterAA_v1.5.7z
  24. InvisibleBody: Makes characters invisible. Use HS2 version (HS2_InvisibleBody): https://www.patreon.com/posts/28424780
  25. BoobSettings: Allows you to override the game's breast physics on each individual character. https://github.com/FairBear/HS2_BoobSettings/releases/
  26. Lipsync: Makes the lip motion of characters more realistic when they are speaking. https://github.com/01010101lzy/kk-lipsync/releases/
  27. ClothColliders: Allows zipmods to easily add cloth physics to clothes and make them interact with the characters. https://github.com/ManlyMarco/Illusion_ClothColliders/releases
  28. Boobs and floor collider (zipmod): makes boobs collide with characters and objects and clothes collides with floor. Fix clipping issue but can cause bugs. https://mega.nz/file/RU8DHaZa#j-CKPrJzWedkviLeMmWT8kGf1pRfJMOUciT60YtySNQ
  29. Fur Shader - for MaterialEditor (zipmod): Make everything fluffy and furry with this fur shader! Open Material Editor and select Fur 20 B from the Shader drop-down list. https://mega.nz/file/NQlHlIKS#lndOMxKtsKcdJOqzZUMQYPA2z96nQuxS5HT8scRHEws
  30. Flame Shader - for MaterialEditor (zipmod): Customizable shader will let you change color, flow speed, brightness, among other settings. Open Material Editor and select KKY/Flame from the Shader drop-down list. https://mega.nz/file/BB0wgYIR#MRNGKt8JyhfCNr99_uFD12Lqm_2NXXksp6hrqEMgD7I
  31. HCharaSwitcher: Switch character cards live during H. Install HS2 version. https://github.com/Mantas-2155X/HCharaSwitcher/releases
  32. TranslationCacheCleaner: Removes all entries from machine translation cache file that would be translated by existing human translations. Use HS2 version (HS2_TranslationCacheCleaner). <nowiki>https://github.com/GeBo1/GeBoPlugins/releases/tag/r6</nowiki>
  33. TranslationHelper: Improves the experience of using XUnity.AutoTranslator in numerous ways. Use HS2 version (HS2_TranslationHelper). https://github.com/GeBo1/GeBoPlugins/releases/tag/r7. To work correctly, install Translation Helper Names: https://cdn.discordapp.com/attachments/715932300382044170/730535231483805726/TranslationHelper_Names.2020-07-08.zip

Feature Plugins for Studio

Studio only plugins.

  1. HS2PE: a plugin that improves posing for Honey Select 2 Studio. Download HS2 version (HS2PE). https://www.patreon.com/posts/hs-kk-ai-hs2-2-0-38673900
  2. FK&IK: Enables FK and IK at the same time in studio. Download HS2 version (HS2_FKIK). https://www.patreon.com/posts/fk-ik-v1-1-now-29928651
  3. AnimationOverdrive: Lets you set animation speeds in Studio to values higher than 3. https://www.patreon.com/posts/animationoverdri-37738615
  4. StudioSceneSettings: Adds a few useful settings for your Studio scenes. All changes save and load with the scene. Use HS2 version (HS2_StudioSceneSettings). https://www.patreon.com/posts/studioscenesetti-32713423
  5. StudioSceneLoadedSound: Plays a sound on scene load or import. Useful for anyone who spends the load time for large scenes alt-tabbed. Use HS2 version (HS2_StudioSceneLoadedSound). https://www.patreon.com/posts/studiosceneloade-32459105
  6. CharacterExport: Export characters from saved Studio scenes. Use HS2 version (HS2_CharacterExport). https://www.patreon.com/posts/characterexport-32434052
  7. StudioObjectMoveHotkeys: Allows you to move objects around in Studio using hotkeys. Use HS2 version (S2_StudioObjectMoveHotkeys). https://www.patreon.com/posts/studioobjectmove-31184561
  8. PoseFolders: Allows you to organize your saved Studio poses into folders. Use HS2 version (HS2_PoseFolders). https://www.patreon.com/posts/posefolders-v1-0-31127973
  9. QuickAccessBox: Adds a quick access list for searching through all items, both stock and modded. Install HS2 version (HS2_QuickAccessBox). https://github.com/ManlyMarco/QuickAccessBox/releases
  10. StudioPOV: Allows you to have first person view in Studio. Use HS2 version (HS2_StudioPOV). https://github.com/Mantas-2155X/StudioPOV/releases
  11. AnimationPairing: When you select more than 2 actors in studio, it will change and convert correct H animations. Use HS2 version (HS2_AnimationPairing). https://github.com/hooh-hooah/AnimationPairing/releases/tag/1.0.0
  12. MoveController: Includes move controllers for studio. https://mikkemods.blogspot.com/2020/06/movecontroller-plugin-for-honey-select-2.html
  13. OrthographicCamera: Allows using of the orthographic (parallel projection) camera mode. Use HS2 version (HS2_OrthographicCamera): https://www.patreon.com/posts/31909622
  14. VN Game Engine (VNGE): Studio Mod for making VN games, animations, utils etc. Use aishoujo_hs2 (vngamexx.xx_aishoujo_hs2) version. https://mega.nz/folder/oiB2wAQK#ojGIzlAN-1B-263uUDEalQ/folder/Jm5xAIbA
  15. HS2 Fighter: Simple fighter game, Require VNGE 17.6.1+ and DHH need for lighting. https://mega.nz/folder/tmhwSA6R#QZ6Y1rgPYdg97_1uAnVExw
  16. HS2 VMDPlayPlugin> .vmd player for HS2, like MMD dances. Open with Ctrl+Shift+V. https://mega.nz/file/rFxDjQwB#IfrLYiCxvbpWS9aTwf82O-_i3Gtb_PVMaxDgJ6V780U
  17. StudioCharaSort: lets you set the default sort type and order for character cards in Studio so the list doesn't always revert back to sort by descending name. https://github.com/kkykkykky/StudioCharaSort/releases/tag/v1.0.1
  18. StudioImageEmbed: Save .png files from your userdata folder to the scene data. Install HS2 version (HS2_StudioImageEmbed v1.0.zip). https://www.patreon.com/posts/39042462
  19. StudioMultiselectChara: If you select a character in studio and press the hotkey, all other instances of that character in the scene will also be selected. Install HS2 version (HS2_StudioMultiselectChara). https://github.com/GeBo1/GeBoPlugins/releases/tag/r6
  20. StudioSceneNavigation: Provides hotkeys for loading the next/previous scene from the scenes folder. Supports Illusion BrowserFolders. Tracks last loaded image so it can pick up where it left off between sessions. Use HS2 version (HS2_StudioSceneNavigation). https://github.com/GeBo1/GeBoPlugins/releases/tag/r6

Graphics Mods

Mods that alters the game graphic processing. Don NOT use more than one at the same time.

  1. DHH Graphics Enhancer: A plugin to adjust various settings to enhance and fine tone graphics. https://mega.nz/file/L59H1J4J#ZPYQ1qAxne5_WqZF1Ht-5_fl7UzMz4mSDNf-eiPdKWc
  2. Graphics: An advanced and powerful graphics enhancer for advanced users. https://github.com/ore-/Graphics/releases/


Utilities used outside the game.

  1. KKManager: Mod, plugin and card manager for games by Illusion. https://github.com/IllusionMods/KKManager/releases
  2. Card Image Replacer: Replaces main preview image in cards and scenes. https://www.patreon.com/posts/32927543