by Mokatai™
Setup

Install Guide

Pick your platform for step-by-step setup.

Step Zero

First, get your game

Mokalight includes no game data. Dump your own legally-obtained disc to an image (.iso / .rvz / .wbfs). Only the GZ2E01 (USA) and GZ2P01 (EUR) GameCube versions are supported.

Dolphin Wiki: Ripping Games

Mokalight ships no game data — bring your own legally-dumped copy (GameCube USA GZ2E01 / EUR GZ2P01).

A fan project — not affiliated with, or endorsed by, Nintendo. The Legend of Zelda and Twilight Princess are trademarks of Nintendo.

Choose Your Platform

Step-by-step by OS

Select your platform, then follow the numbered steps.

Windows

In progress
  1. Download and unzip the Mokalight Windows zip anywhere.
  2. Run dusklight.exe.
  3. In the launcher press "Select Disc Image" and choose your dumped image.
  4. Press Play.

Prefer a terminal? dusklight --dvd \path\to\game.iso

TroubleshootingWindows SmartScreen may warn because the build is unsigned. Click More info, then Run anyway.

Linux

Available now
  1. Download Mokalight-v1.3.0-x86_64.AppImage.
  2. Make it executable: chmod +x Mokalight-v1.3.0-x86_64.AppImage
  3. Run it.
  4. Press "Select Disc Image", choose your dump, then Play.

Prefer a terminal? dusklight --dvd /path/to/game.iso

TroubleshootingA black screen or failure to launch usually means Vulkan isn't set up — install or enable your GPU's Vulkan driver.

macOS

Planned
  1. Extract the Dusklight download.
  2. Launch Dusklight.app.
  3. Press "Select Disc Image" and choose your dump.
  4. Press Play.
TroubleshootingRequires a Metal-capable Mac. This is the base Dusklight app; the Mokalight multiplayer build for macOS is planned.

Android

Planned
  1. Install the APK.
  2. Launch the app.
  3. Press "Select Disc Image" and choose your dump.
  4. Press Play.
TroubleshootingRendering uses Vulkan. Adreno GPUs have known issues.

iOS

Base Dusklight · Sideload
  1. Install iloader (iloader.app). On Windows it needs iTunes; on Linux it needs usbmuxd.
  2. Connect your device via USB and enable Developer Mode (Settings › Privacy & Security › Developer Mode) on iOS 16+, then restart.
  3. In iloader, sign in with your Apple ID, press Refresh to detect the device, then Import IPA.
  4. Trust the developer app (Settings › General › VPN & Device Management › your Apple ID › Trust).
  5. Copy your disc image into the Files app.
  6. Launch and select the disc image.
TroubleshootingIf you see "Untrusted Developer", trust the app under Settings › General › VPN & Device Management, and make sure Developer Mode is enabled.
Multiplayer

Set up multiplayer

Three ways to play together in one shared world.

Way I

Host

One click — a dedicated server is bundled. Then share your 5-character room code and friends drop in.

Way II

Direct Connect

Enter a server address + room code. Works over LAN, Mokatai Mesh, or a port-forwarded WAN — the host's server port (default 43210/UDP) must be reachable.

Way III · Coming soon

Server Browser

Browse and join open rooms without a code. Coming soon.

Help

Common troubleshooting

Tap a question to reveal the fix.

"Select a disc image" keeps reappearing
The image must be a valid USA GZ2E01 or EUR GZ2P01 dump. Other regions and versions are not supported.
Can't connect over the internet
The host's server port must be reachable — port-forward 43210, or use LAN / Mokatai Mesh. Room codes alone don't traverse NAT.
Windows SmartScreen blocked it
Click More info, then Run anyway. The build is unsigned, so SmartScreen warns by default.
Crashes or flicker on some GPUs
A D3D12 / Vulkan / Metal-capable GPU is required. Older Intel iGPUs are likely incompatible, and Adreno has known issues.
iOS "Untrusted Developer"
Trust the app under Settings › General › VPN & Device Management, and enable Developer Mode.