Honey Select Installation Guide - Modern Edition 2.7

Do not use repacks for this guide.
Fakku users, please read the FAQs at the bottom of the page.

Honey Select Installation Guide > Organizing Edition 2.7
Remember to read the FAQs
Guide is long, but it is broken into sections.

There are two packs.
	> ScrewThisNoise's (STN) better repack.
	> IPA (Regular) Starter Pack.
STN uses a new method called BepInEx, but some plugins don't work.
IPA is better supported despite being old.
CHOOSE ONLY ONE PACK
CHOOSE ONLY ONE PACK
CHOOSE ONLY ONE PACK

----------------- Table of Contents -----------------
	> SECTION 0: Game Installation
	> SECTION 1-A: STN [mod] Repack. (BPN Pack)
	> SECTION 1-B: IPA Starter Pack. (IPA Pack) (Recommended)
	> SECTION 2: Installing Mods
	> SECTION 3: Graphical Mods
	> SECTION 4: Advanced Stuff
	> SECTION 5: FAQs

Mods Directory: https://pastebin.com/Z9kkjDjT
	Note: Pastebin has taken this link down.
	Mediafire Directory: https://www.mediafire.com/folder/w6qco733fh5ly/Mods_%26_Add-on#myfiles

Studio Mods: https://mega.nz/#F!EpBRgQjA!itd8__IdjGp6Rac3UkLzLw
Old Mod Directory: https://mega.nz/#F!D992CACB!wGCXpPjskjNl9YoCYL_K0A
Discord Server: https://discord.gg/illusionsoft

----------------- SHORT VERSION -----------------
Step 0: Install the game with all DLCS and update it with the 0630 Patch.
Step 1: Pick one of the packs. IPA is reccomended despite being older than STN/BPN.
Step 3: Open HSResolveMoreSlotID which comes with both packs, and press resolve all. Repeat after installing new mods.
Step 4: Play the game.
Step 5: Install more mods.

================= SECTION 0 =================
Get the game and install it.
	> You can purchase the game at these locations
		> DMM
			> https://dlsoft.dmm.co.jp/detail/illusion_0019pack/
				Contains all DLCs.
		> Fakku's English Version
			> https://www.fakku.net/games/honey-select-unlimited-english
			> https://www.fakku.net/games/honey-select-unlimited-extend-studio-neo-english
				YOU MUST HAVE BOTH BASE AND EXTEND DLC.
				PLEASE READ THE FAQ IF YOU USE FAKKU.
	> Regardless of how you obtained the game, it must contain the Party DLC which includes StudioNEO.
	> After game has been successfully installed and tested, apply the 0630 patch.
		> Download https://mega.nz/#!9RQ2lKBR!8GF7p72HopEXWlxQs2U-4aGIW7Pn7XXd1ujWMwLkzSY
			1: Run the EXE to extract.
			2: Look for the directory.
			3: Go to the Setup folder and copy the contents to your HoneySelect folder.
			4: Overwrite when asked.
				If you are not asked to overwrite, you did it wrong.

================= SECTION 1-A =================
ScrewThisNoise Better Repack
IF YOU USE THIS PACK, DO NOT DO 1-B.
IF YOU DON'T WANT TO USE THIS PACK, SKIP TO 1-B.
This pack is not reccomended because a few important plugins do not work correctly.

	This Repack/ModPack contains a lot of essential mods and plugins.
	This repack uses BepInEx, a different method to enable modding.
	This pack does not contain the game.
	This pack has a recommended graphical mod installed and adjusted.
	Some plugins don't work and may hinder your experience.
	> Download: https://drive.google.com/file/d/1pEbAWqZlfKO8_h_RpuXwy3Kanh1B3Mbk/
	> Mirror if  above doesn't work: https://ai-shoujo.com/download/[ScrewThisNoise]%20HoneySelect%20R0.5.7z
		> If you cannot use 64-bit exes, download this afterwards:
			https://github.com/BepInEx/BepInEx/releases/download/v5.0.1/BepInEx_x86_5.0.1.0.zip
	1: Drag and drop everything into your HoneySelect folder.
	2: Run StudioNEO_64.exe at least once.
	3: Open HSResolveMoreSlotID and resolve slotID errors if any by pressing the Resolve All button.
	4: Enjoy the game.

