DIVA Mod Manager on the Steam Deck

Guide to mod Project DIVA Mega Mix+ using the Diva Mod Manager on SteamOS.

Introduction

This guide will walk you through setting up DIVA Mod Manager[gamebanana.com] as a non-Steam Game to download, update, and manage your mods. I will not be covering how to manually install DIVA Mod Loader[github.com] since that is covered in this other fantastic Steam Guide. (DIVA Mod Manager will setup DIVA Mod Loader for you anyways.)

This guide does not involve or showcase the Linux installation script for DivaModManager[github.com], it covers a different method very similar to setting up Unverum[github.com] on SteamOS.

Also just as heads up, most custom Song Packs require or at least encourage the use of Song Limit Patch. Upon first use, it will create brand new save data and wipe your old. You can't use your old save with mods but make a backup if you don't wanna lose it forever.

Protontricks setup

You will need Protontricks, if you already have that installed you can skip this entire section after reading this.

Open up Discover and search for Protontricks then install it.


After that, search for Flatseal then install and open it.


Click on Protontricks on the left, scroll down to Filesystem then click All user files and give permission to /run/media under Other files.

|
|
What is Flatseal and what exactly am I giving access to?
Flatseal allows you to review and modify permissions from your Flatpak applications, we are giving Protontricks access to any external drive (like a MicroSD card) you may have in case the game is installed there.

DIVA Mod Manager Setup

Download DIVA Mod Manager from GameBanana[gamebanana.com] or Github[github.com]


Extract the folder x64 and DivaModManager.exe to wherever, shouldn't matter where.
(For reference, I placed mine at /home/deck/Documents/Diva Mod Manager)


Right Click DivaModManager.exe, then click Add to Steam.


Open up Steam and find DivaModManager.exe in your Steam Library. Click on the Gear Icon and then Properties.


In Properties, click on Compatibility, check the box, and set it to Proton 9.0-2 (or your preferred Proton).


(You can also rename it from here)

DIVA Mod Manager Prerequisites

Now click Play and you should get an error telling you to install .NET Desktop Runtime[dotnet.microsoft.com]. Click Yes and it should open a download page.
(close Diva Mod Manager if it doesn't close itself after clicking Yes.)



Navigate to the file you just downloaded, Right Click on it then click Open with Protontricks Launcher


Scroll down to DIVA Mod Manager, click on it then click OK.


After a couple seconds, this window should pop up. Click Install.


Close the window once it's finished.

Game Setup

Navigate to DIVA Mod Manager in your Steam Library and click Play. Once it opens click on Setup towards the top and point it to DivaMegaMix.exe


After setup is completed, DIVA Mod Manager should have installed DIVA Mod Loader for you. You should be able to download mods without issue.


You'll know if everything went right if your games folder looks something like this
(You can also test by trying to download a mod)


Finally, in order for mods to actually show up in-game, navigate to Hatsune Miku: Project DIVA Mega Mix+ in your Steam Library. Click on the Gear Icon towards the right, then Click Properties.


In the Launch Settings, copy and paste
WINEDLLOVERRIDES='dinput8.dll=n,b' %command%


Boom done (hopefully)

Potential Issues

A Song Pack/Mod is too big to download through the Mod Manager!

Some Mods in this game are huge and require you to download them off Google Drive or some other site. Once you've downloaded your mod, open the zip/rar/etc file, then place the folder containing the mod in your Mods folder.

Library file path not set

This happened to me when I forgot to extract the x64 folder alongside DivaModManager.exe.

My game launches without working controls!

You are probably launching through the Executable and not Steam. Open up DMM, towards the top right make sure Steam is selected.

DMM can't see hidden Linux folders so I can't navigate to DivaMegaMix.exe during Setup!

Open Protontricks
Find & click DIVA Mod Manager in the list, then click OK
(It should be a Non-Steam Shortcut)


A Winetricks window will eventually pop up, click Select the default wineprefix, then OK


In the next window click Run winecfg, then OK


In the Wine configuration window, click the Drives tab, then check Show dot files

Click Apply then OK, and close any other Winetricks windows.

My game launches without mods!

You can launch the game itself and play with mods just fine but anytime you download new mods or change around mod order, you need to launch the game through DIVA Mod Manager for those changes to take effect.
(also double check your Steam Launch Settings are correct)

My game crashes on launch or during ____!

There are so many reasons this could be happening, but for starters

• A lot of Mods in this game aren't compatible with each other, especially the Eden Project[gamebanana.com].
  
• If you are using multiple song packs, disable all but 1 and see if the game boots.
  
• Disable mods in a batch to see whats causing the problem.

[AlexTheGamer]

No matter what Proton version I use, Diva Mod Manager won't launch from steam, and will only launch if opened manually via protontricks in desktop mode. Otherwise, it'll refuse to launch

[V]

I can't seem to get this to work. No matter what, I cannot find the DivaMegaMix.exe to open on DMM :( I've followed the "DMM can't see hidden Linux folders" instructions but no luck, I even have the pathway to the .exe but I just cannot find it on the files browser they require

[palapapa]

If DMM complains that it can't find the .NET Desktop Runtime even though you have installed it, check if you have DOTNET_ROOT set on your Linux machine (it will probably be set if you have also installed .NET on your Linux machine). Wine inherits that environment variable so that DMM won't be able to find the correct .NET installation. You can set it to, for example, DOTNET_ROOT="C:\Program Files\dotnet".

Another weird issue that you might come across is that Wine might give the following error:

012c:err:module:find_forwarded_export module not found for forward 'icuuc68.u_charsToUChars_68' used by L"C:\\windows\\system32\\icu.dll"

In that case, run winecfg and inside the Libraries tab, add an override for "icu", then click "Edit" and select "Disabled".

[KingSideCastle13]

It's the darndest thing. I followed these instructions, but now Project closes instantly when I try to run it

[Dzvzls]

ohh tysm

[Captain Diagram]

When you Right Click DivaModManager.exe , Add to Steam should be there but if not, you can do it manually. Open up Steam, click Add a Game in the bottom left, then click Add a Non-Steam Game . In the menu that pops up, click Browse... in the bottom left, then navigate to DivaModManager.exe .


You can add any game or application to Steam this way, which is useful for easily switching Proton versions, customizing controls, or using SteamTinkerLaunch. Good thing to learn for every Steam Deck Owner.

[Dzvzls]

i cant find the add to steam thing

[billloic6]

This is for the manager.
For the MODs, just put place them at game folder, and game will automatically load them.

[iathnaht]

ah, yessss, thank you!!

[Captain Diagram]

Once you add DivaModManager.exe to Steam, you can change the controls in the Controller Settings, which is the icon right besides the Gear Icon in Steam. You can set the Joysticks or Trackpads to be a mouse which should fix the problem.