✨ MacGacha 0.3.5 is out: install and auto-update Genshin Impact's Miliastra Sandbox editor, a clear message when your network blocks the game's servers and a fix for the background video playing too fast. Already on 0.3.1? MacGacha updates itself. Found something? Please report it.
A native macOS launcher for Genshin Impact, Honkai: Star Rail and Zenless Zone Zero on Apple Silicon. It installs, updates and verifies the games from HoYoverse's official servers, manages Wine / DXMT / D3DMetal runtimes, and starts each game with one click.
- Requirements: Apple Silicon Mac with Rosetta 2 (MacGacha offers to install it), macOS 27 or later.
Code and documentation in this repository may be written or modified with assistance from large language models (LLMs) and AI agents. The software is provided under the GPL-3.0 license, as is, without warranty.
Genshin Impact and Zenless Zone Zero use a Windows 11 Wine profile for Global and Mainland China. Existing prefixes are updated automatically before launch. This startup fix has been verified in Global Genshin 7.2 with DXMT and D3DMetal, and Global ZZZ 3.3 with D3DMetal. A tester played Mainland China Genshin 7.2 with D3DMetal on a mainland account. Mainland China ZZZ gameplay remains unverified.
- Download
MacGacha-<version>.dmgfrom Releases, open it and drag MacGacha to Applications. - Open MacGacha. MacGacha isn't signed or notarized by Apple, so macOS says it can't verify the developer. Click Done.
- Open System Settings → Privacy & Security, scroll down to the MacGacha message and click Open Anyway, then confirm.
If there's no Open Anyway button, or macOS still refuses to open the app, remove the download quarantine flag in Terminal and open MacGacha again:
xattr -dr com.apple.quarantine /Applications/MacGacha.appThis only changes MacGacha itself, not any system setting. The first launch can take a while as macOS checks the app.
Later versions arrive through Check for Updates… in the MacGacha menu, so you only do this once.
| Game settings | Frame-rate unlock warning |
|---|---|
![]() |
![]() |
| Install | Downloading |
|---|---|
![]() |
![]() |
| One-click setup | Mainland China |
|---|---|
![]() |
![]() |
Done
- One-click Play. Press Play, and the launcher prepares the Wine prefix and the compatibility workaround, starts the game and minimizes itself to the Dock. When the game closes, it comes back and puts back any game files it hid. Accepted in all three games on D3DMetal and DXMT.
- Installing games through HoYoverse's official delivery: install, update, verify and repair, voice packs, using an existing installation, and uninstall. Pause and resume work across app restarts. Free space is checked before and during the download. If macOS is still holding space (Time Machine snapshots, caches), the launcher says so instead of just "not enough space". Check for Updates in a game's menu looks for a new version right away.
- Smaller updates and pre-download. Genshin Impact and Honkai: Star Rail update with HoYoverse's patch files, the way HoYoPlay does. Genshin 7.1 to 7.2 with English voice is 8.4 GB instead of 22.7 GB. When HoYoverse offers the next version early, Pre-download fetches it ahead of release, and the installed version stays playable. Pressing Play pauses the pre-download, and you resume it after playing. On release day the update installs from the downloaded files. A file that can't be patched is downloaded normally.
- Download engine. Resumable, verified downloads with a crash-safe journal. A file reaches the game folder only after its hash matches. Files are downloaded and assembled in parallel, close to the full speed of a 2.5 Gbit link. Downloads and full verification show the time left, and long steps show how long they have been running.
- Launcher. One window for all three games with HoYoPlay's backgrounds, in HoYoPlay's order. Each time you open MacGacha, the next background appears, and the dots at the top switch between them. Animated backgrounds play with MacGacha's own video player, which uses about a third less memory than a web view. Each background's Version Highlights and the current events from HoYoPlay open in the browser.
- Genshin Impact frame-rate unlock (opt-in). A switch in Genshin's game settings, off by default, with a target of 120 FPS or a custom value up to 360. MacGacha loads a small helper into the game that only raises its frame-rate limit, using the method of genshin-fps-unlock. We build it ourselves, reproducibly (release). The first time you turn it on, a warning explains the ban risk. Tested on Global Genshin 7.1: 120 FPS held through a 3.5-hour online session.
- Star Rail at 120 FPS. A switch in Star Rail's game settings, Global and Mainland China, sets the game's own saved frame rate to 120 before each launch. On a new install, change any option in the game's graphics settings once so the game saves its settings, then play again.
- Surround sound. Genshin Impact and Zenless Zone Zero can play in surround on D3DMetal, mixed into Spatial Audio for AirPods and other supported headphones. Speakers with six or more channels keep their own layout. Off by default, one switch per game.
- Game Mode. macOS turns on Game Mode for the games, not for the launcher. Each game runs as its own app with its name and icon, so macOS recognizes it. Confirmed on D3DMetal and DXMT. You can turn it off in Settings.
- Per-game settings: graphics backend, frame limit (Off, 30, 60, 90 or 120), display, Retina mode, DirectX 12 for Zenless Zone Zero and a switch for the compatibility workaround.
- Metal HUD. A switch in each game's settings shows the frame rate, frame time and GPU load over the game. On D3DMetal, Shift-F9 hides or shows it while you play. You choose what it shows, where it sits and how large it is.
- Play time. A capsule above Play shows how long you have played each game, and the game's menu shows the last session. It counts only time the game was running, stays on your Mac and includes your earlier sessions from MacGacha's log.
- External drives and moving games. Games can live on an external drive. When it's disconnected, the game names the drive to connect, and a download or update on it pauses until you resume it with the drive back. Move… in a game's menu moves it to another folder or drive: instantly on the same drive, otherwise by copying and checking every file before the old folder is removed. A pre-download moves with the game. If you cancel or a drive is disconnected before the copy finishes, the game stays where it was.
- Download speed limit. Unlimited by default, or any value you type in Settings, from 0.1 MB/s, for game installs, updates and pre-downloads. A change applies right away, even during a download.
- Notifications. While MacGacha is in the background, it says when an install, update or repair finishes, fails or stops for disk space, and when a new game version or pre-download appears. A switch in Settings turns them off.
- Storage. A Storage panel shows the space each game, its Wine prefix and its pre-download take, plus Wine, logs and caches, and lists what can be freed, such as old runtime versions and prefixes of removed games. Each removal asks first.
- Wish history export (opt-in). With the switch on in Settings, Export Wish History… in a game's menu saves your wish history as a UIGF 4.2 file for other trackers. Open the history in the game once first. While the switch is off, MacGacha doesn't read the history link.
- Miliastra Sandbox. Install Miliastra Sandbox in Genshin Impact's menu adds the Miliastra Wonderland editor, for Global and Mainland China. The game opens it when you edit a stage or test-play it. MacGacha keeps it on the same version as the game, updates it in the background when a new version comes out and repairs it with the game. Pressing Play stops a background update first. Under Wine the game sometimes turns gray when the editor opens. Restarting the game helps.
- Game menu extras. Open Screenshots opens the game's screenshot folder. Reset Wine Prefix in game settings starts the prefix fresh on the next Play. Right-click MacGacha in the Dock to start an installed game.
- Game shortcuts. Create Shortcut in a game's menu adds the game to Applications with its icon. It starts the game through MacGacha without opening the launcher window, works from the Dock, Launchpad and Spotlight, and opens the launcher only when the game needs an update, setup or your attention. Without its window, MacGacha uses noticeably less memory in the background while you play. When the game closes, MacGacha quits again.
- MacGacha Wine 11.22. Our own Wine, built from source with every library it bundles, is the recommended Wine for both DXMT and D3DMetal (release, with complete sources). It includes the upstream crypt32 fix, so Mainland China Genshin and ZZZ no longer need our separate one. Wine 11.20 stays available for rollback. Wine and the graphics layer are separate downloads. D3DMetal requires Apple's terms or an import from your own Game Porting Toolkit.
- Dependencies window. Each graphics layer has a Wine Version list with Automatic and every compatible build, so rolling back is one click. The dependency list MacGacha downloads is signed with the project's key.
- Automatic dependency updates. On by default, with a switch in Settings. New recommended versions install in the background beside the one in use and switch over once no game or download is running. Versions you choose by hand stay as they are. The replaced version is removed after a game has run on the new one for at least two minutes and closed normally. If you imported D3DMetal yourself, Wine still updates on its own and a newer D3DMetal is offered instead. Switching to a new Wine build starts a fresh Wine prefix, so settings stored there, such as Star Rail's saved frame rate, start fresh.
- One-click setup. When a game needs runtimes, "Set Up…" lists exactly what it needs for its settings and installs it all in one go, asking for Apple's terms only when D3DMetal is part of it. The Dependencies panel stays available for picking versions by hand.
- Compatibility components. jadeite and a Steam launcher shim are installed and removed from the Dependencies window. We build the shim ourselves, reproducibly, from Valve's Proton source (release).
- Languages. The interface comes in English, Simplified and Traditional Chinese, Japanese, Korean, Russian, Ukrainian, German, French, Spanish, Portuguese, Indonesian, Thai and Vietnamese. It follows your Mac's language order, or you pick one in Settings. Game news and art follow the interface language (English for Ukrainian, which HoYoPlay doesn't offer). Changing the language restarts MacGacha, and a running download picks up again by itself.
- Automatic updates (Sparkle). Check for Updates… in the MacGacha menu and a switch in Settings. MacGacha asks before it downloads an update and installs it only when no game, recovery or installation is running. The update window shows what changed.
- Recovery. If the launcher crashes or is quit while a game runs, it finds the game again on restart and restores everything once the game exits. Quitting during a game asks first.
- Privacy. Games run in their own Wine prefix with no links to your Desktop, Documents or other home folders. Session logs stay on your Mac and can be turned off in Settings. A diagnostics bundle for bug reports removes paths and tokens.
Verified by hand (macOS 27.0.1)
All three games start and play with a community anti-cheat workaround. None of them needs /etc/hosts changes or administrator rights. Measured on a MacBook Pro 14″ with M5 Pro (48 GB) and on a base M5 (16 GB). Zenless Zone Zero used the same graphics preset on both.
| Game | Default backend | M5 Pro, 48 GB | M5, 16 GB |
|---|---|---|---|
| Honkai: Star Rail 4.6 | D3DMetal, 60 fps cap | 60 fps on Ultra. About half the CPU of DXMT, GPU time about 6.5 ms against 9 ms. | Not measured yet. |
| Zenless Zone Zero | D3DMetal, DirectX 12 | 120 fps on High, battle dips stay above 115. With ray tracing on Low, 70–90 fps. | 70–110 fps on High in battle, depending on how many enemies and effects are on screen. With ray tracing on Low, 50–60 fps. |
| Genshin Impact 7.1 | D3DMetal, 60 fps cap | Steady 60 fps on Ultra at 1800×1169 with render scale 1.2, even frame time. With the frame-rate unlock, 120 fps. | 60 fps at 1512×982 with render scale 1.2. |
DXMT works for every game and stays available as the open-source alternative. The 60 fps cap fixes uneven frame pacing in Star Rail and Genshin, and it can be changed per game.
In progress
- Mainland China editions (beta). A region switch in Settings shows 原神, 崩坏:星穹铁道 and 绝区零 with their own installs, prefixes and settings. 绝区零 installs from the miHoYo servers and runs past the login screen with our Wine crypt32 fix. A tester logged in and played 原神 7.2 with D3DMetal. 崩坏:星穹铁道 still needs in-game testing, and login on 绝区零 hasn't been tested. Testers with mainland accounts are welcome.
- Star Rail's in-game hotfix restart. In the one test so far the game came back without its login window. Starting it again from MacGacha logged in normally.
- Release day with a pre-download, which waits for the next game version to be tested end to end.
Next
- Spatial Audio head tracking. Follow headphone motion during spatial playback.
Found a bug or have an idea? Open an issue and say what you did and what happened, with your Mac model, macOS version, the game and its graphics backend. For problems with installing or launching, attach a diagnostics bundle: Diagnostics in the sidebar → Export Diagnostic Bundle…. It removes paths and tokens.
Use at your own risk. To run under Wine, MacGacha uses community anti-cheat workarounds (jadeite, a Steam launcher shim). They may conflict with HoYoverse's Terms of Service, and a ban is possible, even if unlikely. If you're worried, try it first with a new free-to-play account.
By default MacGacha downloads games only from HoYoverse's official servers and verifies every file. It doesn't change the game process, never edits /etc/hosts and never asks for your password. Each game runs in its own Wine prefix with no access to your Desktop or Documents.
Optional features that do change the game process, such as the Genshin Impact frame-rate unlock, are off by default. Before you turn one on for the first time, MacGacha warns you about the extra ban risk.
MacGacha is an unofficial, community project. It is not affiliated with, endorsed by, or supported by HoYoverse (COGNOSPHERE) or Apple Inc. All game names and trademarks belong to their respective owners.
- Using third-party launchers may conflict with HoYoverse's Terms of Service. Use at your own risk.
- Under Wine, the games' anti-cheat stops them from starting. To launch them, MacGacha uses community workarounds: jadeite for Star Rail, which also blocks one game server through a local proxy while the game runs, and a Steam launcher shim for Genshin Impact and Zenless Zone Zero. These workarounds may conflict with the Terms of Service and could lead to an account ban. By default, MacGacha doesn't change the game process. Optional features that do, such as the Genshin Impact frame-rate unlock, are off by default, and MacGacha warns you about the ban risk before you enable them.
- The software is provided as is. The authors aren't responsible for account bans, data loss or any other damage.
- D3DMetal and the Game Porting Toolkit are © Apple Inc. and licensed under Apple's terms. The launcher will ask you to accept those terms before it downloads the component.
- DXMT: a Metal-based Direct3D 11 translation layer, one of MacGacha's two graphics backends.
- jadeite: the anti-cheat workaround MacGacha uses for Star Rail.
- genshin-fps-unlock: the frame-rate unlocker whose method MacGacha's Genshin Impact unlock uses.
- The Wine project, and CodeWeavers for CrossOver's open-source Wine.
- 3Shain for DXMT and yaagl, whose launch research MacGacha builds on.
- dbc-hbin for the Wine 11.20 fork that MacGacha Wine is built from, and for the Wine 11.20 + D3DMetal builds.
- HouSisong for HDiffPatch, the MIT-licensed patch decoder.
- mkrsym1 for jadeite.
- 34736384 for genshin-fps-unlock, whose method our Genshin Impact frame-rate unlock uses.
- Valve for Proton, the source of our Steam launcher shim.
- an-anime-team, whose bug tracker traced the Mainland China crash (AAGL #572), and Michael Nelson for the upstream Wine fix (MR 11824).
- Apple for D3DMetal and the Game Porting Toolkit.
Copyright (C) 2026 deruta74. MacGacha is free software under the GNU General Public License v3.0, with one additional term under GPL section 7(b) (see NOTICE): the link to the original project, https://github.com/deruta74/MacGacha, must be kept by every conveyed (distributed) copy and every distributed work based on MacGacha, both in its source and in its About screen. Private modifications that aren't distributed aren't affected. Any distributed version, modified or paid, must stay under GPL-3.0 with its source available.
Components the launcher downloads at runtime (MacGacha Wine and other Wine builds, DXMT, D3DMetal, jadeite, the Steam shim, the surround-audio module and the Genshin frame-rate helper) and the games themselves are under their own licenses and terms.







