Cemu logo
Nintendo · Wii U● Active Development

Cemu

The Premier Wii U Emulator

A sophisticated JIT recompiler bridging the Wii U's PowerPC Espresso architecture to modern x86-64 hardware. Run Breath of the Wild at 60fps, Mario Kart 8, Splatoon, and 700+ Wii U titles with near-perfect accuracy.

Section I

System Architecture & Hardware Philosophy

Cemu is a sophisticated software translator that bridges the gap between the Wii U's unique multicore PowerPC architecture — the Espresso microprocessor — and modern x86-64 PC hardware. It achieves this via a Just-In-Time (JIT) recompiler that dynamically translates game instructions on the fly. Understanding your hardware's role is the first step to a stable, high-performance environment.

The CPU is King

The CPU dictates the JIT recompiler's pace. High single-core performance is far more critical than high core counts. A fast 4-core CPU outperforms a slow 16-core CPU in Cemu.

The Memory Mandate

While the official minimum is 4 GB RAM, the practical consensus is that 8 GB or more is strictly required to avoid memory-related crashes during shader-heavy sequences.

Vulkan is the Standard

Vulkan is the definitive graphics API for optimal results, especially for AMD and Intel users. OpenGL is a legacy path that can cause severe performance degradation and should be avoided.

If You Only Remember One Thing

Cemu is CPU-bound, not GPU-bound. Prioritize single-core clock speed when building or selecting a PC for Wii U emulation. A 5 GHz dual-core will outperform a 3 GHz octa-core in most Wii U titles.

Section II

The mlc01 Paradigm and Installation

Cemu's storage model relies heavily on strict directory structures. Deviating from these rules is the most common cause of missing saves, broken updates, and unrecognized DLC. Understanding the mlc01 paradigm before installing a single game will save hours of troubleshooting.

Video Tutorial: Cemu Initial Setup Guide & Directory Management

Configuration Rules

Windows Environment Adjustments

Right-click Cemu.exe, navigate to Properties, and check "Disable full-screen optimizations" to eliminate micro-stuttering caused by the Windows window manager interfering with the rendering loop.

The mlc01 Directory

This acts as the root of the emulated Wii U's internal memory. It houses system files, installed applications, user save data, updates, and DLC. Think of it as the Wii U's internal NAND storage.

Base Games vs. Updates — Critical Separation

Base games must be stored in a dedicated "Game Path" separate from your Cemu installation. Never manually place update or DLC folders into the game path or the mlc01 folder. This is the single most common setup mistake.

Installation Protocol

Updates and DLC must exclusively be installed through Cemu's internal UI via File → Install game title, update or DLC. Manual file placement will result in the content being ignored or causing corruption.

The Modern Standard: .wua Format

Modern deployments should utilize the .wua (Wii U Archive) format. This compressed format consolidates the base game, all updates, and all DLC into a single file, eliminating library clutter and ensuring Cemu always loads the correct version. If you have separate base + update + DLC files, consider converting them to .wua using the Wii U USB Helper or similar tools.

Section III

The Layer Precedence Map: Globals, Profiles & Graphic Packs

Cemu is a profile-first emulator. Global settings provide a baseline, but true stability and performance are achieved by tuning per-title. Cemu reads configuration in layers — understanding this hierarchy prevents hours of confusion when a setting "doesn't seem to apply."

1. Game Profiles — The Silent Override

Game profiles allow per-game settings management. When a game boots, its specific profile will silently override global emulator settings without any notification. This is why a global setting change may appear to have no effect on a specific game.

Thread Quantum

Always leave at 45,000 cycles. Increasing this provides no performance benefit and significantly increases crash probability. This is one of the most misunderstood settings in Cemu.

VSync (Vulkan)

Change to "Match emulated display (Experimental)". This uses the game's built-in frame-pacing logic to significantly reduce input latency and screen tearing.

2. Graphic Packs — The Active Configuration Layer

Graphic packs are not merely cosmetic resolution scalers. They are sophisticated, modular patches that act as active configuration layers, capable of modifying core game code, replacing textures, and overwriting shaders.

Video Tutorial: Understanding Cemu Graphic Packs & FPS++

