Before starting, please join the Mega Mix+ Modding Discord server. There you will be able to find useful information about creating mods, get help from experienced modders, gain access to useful tools, and keep up to date on which of your favorite tools and mods have been updated.

What You Need

samyuu's and nastys’ MM+ Debug (only needed for Osage Play Data generation)

Stewie1.0’s Missing Edit Motions (only needed for Osage Play Data generation)

Introduction

In short, osage_play_data are files that can be generated in-game that contain pre-rendered physics for the motions found in the Edit Mode. Edit Mode was a feature in previous Project DIVA games that allowed users to use pre-made motions, stages, and effects to create PV's. Mega Mix+ on it's own does not contain all of the edit motions, but Stewie1.0's Missing Edit Motions patch restores them. If osage_play_data is missing for a module, the game will, more likely than not, crash when that module is attempted to be used.

This guide was originally written as a part of lavverso's Module Creation Guide, and is an essential part to the module creation process. However, there are a lot of mods that currently do not have osage_play_data (or OPD) generated, and with the release of Stewie1.0's Missing Edit Motions patch, a lot of people may be curious on how to generate OPD on their own. Due to the amount of space OPD takes up, a lot of mods have opted to completely exclude OPD. This, as previously mentioned, causes crashes if any modules are used without the proper OPD. However, it's unfeasible for a lot of people (myself included) to download 20GB of OPD for the vanilla modules. This isn't shade, just a fact- my only access to internet is a hotspot with a data limit, and I'm sure others have similar issues to me.

This guide will have two sections; one for people who are generating OPD for specific modules, and one for people who are generating OPD for everything at once.

Generating OPD is a very time consuming process, especially if you're generating it for large amounts of modules at once and/or have a slow computer. So, before following this guide, please double check all of your mod's download pages and make sure that Missing Edit Motions OPD is either included or available as an alternate download. If you have poor internet and want to go ahead and generate things, feel free to follow this guide.

If you would like to read the full Module Creation Guide, please click here, or click here to read the guide on Google Docs with the original, per-module osage_play_data guide included.

Setting Up

To go more in-depth about what osage_play_data is (which I’ll just refer to as “OPD” for the remainder of this guide), OPD is pre-rendered physics for motions that were available to be used in Edit Mode, which is a function seen in the mainline series of games that lets users create their own PV’s and charts for songs. It is different from osage, which is a general term used for physics in the game (so “osage” for physics, and “osage_play_data ” for pre-rendered Edit Mode physics). There are several songs in MM+’s DLC that have their PV’s created in Edit Mode (better known as Edit PV’s), as these Edit PV’s were created as part of contests that were held when Project DIVA Arcade and Project DIVA Arcade Future Tone were still supported by SEGA. The community has also been working on porting Edit PV’s from the main games as well, and in turn have been restoring missing motions that were left out of the game. Without OPD, the game’s edit motions will not work for that module and in most cases cause the game to crash. Because of this, you need to generate OPD.

In order to generate OPD, you need nastys’ MM+ Debug, which can be found in Project DIVA Modding 2nd. You only need it enabled while generating OPD, and the mod can be disabled or deleted afterwards. While the module names in the UI will be based on the mod_str_array names of the modules for the language that you’re playing in, the UI will be in Japanese, so I will be including plenty of screenshots and circling and/or highlighting the buttons that you need to press.

You will also need is Stewie1.0’s Missing Edit Motions mod. This mod restores the missing edit motions from across the entire Project DIVA series into Mega Mix+ so that we can have fully rendered animations for any edits that are ported to the game. This will be especially helpful for players who are using your modules with mods such as Eden Project (yes, I know some of you hate it, but I’m trying to save you from having people crying in your DM’s that your mod causes Eden to crash because it misses OPD!) Before using the Missing Edit Motions patch, please read the mod’s description on GameBanana to ensure you fully know how the mod works. Remember that the “Missing Edit Motions” mod does not work for generating OPD, and that you must disable “Missing Edit Motions” and enable the “For creating osage_play_data” mod instead. Here’s an example of what that looks like in Diva Mod Manager!
Image Not Found - Click to retry loading

Image Not Found - Click to retry loading

After enabling the MM+ Debug mod, launch your game and get to the title screen. Press the ‘F5’ key, which will bring up the Debug menu (as seen below). Click on ‘DATA_TEST_OPD’.
Image Not Found - Click to retry loading

When you open the OPD debug menu, it should look something like this.
Image Not Found - Click to retry loading

Generating osage_play_data

Generating osage_play_data for All Modules

If you want to generate OPD for all modules, keep in mind that it will be a very time consuming process. So be prepared to alt-tab and work on other things, or do some things away from your PC. I recommend doing this on a vanilla mod loadout with no other mods enabled besides Debug and the For generating osage_play_data mods, that way you're only generating OPD for the vanilla modules. Then, you can follow the guide to generate them for specific modules to avoid wasting time on generating them for mods that already have the necessary OPD.