================= SECTION 1-B =================
IF YOU USE THIS PACK, DO NOT DO 1-A.
If you don't want this pack, go back to 1-A.

	The plugin pack contains a lot of essential plugins and utilities.

Step 1 - Installation
	1: Download Pack: http://www.mediafire.com/file/rw52mkihyig5v6x/
		Drag and drop contents into your HoneySelect folder.
		Overwrite when asked.
	2: Download SBX2_Uncensor_v2.5e : https://pastebin.com/Z9kkjDjT
		You can install SBX2.5e using the resolver.
	3: Download Male_Uncensor_From_PlayClub_v4.1 : https://pastebin.com/Z9kkjDjT
		...Link pending...
	4: Download and install Widesliders: https://mega.nz/#F!D992CACB!wGCXpPjskjNl9YoCYL_K0A?OoNXVYiR
		Ignore other files in the link.
	5: Download English Translations if needed from: https://pastebin.com/Z9kkjDjT
	> Drag and drop everything into your HoneySelcet folder.
	> Overwrite when asked.

Step 2 - Enable Modding
	Drag and drop the game EXE onto IPA.exe to create a Patch & Launch shortcut.
	Run WideSlider.exe

	OR

	Open up HSResolveMoreSlotID.exe
		1: Go to the Installation checker tab.
		2: Click patch IPA
		3: Click Patch Wideslider.
		4: Click Disable RegEX (This speeds up category loading)
		5: Ignore everything else.

	After doing either:
		Run the Patch & Launch shortcuts.
		Run StudioNEO Patch & Launch at least once to register items into HSResolveMoreSlotID.

Step 3 - Checking Status
	Open up HSResolveMoreSlotID.exe
	Go to InstallationChecker

	DO NOT INSTALL 4K OR LRE USING THE INSTALLATION CHECKER

	> HSResolveMoreSlotIDPlugin should be green.
	> Neo Basic Sphere will turn green later. Ignore for now.
	> 0630 Should be green.
	> HSResolveMoreSlotIDPlugin should be green.
	> IPA should be green.
	> Translation and RegEX should be green if you opted for it.
	> Widesliders will turn green after you ran the wideslider exe.
	> Translations will turn green if you installed it.

	DO NOT INSTALL 4K OR LRE USING THE INSTALLATION CHECKER

================= SECTION 2 =================
Installing Mods
	You can obtain mods for the game at: https://pastebin.com/Z9kkjDjT
	Most of the mods you'll find in the [Mods & Add-on] section.
	Ignore everything else beyond that unless you know what you need since both packs above already include plugins.

	Most mods can be installed by simply dragging and dropping everything into your HoneySelect folder.
		> abdata stuff goes into abdata.
		> plugins stuff go into plugins.
		> UserData stuff goes into UserData.
		Most mods are already structured for you, so you don't have to guess what goes where.
		However, this method is messy and makes it harder to uninstall mods later except for plugins.

		Afterwards, Open HSResolveMoreSlotID and resolve any ID conflicts or save neo item lists.

	In HSResolveMoreSlotID.exe, you have the option to set up a folder containing mods.
	This is optional, but recommended since it'll let you organize mods into multiple folders.
		0: Make a new folder, and name it however you wish (ie: HS Mods)
		1: Go to the Settings tab and ensure Mod Loader is active in HSResolveMoreSlotID.
		2: Go to the Mod Folders tab.
		3: Click Add Folder. Add the folder you created.
		4: Put mods in that folder.
			Mod folders support zip files and extracted folders.
				The mod folder window ONLY SHOWS ZIPPED FILES.
				Zips with a yellow name cannot be recognized and must be changed or extracted.
				To check if a mod is installed, search for the item name in one of the other tabs.
		You can have multiple mods folders.
		You can have multiple folders inside mod folders.

		Mods that alter any vanilla asset should be installed using the old method.
			Although they can be installed with the resolver, the resolver will prioritize which asset by file date.

When installing character mods, you may have to resolve ID errors.
	Open HSResolveMoreSlotID and [Auto Resolve Everything].

When installing studio mods, you must run HSResolveMoreSlotID. Go to the NEO tab and [Save Changes] to automatically register items into the list.
	You may have to resolve ID errors by pressing [Auto Resolve Everything].

Mods that must be installed using the old method.
	> Uncensor2.
	> Cubemaps.
	> Plugins and their associated files.
		GGMod is an exception. The plugin must be installed manually, but the mods do not.
	> Skintex
	> LRE (Partial)
	> Cards	and UserData items.

