Honey Select 2: Installing Mods

From Hgames Wiki
< Honey Select 2‎ | Modding
Revision as of 23:08, 11 August 2020 by SpockBauru (talk | contribs) (Added more plugins)

Jump to: navigation, search

Illusion

all characters are at least 18


Honey Select 2 [edit]

News

Install Guide

FAQ & Technical Help

Gameplay

Modding


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.

Terminology

  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 for x64 machines (BepInEx_x64) Link: https://github.com/BepInEx/BepInEx/releases/
  2. 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
  3. 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
  4. TextResourceRedirector: Provide tools for translator works properly in HS2. Install HS2 version (HS2_TextResourceRedirector). https://github.com/IllusionMods/TranslationTools/releases/
  5. 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
  6. 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

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 models and clothes. Without it some modded faces and clothes (like Roy12 ones) will load in a horrendous distorted way. Install HS2 version, with the "2" after "HS" (HS2 BonesFramework). https://www.patreon.com/posts/38056126
  4. More accessories: increase the limit of 20 accessories per character. Install HS2 Version (HS2 MoreAccessories). https://www.patreon.com/posts/38995704
  5. Advanced Bone Modifier eXtended, AKA Bonemod (ABMX): Adds more character customization settings to character maker. These settings are saved inside the card. Use the HS2 version (HS2ABMX). https://github.com/ManlyMarco/ABMX/releases
  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/39642412
  8. Heelz: Make modded High Weels shoes works correctly. https://github.com/hooh-hooah/IL_Heelz/releases/latest
  9. UncensorSelector: Removes the mosaic censor and allows you to specify which uncensors individual characters use. Needs uncensors (next item) to work properly, also don't change the uncensor while in a scene. Use HS2 version(HS2_UncensorSelector). https://www.patreon.com/posts/38666838
  10. Uncensors for UncensorSelector. Penis and vagina variants to choose. Install all files in "mods\MyMods" folder (create if don't exist). https://drive.google.com/drive/folders/1j6mu1bLdTR476fl4ntOIYP6bSxtCVsrD

Feature Game Plugins

These plugins add extra features to the game.

  1. Subtitles: Adds subtitles when characters speak in the scenes. Install HS2 version, with the "2" after "HS" (HS2_Subtitles). https://www.patreon.com/posts/39990542
  2. Better Anti-Aliasing (BetterAA): Add a temporal Anti-aliasing for the game. Much better than the original, makes things stop twinkle. After install go to Settings> Plugin Settings> Better Anti-Aliasing> reduce "Temporal Stability" to 3. https://cdn.discordapp.com/attachments/715932300382044170/717337805726154802/HS2_BetterAA_v1.5.7z
  3. TranslationHelper: Improves the experience of using XUnity.AutoTranslator in numerous ways. Use HS2 version (HS2_TranslationHelper). https://github.com/GeBo1/GeBoPlugins/releases/tag/r8. To work correctly, install Translation Helper Names. https://cdn.discordapp.com/attachments/715932300382044170/737626159419752548/TranslationHelper_Names.2020-07-27.zip
  4. Message Center: Show log messages in the game screen. Useful when some character item is missing. install "BepInEx.MessageCenter". https://github.com/BepInEx/BepInEx.Utility/releases/
  5. EnableFullScreenToggle: Enable full-screen when press alt+enter. Install BepInEx.EnableFullScreenToggle. https://github.com/BepInEx/BepInEx.Utility/releases/
  6. EnableResize: Enable window resizing with the mouse. Must be enabled in "Plugin Settings" and restart the game. Install "BepInEx.EnableResize". https://github.com/BepInEx/BepInEx.Utility/releases/
  7. InputHotkeyBlock: Prevents plugin hotkeys from triggering while typing in an input field. Install BepInEx.InputHotkeyBlock. https://github.com/BepInEx/BepInEx.Utility/releases/
  8. MuteInBackground: Adds an option to mute a game when it loses focus, i.e. when alt-tabbed. Must be enabled in "Plugin Settings". Useful in an desperate alt+tab situation ( ͡° ͜ʖ ͡°). Install BepInEx.MuteInBackground. https://github.com/BepInEx/BepInEx.Utility/releases/
  9. Bepis Fix: Fix the rotating penis issue. https://cdn.discordapp.com/attachments/715932300382044170/722498293640462428/Bepis_Fix_for_HS2.7z
  10. 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
  11. BrowserFolders: Adds folder support to card browsers in main game and studio. Download HS2 version (HS2_BrowserFolders). https://www.patreon.com/posts/38231183
  12. HideAllUI: Hide the interface with the press of space button. Use HoneySelect2 version (HideAllUI.HoneySelect2). https://github.com/IllusionMods/HideAllUI/releases
  13. FemaleParameterInfo: An simple cheater designed for simplicity. It adds a box with the selected girl stats in the Lobby. https://cdn.discordapp.com/attachments/715932300382044170/717803833874448415/FPI.zip
  14. CheatTools: Powerful Trainer that allows control over player, heroines, and most other aspects of the game. Hit F12 in an scene. Needs "Runtime Unity Editor" to work (next item). Use HS2 version (HS2_CheatTools). https://www.patreon.com/posts/37889909
  15. Runtime Unity Editor: In-game inspector, editor and interactive console for applications made with Unity3D game engine. Needed for CheatTools to work. Downlaod BepInEx5 version (RuntimeUnityEditor_BepInEx5). https://github.com/ManlyMarco/RuntimeUnityEditor/releases
  16. HS2US: Various optimizations and quality of life improvement for HS2. Install HS2 version, with the "2" after "HS" (HS2US). https://www.patreon.com/posts/38675642
  17. DragAndDrop: Drag cards, scenes and outfits from you pc to the game window for load them. Use HoneySelect2 version (DragAndDrop.HoneySelect2). https://github.com/IllusionMods/DragAndDrop/releases
  18. HeightBar: Allows measuring of the character's height in centimeters. Use HS2 version (HS2_HeightBar). https://www.patreon.com/posts/35859949
  19. 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
  20. BetterHScenes: Adds some extra features in scenes. Use HS2 version (HS2_BetterHScenes). https://github.com/Mantas-2155X/BetterHScenes/releases
  21. 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
  22. 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
  23. 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
  24. 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
  25. Beaver: Automatically hide accessories in lower abdomen if panties are dressed, so piercings wont clip through clothes Install HS2 version (BeaverHS2.zip). https://mikkemods.blogspot.com/2020/07/bugfixes-and-ai-girl-updates.html
  26. 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
  27. PovX: PoV (first person view) mod for HoneySelect 2. Disable Depth of Field in "settings" before use. Read instructions in https://github.com/FairBear/HS2_PovX . Download: https://github.com/FairBear/HS2_PovX/releases/
  28. InvisibleBody: Makes characters invisible. Available in Body> Overall. Use HS2 version (HS2_InvisibleBody): https://www.patreon.com/posts/28424780
  29. BoobSettings: Allows you to override the game's breast physics on each individual character. Available in Body> Chest. https://github.com/FairBear/HS2_BoobSettings/releases/
  30. Lipsync: Makes the lip motion of characters more realistic when they are speaking. Use HS2 version (HS2Lipsync) https://github.com/01010101lzy/kk-lipsync/releases/
  31. ClothColliders: Allows zipmods to easily add cloth physics to clothes and make them interact with the characters. Downlaod HS2 version (HS2_ClothColliders) https://github.com/ManlyMarco/Illusion_ClothColliders/releases
  32. Boobs and floor collider (zipmod): makes boobs collide with characters and objects and clothes collides with floor. Fix clipping issue but can cause bugs. Install in "mods\MyMods" folder. https://mega.nz/file/RU8DHaZa#j-CKPrJzWedkviLeMmWT8kGf1pRfJMOUciT60YtySNQ
  33. HCharaSwitcher: Switch character cards live during H. Install HS2 version. https://github.com/Mantas-2155X/HCharaSwitcher/releases
  34. TranslationCacheCleaner: Removes all entries from machine translation cache file that would be translated by existing human translations. Press LeftShift + F6 to clean the cache. Use HS2 version (HS2_TranslationCacheCleaner). https://github.com/GeBo1/GeBoPlugins/releases/tag/r8
  35. MakerDefaults: Lets you modify the starting settings of the character maker. Install HS2 version (HS2_MakerDefaults). https://www.patreon.com/posts/39323239
  36. BetterPenetration: Solves penis telescope (accordion effect) in scenes, with additional features. Configure values in "Plugin Settings" while in an scene to a better effect. Recommended to use TMAA uncensors. Use HS2 version (HS2_BetterPenetration). https://github.com/Animal42069/BetterPenetration/releases/
  37. MakerSearch: Allows you to search items in the Character Maker. A must have. Downlaod HS2 version (HS2_MakerSearch). https://github.com/Mantas-2155X/MakerSearch/releases/
  38. ExtraGroups: Allows you to have more than the default amount of groups and girls per group in main game. Confiture in "Plugin Settings" and restart the game to take effect. Install HS2 version (HS2_ExtraGroups). https://github.com/Mantas-2155X/HS2_ExtraGroups/releases/
  39. Straight 2 Maker: Skip the title screen and load straight into the female character creator when you start Honey Select 2. Use HS2 version (Straight2MakerHS2). https://mikkemods.blogspot.com/2020/07/straight-2-maker-plugin-for-honey.html
  40. Character loader: Alternative interface to load characters. Use HS2 version (CharLoaderHS2). https://mikkemods.blogspot.com/2020/08/character-loader-plugin-12.html

Feature Plugins for Studio

Studio only plugins.

  1. HS2PE: a plugin that improves posing for Honey Select 2 Studio. Download HS2 version, with the "2" in the middle (HS2PE). https://www.patreon.com/posts/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/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/39932123
  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/32459105
  6. CharacterExport: Export characters from saved Studio scenes. Use HS2 version (HS2_CharacterExport). https://www.patreon.com/posts/32434052
  7. MaleJuice: Enables juice textures (aka cum) on males. Use HS2 version (HS2_MaleJuice). https://www.patreon.com/posts/38142772
  8. StudioObjectMoveHotkeys: Allows you to move objects around in Studio using hotkeys. Use HS2 version (S2_StudioObjectMoveHotkeys). https://www.patreon.com/posts/31184561
  9. PoseFolders: Allows you to organize your saved Studio poses into folders. Use HS2 version (HS2_PoseFolders). https://www.patreon.com/posts/31127973
  10. QuickAccessBox: Adds a quick access list for searching through all items, both stock and modded. Install HS2 version (HS2_QuickAccessBox). https://www.patreon.com/posts/38060886
  11. StudioPOV: Allows you to have first person view in Studio. Use HS2 version (HS2_StudioPOV). https://github.com/Mantas-2155X/StudioPOV/releases
  12. 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/
  13. MoveController: Includes move controllers for studio. https://mikkemods.blogspot.com/2020/06/movecontroller-plugin-for-honey-select-2.html
  14. OrthographicCamera: Allows using of the orthographic (parallel projection) camera mode. Use HS2 version (HS2_OrthographicCamera): https://www.patreon.com/posts/31909622
  15. 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
  16. HS2 Fighter: Simple fighter game, Require VNGE 17.6.1+ and DHH need for lighting. https://mega.nz/folder/tmhwSA6R#QZ6Y1rgPYdg97_1uAnVExw
  17. HS2 VMDPlayPlugin: .vmd player for HS2, like MMD dances. Open with Ctrl+Shift+V. https://mega.nz/file/rFxDjQwB#IfrLYiCxvbpWS9aTwf82O-_i3Gtb_PVMaxDgJ6V780U
  18. 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/
  19. 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
  20. 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
  21. 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
  22. Scripted Dicks: Penis that fit the right place, finally! Read carefully the mod page and the MEGA manual. https://www.patreon.com/posts/38432349
  23. StudioCustomMasking: Allows you to add map masking functionality for maps made out of items in Studio. Install HS2 version (HS2_StudioCustomMasking). https://www.patreon.com/posts/40214619
  24. SceneLoader plugin: Adds folder support to load Studio scenes and a more convenient interface for browsing scene files. Downlaod HS2 version (SceneLoaderHS2). https://mikkemods.blogspot.com/2020/08/sceneloader-plugin-for-ai-girl-and.html
  25. HS2WearCustom: Plug-in for changing clothes and hair in studio. https://mega.nz/file/6AhAxQZC#b3Rk4fQu2vMkdy0VvBk-6us12pKpjz4yRP4ZbFvctoU

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

Utilities used outside the game. The first one (KKManager) is the most important, you NEED to know how to use it.

  1. KKManager: Mod, plugin and card manager for games by Illusion. With this you can download the Sideloader Modpack, with over than 50GB worth of zipmods including clothes, items, studio maps, game rooms, etc... https://www.patreon.com/posts/39672858
  2. IllusionLauncher: English launcher with various configs. Use HoneySelect.2 version, with 2 in the end (IllusionLaunchers_HoneySelect.2). https://github.com/IllusionMods/IllusionLaunchers/releases/
  3. Card Image Replacer: Replaces main preview image in cards and scenes. https://www.patreon.com/posts/32927543