FPS++ for Breath of the Wild

The FPS++ graphic pack dynamically adjusts the game's internal logic, allowing Breath of the Wild to run at 60 FPS or higher without breaking game physics. This is the single most impactful optimization available for the most popular Wii U title. Enable it via Right-click game → Edit graphics packs → Mods → FPS++.

Section IV

Input & Controller Architecture

Cemu has evolved from requiring third-party wrappers to utilizing native hardware communication. The introduction of SDL2 represents a major milestone that eliminates historical dependencies on external tools.

SDL2 Revolution

SDL2 provides native support for gyroscopes and accelerometers in the PlayStation DualSense, DualShock 4, and Nintendo Switch Pro controllers. No third-party tools required.

Deprecating Cemuhook

SDL2 entirely removes the historical dependency on Cemuhook for motion-sensitive gameplay. If you previously used Cemuhook, you must change your GamePad motion source back to "Default" to avoid conflicts.

XInput for Xbox Controllers

Xbox controllers do not possess motion capabilities and should be mapped using XInput for standard gamepad play. This is the recommended path for arcade cabinet setups using Xbox-style controllers.

Arcade Cabinet Setup

Sanwa joysticks and arcade buttons map cleanly via XInput or DirectInput. For fighting games (Smash Bros.), an arcade stick layout is ideal. For Zelda/platformers, a standard gamepad layout is preferred.

Important: Cemuhook Migration

If upgrading from an older Cemu installation that used Cemuhook, go to Settings → Input → GamePad → Motion Source and set it back to Default. Leaving it on Cemuhook after SDL2 integration causes motion input to fail silently.

Section V

Demystifying Shaders: Stutter vs. Pop-in

The translation of Wii U graphics (Latte GPU) into a format your PC understands (SPIR-V for Vulkan) is historically the largest source of performance degradation in Cemu. Understanding the two cache systems is essential for diagnosing and resolving performance issues.

Asynchronous Shader Compilation

When Cemu encounters a brand-new shader, it has two choices: freeze the game to compile it, or keep the game moving and compile in the background.

✓ Async Enabled (Recommended)

Compilation happens in the background. Gameplay stays fluid. The trade-off is brief visual pop-in — objects may be temporarily invisible for under 100ms until the shader compiles.

✗ Async Disabled

Compilation blocks the game loop, causing shader stutter — momentary freezes every time a new shader is encountered. Eliminates pop-in but destroys gameplay fluidity.

Shader vs. Pipeline Caches

These two cache types are frequently confused but serve fundamentally different purposes.

Shader Caches

Store the translated shader programs. Generally transferable between different regions of the same game. Can be shared online to skip the initial compilation phase.

Pipeline Caches

Store the specific state of the graphics pipeline. Strictly locked to the exact hardware, GPU, and driver version that generated them. Never share pipeline caches between different machines.

If You Only Remember One Thing

Enable Async shader compilation and accept the brief pop-in. Shader stutter is far more disruptive to gameplay than visual pop-in. After your first full playthrough, the shader cache is built and both problems disappear entirely.

Section VI

Advanced Diagnostics & Edge Cases

Even in a highly optimized setup, specific edge cases require targeted solutions. These are the most commonly encountered hardware-specific issues and their verified workarounds.

HIGH

Nvidia RTX 40-Series Driver Crashes

Users experiencing severe, system-locking crashes on modern Nvidia GPUs (RTX 40-series) may be suffering from driver instability.

Verified Fix

Roll back Nvidia drivers specifically to version 565.90 (October 2024). This has been identified as a reliable workaround for RTX 40-series instability in Cemu under Vulkan.

MEDIUM

AMD Polygon Corruption

Recent AMD driver updates have occasionally introduced regressions causing severe polygon corruption in titles like Breath of the Wild and Xenoblade Chronicles X.

Verified Fix

Ensure you are using Cemu 2.3 or newer. These versions implemented specific race condition fixes for Vulkan that mitigate AMD driver bugs. If corruption persists, try temporarily switching to OpenGL to confirm the issue is driver-related.

MEDIUM

Super Mario 3D World Level-End Crashes

A known bug causes crashes at the end of levels in Super Mario 3D World, specifically during the level completion animation.

