3)+Usage,+Modules+(Costumes),+Troubleshooting - PDModdingCommunity/PD-Loader GitHub Wiki
Run diva.exe. The file must not be patched.
NOTE: Starting from version 1.5 BETA 2, this is handled automatically, but you might have to do it manually in some cases.
On high-DPI displays (display scaling > 100%), it is highly recommended to disable DPI scaling for diva.exe to pixellation. Right-click on diva.exe, select the "Compatibility" tab and click "Change high DPI settings"
Check "Override high DPI scaling behaviour." and select "Application"
NOTE: Starting from version 1.5 BETA, this is handled automatically.
On computers with more than one GPU (e.g. most laptops), you must run diva.exe the NVIDIA GPU. To set it as the default GPU for the game, open the NVIDIA Control Panel, go to "3D Settings", "Manage 3D settings", "Program Settings", click "Add"
Click "Browse"
Browse to the game folder and select "diva.exe"
Select "High-performance NVIDIA processor"
Click "Apply"
Some GPUs cannot decode the movies and the game hangs. If that's the case, make sure DivaMovie is enabled.
NOTE:
- On Windows 7, you can replace the WMV files with MP4 AVC ones (don't forget to edit [mdata_]pv_db.txt afterwards) to get hardware decoding. Windows Vista cannot play MP4 AVC files.
- DivaMovie only "supports" 1280x720 WMVs with no audio track and may not correctly work with some mods.
- On GNU/Linux, and even on some Windows systems, no movies can be played (not even with DivaMovie) and they must be disabled:
Or edit config.ini with Notepad++ or Wordpad (any native text editor is fine for GNU/Linux) and set No_Movies in the [Patches] section to 1.
ADVANCED USERS ONLY: You might get WMVs to play on Windows 7 with hardware decoding by replacing the system DLLs with these ones (you might have to take ownership of the system DLLs).
Technical details: PDAFT uses DXVA to decode the video, then it's passed to OpenGL with the NV_DX_interop extension, which is not supported by Wine. We're looking for a workaround to get movies working on GNU/Linux.
Downgrade the NVIDIA driver to version 446 or lower, or upgrade it to version 460 or higher, whichever works for you. Either way, do a clean install (reset the settings).
Drivers after 446, including 460+, can cause movies to randomly not load (causing black screens, black frames, green lighting, etc...). You can also try disabling DivaMovie (although it shouldn't help more than restarting the game).
Right click on diva.exe, select Properties, go to the Compatibility tab, and disable fullscreen optimizations.
If that doesn't fix it, try changing the display mode to Failsafe or Windowed.
If you still get stuttering, your computer is probably too slow. If you're using the original movie files (or custom 1280x720 WMVs), you can try enabling "Force software decoding" in DivaMovie, but that will increase the CPU utilization and might cause even more stuttering.
On AMD Navi GPUs, movies aren't rendered correctly. There is currently no fix nor workaround besides disabling movies.
By default, the game takes full control of the primary sound device. If you do not hear, or cannot record, any audio from the game, make sure to select the correct sound device, especially if a DualShock 4 is connected. To take screenshots, use Win+Alt+PrintScr (or GeForce Experience) on Windows.
Turing GPUs may be detected as Ampere according to the launcher. It's actually just the text, the actual detection is most likely correct.
Disconnect all controllers and reboot your computer.
Alternatively, edit keyconfig.ini with Notepad++ or Wordpad (or any native text editor for GNU/Linux) and comment out (with a '#') MENU_L and MENU_R. Note that you won't be able to use the D-pad in the menus anymore.
PD Loader probably failed to detect your NVIDIA GPU architecture.
This is normal on GNU/Linux, but can also happen on Windows if your version of PD Loader is too old, in which case, try updating it.
From the Graphics tab, click the "NVIDIA GPU" dropdown and select yours, for example:
GTX 750 Ti, 9xx: Maxwell
GTX 10xx: Pascal
Titan V: Volta/Turing
RTX 20xx, GTX 16xx: Turing
RTX 30xx: Ampere
RTX 40xx: Ada Lovelace
Anything newer: try Ada.
If no custom patches are detected, try downgrading Wine to version > 4.12 <= 6.0.
Possibly caused by the ini library. A fix is planned. As a workaround, delete the ini file.
- ShaderPatch hasn't been tested on a large variety of systems and may cause issues on some. Try disabling it if the game crashes.
- DivaMovie only supports 720p WMV movies when hardware decoding is not available, and is known to cause issues on some systems (so try disabling it if you're having issues with some PVs).
- NVIDIA graphics drivers above 446 can cause issues with movies on newer versions of Windows 10.
- Movies are not supported at all on GNU/Linux and must be disabled.
- GPU autodetection is not supported on GNU/Linux, so the correct workaround must be manually selected and, on AMD GPU systems, Novidia must be forced and the proprietary amdgpu-pro driver must be installed.
- dGPU switching is not supported on GNU/Linux (the Lutris installer is configured to work around this, at least on NVIDIA Optimus laptops).
- If using both NVIDIA and AMD, disable Novidia (otherwise, characters may disappear).
- Launcher reports Turing instead of Ampere, even though the GPU is detected correctly.
TLAC supports the following controllers natively:
- Keyboard
- Mouse
- DualShock 4 / DualSense
- XInput (Xbox 360/One and XInput wrappers for most other controllers)
- Generic DirectInput
NOTE: If your controls are not responding, try launching the game in windowed or borderless mode.
Supported natively. On Windows, DS4Windows is recommended for rumble and other features and may be necessary for 3rd-party controllers.
You can use DsHidMini (formerly ScpToolkit 1.6) to emulate an XInput controller.
Use BetterJoyForCemu (README) or ProconXInput (Pro Controller only).
Works as a DualShock 4. For arcade mode slider support (currently in alpha), set ps4_official_slider and slider_in_menus in keyconfig.ini to true, and set Hardware_Slider in config.ini to 1. You should also remove DS4 sticks from button bindings here (JVS_LEFT, JVS_RIGHT, MENU_L, MENU_R).
Works as a DualShock 4. A custom firmware created by Shink.Ryu is available for better support on Discord: https://discord.gg/cvBVGDZ
NOTE: Currently, the firmware updater requires Windows.
Edit keyconfig.ini with Notepad++.
Replace the VID and the PID with your controller's.
The button names you can use are commented in the file, they start with "GU_". If you don't see them, delete keyconfig.ini and run diva.exe to update the file.
If nothing works, you can emulate keyboard input with AntiMicroX.
XInput is emulated via SDL2. Use SDL2 Gamepad Tool to generate an appropriate environment variable for your controller (or use an existing one) if necessary.
Enable "Use Hardware Slider" in Options. If necessary, disable the Input Emulator and/or Slider Emulator components. If the game crashes, disable "XInput Rumble" in Options and/or disconnect all other controllers.
See Configuration files.
IMPORTANT: Do not edit any of the .ini configuration files with Notepad. Use Notepad++ (or WordPad) with UTF-8 encoding instead, otherwise your game may crash. On GNU/Linux, all text editors (except Wine Notepad) should work.
- Use "plugins\components.ini" to enable or disable TLAC components.
- Use "plugins\config.ini" to enable or disable plugins loading along other useful settings.
- Use "plugins\keyconfig.ini" to change your game keybindings.
- Use "plugins\playerdata.ini" to change your playername and other player customization.
Place any .dva plugin you want to use inside the "plugins" folder.
Launch "diva.exe". Use "--launch" argument to bypass the launcher and to be able to use other arguments.
You used the Lutris build on Windows or didn't follow the instructions, you silly old sausage!
Re-enable the Scale Component (in PD Launcher → Components).
If it doesn't work, try disabling DPI scaling. Also, verify your files.
The game is designed to run constantly at 60 FPS. If you have a high-refresh-rate monitor or if your computer isn't fast enough, motions will not be interpolated and therefore will look too fast or too slow.
PD Loader includes a Frame Rate Manager component as a workaround, which is disabled by default because it can cause stuttering. If you enable it and your monitor's refresh rate is 60 Hz, it is recommended to set FRM motion rate to 60 to avoid issues such as fast blinking.
Disable Threaded Optimization for diva.exe in the NVIDIA Control Panel.
This is usually caused by Windows's DWM. To work around this, switch between the game and another window (Alt+Tab) until gameplay is smooth.
Copy the game to the internal SSD and run it from there. If you need to save space, delete objset, osage_play_data, rob, skin_param, pv_param, ibl, light_param, particle, and pv_expression. If it still desyncs a little bit, increase the buffer size and periods in DivaSound. You can also try disabling Shader.
Please avoid skipping any steps. Everything is possible, as trivial as anything may seem.
- (common for FREEZES AT THE LOADING SCREEN, DON'T SKIP) Disable all COM ports (the game may mistake a COM device for the slider and crash) with Device Manager/setserial
- (common for CRASHES, DON'T SKIP) Change the default audio device (if possible, use your NVIDIA graphics card's audio output; otherwise, use your motherboard's). Some audio devices/drivers (especially Focusrite) crash the game, for unknown reasons
- (common, DON'T SKIP) Disable all other audio devices/interfaces
- If you have an AMD GPU and you're on Windows, make sure your AMD graphics driver is version 22.6.1 or earlier (22.7.1+ is not supported – DivaGL may or may not work as a workaround)
- If you do use DivaGL, make sure you have the original glut32.dll from the game (see "Verify your files")
- If you have an AMD GPU and you're on Linux, make sure to run the game with amdgpu-pro (using
proglorLD_PRELOAD="/opt/amdgpu-pro/lib64/libGL.so.1.2"or similar) - Update PD Loader
- Clean-reinstall PD Loader (delete the plugins folder before reinstalling)
- Verify your files
- Delete all mdata except the official M215, M220, M230, M240, M250, M260, M270, M271
- Close MSI Afterburner/RivaTuner (and/or similar programs) or set it to "Framebuffer" instead of "Viewport"
- Disconnect all controllers and virtual input devices
- Make sure you have a working default audio output device
- Uninstall the Focusrite/other audio interface drivers temporarily
- Disable all 3rd-party patches and plugins
- Disable DivaSound and/or DivaMovie and/or ShaderPatch (temporarily)
- Disable Novidia (unless you're running the game on AMD graphics)
- Remove any Unicode/Chinese characters from the path (especially when using 3rd-party plugins such as DivaImGui)
- Make sure you have enough free space on the system and game drives
- Make sure the root, "ram", and "plugins" folders are writable
- Move the game to another drive with/without a different file system if not on the system drive
- Delete ram/osage_play_data
- Reboot (on Windows 8/8.1/10/11, select "Restart" not "Shut down")
- Make sure it's running on the NVIDIA GPU (or AMD with Novidia force-enabled in its settings)
- If you have edited any .ini file with Notepad, restore the original file
- Undo any overclock you've applied
- Make sure you have enough available RAM and free disk space (on both the system and the game drives)
- Do a clean install of the graphics driver (for NVIDIA users, NVIDIA 446 is recommended)
- Do the above, but remove the old driver with https://www.wagnardsoft.com/ in safe mode
- Exclude the game folder from your antivirus (risky if you're using 3rd-party plugins/patches)
- Use a Windows restore point (if the game worked before)
- BitDefender AV seems to not like PD Loader, sometimes even if you add an exception
The game is running in the background. To kill it on Windows, press Win+R and enter:
taskkill /f /im diva.exe
On GNU/Linux, use Lutris to stop it. If you're not using Lutris, press Alt+F2 and try one of the following commands:
wine taskkill /f /im diva.exe
wine taskmgr # then kill diva.exe manually
wineserver -k # WARNING: this will close all Windows applications
or kill diva.exe with System Monitor.
- Make sure the default sound device is correct (especially after plugging in a DualShock 4)
- Enable the DivaSound plugin, or change its backend if it's already enabled
- If you're not using DivaSound, make sure "Stereo" is enabled in the Options tab (note that if this doesn't work, you will need to use DivaSound)
Disable Windows 10 HDR.
Modules can be mixed by enabling the DivaWig plugin and pressing the following keys in the game:
0: Update everything ("disable" DivaWig)
1: Hair
2: Head accessory
3: Face accessory
4: Face textures
5: Head
6: Chest accessory
7: Body
8: Back accessory
9: Nothing
For example, select a module, press 1, then select another module to use its hairstyle on the first one.
Note that DivaWig is currently unstable and disabled by default.