Wii U《Sonic Mania》(2017) 更新移植版

Sonic Mania (2017) — Wii U Updated Port | Beta 2​

Hey everyone!

I'm happy to share my updated Sonic Mania (2017) port for Wii U!

This project builds upon Clownacy's original Sonic Mania Wii U port, bringing in newer improvements from the Sonic Mania and RSDKv5 decompilation projects, along with additional Wii U-specific compatibility fixes.

The goal is to keep the existing Wii U port updated while preserving the work of its original developers.

Screenshots — Running on Real Wii U Hardware​

Captured directly from a real Wii U.

Main menu running on Wii U.

Gameplay running on Wii U.

GamePad display output.

What's New?​

Audio Fixes​

Audio playback fixes!

• Fixed audio playback through the native Wii U AX audio backend.
• Improved audio buffer synchronization.
• Corrected SDL2 audio initialization in RSDKv5.

This was one of the major issues addressed during development of this updated version.

Updated Sonic Mania Code​

This release integrates changes made to the original Sonic Mania decompilation since the previous Wii U port's v1.0.7.

Some of the included fixes are:

• Improved ring and breakable wall collision behavior.
• Fixes for Knuckles' wall-climbing movement.
• Fixes for Tails' tails in Bonus Stages.
• Special Stage fixes, including emerald palette colors and pink sphere teleportation.
• Corrections to various enemies and objects, including Rattlekiller, WoodChipper, Popcorn Machine, and MagnetSphere.
• Additional gameplay and object logic fixes.

Updated RSDKv5 Engine​

The engine has also been updated to a newer codebase incorporating the RSDKv5 v1.1.1 changes.

Improvements include:

• Settings persistence fixes.
• ModAPI settings-string memory corruption fix.
• Legacy engine and stage-handling fixes.
• Additional compatibility and maintenance improvements.

Wii U SDL2 Improvements​

The updated Wii U SDL2 implementation includes:

• Improved V-Sync behavior.
• Rendering fixes.
• Additional texture and pixel format support.
• Compatibility improvements for newer Wii U toolchains.
• Nunchuk input compatibility fix.

Some upstream engine changes target other platforms and may not directly affect the Wii U version.

Testing and Current Status​

Tested on real Wii U hardware.

Confirmed during testing:

• Native Wii U executable launches.
• Game menus display correctly.
• Gameplay is functional.
• Audio playback works.
• Video output works on TV and GamePad.

The published WUHB was reproduced from the released source code and matches the executable tested on the console.

Please note: This is still a beta release. Not every game mode, stage, or upstream change has been individually tested, so bugs may still be present.

If you encounter any issues, feel free to report them!

Download​

GitHub Release:

https://github.com/vbarros22/Sonic-Mania-Decompilation-Wii-U/releases/tag/wiiu-beta2

Direct WUHB Download:

https://github.com/vbarros22/Sonic-.../releases/download/wiiu-beta2/SonicMania.wuhb

The release contains the Wii U homebrew executable.

Game assets are not included. You must provide the required game data from your own legally obtained copy of Sonic Mania.

Installation — Step by Step​

Requirements:

• A Wii U capable of running homebrew applications.
• An SD card.
• The SonicMania.wuhb file from this release.
• The original Data.rsdk file from your legally obtained copy of Sonic Mania.

Step 1 — Download the Wii U executable

Download SonicMania.wuhb from the Beta 2 GitHub release.

Step 2 — Create the game folder

On your SD card, navigate to:

sd:/wiiu/apps/

Create a folder named SonicMania if it doesn't already exist.

Step 3 — Copy the game files

Place SonicMania.wuhb and your original Data.rsdk file inside the SonicMania folder.

Your SD card should look like this:

SD Card
└── wiiu
└── apps
└── SonicMania
├── SonicMania.wuhb
└── Data.rsdk
Important: The Data.rsdk file is not included in the download. You must obtain it from your own legally purchased copy of Sonic Mania.

Make sure the file is named exactly Data.rsdk and is not inside an additional subfolder.

Step 4 — Launch the game

1. Safely eject your SD card from your computer.
2. Insert it into your Wii U.
3. Open your homebrew launcher or compatible homebrew menu.
4. Select Sonic Mania and launch it.

Notes:

• Do not rename SonicMania.wuhb or Data.rsdk.
• If the game cannot find its data, double-check the folder structure and file names.
• This is a beta release, so some issues may still occur.

Enjoy Sonic Mania on Wii U!

Source Code​

The updated source code is available on GitHub.

Sonic Mania Wii U:

https://github.com/vbarros22/Sonic-Mania-Decompilation-Wii-U

RSDKv5 Wii U:

https://github.com/vbarros22/RSDKv5-Decompilation-Wii-U

SDL2 Wii U:

https://github.com/vbarros22/SDL

Credits and Special Thanks​

Clownacy — Creator of the original Sonic Mania Wii U port. This updated version builds upon his original Wii U implementation.

Original project:

https://github.com/Clownacy/Sonic-Mania-Decompilation-Wii-U

RSDKModding / Rubberduckycooly and contributors — Sonic Mania and RSDKv5 decompilation projects.

SDL2 Wii U contributors — Wii U SDL2 implementation and compatibility improvements.

devkitPro / WUT contributors — Wii U homebrew development tools and libraries.

vbarros22 — Beta 2 integration, upstream updates, Wii U audio fixes, compatibility work, testing, and release maintenance.

Huge thanks to everyone who contributed to the original projects and to the Wii U homebrew community!

Feedback​

This is an ongoing effort to keep Sonic Mania running on Wii U with newer decompilation improvements.

If you test this release, I'd love to hear your feedback, especially regarding audio, performance, controls, and compatibility.

Thanks for checking it out, and enjoy Sonic Mania on Wii U!