github vitor251093/KHMelonMix v0.8.1
0.8.1
on GitHub

latest release: v0.8.2
12 hours ago
  • (Days & Re:Coded) (Linux) Adding loading transition between selecting the game on the 1.5+2.5 collection and the game opening
  • (Days & Re:Coded) Saves should be stored in the cloud if launched through the 1.5+2.5 collection
  • (Days & Re:Coded) Importing configs from the 1.5+2.5 collection
  • (Days & Re:Coded) Improving dual screen mode support
  • Automatic game controller mapping

Installing

If this is your first time using the Melon Mix, follow the "How to install for the first time" guide down below. If you want to keep your save files from older Melon Mix versions, follow the "How to upgrade from an older version" guide right here:

How to upgrade from an older version

First, press Config -> Input and hotkeys to configure the controls (the old configs were dropped in 0.8.1, so it's better if you double check the controls). If you want to change anything, remember to disable "Automatically map joysticks for this game".

Now, on Windows, replace MelonMix.exe with the newest one.

And finally, on Steam Deck, replace MelonMix.exe (if you are using the 1.5+2.5 collection) and MelonMix.AppImage with the newest one, provided in this release. Then right click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox.

Migrating from versions below 0.6.0

For additional required steps, check the 0.6.0 migration guide.

How to install for the first time

Windows (without the 1.5+2.5 collection)

  1. Download the latest version for Windows;
  2. Open the downloaded ZIP file and copy the contents to an empty folder;
  3. Create a folder named "roms" next to the Melon Mix executable that you just copied;
  4. In order to play "358/2 Days":
    1. Dump an original copy of "358/2 Days" and copy the NDS file to your computer (instructions at "How to dump DS cart into an NDS file" down below);
    2. Rename that NDS file to "days.nds", place it inside the "roms" folder;
  5. In order to play "Re:Coded":
    1. Dump an original copy of "Re:Coded" and copy the NDS file to your computer (instructions at "How to dump DS cart into an NDS file" down below);
    2. Rename that NDS file to "recoded.nds", place it inside the "roms" folder;
  6. Place this assets folder next to the Melon Mix executable file (optional; only if you want to upgrade the audio / cutscenes / textures / sprites);
  7. The next steps are only necessary if you are launching Melon Mix for the first time;
    1. In the future, launch the Melon Mix using "MelonMix_KHDays.bat" or "MelonMix_KHReCoded.bat", but, right now, launch "MelonMix.exe";
    2. Open the Days/ReCoded NDS file with the Melon Mix (you MUST open the NDS file BEFORE following the next steps, otherwise they won't work), and then:
    3. Press Config -> Plugin settings to configure the Melon Mix according to your personal preferences;
    4. If you plan to play with a keyboard, or you don't want your game controllers to be mapped automatically, press Config -> Input and hotkeys, disable "Automatically map joysticks for this game", and then configure the controls (recommended mappings at the "Recommended controller binds" guide below).

Linux / Steam Deck (without the 1.5+2.5 collection)

  1. Download the latest version for Linux;
  2. Open the downloaded ZIP file and copy the contents to an empty folder;
  3. Create a folder named "roms" next to the Melon Mix executable that you just copied;
  4. In order to play "358/2 Days":
    1. Dump an original copy of "358/2 Days" and copy the NDS file to your computer (instructions at "How to dump DS cart into an NDS file" down below);
    2. Rename that NDS file to "days.nds", place it inside the "roms" folder;
  5. In order to play "Re:Coded":
    1. Dump an original copy of "Re:Coded" and copy the NDS file to your computer (instructions at "How to dump DS cart into an NDS file" down below);
    2. Rename that NDS file to "recoded.nds", place it inside the "roms" folder;
  6. Place this assets folder next to the Melon Mix executable file (optional; only if you want to upgrade the audio / cutscenes / textures / sprites);
  7. Right-click the binary/AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox. Repeat those steps for MelonMix_KHDays.sh and MelonMix_KHReCoded.sh as well;
  8. The next steps are only necessary if you are launching Melon Mix for the first time;
    1. In the future, launch the Melon Mix using "MelonMix_KHDays.sh" or "MelonMix_KHReCoded.sh", but, right now, launch the binary/AppImage;
    2. Open the Days/ReCoded NDS file with the Melon Mix (you MUST open the NDS file BEFORE following the next steps, otherwise they won't work), and then:
    3. Press Config -> Plugin settings to configure the Melon Mix according to your personal preferences;
    4. If you plan to play with a keyboard, or you don't want your game controllers to be mapped automatically, press Config -> Input and hotkeys, disable "Automatically map joysticks for this game", and then configure the controls (recommended mappings at the "Recommended controller binds" guide below).

macOS (without the 1.5+2.5 collection)

  1. Download the latest version for macOS (Intel / Apple Silicon);
  2. Open the downloaded ZIP file and copy the contents to an empty folder;
  3. Create a folder named "roms" next to the Melon Mix executable that you just copied;
  4. In order to play "358/2 Days":
    1. Dump an original copy of "358/2 Days" and copy the NDS file to your computer (instructions at "How to dump DS cart into an NDS file" down below);
    2. Rename that NDS file to "days.nds", place it inside the "roms" folder;
  5. In order to play "Re:Coded":
    1. Dump an original copy of "Re:Coded" and copy the NDS file to your computer (instructions at "How to dump DS cart into an NDS file" down below);
    2. Rename that NDS file to "recoded.nds", place it inside the "roms" folder;
  6. Place this assets folder inside the app's Contents folder (right click the Melon Mix app and press "Show Package Contents" to find it) (optional; only if you want to upgrade the audio / cutscenes / textures / sprites);
  7. Move the Melon Mix app to the Applications folder, or run the following command in the terminal: xattr -drs com.apple.quarantine <path>, replacing <path> with the full path of the Melon Mix app;
  8. Now you just need to launch the Melon Mix app, and open the desired NDS file with it;
  9. The next steps are only necessary if you are launching Melon Mix for the first time;
    1. Open the Days/ReCoded NDS file with the Melon Mix (you MUST open the NDS file BEFORE following the next steps, otherwise they won't work), and then:
    2. Press Config -> Plugin settings to configure the Melon Mix according to your personal preferences;
    3. If you plan to play with a keyboard, or you don't want your game controllers to be mapped automatically, press Config -> Input and hotkeys, disable "Automatically map joysticks for this game", and then configure the controls (recommended mappings at the "Recommended controller binds" guide below).

Windows (from the 1.5+2.5 collection) (Steam only)

  1. Download the latest version for Windows;
  2. Extract the downloaded ZIP file to a new folder (let's refer to it in the next steps as the "extracted folder");
  3. Open Steam, right-click your installation of the 1.5+2.5 collection, and press Manage -> Browse local files, which will open a folder (let's refer to it in the next steps as the "collection folder");
  4. Inside the collection folder, rename KINGDOM HEARTS HD 1.5+2.5 Launcher.exe to KINGDOM HEARTS HD 1.5+2.5 Launcher backup.exe;
  5. Copy KINGDOM HEARTS HD 1.5+2.5 Launcher.exe folder from the extracted folder to the collection folder;
  6. Inside the collection folder, open the Image folder, and create a melon folder inside of it;
  7. Copy MelonMix.exe and the roms folder from the extracted folder to the melon folder;
  8. In order to play "358/2 Days":
    1. Dump an original copy of "358/2 Days" and copy the NDS file to your computer (instructions at "How to dump DS cart into an NDS file" down below);
    2. Rename that NDS file to "days.nds", place it inside the roms folder;
  9. In order to play "Re:Coded":
    1. Dump an original copy of "Re:Coded" and copy the NDS file to your computer (instructions at "How to dump DS cart into an NDS file" down below);
    2. Rename that NDS file to "recoded.nds", place it inside the roms folder;
  10. Place this assets folder next to the Melon Mix executable file (optional; only if you want to upgrade the audio / cutscenes / textures / sprites);
  11. The next steps are only necessary if you want to customize your experience, or if you plan to play with a keyboard;
    1. Open the Melon Mix directly through MelonMix.exe;
    2. Open the Days/ReCoded NDS file with the Melon Mix (you MUST open the NDS file BEFORE following the next steps, otherwise they won't work), and then:
    3. Press Config -> Plugin settings to configure the Melon Mix according to your personal preferences;
    4. If you plan to play with a keyboard, or you don't want your game controllers to be mapped automatically, press Config -> Input and hotkeys, disable "Automatically map joysticks for this game", and then configure the controls (recommended mappings at the "Recommended controller binds" guide below).

Linux / Steam Deck (from the 1.5+2.5 collection) (Steam only)

  1. Download the latest version for Linux;
  2. Extract the downloaded ZIP file to a new folder (let's refer to it in the next steps as the "extracted folder");
  3. Open Steam, right-click your installation of the 1.5+2.5 collection, and press Manage -> Browse local files, which will open a folder (let's refer to it in the next steps as the "collection folder");
  4. Inside the collection folder, rename KINGDOM HEARTS HD 1.5+2.5 Launcher.exe to KINGDOM HEARTS HD 1.5+2.5 Launcher backup.exe;
  5. Copy KINGDOM HEARTS HD 1.5+2.5 Launcher.exe folder from the extracted folder to the collection folder;
  6. Inside the collection folder, open the Image folder, and create a melon folder inside of it;
  7. Copy MelonMix.exe, MelonMix.AppImage and the roms folder from the extracted folder to the melon folder;
  8. In order to play "358/2 Days":
    1. Dump an original copy of "358/2 Days" and copy the NDS file to your computer (instructions at "How to dump DS cart into an NDS file" down below);
    2. Rename that NDS file to "days.nds", place it inside the roms folder;
  9. In order to play "Re:Coded":
    1. Dump an original copy of "Re:Coded" and copy the NDS file to your computer (instructions at "How to dump DS cart into an NDS file" down below);
    2. Rename that NDS file to "recoded.nds", place it inside the roms folder;
  10. Place this assets folder next to the Melon Mix executable file (optional; only if you want to upgrade the audio / cutscenes / textures / sprites);
  11. Right-click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox;
  12. The next steps are only necessary if you want to customize your experience, or if you plan to play with a keyboard;
    1. Open the Melon Mix directly through MelonMix.AppImage;
    2. Open the Days/ReCoded NDS file with the Melon Mix (you MUST open the NDS file BEFORE following the next steps, otherwise they won't work), and then:
    3. Press Config -> Plugin settings to configure the Melon Mix according to your personal preferences;
    4. If you plan to play with a keyboard, or you don't want your game controllers to be mapped automatically, press Config -> Input and hotkeys, disable "Automatically map joysticks for this game", and then configure the controls (recommended mappings at the "Recommended controller binds" guide below).

Recommended Controller Binds

  • (DS Keypad tab) Map the DS D-Pad to your controller's left analog stick
  • (DS Keypad tab) Map the Start button to the equivalent key 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 "Switch Target - Left" to the L2/LT button in your controller
  • (Add-ons tab) Map "Lock On" to the R1/RB button in your controller
  • (Add-ons tab) Map "Switch Target - Right" to the R2/RL button in your controller
  • (Add-ons tab) Map "Fullscreen Map Toggle" to the Select/Share/View button in your controller
  • (Add-ons tab) Map "HUD Toggle" to the L3/L button in your controller
  • (General hotkeys) Map "Toggle fullscreen" to an available button of your preference

Note: don't add the same game controller key to two DS inputs, or neither of them will work properly.

How to dump DS cart into an NDS file

There are multiple ways to do so. Those are some of them:

Check out latest releases or
releases around vitor251093/KHMelonMix v0.8.1

Don't miss a new KHMelonMix release

NewReleases is sending notifications on new releases.

Get notifications