Title: Costume Customizer Mod for DOAXVV
Version: v2.5.2
Released: 2/28/2023

Topic Forum: https://www.loverslab.com/topic/109195-costume-customization-mod/
Download Page: https://www.loverslab.com/files/file/7305-costume-customizer-framework-mod/

***************
* Description *
***************
This mod allows you to mix-and-match portions of suits that have been provided by the CostumeCustomizer mod-packs you've included. It replaces the Takao R Suit (Black/Red Bikini w/ Pareo) and Dewa SR Suit (Orange/White Bikini w/ Pareo). It uses a 2D overlay menu to customize your outfit to your liking.

****************
* Installation *
****************
- Mod Manager installation
Either use DOAXVV Mod Manager to install using the vvmm_CostumeCustomizer_v*.zip or through the online database.

- Manual Installation
Extract CostumeCustomizer zip at the root of your DOAXVV game directory.
Run update.bat within CostumeCustomizer folder inside Mods/Costumes/CostumeCustomizer to ensure Mod-Packs are compatible.

Note: If you install any legacy mod-packs (ones released before CC v2.0, be sure to rerun update.bat after installing them to update them to latest).

**********************************
* Mod Pack Installation (Manual) *
**********************************
1. Download your desired mod packs.
  Example: CostumeCustomizer_NudeStrapsSet1_v1.0.zip

2. Extract your mod pack into the CostumeCustomizer folder, such that they reside as follows:
  Example: DOAX-VenusVaction/Mods/Costumes/CostumeCustomizer/CostumeCustomizer_NudeStrapsSet1_v1.0
  Note: Check that you have the following ini files correctly located (for the given example):
    DOAX-VenusVaction/Mods/Costumes/CostumeCustomizer/CostumeCustomizer_NudeStrapsSet1_v1.0/Common.ini
    DOAX-VenusVaction/Mods/Costumes/CostumeCustomizer/CostumeCustomizer_NudeStrapsSet1_v1.0/Marie.ini
    DOAX-VenusVaction/Mods/Costumes/CostumeCustomizer/CostumeCustomizer_NudeStrapsSet1_v1.0/Honoka.ini\

3. Disable or delete an unused ModPack slot.
  Note: CostumeCustomizer currently supports 240 mod pack slots designated by folders 01 - 99, 100-240.
  Example: Delete unused mod slot folder 01

4. Rename ModPack to fill in the recently disabled/deleted mod slot
  Example:
    Before: DOAX-VenusVaction/Mods/Costumes/CostumeCustomizer/CostumeCustomizer_NudeStrapsSet1_v1.0
    After: DOAX-VenusVaction/Mods/Costumes/CostumeCustomizer/01

5. Navigate into the Mods/Costumes/CostumeCustomizer folder and execute update.bat.

6. Start the game, or reload mods if already running using F10.

***************
* How to Use  *
***************
Have the correct swimsuit displayed on-screen before attempting to use any of the keyboard shortcuts. Ensure that the character wearing a given suit (Takao/Dewa) is properly associated with that suit in the customization menu.

Keyboard Shortcuts:
F3 - Cycle Clothing Menu*
CTRL+F3 - Switch to Material Editor Menu (Use 1-9,0 on the GUI to select the GUI items)

Note*: If multiple different model-types are available to customize clothing, the F3 button will cycle between each currently on-screen model type and off
  - Common Body Type Customization menu
  - Honoka Body Type Customization menu
  - Marie Rose Body Type Customization menu
  - Menu Off

With clothing menu open:
` (backtick) or BACKSPACE     Switch to preset menu; while in presets change the page
CTRL + 1                      Switch to Shirts/Dresses menu; while in Shirts/Dresses change the page
CTRL + 2                      Switch to Bra menu; while in Bra change the page
CTRL + 3                      Switch to Panty menu; while in Panty  change the page
CTRL + 4                      Switch to Skirt menu; while in Skirt  change the page
CTRL + 5                      Switch to Glove menu; while in Glove change the page
CTRL + 6                      Switch to Shoe/Stocking menu; while in Shoe/Stocking change the page
CTRL + 7                      Switch to Accessory 1 menu; while in Accessory 1 change the page
CTRL + 8                      Switch to Accessory 2 menu; while in Accessory 2 change the page
CTRL + 9                      Switch to Accessory 3 menu; while in Accessory 3 change the page
CTRL + 0                      Switch to Accessory 4 menu; while in Accessory 4 change the page

With Material Menu open:
` (backtick) or BACKSPACE     Switch to material edit menu
CTRL + 1                      Switch to Common-Body Takao Custom Material Toggle
CTRL + 2                      Switch to Common-Body Dewa Custom Material Toggle
CTRL + 3                      Switch to Honoka-Body Takao Custom Material Toggle
CTRL + 4                      Switch to Honoka-Body Dewa Custom Material Toggle
CTRL + 5                      Switch to MarieRose-Body Takao Custom Material Toggle
CTRL + 6                      Switch to MarieRose-Body Dewa Custom Material Toggle
CTRL + 7                      Switch to material edit menu
CTRL + 8                      Switch to material edit menu
CTRL + 9                      Switch to material edit menu
CTRL + 0                      Switch to material edit menu

