2)+Installation - PDModdingCommunity/PD-Loader GitHub Wiki

Previous | Next

1) System Requirements

2) Installation

3) Verification

System Requirements

  • 64-bit CPU (x86_64)
  • 2 GB of RAM
  • NVIDIA GPU recommended (Fermi-based or newer required for 3D rendering) and → the latest driver. If you get crashes or black screen in movie PVs, do a clean install or downgrade to version 446 instead (again, do a clean install).
    • However, if you have an Intel GPU (or a generic or old GPU that supports OpenGL ~2.1, including Apple M1), check out → this tutorial BUT use → this version of DivaImGui, or keep reading for Mac instructions
      DO NOT USE USE VERSION 0.0.5 OR EARLIER FROM ITS GITHUB PAGE, as it is known to cause visual artefacts
    • Or if you have an AMD GPU, you can make use of the unofficial AMD compatibility included in PD Loader 2.5 and newer (Novidia). On Windows, AMD drivers newer than 22.6.1 are not supported.
    • EXPERIMENTAL If you have an AMD GPU on drivers newer than 22.6.1, or an Intel GPU, etc... try korenkonder's DivaGL (experimental, may not work properly; needs testing)
  • Windows Vista SP2¹/7 SP1/8.x/10/11 (64-bit), GNU/Linux (64-bit), macOS 10.14 Mojave or newer²
  • Your own dump of PDAFT version "7.10" without any modifications
  • Your own dump of the official MDATA (optional)
  • → Visual C++ Runtime / Redistributable for Visual Studio 2019 or newer (install both the 32-bit and the 64-bit versions)
  • → .NET Framework 4.8 (or 4.5.2 on Windows Vista) (for Launcher.dva)
  • → The latest release of PD Loader

DO NOT GET THE SOURCE CODE! (that is, unless you want to build it yourself)

If you're here from README.txt, click on the link above to download the release!

Video tutorials do not and can NOT replace this wiki! Read it if you have any issues, before asking questions.

¹ Windows Vista support is experimental and currently requires mfplat.dll (64-bit) from Windows 7 in the game folder, and PD Loader unstable.

² macOS support is experimental and currently only been tested on Apple M1 with macOS 11 Big Sur and 12 Monterey, and on an Intel-based Mac with macOS 10.14 Mojave, 10.15 Catalina, and 11.6 Big Sur. There may be significant differences on macOS 10.13 High Sierra and earlier.

Installation

1) Extract everything to the root folder of the game (if you've replaced glut32.dll with a custom version, restore the original, as well)

2) (optional) Install the official MDATA. M215 to M271 are supported, custom MDATA folders are also supported

3) (REQUIRED for QuickSFV and for some plugins, such as lang.dva and DivaImGui stable) Remove any non-ASCII characters, such as Chinese or Japanese characters, in the game path

To install the MDATA (optional), copy each update to the "mdata" folder in the root folder of the game (create it if it doesn't exist); otherwise, make sure to have at least an empty "mdata" folder

Your game folder should look like this (if not, you did something wrong, such as using the source code):

Folder structure
Note that you may have dinput8.dll instead of dnsapi.dll. They're exactly the same file, but it's been renamed dinput8.dll on Windows 10 for compatibility.
mdata/M271 is optional.

Files required to make the MDATA available in the game are included¹ ("ram/databank/PvList*" files).

Now verify your game data, then see the next page for troubleshooting and controller configuration. See Known issues, as well.

To start the game on Windows, just run diva.exe.

¹ Created manually and converted with PD_Tool.

Additional installation steps (GNU/Linux)

  1. Install winehq-devel or winehq-stable. Versions 4.12-5.0 work fine. Versions 5.8-6.5 (and maybe even newer) may be affected by a bug that prevents .NET Framework from installing. However, that should be fixed in the latest devel version.

  2. Install .NET Framework 4.8 with Winetricks

winetricks --force dotnet48

NOTE FOR LUTRIS USERS: You may need to add DOTNET_ROOT (with an empty value) to the environment variables for the launcher to work.
NOTE: If you don't install .NET Framework 4.5 or newer, you have to remove plugins/Launcher.dva.

5.1) Manually download and install Visual C++ Redistributable for Visual Studio 2019 (install both the 32-bit and the 64-bit versions)

  1. Run

winecfg

  1. In "Libraries," add two new DLL overrides: dinput8, dnsapi (native, builtin)

  2. Disable movie playback

  3. If your GPU is NVIDIA Maxwell/Pascal or Turing/Ampere, select your GPU type manually.
    If it is AMD, install amdgpu-pro and force-enable Novidia in Plugins -> Novidia -> Config

  4. If you're using NVIDIA On-Demand (official offloading, enabled in the NVIDIA X Server Settings) e.g. on a laptop, use the following environment variables:

