Repository navigation
Releases
MacGacha 0.3.5
MacGacha 0.3.5
- Miliastra Sandbox. Genshin Impact's Miliastra Wonderland editor can now be installed from the game menu, for Global and Mainland China. Once installed, MacGacha keeps it on the same version as the game and updates it in the background when a new version comes out. Pressing Play stops a background update first. Before this, updating the game left an older editor in place and test play could fail. MacGacha also switches the editor to software rendering, because its window stays blank under Wine otherwise.
- If the game turns gray. When the editor opens, Genshin Impact sometimes turns gray and stops responding. Quit the game and start it again. It usually works on the next try. We're looking into the cause.
- Clearer startup failures. When a game can't reach its servers, for example on school or work Wi-Fi that blocks them, the footer now says so instead of only reporting that the game closed. Launch failures show in a highlighted capsule with Open Log, and the version and play time stay visible.
- Fixes. The background video no longer plays fast after the launcher was in the background for a while.
MacGacha 0.3.4
MacGacha 0.3.4
- Any download speed. The download limit in Settings is now a switch with a field for your own value in MB/s, instead of a few fixed choices.
- Opens on your last game. The launcher opens on the game you last opened or started, including a start from a shortcut or the Dock menu.
- Dock icon while a game starts. MacGacha's Dock icon shows a spinning badge from Play until the game window appears. This helps most with game shortcuts, where the launcher window stays hidden.
- Fixes. Zenless Zone Zero (Mainland China) could show a blank captcha window at login. MacGacha now clears the game's saved WebView render setting before each launch. Game settings no longer grow taller than the launcher window. They scroll instead and follow the window when you resize it.
MacGacha 0.3.3
MacGacha 0.3.3
- MacGacha Wine 11.22. Our Wine moves to 11.22 for both DXMT and D3DMetal and arrives with automatic dependency updates. It includes the upstream certificate fix, so the separate crypt32 fix for Mainland China Genshin and ZZZ is no longer needed with it. Surround sound has a matching 11.22 module. Wine 11.20 stays available in Dependencies if you want to go back. Switching Wine starts a fresh prefix.
- Download speed limit. Settings now has a Download speed choice: Unlimited, or 5 to 100 MB/s. It applies to game installs, updates and pre-downloads, and a change takes effect right away, even during a download.
- Notifications. While MacGacha is in the background, it tells you when an install, update or repair finishes, fails or stops for disk space, and when a new game version or pre-download appears. Click a notification to open that game. A switch in Settings turns them off.
- Storage. A new Storage panel in the sidebar shows how much space each game, its Wine prefix and its pre-download take, plus Wine, logs and caches. "Can be freed" lists what MacGacha no longer needs, such as old runtime versions and prefixes of removed games. Remove items one by one or all at once with Remove All, always after you confirm.
- Wish history export (opt-in). Turn it on in Settings, open the wish history in the game once, then choose Export Wish History… in the game's menu. MacGacha saves your history as a UIGF 4.2 file that other wish trackers can import. It is off by default, and while it's off MacGacha doesn't read the game's history link at all.
- Open Screenshots in a game's menu opens the folder where the game saves its screenshots.
- Reset Wine Prefix in game settings recreates the game's Wine prefix on the next Play, which often helps when a game stops starting after a change. Game files and logins saved in the game folder are kept.
- Game shortcuts. Create Shortcut in a game's menu adds the game to Applications with its icon, so you can keep it in the Dock or find it in Spotlight. It starts the game without opening the launcher, which only appears when the game needs an update, setup or your attention. When the game closes, MacGacha quits again.
- Play from the Dock. Right-click MacGacha in the Dock to start an installed game.
- Metal HUD options. Choose what the HUD shows (Apple's standard set, frame rate only, a full set or your own selection), where it sits on screen and how large it is, separately for each game.
- A tidier launcher. The game's version and your play time sit in two small capsules above Play, the line above them only appears when there's something to say, the video switch only shows on animated backgrounds, and an available pre-download is a round icon beside Play.
- Fixes. Opening the launcher could show "Another operation is already running" and a Set Up button even though everything was installed. The Settings window now fits on smaller screens and scrolls.
surround-audio-wine-11.22-1
Wine 11.22 surround audio component
This component modifies the Unix CoreAudio driver of MacGacha Wine 11.22.
Wine and the MacGacha audio patch/probes are LGPL-2.1-or-later. Wine copyright
and license notices remain in the original source headers and COPYING.LIB.
Only the x86_64 Unix module is distributed. No PE DLL, game modification or
Apple graphics payload is included. System audio frameworks remain supplied
by macOS.
The official Wine 11.22 archive is pinned to SHA-256
f172e9c1be73e862057deae1f0e03ce95919986c5df8a18e1c0829c34863c9ee
from https://dl.winehq.org/wine/source/11.x/wine-11.22.tar.xz.
The same checksum-pinned compatibility delta and fork build support as
MacGacha Wine 11.22 are retained under build-inputs/compat/wine. Corresponding
source consists of those exact original source archives, the Wine compatibility
delta and the separate audio patch, with their retained build scripts and locks.
The complete Wine 11.22 source-delivery archive also retains both original
archives. No installed runtime is used as a build input.
Component surround-audio-wine-11.22-1 is ABI-scoped to
d3dmetal-wine11.22mg1.0-gptk4.0b3. It must not be selected for Wine 11.20.
Wine 11.20 component identities and ABI scopes remain separate.
The exact MACGACHA_SURROUND=1 opt-in gate, virtual endpoint namespace,
mono/stereo-device eligibility, native multichannel handling, spatial output
routing and channel-preserving stereo fallback retain the original behavior.
The shared spatial headers are unchanged. Wine 11.22's stock mixer remains
active only on the stock path. Shared runtimes, prefixes and game files are
not modified by installing this component.
Synthetic fake-AudioUnit and abort-only dyld probes establish module packaging
and controlled behavior. They do not establish device or game audio quality.
Runtime catalog revision 4
Compatible runtime component catalog. This is not an application update.
MacGacha Wine 11.22 - Version 1.0
MacGacha source-built Wine 11.22 candidate
Base: official Wine wine-11.22, commit
9f8c4ae4d35c7ff4153267aba9618c026f5f5583.
The WineHQ source archive and detached release signature are recorded in
source-runtime-11.22.lock.json. Wine remains LGPL-2.1-or-later.
See COPYING.LIB, AUTHORS and NOTICES.md in the runtime.
The compatibility delta carries the paired MSync client/server, ARM64 server
support for x86 clients, D3DMetal bridge, FSR bridges, cursor handling and
resource lifetime corrections from the exact Wine 11.20 fork input retained
in the lock. Its complete original archive accompanies the candidate sources.
The macOS driver reconciles those changes with Wine 11.22 IOSurface rendering.
Protocol tables are regenerated from the Wine 11.22 protocol plus the retained
extensions. The independent opt-in Dock icon patch is also applied.
MR 11824 is already upstream. No crypt32 correction is applied.
Only the three named build/staging scripts are copied from the fork archive.
Runtime source changes enter through the checksum-pinned compatibility delta.
The original inputs, complete delta, build scripts and receipts accompany the
candidate under source-inputs. This is a new build and requires qualification.
Dependencies and tools are built from the pinned source-build.lock.json inputs.
Their configuration and source-delivery limits remain documented in
SOURCE-NOTICE.md. Runtime dependency notices remain under share/licenses and
lib/GStreamer.framework/Versions/1.0/share/licenses.
Apple graphics and sidecars are excluded. DXMT and consented D3DMetal are
separate inputs. The Wine 11.20 Surround module is not qualified for this ABI
and must not be loaded into Wine 11.22. A separate rebuild is required.
MacGacha build orchestration and wrapper are GPL-3.0-only with the project
NOTICE term. This local candidate does not authorize publication.
MacGacha 0.3.1
MacGacha 0.3.1
- 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.
- Play time. The line above Play shows how long you have played each game, and the game's menu shows the last session. Only time the game was actually running counts, and your earlier sessions from MacGacha's log are included. It stays on your Mac.
- Games on external drives. If the drive with a game is disconnected, the game shows which drive to connect instead of looking uninstalled. A download or update on that drive pauses and continues with Resume once the drive is back.
- Move a game. Move… in a game's menu moves it to another folder or drive. On the same drive it's instant. To another drive, MacGacha copies the game, checks every file and only then removes the old folder. 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.
MacGacha 0.3.0
MacGacha 0.3.0
- MacGacha Wine 11.20. Our own Wine build, made from source, is now the recommended Wine for both DXMT and D3DMetal. Wine and the graphics layer are separate downloads, and D3DMetal still needs Apple's terms or your own Game Porting Toolkit.
- Automatic dependency updates. MacGacha installs new recommended versions of Wine and other dependencies in the background and switches to them once no game or download is running. Versions you choose by hand stay as they are. You can turn this off in Settings.
- Old versions clean up after themselves. The version an update replaced stays installed until a game has run on the new one for at least two minutes and closed normally. Then MacGacha removes it. Shared components and versions you pinned stay.
- Imported Game Porting Toolkit. Wine updates keep your imported D3DMetal. A newer D3DMetal is offered instead of installed, and skipping it only skips that version.
- Redesigned Dependencies. Each graphics layer has a Wine Version list with Automatic and every compatible build, so rolling back is one click. Rows show the build version, and background updates show their progress on the card.
- Signed dependency list. MacGacha only accepts a dependency list signed with the project's key.
- Steadier downloads. Fast connections no longer pause for a second or two every few seconds while files are written to disk.
Switching to a new Wine build creates a fresh Wine prefix for each game. Settings stored there, such as Star Rail's saved frame rate, start fresh. Your game files and saved logins are not affected.
Runtime catalog revision 3
Compatible runtime component catalog. This is not an application update.
MacGacha Wine 11.20 · Version 1.0
MacGacha Wine 11.20, version 1.0. A Wine runtime built from source for MacGacha. MacGacha downloads it as a dependency, so there is nothing to install by hand.
- Wine 11.20 fork: https://github.com/dbc-hbin/wine-yaagl-d3dmetal at commit a05983676741c558ac46937a29a93e02b38de8c7, with the Dock icon patch from
compat/dock-icon. - Every bundled library is built from pinned source archives. The sources archive contains the Wine source, all dependency sources, build scripts, configuration arguments and build receipts.
- Apple D3DMetal is not included. MacGacha adds it only after you accept Apple's license, or from your own Game Porting Toolkit.
Wine is licensed under LGPL-2.1-or-later. Notices are in COPYING.LIB, AUTHORS, NOTICES.md and share/licenses. The MacGacha build scripts are GPL-3.0-only.
| File | SHA-256 |
|---|---|
| wine-11.20-macgacha-1.0.tar.xz | c3b9d33653c6585fed36edf819e6239cae5a385f87fd4f0e2d093c848f15ec7e |
| wine-11.20-macgacha-1.0-sources.tar.xz | a9fc5ca325c1aeaa0a861883fd50361c0c45a1f04bed1363f01e165acf104ab8 |