Choosing the same category as the current category will cycle between the available pages of options:
  - Mod Packs 1-24
  - Mod Packs 25-48
  - Mod Packs 49-72
  - Mod Packs 73-96
  - Mod Packs 97-120
  - Mod Packs 121-144
  - Mod Packs 145-168
  - Mod Packs 167-192
  - Mod Packs 193-216
  - Mod Packs 217-240
  - Mod Packs 241-264
  - Mod Packs 265-288
  - Mod Packs 490-312
  - Mod Packs 730-336
  - Mod Packs 337-360
  - Mod Packs 361-384
  - Mod Packs 385-408
  - Mod Packs 407-432
  - Mod Packs 433-456
  - Mod Packs 457-480

While mouse is hovering over an item:
1          Wear option 1
2          Wear option 2
3          Wear option 3
4          Wear option 4
5          Wear option 5
6          Wear option 6
7          Wear option 7
8          Wear option 8
9          Wear option 9
0          Wear option 10
Shift + 1  Wear option 11
Shift + 2  Wear option 12
Shift + 3  Wear option 13
Shift + 4  Wear option 14
Shift + 5  Wear option 15
Shift + 6  Wear option 16
Shift + 7  Wear option 17
Shift + 8  Wear option 18
Shift + 9  Wear option 19
Shift + 0  Wear option 20

While the menu is displayed, icons of each character is displayed next to the clothing menu.
If they are colored, the girl is associated with that suit's customization (Takao or Dewa).
If the girl's icon is grayscale and dim, the character is not active for that suit's customization.
Pressing any of the option buttons (1-9, 0) while hovering over the girls icon will set her to the current suit's customization.

****************************
* Known Issues/Limitations *
****************************
- Kasumi and Misaki share the same skin texture hash so they can't be differentiated. They must either both wear Takao or both wear Dewa if displayed concurrently.
- Patty and Misaki share the same head shadow hash so they can't be differentiated. To properly use Patty, ensure both Misaki and Patty are associated with the Takao suit.

***************
* Change Log  *
***************
v2.5.2 - (2/28/2023)
Minor Fixes to menu.ini.

v2.5.1 - (2/26/2023)
Added support for Yukino. Added new VB Hashes for DMM Leifang, Sayuri, and Fiona head hashes.

v2.5 - (8/29/2022)
Added support for Shandy. Adjusted MaterialEditor.ini to support disabling (with appropriate patch). Multiple versions released for 1/10/20 page support.

v2.4 - (4/15/2022)
Increased Page count to 20. Added support for Amy (Common body Type).

v2.3.1 - (2/7/2022)
Corrected Menu.ini issue causing warning for Tina's hash.

v2.3 - (2/6/2022)
Added support for Tina (Common body type). Corrected Lobelia detection. Increased maximum mesh count per item to 6 Opaque-meshes and 6 alpha-blended meshes. Updated Marie body-type leg mesh based on SavageMoonBoy's corrections.

v2.2.3 - (11/12/2021)
Added support for Koharu (Common body type). Compressed persistent material toggle variables to reduce the number of persistent variables needed, added a mod-loading delay of 3 frames to reduce the chances for crashing on reloading.

v2.2.2 - (7/18/2021)
Added support for Elise (Honoka body type). Added Menu Overlay Support, see forum topic for details.

v2.2.1 - (6/20/2021)
Switched custom material marker resource from ps-t96 to ps-cb11 to avoid various incompatibilities.

v2.2 - (6/6/2021)
Added Material Editor Previewer and persistent material customization.

v2.1 - (4/3/2021)
Added support for Nanami (Common body type). Increased support to 240 different Mod-Packs.

v2.0.6 - (11/26/2020)
Added support for Lobelia (Marie-Rose body type).

v2.0.5 - (11/26/2020)
Updated hashes for Sayuri. Added BACKSPACE alternative key combination for Preset page to be more international keyboard friendly.

v2.0.4 - (10/28/2020)
Fixed issue with INI Generation where custom tan/body textures INI logic wasn't being produced correctly when using default meshes. Fixed all release packages to properly include latest files.

v2.0.3 - (10/22/2020)
Fixed issue with custom tanning textures, updated ini generation to allow custom tan/body textures even when using default meshes.

