Skip to content
This repository has been archived by the owner on Jul 31, 2022. It is now read-only.
/ ZLauncher Public archive

The Legend of Zelda: Breath of the Wild custom launcher

Notifications You must be signed in to change notification settings

tkashkin/ZLauncher

Repository files navigation

ZLauncher

The Legend of Zelda: Breath of the Wild custom launcher

Features

Download

You can download binaries on releases page.

Configuration

All configurations are done by zlauncher.ini config file. ZLauncher can use another config file if specified with -config command line parameter.

This is an example config file:

[cemu]
path=D:\Programs\Cemu                                          ; Path to Cemu
fullscreen=true                                                ; Fullscreen
cores=0,2,4,6                                                  ; Comma/space delimited list of allowed cores
cmdline=                                                       ; Additional Cemu command line parameters

[game]
path=D:\Games\WiiU\The Legend of Zelda - Breath of the Wild    ; Path to the game
elevate=true                                                   ; Run game with admin priveleges

[speedhack]
path=.\speedhack.exe                                           ; Path to speedhack trainer
enabled=false                                                  ; Is speedhack enabled

[video]
enabled=true                                                   ; Video playback hack enabled

[steam]
enabled=true                                                   ; Is Steam support enabled
elevate=true                                                   ; Run Steam with admin priveleges
gameid=12927812811798609920                                    ; Game id in Steam library

Steam (overlay and controller)

You can launch game through Steam to get Steam overlay and Steam controller working:

  • Add ZLauncher into your Steam library as a Non-Steam game
  • Create desktop shortcut for this game
  • Find new shortcut on desktop and open its properties
  • Copy id number from URL attribute. It will be something like steam://rungameid/12927812811798609920
  • Paste id to the gameid parameter of the [steam] section
  • Delete shortcut if you want
  • Set the [steam].enabled parameter to true
  • Set the [steam].elevate and [game].elevate parameters to true if you want to run game as admin

Video playback

ZLauncher supports BotW cutscenes playback using external mpv player. ZLauncher reads Cemu log file and starts playing when game tries to access video file. To enable video playback hack:

  • Enable logging in Cemu (Debug > Logging > Enable logging and Debug > Logging > File access)
  • Set the [video].enabled parameter to true

ZLauncher vs Cemuhook

ZLauncher and Cemuhook works differently. Just choose what you like:

Cemuhook is hooking some Cemu functions and replacing its functionality.
Pros:
  • It's integrated into Cemu.
  • It works in another games, not BotW only.
  • It's more seamless integration: subtitles are visible, timings are correct.
Cons:
  • It interferes with Cemu, something can break after updates.
  • It's closed-source now.

ZLauncher is constantly reading Cemu log and shows cutscene in external borderless window.
Pros:
  • It doesn't touch Cemu in any way.
  • It most likely continue to work after updates.
Cons:
  • Video is shown in separate overlay.
  • Subtitles are hidden.
  • Timings may be broken.

You can disable ZLauncher video playback by setting [video].enabled parameter to false. Then you can remove mpv.exe if you want.