To generate OPD for all modules, just check the box next to the option that says "opdi" and click the large gray button underneath.
Image Not Found - Click to retry loading

While it's generating, it should look something like this. Notice that, with all of my mods, I have 1824 parts that are going to have OPD generated. You may have a different number, and that's completely normal! In a vanilla game with all DLC, your total should be around 1327. Just sit back and let it generate. Note that this may take upwards of an hour or more, and that's completely normal.
Image Not Found - Click to retry loading

Just sit patiently and let it do it's thing. Once it's done, your screen should look like this!
Image Not Found - Click to retry loading

Now, you should either read the below section on how to generate OPD for specific modules if you would like to learn how, or you should jump below to the installation section.

Generating osage_play_data for Specific Modules

As mentioned above, generating OPD for all modules is a very time consuming process. I recommend generating OPD for all of the vanilla modules if you haven't already, but if you downloaded a new mod that is missing Missing Edit Motions OPD, you may want to generate them for specific modules. If so, this is for you!

Click on the drop-down menu and click the second option.
Image Not Found - Click to retry loading

When clicked on, your menu should look something like this.
Image Not Found - Click to retry loading

To select your module, you need to open the second drop down list; for me, it says “Hatsune Miku” because I’m currently playing in English, but it may vary for you depending on what your language preferences are in Steam.
After clicking the drop down button, you will be presented with a list of modules listed by Module ID.
Image Not Found - Click to retry loading

Let’s say, for the purposes of this tutorial, you want to generate OPD play data for the DE:MONSTAR module for the XHD Module Pack (at the time of this guide being written, the mod didn’t have OPD). You want to scroll down the module list using the sidebar (just like you would any website) until you find the module you’re looking for.
Image Not Found - Click to retry loading

Click on the DE:MONSTAR module name. Next, click on the highlighted button next to the drop down menu.
Image Not Found - Click to retry loading

This will add the module to the list of modules you want to generate OPD for!
Image Not Found - Click to retry loading

If you want to generate OPD for another module- say, Lollipop from the XHD Module Pack, just open the dropdown menu and click on it. The nice thing about the debug menu is that it will stay on the last module you selected, so you don’t have to scroll all the way down and find your modules again if you used one range of module ID’s.
Image Not Found - Click to retry loading

Adding it to the list to generate is the same as before. Click the module name, and hit the button next to the drop down. This will add it to the list!
Image Not Found - Click to retry loading

You can do this for as many modules as you like. For this guide, we’ll just generate OPD for DE:MONSTAR and Lolipop.
Whenever you’re ready to generate, check the box next to the option that says “opdi” and click the bottom button to generate!
Image Not Found - Click to retry loading

While it’s generating, the window will go away and your screen will look something like this. Give it time, as it might take a while to generate the OPD , especially if there’s a lot of modules involved.
Image Not Found - Click to retry loading

When finished, your screen should look something like this!
Image Not Found - Click to retry loading

Now close Project DIVA Mega Mix+.

Installing Your osage_play_data

The next question is, where do I find the OPD that the game just generated? The generated osage can be found in the ram folder of your Project DIVA Mega Mix+ install directory.
For you, the directory may be C:\Program Files (x86)\Steam\steamapps\common\Hatsune Miku Project DIVA Mega Mix Plus. If you installed the game elsewhere, you should know where it is. If you don’t know where it is, follow these steps.

Open Steam and go to the Hatsune Miku Project DIVA Mega Mix+ page.
Click the gear icon and go to ‘Manage’, then ‘Browse local files’.
Huzzah! You’re in your Mega Mix+ directory.

Now that you’re in your install directory, do you see that ‘ram’ folder? That’s where your OPD was generated. Click on it!
Image Not Found - Click to retry loading

You will see an osage_play_data folder.
Image Not Found - Click to retry loading

If you click on it, you’ll see the pre-generated motions for each object in your modules!
Image Not Found - Click to retry loading

Go back to your ram folder, and you want to Cut your osage_play_data folder.
Image Not Found - Click to retry loading

Now go to your mods folder- in my case, the XHD Module Pack mod folder. If you don't have a mod, you can use a pre-existing one or use something like the Template Mod included with your DIVA Mod Loader download. Open the rom folder, and Paste the osage_play_data folder there. It should look something like this!
Image Not Found - Click to retry loading

Notice that the osage_play_data folder is in your rom folder.

Congratulations, you now have working OPD for your modules!
Image Not Found - Click to retry loading

Final Checklist

Did you make a back-up of your mod before adding osage_play_data to it?
Did you generate osage play data using Stewie1.0’s Restore Edit Motions patch?
Did you test your modules in some Edit Mode songs before finishing?

Extra Help

If you need any help, please join the Mega Mix+ Modding server and go to the #mod-creation-help channel there. Also make sure that you check out #resources-and-faq as well, as there are some useful tutorials that may help you alongside this. Alternatively, you can also join the Project DIVA Modding 2nd server and ask for assistance there. If you have any tips or suggestions on how to make this document better, please leave a comment on this page or DM the creator of this document on Discord via @lavverso.