How to Install and Play Melee 3D on Dolphin: ISO, Patching and Controls

To install Melee 3D, you need your own clean US/NTSC 1.02 Super Smash Bros. Melee ISO, verify its MD5 hash, apply the mod’s platform-specific patch, and open the newly created ISO in Dolphin. Melee 3D is a fan-made three-dimensional reinterpretation, not a standalone game or a downloadable retail ISO. The original image must remain untouched so you can retry the patch or return to vanilla Melee. Once it launches, configure an emulated or real GameCube controller and learn the mod’s Throttle input: ordinary attack and recovery directions do not always work like standard two-dimensional Melee.

What is Melee 3D?

Melee 3D is a fan-made patch for Super Smash Bros. Melee that adapts arenas and movement for three-dimensional play. The project’s latest listed release was v1.0 when checked in November 2026. It modifies a legally obtained Melee image; it does not include Nintendo’s game data and should not be treated as a separate retail release.

The developer’s README requires an unmodified US/NTSC 1.02 image. A PAL dump, another revision, a pre-patched image, or a compressed archive passed directly to the patcher can fail. The required source hash is MD5 0e63d4223b01d9aba596259dc155a174. A disc listing may say “Melee” without proving that the resulting dump has this revision or checksum.

Keep two files after installation: the untouched vanilla ISO and the separate Melee 3D ISO. Dolphin should point to the patched copy when you want the mod and to the original when you want ordinary Melee.

What do you need before installing?

• A legally obtained original GameCube disc and a dump made from that disc. Dolphin’s ripping guide describes using suitable hardware and CleanRip to create an ISO from a disc you own.
• A US/NTSC 1.02, unmodified ISO with MD5 0e63d4223b01d9aba596259dc155a174.
• The Melee 3D release archive from the walz0/Melee-3D project’s release area. Use the latest release shown there; it was v1.0 when checked.
• A desktop Dolphin build from Dolphin’s official downloads page. That page listed stable release 2609a on October 30, 2026; this listing is a version reference, not a compatibility test for Melee 3D.
• Enough storage for the original and patched images, plus the extracted patch files. Do not overwrite the clean source.

If your source is compressed, extract it to a normal ISO before checking the hash or running xdelta. The patcher expects a file, not a compressed container.

How do you verify the correct Melee ISO?

Hash verification is the fastest way to catch the wrong region, revision, or a modified source before xdelta reports a less helpful error.

1. Locate the unmodified ISO produced from your own NTSC GameCube disc.
2. On Windows, use a trusted MD5 utility or PowerShell hashing tool; on Linux, run md5sum path/to/ssbm.iso. On macOS, use an MD5 utility such as the system command md5.
3. Compare the complete result with 0e63d4223b01d9aba596259dc155a174.
4. Proceed only when the values match exactly. Rename the file if useful, but do not edit its contents or apply another mod first.

If the value differs, stop and obtain a fresh dump from the correct US/NTSC 1.02 disc. Do not try to “fix” the mismatch with a controller utility, driver updater, or PC-cleaning program; those do not change the source data the patcher validates.

Where should you get the patch?

Use the release area of walz0/Melee-3D, rather than a mirror or a pre-patched ISO. Download the archive for your operating system, extract it, and read the included instructions. GitHub did not expose individual asset names during the release-page check, so follow the filenames in the archive you actually downloaded instead of relying on a guessed installer name.

The archive contains the patching material and platform-specific helper files. Downloading the patch does not grant a copy of Melee; you still supply your own verified source image.

How do you patch Melee 3D on Windows?

Windows uses the batch file supplied in the extracted release. The important detail is that you drag the clean ISO onto the batch file; double-clicking the batch file by itself is a documented cause of a missing-file error.

1. Extract the Windows portion of the Melee 3D archive to a folder with a simple path.
2. Confirm that your clean ISO’s MD5 matches the required value.
3. Drag the verified ISO file onto the included .bat file.
4. Allow the script to finish. The project instructions say the output appears beside the batch file as Super Smash Bros. Melee 3D.iso.
5. Leave the original ISO untouched. If you need to retry, use that original rather than the generated image.

