blueskythlikesclouds / divamodloader

Mod loader for Hatsune Miku: Project DIVA Mega Mix+

DIVA Mod Loader

DIVA Mod Loader (DML) is a mod loader for Hatsune Miku: Project DIVA Mega Mix+. It allows you to make file replacement mods without hassle and provides extra features for convenience.

You can use DIVA Mod Manager (DMM) or d4m as a front-end for DML.

Installation

• Download the latest version from the Releases page.
• Extract everything to where DivaMegaMix.exe is located.
• dinput8.dll, config.toml and mods must be next to this executable file.
• Linux users (including Steam Deck) additionally need to do the following:
  1. Right click the game on Steam.
  2. Select Properties -> Launch Options.
  3. Enter WINEDLLOVERRIDES='dinput8.dll=n,b' %command% as the command.
• MacOS users (using Apple's Game Port Toolkit) additionaly need to do the following:
  1. Open winecfg (in Terminal write gameportingtoolkit ~/change-to-your-prefix-name winecfg)
  2. Select Libraries
  3. Open the dropdown menu -> select from the list dinput8.dll -> press Add
  4. Make sure it says dinput8(native, builtin). if not, press Edit and select Native and Builtin.

Features

Configuration File

config.toml located next to dinput8.dll allows you to configure the behavior of DML.

enabled = true
console = false
mods = "mods"

• enabled: Whether the mod loader is enabled.
• console: Whether a console window is going to be created.
• mods: The directory where mods are stored.

Mod Loading

Each mod contains a config.toml file located within the mod directory.

enabled = true
include = ["."]
dll = ["TemplateMod.dll"]

name = "Template Mod"
description = "This is a template mod!"
version = "1.0"
date = "27.05.2022"
author = "Skyth"

• enabled: Whether the mod is going to be loaded.
• include: A list of directories to scan when doing external file replacements. Most mods only need "." as the value. If your mod only contains a DLL file without replacing any files, you should remove this property.
• dll: A list of DLL files to load. You should remove this property if your mod doesn't utilize any DLL files, otherwise you are going to receive errors at startup.

Rest of the properties should be self-explanatory and are not used by DML. They are only used by DMM or d4m to display information about the mod if it wasn't downloaded from GameBanana. However, please make sure to use version/date values in the same format as the given example.

File Replacement

An example mod file structure is as follows:

• mods
  • Example Mod
    • config.toml
    • rom
      • objset
        • mikitm001.farc
      • lang2
        • mod_str_array.toml
    • rom_steam_en
      • rom
        • 2d
          • spr_gam_cmn.farc

As you can see, the files are organized in a way that is similar to the CPKs. However, most of the time, you only need to use the main rom directory. Rest of the rom directories are used to replace files for specific languages.

Mod Database Loading

DML can load mod databases which contain entries only relevant to the mod. This makes it possible for multiple mods to co-exist without conflicts. For example, when adding a new song, you can add its PV entry to mod_pv_db.txt file without having to include entries from the base game or other mods.

This works with all database types, mod_obj_db.bin, mod_tex_db.bin, mod_aet_db.bin, etc. However, please note that ID conflicts are still an issue when using this method. Automatic ID conflict fixing is planned to be implemented in the future.

Mod String Array Loading

Mods cannot replace str_array.bin files without overriding each other. As a solution, DML can load mod_str_array.toml files located in the lang2 directory with entries only relevant to the mod.

An example string array file from the Mikudayo/Mikunano mod is as follows:

1273 = "Mikudayo"
cn.1273 = "MIKUDAYO"
kr.1273 = "미쿠다요"
tw.1273 = "MIKUDAYO"
1274 = "Mikunano"
cn.1274 = "MIKUNANO"
kr.1274 = "미쿠나노"
tw.1274 = "MIKUNANO"

An id = "value" pair declares a string for all languages. If you want to declare a string for a specific language, you need to prefix the id with the language code. For example, cn.1273 = "MIKUDAYO" declares the string for Chinese. Language specific strings take precedence over the global ones.

Please make sure all strings are wrapped in quotes.

Grouped String Arrays

When following the original string array file layout, a few limitations arise. For instance, since modules have their specific range starting from 275, adding too many module names outside the range could override customize item names. To solve this issue, DML provides a feature where you can specify strings in separate named arrays by their original ID, without worrying about accidentally overriding other strings.

To demonstrate this format, the previous string array example can be redone as follows:

module.998 = "Mikudayo"
cn.module.998 = "MIKUDAYO"
kr.module.998 = "미쿠다요"
tw.module.998 = "MIKUDAYO"
module.999 = "Mikunano"
cn.module.999 = "MIKUNANO"
kr.module.999 = "미쿠나노"
tw.module.999 = "MIKUNANO"

In this example, 998/999 numbers correspond to the module IDs, instead of the 1273/1274 in the previous example where the required offset number 275 was added to them. Modders are advised to exclusively use this format.

All of the following string types are supported, and the same ID rule applies to all of them:

• module
• customize
• cstm_item
• btn_se
• slide_se
• chainslide_se
• slidertouch_se

Please note that both formats can be used at the same time in the same file.

DLL Loading

DML allows you to inject your own code into the game by loading DLL files. Certain functions can be exposed in the DLLs for initialization and per frame updates.

extern "C"
{
    void __declspec(dllexport) PreInit() {}

    void __declspec(dllexport) Init() {}

    void __declspec(dllexport) PostInit() {}

    void __declspec(dllexport) D3DInit(IDXGISwapChain* swapChain, ID3D11Device* device, ID3D11DeviceContext* deviceContext) {}

    void __declspec(dllexport) OnFrame(IDXGISwapChain* swapChain) {}	

    void __declspec(dllexport) OnResize(IDXGISwapChain* swapChain) {}
}

• PreInit is called before any of the game's global variables are initialized. You only need to use this if you want to hook into C++ static initializers.
• Init is called after the game's global variables are initialized. This is likely going to be the function where you initialize your mod and inject code. You cannot hook into C++ static initializers from this function as they have been called already.
• PostInit is called after every DLL mod is initialized. This is a pretty niche use case and you probably won't need it.
• D3DInit is called in D3D11CreateDeviceAndSwapChain after the device gets initialized. You could use this (along with OnFrame) to hook ImGui into the game.
• OnFrame is called before the game's frame is presented to the screen. You can use this to execute logic per frame.
• OnResize is called after the game's buffers are resized.

You can omit functions that you don't need to use. They are not required to be declared.

You can use different naming conventions for your functions, eg. PreInit, preInit and pre_init.

The current directory is changed to where the DLL is located before any of the Init functions are called. This is useful if you want to use relative paths.

Please refrain from executing any logic in DllMain, use these exported functions instead. DllMain has too many limitations and issues to be considered reliable.

divamodloader's Issues

str_array causes random crashes on boot

Issue is already known, just putting it on the issue tracker for reference.

Found a error when you type ' on the gamebanana search bar.

Only closing and reopening fixes the bug, the retry button doesn't do anything :[

File in tutorial doesn't exist

The dinput.dll doesn't exist. Also the tutorial is extremely hard to understand, I have no clue how to install it.

Failed to load, Specified module not found

Sorry if this isn't the right place to ask, but I figured I'd ask and be redirected if needed. These are from Eden Project, if that's a contributing factor.
Currently it won't load:

• LyricsPatch.dll
• SaveDataMigrator.dll
• OldMan.dll

I'm unsure if I need a specific plugin or not. I downloaded the one provided in the previous SongLimitPatch.dll issue, however it didn't fix these. I accidentally deleted a few plugins a bit ago, so I'm assuming that might be the issue. I don't know the specific ones I need to redownload though.

[Request] Output console to log file

Having the console output to the log file would help out with debugging some mods that might not work for some people, and said mods output their sig scan address(es) to the console. (ex. Restore Cut Songs, High Refresh Rate)

Failed to load SonglimitPatch.dll

Please anything can help to solve this..I can't have song mod without it..thanks

input lag after the update

i updated the diva mod loader and after i open the game and there is input lag on any song (official and custom) i don't know how to resolve this, i tried the offset reset and other staff that the game offer but noting work, wnyone know how to resolve?

Game not launching after 1.03 update with mods on Steam Deck

On Steam Deck, After 1.03 update, game refuses to launch before removing WINEDLLOVERRIDES='dinput8.dll=n,b' %command% in launch options, Any tips?

mod_pv_db.txt doesn't work on rom_steam_xx/rom

I need use rom_steam_xx to supports game read different mod_pv_db on different language
but when i change my pv_db file name to mod_pv_db then game doesn't read mod_pv_db file
and when i change pv_db file name to mdata_pv_db, end_pv_db, patch_pv_db and patch2_pv_db, every thing work fine so i don't think it's because i put pv_db file in wrong folder
e.g
rom_steam_tw/rom/mod_pv_db.txt → doesn't work
rom_steam_tw/rom/patch2_pv_db.txt → work
(sorry i'm not good at english, maybe I didn't explain clearly)

Json error

Mod updating is failing after a json error

I checked the targeted line but nothing seems wrong:

An idea of what might cause the error?

CPK support

would be cool if we could drag and drop a CPK into the mod folder