Dead or Alive Xtreme Venus Vacation
===================================

This is not to be confused with the console exclusive game Dead or Alive Xtreme
3: Venus. This is a free to play casual volleyball *management* game, and lacks
the volleyball gameplay or minigames of its console counterpart and has no
English translation, but - at least it is on PC. For help with installing this
game refer to [this article][1] (the camera mode of the Google Translate
Android app may also be helpful for any steps that have changed since this
article was written), and [the beginners guide][2] to understand the game
itself.

[1]: https://www.dualshockers.com/dead-alive-xtreme-venus-vacation-guide/
[2]: https://docs.google.com/spreadsheets/d/1rkWZB4DcKsKydZgpZzXrj7f1MGXRMJ3GDiqmEXeVQUw/edit#gid=1887486128

Costume Mods
------------
This mod primarily adds support for NVIDIA 3D Vision to the game, but it is
also required for the costume mods available for this game. If this is why you
are here you can ignore any of the information below that is specific to 3D
Vision users and just follow the instructions on the website that led you here.

This mod by itself will not change any costumes - for that you will need mod
packs available from elsewhere and extract them into the Mods directory. You
don't need to restart the game after installing a new mod - just press F10 in
game to load any new mods.

Some mod packs ship with optional parts of the mods that are not enabled by
default - look for any files or directories in the mod pack that is named
"DISABLED something", and remove the "DISABLED" from the filename to enable it.

Installing (3D Vision + Costume Mod users)
------------------------------------------
1. Extract the contents of the zip file to the game directory.

2. In the launcher (not the game), open settings (2nd button from the top) and
   change everything to the left-most option (lower quality options are known
   not to work).

3. **IMPORTANT (3D Vision Users only): Once the main game launches, press F7 to
   switch to exclusive full screen mode to engage 3D. Repeat this anytime you
   alt+tab out of the game to re-engage 3D.**

Keys (3D Vision + Costume Mod Users)
------------------------------------
- F1: Show help
- F2: Toggle costume mods
- Shift+F2: Cycle costume mod shadow modes (on/off/original)
- Mouse back button: Toggle HUD visibility
- Ctrl+F9: 3DMigoto performance monitor

Keys (3D Vision Users Only)
---------------------------
- F7: Full Screen
- ~: Toggle auto-convergence feature on and off
- Ctrl+F5: Reduce popout when auto-convergence is on
- Ctrl+F6: Increase popout when auto-convergence is on

Auto-Convergence (3D Vision Users Only)
---------------------------------------
This fix uses my new auto-convergence feature (first introduced in my Life is
Strange: Before the Storm fix) to automatically adjust the convergence while
playing to suit the various scenes and quick camera angles changes this game
does. For this game I have set it to try to keep everything inside the screen
(behind the HUD), while still maximising the 3D effect in any given scene.

The auto-convergence feature replaces the traditional meaning of 3D Vision's
convergence setting with a "popout" setting, which is similar to convergence,
but gives better results with a wider range of camera angles, monitor sizes and
viewing distances. The same keys that normally adjust the convergence will
adjust the popout instead when auto-convergence is enabled, and the popout
value will be displayed on screen while adjusting it.

This feature has a number of tunable parameters, which can be tweaked by
editing the [Constants] section in the d3dx.ini. These tunables include things
such as the initial popout, minimum and maximum allowable convergence values,
thresholds for how far the convergence is allowed to get away from the target,
and threshold for the anti-judder countermeasure.

3D Vision Fixes
---------------
- Lights & shadows
- Water
- HUD
- Added automatic convergence

3D Vision Update v1.1
---------------------
- Fixed ripples
- Fixed auto-convergence popout bias changing on full screen
- Use a lower convergence preset when Burst is activated

Update v1.2
-----------
- Fixed shadow glitch
- This fix now forms the basis for third party costume mods

Update v1.4
-----------
- Major 3DMigoto update (conditional logic, performance monitor)
- Auto-convergence performance cost will be skipped when 3D Vision is disabled
- Added toggle keys for costume mods and shadows (try cycling shadow modes if performance is an issue)
- New built in help shown by pressing F1
- Enabled costume mods for missing costume + shadow shaders
- Enabled costume and fingernail texture replacement mods
- Fix cases where a shadow could go missing from a costume mod
- HUD will always be shown in burst mode

Update v1.5
-----------
- Fix missing legs in some costume mods
- F2/Shift+F2 hotkeys now show status in overlay

Update v1.6
-----------
- Re-fixed lighting & auto-convergence broken by game update

Update v1.7
-----------
- Updated costume mod and 3D Vision ripple fix for compatibility with DOAXVV
  December 6th update
- Update to 3DMigoto 1.3.12 (adds vertex buffer hunting keys, clipboard marking
  mode, etc)
- 3D Vision: Made specular reflections on some (not all) materials render at
  their accurate depth instead of surface depth.
- 3D Vision: Tweaked auto-convergence settings for more comfort in some
  cutscenes.

Hotfix v1.8
-----------
- Fixed pink fingernails
- Added another missing costume shader

Known Issues (3D Vision Users Only)
-----------------------------------
The news and Gacha probabilities windows and certain text boxes are blank while
in full screen. Alt+tab out of the game (not just disabling 3D) and they will
appear, and press F7 to re-enable 3D when done, but of course it is all in
Japanese anyway. Visit [this site][3] for English translations.

[3]: http://www.doax-venusvacation.com

Side-by-Side / Top-and-Bottom Output Modes (3D Vision Users Only)
-----------------------------------------------------------------
This fix is bundled with the SBS / TAB output mode support in 3DMigoto. To
enable it, edit the d3dx.ini, find the [Present] section and uncomment (remove
the semicolon) the line that reads:

    run = CustomShader3DVision2SBS

Then, in game press F11 to cycle output modes. If using 3D TV Play, set the
nvidia control panel to output checkerboard to remove the 720p limitation.

Like my Work?
-------------
Fixing games takes a lot of time and effort, and I am currently otherwise
unemployed largely due to my ongoing [battle with mental health issues][4].

If you are in a position where you are able to do so, please consider
[supporting me with a monthly donation on Patreon][5], and thanks again to
those that already do! While I prefer the more stable monthly support that
Patreon offers, I can of course understand that some of you prefer to make
one-off donations when you can, and for that you can use [my Paypal][6]. As a
reminder, these donations are to support me personally, and do not go to other
modders on this site.

[4]: https://forums.geforce.com/default/topic/1000942/3d-vision/where-has-darkstarsword-been-/
[5]: https://www.patreon.com/DarkStarSword
[6]: https://www.paypal.me/DarkStarSword

_This mod is created with 3DMigoto (primarily written by myself, Bo3b and
Chiri), and uses Flugan's Assembler. See [here][7] for a full list of
contributors to 3DMigoto_

[7]: https://darkstarsword.net/3Dmigoto-stats/authors.html
