Releases: vitor251093/KHMelonMix
0.5.0
Changes
- Fixing macOS builds (experimental)
- Configs should be preserved in the folder path has special characters
- Windows build is a static build again
- Initial Re:Coded support
Installing
If this is your first time using the Melon Mix, follow the How To Play guide. If you want to keep your save files from older Melon Mix versions, follow the Migrating guide.
Migrating
On Windows, replace MelonMix.exe with the newest one, along with all the DLLs provided in this release (if any).
On Steam Deck, replace MelonMix.AppImage with the newest one, provided in this release.
Migrating from versions below 0.4.1
For additional required steps, check the 0.4.1 migration guide.
How To Play
- Download the zip file made for your system (not the source code zip);
- Extract the zip file inside a new folder (all the next steps will take place inside this folder);
- Create a folder named "roms";
- (Days) Dump an original copy of "Kingdom Hearts 358/2 Days" into a NDS file, rename that NDS file to "days.nds", and place it inside "roms";
- (Re:coded) Dump an original copy of "Kingdom Hearts Re:Coded" into a NDS file, rename that NDS file to "recoded.nds", and place it inside "roms";
- Replace the assets folder with this assets folder (this step is only required if you want to replace the DS cutscenes with HD cutscenes);
- (Windows) Launch "MelonMix_KHDays.bat" to play Days, and launch "MelonMix_KHReCoded.bat" to play Re:Coded;
- (Linux) Right click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox;
- (Linux) Repeat step 8 with MelonMix_KHDays.sh and MelonMix_KHReCoded.sh;
- (Linux) Launch "MelonMix_KHDays.sh" to play Days, and launch "MelonMix_KHReCoded.sh" to play Re:Coded.
Note: The Linux steps are also applicable on the Steam Deck.
How to dump DS cart into an NDS file
There are multiple ways to do so. Those are some of them:
Using a DSi: https://dsi.cfw.guide/dumping-game-cards.html
Using a 3DS: https://3ds.hacks.guide/dumping-titles-and-game-cartridges.html
Recommended controller binds
- (DS Keypad tab) Map the DS D-Pad to your controller's left analog stick
- (DS Keypad tab) Map the Select/Start buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the A/B/X/Y buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the L button to the L1/LB button in your controller
- (Touch Screen tab) Map the DS Touch Screen to your controller's right analog stick
- (Add-ons tab) Map the command menu to your controller's D-Pad
- (Add-ons tab) Map the L2 button to the L2/LT button in your controller
- (Add-ons tab) Map R1 and R2 to the R1/RB and R2/RL buttons in your controller
- (Add-ons tab) Map the HUD Toggle to an available button of your preference
- (General hotkeys) Map Toggle fullscreen to an available button of your preference
0.4.5
Changes
- Fixing HD cutscene related bugs
- Emulator pause functionality should be able to pause HD cutscenes as well
- Non HD cutscenes should show top/bottom screen accordingly
Installing
If this is your first time using the Melon Mix, follow the How To Play guide. If you want to keep your save files from older Melon Mix versions, follow the Migrating guide.
Migrating
On Windows, replace MelonMix.exe with the newest one, along with all the DLLs provided in this release.
On Steam Deck, replace MelonMix.AppImage with the newest one, provided in this release.
Migrating from versions below 0.4.1
For additional required steps, check the 0.4.1 migration guide.
How To Play
- Download the zip file made for your system (not the source code zip);
- Extract the zip file inside a new folder (all the next steps will take place inside this folder);
- Create a folder named "roms";
- (Days) Dump an original copy of "Kingdom Hearts 358/2 Days" into a NDS file, rename that NDS file to "days.nds", and place it inside "roms";
- (Re:coded) Dump an original copy of "Kingdom Hearts Re:Coded" into a NDS file, rename that NDS file to "recoded.nds", and place it inside "roms";
- Replace the assets folder with this assets folder (this step is only required if you want to replace the DS cutscenes with HD cutscenes);
- (Windows) Launch "MelonMix_KHDays.bat" to play Days, and launch "MelonMix_KHReCoded.bat" to play Re:Coded;
- (Linux) Right click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox;
- (Linux) Repeat step 8 with MelonMix_KHDays.sh and MelonMix_KHReCoded.sh;
- (Linux) Launch "MelonMix_KHDays.sh" to play Days, and launch "MelonMix_KHReCoded.sh" to play Re:Coded.
Note: The Linux steps are also applicable on the Steam Deck.
How to dump DS cart into an NDS file
There are multiple ways to do so. Those are some of them:
Using a DSi: https://dsi.cfw.guide/dumping-game-cards.html
Using a 3DS: https://3ds.hacks.guide/dumping-titles-and-game-cartridges.html
Recommended controller binds
- (DS Keypad tab) Map the DS D-Pad to your controller's left analog stick
- (DS Keypad tab) Map the Select/Start buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the A/B/X/Y buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the L button to the L/L1/LB button in your controller
- (Touch Screen tab) Map the DS Touch Screen to your controller's right analog stick
- (Add-ons tab) Map the command menu to your controller's D-Pad
- (Add-ons tab) Map R1 and R2 rather than the R button from the DS keypad tab
- (Add-ons tab) Map the HUD Toggle to an available button of your preference
- (General hotkeys) Map Toggle fullscreen to an available button of your preference
0.4.4
Changes
- Fixing menus focus and background color
- 16:9 aspect ratio should be the default
- Improving floating dialog box size
Installing
If this is your first time using the Melon Mix, follow the How To Play guide. If you want to keep your save files from older Melon Mix versions, follow the Migrating guide.
Migrating
On Windows, replace MelonMix.exe with the newest one, along with all the DLLs provided in this release.
On Steam Deck, replace MelonMix.AppImage with the newest one, provided in this release.
Migrating from versions below 0.4.1
For additional required steps, check the 0.4.1 migration guide.
How To Play
- Download the zip file made for your system (not the source code zip);
- Extract the zip file inside a new folder (all the next steps will take place inside this folder);
- Create a folder named "roms";
- (Days) Dump an original copy of "Kingdom Hearts 358/2 Days" into a NDS file, rename that NDS file to "days.nds", and place it inside "roms";
- (Re:coded) Dump an original copy of "Kingdom Hearts Re:Coded" into a NDS file, rename that NDS file to "recoded.nds", and place it inside "roms";
- Replace the assets folder with this assets folder (this step is only required if you want to replace the DS cutscenes with HD cutscenes);
- (Windows) Launch "MelonMix_KHDays.bat" to play Days, and launch "MelonMix_KHReCoded.bat" to play Re:Coded;
- (Linux) Right click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox;
- (Linux) Repeat step 8 with MelonMix_KHDays.sh and MelonMix_KHReCoded.sh;
- (Linux) Launch "MelonMix_KHDays.sh" to play Days, and launch "MelonMix_KHReCoded.sh" to play Re:Coded.
Note: The Linux steps are also applicable on the Steam Deck.
How to dump DS cart into an NDS file
There are multiple ways to do so. Those are some of them:
Using a DSi: https://dsi.cfw.guide/dumping-game-cards.html
Using a 3DS: https://3ds.hacks.guide/dumping-titles-and-game-cartridges.html
Recommended controller binds
- (DS Keypad tab) Map the DS D-Pad to your controller's left analog stick
- (DS Keypad tab) Map the Select/Start buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the A/B/X/Y buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the L button to the L/L1/LB button in your controller
- (Touch Screen tab) Map the DS Touch Screen to your controller's right analog stick
- (Add-ons tab) Map the command menu to your controller's D-Pad
- (Add-ons tab) Map R1 and R2 rather than the R button from the DS keypad tab
- (Add-ons tab) Map the HUD Toggle to an available button of your preference
- (General hotkeys) Map Toggle fullscreen to an available button of your preference
0.4.3
Changes
- Fixing game scene detection for EU and JP ROMs
- JP Rev1 ROMs are now supported
Installing
If this is your first time using the Melon Mix, follow the How To Play guide. If you want to keep your save files from older Melon Mix versions, follow the Migrating guide.
Migrating
On Windows, replace MelonMix.exe with the newest one, along with all the DLLs provided in this release.
On Steam Deck, replace MelonMix.AppImage with the newest one, provided in this release.
Migrating from versions below 0.4.1
For additional required steps, check the 0.4.1 migration guide.
How To Play
- Download the zip file made for your system (not the source code zip);
- Extract the zip file inside a new folder (all the next steps will take place inside this folder);
- Create a folder named "roms";
- (Days) Dump an original copy of "Kingdom Hearts 358/2 Days" into a NDS file, rename that NDS file to "days.nds", and place it inside "roms";
- (Re:coded) Dump an original copy of "Kingdom Hearts Re:Coded" into a NDS file, rename that NDS file to "recoded.nds", and place it inside "roms";
- Replace the assets folder with this assets folder (this step is only required if you want to replace the DS cutscenes with HD cutscenes);
- (Windows) Launch "MelonMix_KHDays.bat" to play Days, and launch "MelonMix_KHReCoded.bat" to play Re:Coded;
- (Linux) Right click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox;
- (Linux) Repeat step 8 with MelonMix_KHDays.sh and MelonMix_KHReCoded.sh;
- (Linux) Launch "MelonMix_KHDays.sh" to play Days, and launch "MelonMix_KHReCoded.sh" to play Re:Coded.
Note: The Linux steps are also applicable on the Steam Deck.
How to dump DS cart into an NDS file
There are multiple ways to do so. Those are some of them:
Using a DSi: https://dsi.cfw.guide/dumping-game-cards.html
Using a 3DS: https://3ds.hacks.guide/dumping-titles-and-game-cartridges.html
Recommended controller binds
- (DS Keypad tab) Map the DS D-Pad to your controller's left analog stick
- (DS Keypad tab) Map the Select/Start buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the A/B/X/Y buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the L button to the L/L1/LB button in your controller
- (Touch Screen tab) Map the DS Touch Screen to your controller's right analog stick
- (Add-ons tab) Map the command menu to your controller's D-Pad
- (Add-ons tab) Map R1 and R2 rather than the R button from the DS keypad tab
- (Add-ons tab) Map the HUD Toggle to an available button of your preference
- (General hotkeys) Map Toggle fullscreen to an available button of your preference
0.4.2
Changes
- Fixes regarding game scene detection
- Fixing heart counter proportion
- Fixes regarding the cutscenes
- Fast forward should be automatically used during loading screens
Installing
If this is your first time using the Melon Mix, follow the How To Play guide. If you want to keep your save files from older Melon Mix versions, follow the Migrating guide.
Migrating
On Windows, replace MelonMix.exe with the newest one, along with all the DLLs provided in this release.
On Steam Deck, replace MelonMix.AppImage with the newest one, provided in this release.
Migrating from versions below 0.4.1
For additional required steps, check the 0.4.1 migration guide.
How To Play
- Download the zip file made for your system (not the source code zip);
- Extract the zip file inside a new folder (all the next steps will take place inside this folder);
- Create a folder named "roms";
- (Days) Dump an original copy of "Kingdom Hearts 358/2 Days" into a NDS file, rename that NDS file to "days.nds", and place it inside "roms";
- (Re:coded) Dump an original copy of "Kingdom Hearts Re:Coded" into a NDS file, rename that NDS file to "recoded.nds", and place it inside "roms";
- Replace the assets folder with this assets folder (this step is only required if you want to replace the DS cutscenes with HD cutscenes);
- (Windows) Launch "MelonMix_KHDays.bat" to play Days, and launch "MelonMix_KHReCoded.bat" to play Re:Coded;
- (Linux) Right click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox;
- (Linux) Repeat step 8 with MelonMix_KHDays.sh and MelonMix_KHReCoded.sh;
- (Linux) Launch "MelonMix_KHDays.sh" to play Days, and launch "MelonMix_KHReCoded.sh" to play Re:Coded.
Note: The Linux steps are also applicable on the Steam Deck.
How to dump DS cart into an NDS file
There are multiple ways to do so. Those are some of them:
Using a DSi: https://dsi.cfw.guide/dumping-game-cards.html
Using a 3DS: https://3ds.hacks.guide/dumping-titles-and-game-cartridges.html
Recommended controller binds
- (DS Keypad tab) Map the DS D-Pad to your controller's left analog stick
- (DS Keypad tab) Map the Select/Start buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the A/B/X/Y buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the L button to the L/L1/LB button in your controller
- (Touch Screen tab) Map the DS Touch Screen to your controller's right analog stick
- (Add-ons tab) Map the command menu to your controller's D-Pad
- (Add-ons tab) Map R1 and R2 rather than the R button from the DS keypad tab
- (Add-ons tab) Map the HUD Toggle to an available button of your preference
- (General hotkeys) Map Toggle fullscreen to an available button of your preference
0.4.1
Changes
- Cutscenes replacement should be more stable
- Re:Coded now can be launched again
Installing
If you want to keep your save files from older versions, follow the Migrating guide. Otherwise, follow the How To Play guide.
Migrating
On Windows, replace khDaysMM.exe with MelonMix.exe, along with all the DLLs provided in this release.
On Steam Deck, replace khDaysMM-x86_64.AppImage with MelonMix.AppImage, provided in this release.
On both, download this assets folder, and place it next to the Melon Mix executable. This step is only required if you want to replace the DS cutscenes with HD cutscenes.
Migrating from versions below 0.4.0
For additional required steps, check the 0.4.0 migration guide.
How To Play
- Download the zip file made for your system (not the source code zip);
- Extract the zip file inside a new folder (all the next steps will take place inside this folder);
- Create a folder named "roms";
- (Days) Dump an original copy of "Kingdom Hearts 358/2 Days" into a NDS file, rename that NDS file to "days.nds", and place it inside "roms";
- (Re:coded) Dump an original copy of "Kingdom Hearts Re:Coded" into a NDS file, rename that NDS file to "recoded.nds", and place it inside "roms";
- Replace the assets folder with this assets folder (this step is only required if you want to replace the DS cutscenes with HD cutscenes);
- (Windows) Launch "MelonMix_KHDays.bat" to play Days, and launch "MelonMix_KHReCoded.bat" to play Re:Coded;
- (Linux) Right click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox;
- (Linux) Repeat step 8 with MelonMix_KHDays.sh and MelonMix_KHReCoded.sh;
- (Linux) Launch "MelonMix_KHDays.sh" to play Days, and launch "MelonMix_KHReCoded.sh" to play Re:Coded.
Note: The Linux steps are also applicable on the Steam Deck.
How to dump DS cart into an NDS file
There are multiple ways to do so. Those are some of them:
Using a DSi: https://dsi.cfw.guide/dumping-game-cards.html
Using a 3DS: https://3ds.hacks.guide/dumping-titles-and-game-cartridges.html
Recommended controller binds
- (DS Keypad tab) Map the DS D-Pad to your controller's left analog stick
- (DS Keypad tab) Map the Select/Start buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the A/B/X/Y buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the L button to the L/L1/LB button in your controller
- (Touch Screen tab) Map the DS Touch Screen to your controller's right analog stick
- (Add-ons tab) Map the command menu to your controller's D-Pad
- (Add-ons tab) Map R1 and R2 rather than the R button from the DS keypad tab
- (Add-ons tab) Map the HUD Toggle to an available button of your preference
- (General hotkeys) Map Toggle fullscreen to an available button of your preference
0.4.0
Changes
- Information header is now visible in pause menu
- Information header now has a better appearance
- Better Lock On controls
- Cutscenes can now be replaced by HD counterparts
Installing
If you want to keep your save files from older versions, follow the Migrating guide. Otherwise, follow the How To Play guide.
Migrating
On Windows, replace khDaysMM.exe with MelonMix.exe, along with all the DLLs provided in this release.
On Steam Deck, replace khDaysMM-x86_64.AppImage with MelonMix.AppImage, provided in this release.
On both, download this assets folder, and place it next to the Melon Mix executable. This step is only required if you want to replace the DS cutscenes with HD cutscenes.
Migrating from versions below 0.3.2
For additional required steps, check the 0.3.2 migration guide.
Migrating from Actions builds between 0.3.2 and 0.4.0
Move the cutscenes from assets/days/cutscenes to assets/days/cutscenes/cinematics.
How To Play
Note: Re:coded seems to crash on this release
- Download the zip file made for your system (not the source code zip);
- Extract the zip file inside a new folder (all the next steps will take place inside this folder);
- Create a folder named "roms";
- (Days) Dump an original copy of "Kingdom Hearts 358/2 Days" into a NDS file, rename that NDS file to "days.nds", and place it inside "roms";
- (Re:coded) Dump an original copy of "Kingdom Hearts Re:Coded" into a NDS file, rename that NDS file to "recoded.nds", and place it inside "roms";
- Replace the assets folder with this assets folder (this step is only required if you want to replace the DS cutscenes with HD cutscenes);
- (Windows) Launch "MelonMix_KHDays.bat" to play Days, and launch "MelonMix_KHReCoded.bat" to play Re:Coded;
- (Linux) Right click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox;
- (Linux) Repeat step 8 with MelonMix_KHDays.sh and MelonMix_KHReCoded.sh;
- (Linux) Launch "MelonMix_KHDays.sh" to play Days, and launch "MelonMix_KHReCoded.sh" to play Re:Coded.
How to dump DS cart into an NDS file
There are multiple ways to do so. Those are some of them:
Using a DSi: https://dsi.cfw.guide/dumping-game-cards.html
Using a 3DS: https://3ds.hacks.guide/dumping-titles-and-game-cartridges.html
Recommended controller binds
- (DS Keypad tab) Map the DS D-Pad to your controller's left analog stick
- (DS Keypad tab) Map the Select/Start buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the A/B/X/Y buttons to the equivalent keys in your controller
- (DS Keypad tab) Map the L button to the L/L1/LB button in your controller
- (Touch Screen tab) Map the DS Touch Screen to your controller's right analog stick
- (Add-ons tab) Map the command menu to your controller's D-Pad
- (Add-ons tab) Map R1 and R2 rather than the R button from the DS keypad tab
- (Add-ons tab) Map the HUD Toggle to an available button of your preference
- (General hotkeys) Map Toggle fullscreen to an available button of your preference
0.3.2 (stable)
Changes
- Mission gauge should appear in pause menu again
- Results scene shouldn't show only the top screen
- Hearts counter display resize shouldn't cause visual glitches
- Hearts counter should be properly resized when showing 4-digit numbers
- ROMs other than Days and Recoded should be loadable
Migrating
Replace khDaysMM.exe (khDaysMM-x86_64.AppImage on SteamDeck) with the new one, provided in this release.
Migrating from 0.2.1
After the first startup, you will see the DS bottom screen alongside the customized single view. Press Config -> Screen sizing -> Top only to fix that.
How to play Kingdom Hearts 358/2 Days only
First, download the zip file made for your system (not the source code zip). Then, you will need an original copy of "Kingdom Hearts 358/2 Days" in order to dump it into a NDS file. Rename that NDS file to "game.nds", place it inside a folder named "rom", and then place that folder next to the downloaded Melon Mix executable (which was inside the zip file that you downloaded). Now you just need to launch the Melon Mix executable.
Steam Deck
The AppImage build is compatible with the Steam Deck. In order to use it, download the AppImage build, extract the zip, right click the AppImage and go to "Properties". Then go to the "Permissions" tab and check the "Allow executing file as program" checkbox. Don't forget the NDS file, like mentioned above.
How to play Kingdom Hearts 358/2 Days and Kingdom Hearts Re:Coded (WIP)
First, download the zip file made for your system (not the source code zip). Create a folder named "roms", and then place it next to the downloaded Melon Mix executable (which was inside the zip file that you downloaded).
You will need an original copy of "Kingdom Hearts 358/2 Days" in order to dump it into a NDS file. Rename that NDS file to "days.nds", and place it inside "roms". You will also need an original copy of "Kingdom Hearts Re:Coded" in order to dump it into another NDS file. Rename that NDS file to "recoded.nds", and also place it inside "roms".
Now you just need to launch "MelonMix_KHDays.bat" (or MelonMix_KHDays.sh if you are not on Windows) to play Days, and launch "MelonMix_KHReCoded.bat" (or MelonMix_KHReCoded.sh if you are not on Windows) to play Re:Coded.
Steam Deck
The AppImage build is compatible with the Steam Deck. In order to use it, download the AppImage build, extract the zip, right click the AppImage and go to "Properties". Then go to the "Permissions" tab and check the "Allow executing file as program" checkbox. Do the same with MelonMix_KHDays.sh and MelonMix_KHReCoded.sh. Don't forget the NDS file, like mentioned above.
0.3.1
Changes
- Mission Mode "holo-memory" shouldn't overlay a black screen during dialogue
- Custom cheats are now properly supported
- Dialog box should look proper during choices
- Heart points shouldn't be visible in pause menu
- Adding third HUD toggle state (no map, no target and no gauge)
Migrating
Replace khDaysMM.exe (khDaysMM-x86_64.AppImage on SteamDeck) with the new one, provided in this release.
Migrating from 0.2.1
After the first startup, you will see the DS bottom screen alongside the customized single view. Press Config -> Screen sizing -> Top only to fix that.
How to play
First, download the zip file made for your system (not the source code zip). Then, you will need an original copy of "Kingdom Hearts 358/2 Days" in order to dump it into a NDS file. Rename that NDS file to "game.nds", place it inside a folder named "rom", and then place that folder next to the downloaded Melon Mix executable (which was inside the zip file that you downloaded). Now you just need to launch the Melon Mix executable.
Steam Deck
The AppImage build is compatible with the Steam Deck. In order to use it, download the AppImage build, extract the zip, right click the AppImage and go to "Properties". Then go to the "Permissions" tab and check the "Allow executing file as program" checkbox. Don't forget the NDS file, like mentioned above.
0.3.0
Changes
- macOS builds are temporarily suspended due to build failures
- Double 3D scenes now are properly supported
- Dialog boxes should be properly adapted
- D-pad should control the menus while not ingame
- D-pad shouldn't do anything ingame if the used command menu input is unavailable
- Heart points should be properly positioned on the HUD
Migrating from 0.2.1
After the first startup, you will see the DS bottom screen alongside the customized single view. Press Config -> Screen sizing -> Top only to fix that.
How to play
First, download the zip file made for your system (not the source code zip). Then, you will need an original copy of "Kingdom Hearts 358/2 Days" in order to dump it into a NDS file. Rename that NDS file to "game.nds", place it inside a folder named "rom", and then place that folder next to the downloaded Melon Mix executable (which was inside the zip file that you downloaded). Now you just need to launch the Melon Mix executable.
Steam Deck
The AppImage build is compatible with the Steam Deck. In order to use it, download the AppImage build, extract the zip, right click the AppImage and go to "Properties". Then go to the "Permissions" tab and check the "Allow executing file as program" checkbox. Don't forget the NDS file, like mentioned above.