================= SECTION 3 =================
Graphical Mods
If you installed STN's Repack, skip step 1.
This section will cover LRE+IBL.

Step 1 - Obtain the Mod.
	0: Go to https://joan6694.bitbucket.io/ or look in the pastebin: https://pastebin.com/Z9kkjDjT
	1: Download AAIO from the HS Linear Rendering Experiment tab.
	2: Drag and drop everything from your respective folder according to your game status.
		> If your game is fresh.
			1: Use the [From Scratch] folder.
			2: When asked to overwrite, choose NO.
				By choosing NO, you install only the essentials.
				By choosing YES, you will install a different default character and oversaturated materials.
		> If you've had 4K diffuse installed.
			1: Use the 4K folder.
			2: Overwrite when asked.
		> If you've had LRE installed.
			1: Use the From LRE folder.
			2: Overwrite when asked.
		> If you don't know.
			1: Use the From LRE folder.
			2: Overwrite when asked.
	After installing the pack, the game will look different. This is normal, you must adjust it.
	Your character's may become extra shiny. Adjust the characters yourself.

Step 2 - Setting up LRE for the first time.
If you wish to skip doing the prep work yourself in Step 2, skip to the end of SECTION 3 for some presets.
	> UserData\GraphicSetting\Config.xml :: tells the game what presets to use.
	> UserData\GraphicSetting\ImageEffect :: is where color presets are.
	> UserData\GraphicSetting\Common :: is default post processing effects.
	> UserData\GraphicSetting\Style :: is for people familiar with 4K diffuse.

	1: Delete LightingRenderingAssist.xml to reset it.
	2: Edit the xml inside the ImageEffect folder and adjust the colors to your liking.
	3: Edit the Config.xml to point to your preset.

	If you don't know what setting does what, you can open IBL (F5) in-game and try them there.
		Any changes you make in IBL is temporary. They are only saved with studio scenes.
			The default settings will always be what you put inside the xmls.

	If you delete any of the XMLs, the game will try and remake a default one.

LRE Skins
Both of these contain brighter skins with better color handling.
	Nyaacho and Honey D LRE Skins: https://mega.nz/#!NJURDADZ!3DBuEO462W0Y8XoN1pvqUfB6cd3YpTycim8mwRElWgc
		When asked to overwrite, choose YES.
	Body Deluxe: http://metagraphy.blog.fc2.com/blog-entry-140.html
		When asked to overwrite, choose YES.

Red Eye Fix
Default LRE installation comes with bloodshot eyes.
	> Metagraphy's eyeball fix: https://www.patreon.com/posts/meta-eyeball-fix-28577090
		If you chose NO when installing the AAIO, you might not need this.
		If your characters have the eyes of a drug addict, you might need this.

Cubemaps
Cubemaps are useful for quickly setting up ambient lighting.
		Some cubemaps have large file sizes.
	Metagraphy Cubemaps: https://mega.nz/#F!ofhTgbTQ!fAgjV1YlQ7wRy4vZ-LhZNQ
	Joan Cubemaps: https://mega.nz/#!BtIVUYBT!Cp9WmPCX35C-0cj-HukDdhRQ7qz6tnoa9p7ynpZOucE
	Hooh Cubemaps: https://mega.nz/folder/00U0SI5J#OHkvdPdZJlqdv8cYW31cjQ

LRE / IBL Presets
If you need a preset to quickly set up your LRE/IBL environment.
	Metagraphy's: https://www.patreon.com/posts/meta-body-skin-26688397
		Balances light and dark.
		Mainly utilizies IBL.
		Starter kit is at the  bottom of the page.
		Please read the Demonstration section on how to use it.
	Ante's: https://mega.nz/folder/SJ9W3QpK#zW9jjLiKqUnbPmvwz24-AQ
		Attempts to retain the game's vanilla colors.
		Does not utilize IBL, but includes IBL presets.
		When opening IBL(F5) in the character maker, always choose [Just This Time].
Regardless of what LRE preset you use, you can override them with IBL on a scene by scene basis.

================= SECTION 4 =================
Extra Stuff

