Skip to content

0.9.1

Latest
Latest

Choose a tag to compare

View all tags
@vitor251093 vitor251093 released this 16 Jul 20:20
v0.9.1
3a3adb5
  • Game settings (by @Nexkiv)
  • Hash of exported textures reverted to original hashes (thanks to @Kite2810)
  • Reverting back to always using X11/XWayland on Linux for now (fixes visual issues on Linux)

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

If you aren't using automatic mapping, and want to use the joystick to open the new game settings, go to Config -> Input and hotkeys, open the Add-ons tab, and bind a key to the "Open settings" entry. Note: the chosen key will only work during the intro, the title screen, and the ingame config menu, so we recommend using Square (Playstation) / X (Xbox) / X (Steam Deck) / Y (Switch Pro).

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.9.0

For additional required steps, check the 0.9.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. Launch the Melon Mix using "MelonMix_GameSelector.bat", or "MelonMix_KHDays.bat", or "MelonMix_KHReCoded.bat";
  8. As the game launches, open the game settings, by pressing Esc on your keyboard, or, with your gamepad, pressing Square (Playstation) / X (Xbox) / X (Steam Deck) / Y (Switch Pro);
  9. Configure the game according to your personal preferences.

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_GameSelector.sh, MelonMix_KHDays.sh and MelonMix_KHReCoded.sh as well;
  8. Launch the Melon Mix using "MelonMix_GameSelector.sh", "MelonMix_KHDays.sh" or "MelonMix_KHReCoded.sh";
  9. As the game launches, open the game settings, by pressing Esc on your keyboard, or, with your gamepad, pressing Square (Playstation) / X (Xbox) / X (Steam Deck) / Y (Switch Pro);
  10. Configure the game according to your personal preferences.

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. As the game launches, open the game settings, by pressing Esc on your keyboard, or, with your gamepad, pressing Square (Playstation) / X (Xbox) / X (Steam Deck) / Y (Switch Pro);
  10. Configure the game according to your personal preferences.

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. Open either Days or Re:Coded from the 1.5+2.5 collection;
  12. As the game launches, open the game settings, by pressing Esc on your keyboard, or, with your gamepad, pressing Square (Playstation) / X (Xbox) / X (Steam Deck) / Y (Switch Pro);
  13. Configure the game according to your personal preferences.

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. Open either Days or Re:Coded from the 1.5+2.5 collection;
  12. As the game launches, open the game settings, by pressing Esc on your keyboard, or, with your gamepad, pressing Square (Playstation) / X (Xbox) / X (Steam Deck) / Y (Switch Pro);
  13. Configure the game according to your personal preferences.

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
  • (Add-ons tab) Map "Open settings" to Square (Playstation) / X (Xbox) / X (Steam Deck) / Y (Switch Pro)
  • (General hotkeys) Map "Toggle fullscreen" to an available button of your preference

Note: don't add the same gamepad key to two DS inputs, or neither of them will work properly. The only exception to this rule is "Open settings", because it is only triggered during the intro, the title screen, and the ingame config menu.

How to dump DS cart into an NDS file

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

Contributors

Nexkiv and Kite2810
Assets 10
Loading