If Windows says it cannot find Super Smash Bros. Melee 3D.iso, check that you dragged the ISO onto the batch file and did not merely launch the batch file. Also verify that the source is extracted, has the expected filename or path handling, and matches the MD5.

How do you patch Melee 3D on macOS?

The Mac folder includes a MultiPatch application. You select the xdelta patch, the clean input image, and a new output location.

1. Extract the Mac files from the release archive.
2. Open the included MultiPatch application. If macOS displays a security prompt for an application downloaded from the internet, use the system’s normal approval process only if you trust the file you downloaded from the project release.
3. In MultiPatch, choose patch.xdelta inside the Melee3D-Slippi folder as the patch.
4. Select your verified, unmodified NTSC 1.02 ISO as the input file.
5. Choose a distinct output path and filename, then apply the patch.
6. Keep both the source and output images. Open the output in Dolphin after patching completes.

Do not select a compressed archive as the input and do not save the output over the clean ISO. A separate destination makes recovery straightforward if you later need to patch again.

How do you patch Melee 3D on Linux?

Linux uses xdelta3 from the command line. Install your distribution’s xdelta3 package as described in the project README, then substitute real paths for every placeholder in the command.

1. Extract the release archive and any compressed source image.
2. Check the source with md5sum path/to/ssbm.iso. It must return 0e63d4223b01d9aba596259dc155a174.
3. Run xdelta3 -dfs path/to/vanillassbm path/to/patch.xdelta path/to/patchediso.iso.
4. Treat the last argument as the output filename. It is not a second input file.
5. Open patchediso.iso in Dolphin and retain the vanilla image for future attempts.

The XD3_INVALID_INPUT checksum error generally means the source is incompatible or modified. Recheck the region, revision, extraction step, and MD5 before changing anything else.

How do you open the patched image in Dolphin?

Install a desktop Dolphin build from its official downloads page, then add the generated ISO to Dolphin’s game list or open it directly as a GameCube game.

1. Launch Dolphin.
2. Choose the option to add a game directory and select the folder containing Super Smash Bros. Melee 3D.iso, or use Dolphin’s open-file command to select that ISO.
3. Start the patched image from the game list. Keep the vanilla ISO in a different folder if you want to avoid selecting the wrong copy.
4. For controls, open Options → Controller Settings.
5. Under the GameCube controller ports, choose an emulated controller and map its buttons, stick, C-stick, triggers and D-pad. Dolphin can map a keyboard or another supported input device, so a physical GameCube pad is optional.
6. If you use a real GameCube controller, select the supported adapter and configure the corresponding port. The adapter and controller must be recognized by your operating system and Dolphin before the game can read them.

This is a workflow based on the project and Dolphin documentation, not a claim that every Dolphin build, operating system, controller adapter, game mode or online service has been exhaustively tested with Melee 3D.

How does movement and the Throttle work?

The project’s central control change is three-dimensional direction. As the developer explains, “Your character moves in the direction you point the control stick.” Attacks are forward by default, while the Throttle supplies the up-or-down component that a normal two-dimensional input diagram cannot show.

Basic movement

• Use the main control stick to move in the direction you point it.
• Attacks normally go forward relative to your character.
• The Throttle is bound to R by default. The README says it can be changed with L or R on the character-select screen.

Special moves and recovery

• Throttle plus B performs the down-special input described by the README.
• While recovering, holding Throttle during an up-special points the trajectory toward the ledge.
• Release Throttle before the move comes out if you want the control stick to aim the up-special instead.
• For recoveries that do not use Throttle, the C-stick can adjust vertical direction.
• Some Ness specials use the main stick horizontally and the C-stick vertically, so their inputs do not follow one universal rule.

Practice these interactions in a safe mode before attempting a match. The same button can have a different practical purpose depending on whether you are attacking, recovering, or controlling a character with a special-case input.

Which stages are included?

The project README lists nine adapted 3D stages. The list is a documented stage count, not a player-count, frame-rate or compatibility statistic.

• Final Destination
• Pokémon Stadium
• Yoshi’s Story
• Fountain of Dreams
• Dream Land N64
• Green Greens
• Yoshi’s Island
• Mute City
• Onett