Missing Legacy 4K Skins
	1: Download 4K_Skin_Diffuse_Initial_Pack (All-In-One) from https://pastebin.com/Z9kkjDjT
	2: in the .rar file, go to the [abdata] folder.
	3: Drag and drop the [list] and [plastic] folder into your HoneySelect/abdata folder.
		If asked to overwrite, choose NO.
	This installs the 4K skins from 4K diffuse without installing the entire graphics mod portion.
	If you installed the entire package, you might have to re-do the LRE installation process again.

Legacy Body Shine for Custom Heads :: IE: Fixing seams.
	This is OPTIONAL. This is a one or the other type of deal.
	If you prefer using Roy12's character mods, you might want this.
	IF you prefer making custom characters using vanilla heads, you don't want this.

	1: In the 4K_Skin_Diffuse_Initial_Pack (All-In-One) .rar file, go to [abdata].
	2: Drag and drop the [chara] folder into your HoneySelect/abdata folder.
		When asked to overwrite, choose yes.
		You will be replacing these two files:
			cf_m_base.unity3d
			cf_m_face_00.unity3d
		These two control minute detail of the body and is largely responsible for the body's shine.
	3: If you have HSStandard: Go to HoneySelect\UserData\modprefs.ini
		Under [HSStandard], set replaceSkin=0.

If you wish to revert back to the LRE shine, just reinstall Metagraphy's body set in SECTION 3 or take the same two files, or enable HSStandard.

================= SECTION 5 =================
FAQS
Q: Does this work with repacks?
A: Maybe. But a certain FR repack has a ton of issues that make doing anything with it a pain.

Q: Is there a difference between BepInEX and IPA?
A: Yes, but IPA is reccomended for HS due to having much more support behind it despite BepInEx being much more supported for other games.

Q: Is there a modloader like sideloader or a mod manager?
A: HSResolveMoreSlotID can load mods from a folder that you put to the side.

Q: I'm on IPA, and I want to switch to BPN.
A: You must have a vanilla copy of the game available.
	> Delete all the *_Data folders. Don't touch abdata or UserData.
	> Copy the *_Data folders from your backup into your Honey Select Folder. Don't touch abdata or UserData.
	> Copy the game .exes from your backup into your Honey Select folder and overwrite.
	> Delete IPA.exe
	> Delete the IPA folder
	> Delete Mono.Cecil.dll
	> Delete UITranslation from Plugins
	> Delete all instances of "UnityEngine.UI.Translation" by using search.
	> Delete all instances of "Wideslider" by using search.
	> Install the repack
		> If you choose to overwrite, you may have to redownload several body related mods and redo your LRE settings.
	Run the game.

Q: I'm on BPN, and I want to switch to IPA.
A:	> Delete BepInEX folder.
	> Delete winhttp.dll
	> doorstop_config.ini
	> In the Plugins_backup folder, drag everything inside there back into Plugins and overwrite.
		> Optional: Just install the plugin pack after deleting the first 3 files.
	> Install IPA from the pastebin, resolver, or github page by drag and dropping contents into the HoneySelect folder.
		> Optional: Just install the plugin pack after deleting the first 3 files.
	> Drag and drop game exe's onto ipa.exe or use the resolver to patch.
	> Run the Patch & Launch shortcuts.
	> If plugins are still broken, you may need to reinstall them.

Q: I'm on Fakku version, and wish to mod my game.
A: You must have the Extended DLC.

Q: I'm on DMM version, and wish to mod my game.
A: Install the 0630 patch and continue following the guide.

Q: Is there a reason why I shouldn't install the full 4K Diffuse mod?
A: It contains a graphics patch and data for an older version of the game.
	You can already access the 4K settings through the latest version of LRE+IBL.

Q: Is there a reason why I shouldn't install the full LRE + IBL package?
A: It contains additional files that will replace your default character maker girl and saturated materials.
	You can change your default girl with HSUS.
	The saturated materials assumes you will be using default LRE + IBL settings, which was originally meant for a much older version of LRE.

Q: Is there a reason why I shouldn't use the resolver to install 4k Diffuse or LRE?
A: It installs extremely old versions.

Q: I installed LRE and now my background is gone.
A: https://joan6694.bitbucket.io/
	Install  HS Image Based Lighting (IBL) 5.1.0. and go to [UserData\GraphicSetting] and open Config.xml then turn <CharaMakerReform> to False.
	5.0.1. is bugged.

Q: There are multiple resolvers, which one do I  use?
A: Only HSResolveMoreSlotID. Delete everything else.