__GLX_VENDOR_LIBRARY_NAME=nvidia

__NV_PRIME_RENDER_OFFLOAD=1

  1. (recommended) Either disable pulseaudio, run the game with pasuspender, or add the following to /etc/pulse/daemon.conf:

default-fragments = 5

default-fragment-size-msec = 2

(optional) and uncomment the following:

high-priority = yes

nice-level = -11

realtime-scheduling = yes

realtime-priority = 5

then run pulseaudio -k ; pulseaudio -D and run the game with PULSE_LATENCY_MSEC=60 (or enable "Reduce PulseAudio Latency" in Lutris). You can also try running the game with PULSE_LATENCY_MSEC=50 if there aren't any gaps in the audio. You should also set "Target Buffer Size" and "Buffer Periods" to 1 in DivaSound. It is recommended to disable the compositor (enable "Disable desktop effects" if you're using Lutris).

To start the game, just run diva.exe with Wine.

If the game crashes, set Launcher.dva=0 in plugins/config.ini under [plugins].

Additional installation steps (macOS)

(this section is a draft and might contain mistakes)

  1. Open a terminal window and install Homebrew

  2. Install wine-crossover

5.1) Install winetricks

brew install winetricks

  1. Install .NET Framework 4.8 with Winetricks

winetricks --force dotnet48

NOTE: If you don't install .NET Framework 4.5 or newer, you have to remove plugins/Launcher.dva.

6.1) Manually download Visual C++ Redistributable for Visual Studio 2019 (both the 32-bit and the 64-bit versions), then open a terminal panel in the folder where you downloaded them (or manually "cd" to it) and run

wine vc_redist.x86.exe

wine vc_redist.x64.exe

  1. Run

winecfg

  1. In "Libraries," add two new DLL overrides: dinput8, dnsapi (native, builtin)

  2. Install this patch by copying it to the patches folder (also enable it in the launcher if necessary)

  3. Install DivaImGui development

10.1) Edit graphics.ini, set disableGpuDetect = 1, intel = 1, and run bc5begone (High quality):

wineconsole bc5begone.exe

  1. Open a terminal panel in the game directory (or manually "cd" to it) and run

wine diva.exe

11.1) Disable movie playback, DivaMovie, and ShaderPatch. Do NOT disable 3D rendering (even though it will not work), but disable everything else in the Details section, and manually set the window size to 1280x720 by typing it in the combobox

11.1.1) If the launcher crashes, manually edit config.ini (e.g. with TextEdit) and change the following:

[Graphics]
Shader = 0
...
[Patches]
...
No_Movies = 1
...
[plugins]
Launcher.dva = 0
Novidia.dva = 0
DivaImGui.dva = 1
macoscompat.p = 1

11.2) (optional) Use Skyth's No Osage Play Data patch.

  1. (optional) If the game freezes and desyncs, copy it to the internal SSD. Delete objset, osage_play_data, rob, pv_param, pv_expression, ibl, light_param, particle, and skin_param, if you need to save space. Also, increase the buffer size and periods in DivaSound if it still desyncs.

To start the game, just run diva.exe with Wine. Use WINEESYNC=1 WINEDEBUG=-all for the best performance.

WINEESYNC=1 WINEDEBUG=-all wine diva.exe

Additional installation steps (SteamOS 3.0/Steam Deck)

Check out this guide.

Verification

Use QuickSFV or a similar program to verify your game and mount data.

QuickSFV 2.36, Windows (and GNU/Linux and macOS with Wine) (recommended)

Just double click verify_base_game.sfv and verify_mount_data.sfv.

QuickSFV 3.00, Windows (command line only; do not double click the files, or you won't see the results)

quicksfv verify_base_game.sfv

quicksfv verify_mount_data.sfv

QuickSFV 3.00, GNU/Linux

LD_LIBRARY_PATH=.:$LD_LIBRARY_PATH ./quicksfv verify_base_game.sfv

LD_LIBRARY_PATH=.:$LD_LIBRARY_PATH ./quicksfv verify_mount_data.sfv

Note that glut32.dll will fail if you replaced it with PD Loader's FreeGLUT, but that's fine.
M270/info.txt might fail in some cases, but it should be fine as long as it exists.
M271 is optional and will fail if you don't have it.

Previous | Next

⚠️ **GitHub.com Fallback** ⚠️