The inspected primary documentation does not establish a measured FPS figure, audience size, or an independently verified character-by-character compatibility percentage. Treat the release’s stage list as the reliable scope statement rather than assuming every original Melee feature behaves identically.

Why does xdelta report a checksum mismatch?

The usual cause is an incompatible or modified source image. The developer specifically identifies the wrong revision or altered ISO as the reason for xdelta3: target window checksum mismatch: XD3_INVALID_INPUT.

• Confirm that the dump is US/NTSC 1.02, not PAL or another revision.
• Recalculate the MD5 and compare every character with 0e63d4223b01d9aba596259dc155a174.
• Extract a compressed source image before patching.
• Remove prior patches, texture packs, randomizers, or other modifications from the source.
• Use the patch file from the project release that matches your platform instructions.
• Retry from the untouched ISO and write to a new output path.

If the hash still differs, the patcher cannot make that image compatible by changing Dolphin settings. Obtain a correct dump from a disc you legally own.

Can you play Melee 3D online?

Online support is not guaranteed for every client or mode. The project warns that Slippi users should use only the default Slippi Gecko codes because additional codes may cause desyncs.

Dolphin’s separate Netplay documentation tells players to match game copies and emulator versions. That guidance should not be conflated with Slippi matchmaking, and it does not establish that Melee 3D works in every online service. If you try an online session, use the project’s stated default-code setup, make sure participants have matching patched images, and expect troubleshooting to differ between Slippi and Dolphin Netplay.

The project issue list includes reports involving Nintendont and GCLoader. Those reports concern different hardware environments and are not evidence that Dolphin itself fails or succeeds with a particular release.

How should you keep vanilla and modded files organized?

A simple folder layout prevents accidental overwrites and makes hash checks repeatable:

• Me​lee/vanilla/ssbm_ntsc_102.iso — the verified, untouched source.
• Me​lee/melee-3d/ — the extracted patch files and generated ISO.
• Me​lee/dolphin-games/ — optional folder scanned by Dolphin.

Use clear filenames, but remember that renaming does not change the underlying hash. Back up the clean source before experimenting with another patch or a different Dolphin setup. If a retry fails, delete only the incomplete output and start again from the preserved vanilla image.

Do you need a GameCube controller?

No. Dolphin can map a keyboard or another supported device through an emulated GameCube controller. A real GameCube controller with a Dolphin-compatible USB adapter is optional, but it can make the analog movement and Throttle timing easier to reproduce for players who already prefer that layout.

Whichever device you choose, verify the main stick, C-stick, A, B, triggers, D-pad and the button assigned to Throttle before starting a match. In Melee 3D, a missing trigger mapping can remove an important directional option even when ordinary attacks appear to work.

What should you remember before launching?

1. Melee 3D is a fan patch, not a standalone retail game.
2. Use a legally obtained, unmodified US/NTSC 1.02 ISO with MD5 0e63d4223b01d9aba596259dc155a174.
3. Patch with the platform-specific tool and create a separate output ISO.
4. Open that output in Dolphin and configure an emulated or real controller.
5. Learn the Throttle scheme before assuming standard Melee recovery inputs apply.
6. For Slippi, follow the warning about default Gecko codes; do not assume every online mode is supported.

Frequently Asked Questions

Can I use a PAL copy of Melee for this mod?

No. The project specifies the US/NTSC 1.02 revision, and the required MD5 identifies that exact source. A PAL image can be a legitimate dump yet still be incompatible with this patch.

Should I delete the original ISO after patching?

Keep it. The clean image is your rollback and retry source, while the generated file is the modded copy. Retaining both also prevents you from accidentally patching an already modified image.

Why does my patched game not appear in Dolphin’s list?

Dolphin scans only the directories you add to its game paths. Add the folder containing the generated ISO, or open the file directly, and check that the patch completed rather than leaving a partial output.

Is the R button always the Throttle button?

R is the default binding described by the project, but the README allows changing it with L or R on the character-select screen. Confirm the active binding before practicing recoveries or special moves.

Does the nine-stage list mean nine-player matches are supported?

No. Nine is the number of adapted stages listed by the project. It says nothing about player capacity, performance, or compatibility of every character and mode.