v2.0.2 - (9/12/2020)
Fixed issue with incorrect custom body texture resource handling.

v2.0.1 - (9/9/2020)
Updated update.bat script to support spaces in the game's path.

v2.0.0 - (9/9/2020)
2 independent suit customizations now possible concurrently by utilizing both Takao R suit and the Dewa SR suit. Refactored to ref copies across the board. Including CCModPackUpdater to regenerate all Mod-Pack INI logic to be compatible.

v1.9.8 - (8/29/2020)
Added support for Tsukushi. Adopted updated groin meshes for Honoka and Common body models prepared by IceTree5.

v1.9.7 - (7/19/2020)
Fixed base nude mesh exports for Common and Honoka for pubic UV mapping seam.

v1.9.6 - (6/22/2020)
Fixed Mod-Manager integration for default Steam path and other pathes that include spaces.

v1.9.5 - (6/21/2020)
Added support for Patty, Mod-Manager previews and integration

v1.9.4 - (4/1/2020)
Minor corrections to mesh normals and weight paint to clean-up body defects. Corrected loading mod-packs 12-15.

v1.9.3 - (3/7/2020)
Updated shared body mesh to a smoother model with better weight-paint to reducies the jagged edges.

v1.9.2 - (3/7/2020)
Minor update to cache the ps-cb2 files live for the default ps-cb2 buffers to maintain accurate fresnel settings.

v1.9.1 - (3/4/2020)
Fixed issue with presets not saving properly with up-to-date Mod-Pack INI logic.

v1.9 - (3/1/2020)
Expanded maximum number of available mod-packs to 96 from 24 and implemented pages to cycle between each group of 24. Switching category will display mod-packs 1-24, pressing the key command for that same category will cycle to the next page up to page and loop around (pages: 1-24, 25-48, 49-72, 73-96). Fixed an issue with the preview display of Mod-Pack 3. Fixed an issue with extremity clothing shadows not casting properly. Consolidated key commands and deconflicted menu when multiple body-types are using CostumeCustomizer and the user attempts to utilize the menu (Pressing F3 will cycle between customization menus currently available on screen). Increased available options and adjusted keyboard shortcuts. Preset category hotkey changed to backtick (`) with any modifier as CTRL+` doesn't function with the Japanese IME active.

v1.8 - (2/20/2020)
Added support for Sayuri skin overrides. PS1 and PS2 textures now default to emtpy normal and specular maps so there shouldn't be any issues for shaders if they aren't overridden in a ModPack.

v1.7 - (8/18/2019)
Added support for Monica skin overrides. Corrected keybindings so selecting option 11/12 are done using the -/+ on the number row rather than NUMPAD.

v1.6 - (4/26/2019)
Added support for Kanna skin overrides. Switched Custom Shaders to Global ShaderRegex. This is to fix an issue regarding shadows not being applied to the alpha-enabled clothing drawn from custom shaders. I couldn't seem to find a different way to fix it while still using custom shaders so this is the result. This does mean that all other draw calls will be subject to the Shader modification. The modification replaces the cb2 buffer for the cb12 buffer for most pieces except for a handful of items that were determined to be dynamic based on the scene. Those items will be derived from the original cb2 buffer.

v1.5.1 - (1/14/2019)
Fixed issue with multiple characters on screen at the same time.

v1.5 - (1/13/2019)
Added support for custom Tan textures and skin textures per body mesh. Skin Textures are per character skin, (which means there will need to be a minor update for each new character added). However Misaki and Kasumi use the same skin, so those will still be shared. Custom Default Constant Buffer support is also added. This allows altering several properties used in the pixel shader including minor color manipulation, Specular Color, and Fresnel. Some properties may be deprecated when it becomes more apparent whether they should be allowed to be overridden or whether they should stay the value they are in game.

v1.4 - (1/6/2019)
Cleaned up logic for "else if", added support for persist variables so now the current outfit will maintain between play sessions. Currently still compatible with CCModPackGenerator v1.0.1.

v1.3.1 - (12/2/2018)
Changed packaging structure so installation is just extract main zip/patch into root of DOAXVV game folder.

v1.3 - (11/10/2018)
New menu graphics provided by IceTree5
Split Chest into 2 secions (backwards compatible with the original 1 replacement)

v1.2 - (10/24/2018)
Fixed Default load when reloading with F10. 

v1.1 - (10/20/2018)
Initial Release supporting all 3 body types
Added Marie Rose, Luna, and Honoka Support. Fixed draw order of the alpha pieces. Order is Panty -> Bra -> Skirt -> Chest -> Acc1 -> Acc2 -> Acc3 -> Acc4.

v1.0 - (10/13/2018)
Initial Release supporting common body.
Supports 1 page each for presets and 10 categories, each page supports 24 items, each item supports 12 options.