Verified Fix

Update to Cemu version 2.4 or newer. This version implemented specific fixes for the level-end corruption that triggered the crash.

Section VII

Networked Services: The Pretendo Integration

With the official shutdown of Nintendo Network servers in 2024, online functionality in Cemu requires transitioning to community alternatives. Cemu now natively supports Pretendo Network, a free, open-source replacement for Nintendo Network.

Video Tutorial: Configuring Pretendo for Cemu Online Play

Hardware Requirements

To access Pretendo legally and securely, you must dump specific system files from a physical Wii U console using the Dumpling tool.

otp.bin — One-Time Programmable data, unique to your console
seeprom.bin — Serial EEPROM, contains console-specific identifiers

Why These Files Matter

These files provide the unique identifiers necessary for the emulator to interface with community servers. Missing either file will result in a connection rejection. They are tied to your specific physical console and cannot be substituted with files from another unit.

Legal Note

Pretendo requires files dumped from a console you legally own. The Dumpling tool is the recommended method. Do not use otp.bin or seeprom.bin files obtained from third-party sources, as these are tied to another person's console and will result in account conflicts or bans.

Reference

Top Wii U Titles in Cemu

#TitleGenreNotes
1The Legend of Zelda: Breath of the WildAction-AdventureFlagship title — use FPS++ graphic pack for 60fps
2Super Mario 3D WorldPlatformerUpdate to Cemu 2.4 to fix level-end crash bug
3Mario Kart 8RacingExcellent performance; high-res graphic packs available
4SplatoonShooterPretendo Network for online play; gyro via SDL2
5Xenoblade Chronicles XJRPGUse Cemu 2.3+ to avoid AMD polygon corruption
6Super Smash Bros. for Wii UFightingArcade stick / Sanwa joystick compatible via XInput
7Donkey Kong Country: Tropical FreezePlatformerRuns near-perfectly; great for casual arcade play
8Bayonetta 2ActionExcellent performance; arcade button layout ideal
9Pikmin 3StrategyStable; pointer controls via mouse or motion
10New Super Mario Bros. UPlatformerIdeal for multiplayer arcade cabinet setups
11Captain Toad: Treasure TrackerPuzzleRuns flawlessly; great for all ages
12Hyrule WarriorsHack-and-SlashArcade button layout ideal; good performance
13Wind Waker HDAction-AdventureGorgeous HD remaster; stable at 60fps with graphic packs
14Twilight Princess HDAction-AdventureExcellent performance; Vulkan recommended
15Yoshi's Woolly WorldPlatformerCharming co-op title; runs excellently

Reference

Troubleshooting

Game shows as unrecognized or won't launch
Verify the game is in a supported format (.wua, .wud, .rpx). Check that your game path is correctly set in Options → General Settings → Game Paths. Ensure you haven't accidentally placed the game inside the mlc01 folder.
DLC or updates not being applied
DLC and updates must be installed via File → Install game title, update or DLC. Never manually copy update/DLC folders into the game path or mlc01. After installation, verify via right-clicking the game → Properties.
Severe stuttering in Breath of the Wild
Enable Async shader compilation in Debug settings. Install the FPS++ graphic pack. On first launch, stuttering is normal as shaders compile — it will improve dramatically on subsequent sessions as the cache builds.
Black screen on game launch
Ensure Vulkan is selected as the graphics API. Verify your GPU drivers are up to date (or rolled back to 565.90 for Nvidia RTX 40-series). Check that the mlc01 directory is correctly configured.
Controller not being detected
Cemu uses SDL2 for modern controllers. Go to Options → Input Settings and configure your controller there. For Xbox controllers, use XInput. For PS4/PS5/Switch Pro, SDL2 should detect them automatically.
Save data not persisting between sessions
Save data is stored in the mlc01 directory. Ensure mlc01 is not located inside a read-only folder. If you moved Cemu, verify the mlc01 path in Options → General Settings → MLC Path.
Pretendo connection rejected
Ensure both otp.bin and seeprom.bin are present and correctly placed. These must be dumped from your own physical Wii U using the Dumpling tool. Files from other consoles will be rejected.

Explore More Emulator Guides