What is this?
Muguet is a native Mach-O port of GTA V for iOS and macOS with added multiplayer, running the game's original WebAssembly code outside the browser using wasmtime and wgpu on Metal instead of a browser's JS/WebGPU stack.
Muguet is a native Mach-O port of GTA V for iOS and macOS with added multiplayer, running the game's original WebAssembly code outside the browser using wasmtime and wgpu on Metal instead of a browser's JS/WebGPU stack.Is this a browser wrapper or a real native game?It is a real native app: Muguet throws away the browser layer (JS engine, WebGPU, Web Audio) and runs the same game.wasm natively, compiling its code to native arm64 (cached on launch for macOS, baked in at build time for iOS) with wasmtime for code execution and wgpu on Metal for rendering.
It is a real native app: Muguet throws away the browser layer (JS engine, WebGPU, Web Audio) and runs the same game.wasm natively, compiling its code to native arm64 (cached on launch for macOS, baked in at build time for iOS) with wasmtime for code execution and wgpu on Metal for rendering.How do I build and install it?Build macOS with a plain cargo build, which outputs build/Muguet.app directly; for iOS add the --ipa flag (plus FREE=1 and a BUNDLEID for a free developer account) to get build/Muguet.ipa, which you then install with AltStore.
Build macOS with a plain cargo build, which outputs build/Muguet.app directly; for iOS add the --ipa flag (plus FREE=1 and a BUNDLEID for a free developer account) to get build/Muguet.ipa, which you then install with AltStore.What do I need installed before building this?An Apple Silicon Mac on macOS 14 or later, Xcode 26 or later, and the Rust toolchain; for iOS builds you additionally need rustup toolchain 1.98.1 with the aarch64-apple-ios target, xcodegen (via Homebrew), and an Apple developer account.
An Apple Silicon Mac on macOS 14 or later, Xcode 26 or later, and the Rust toolchain; for iOS builds you additionally need rustup toolchain 1.98.1 with the aarch64-apple-ios target, xcodegen (via Homebrew), and an Apple developer account.Any known limitations I should expect?The minimap doesn't render, story missions are single-player only, iOS needs the increased memory limit entitlement enabled, and sideloading via Sideloadly or SideStore probably won't work well, so AltStore is the recommended install method.
The minimap doesn't render, story missions are single-player only, iOS needs the increased memory limit entitlement enabled, and sideloading via Sideloadly or SideStore probably won't work well, so AltStore is the recommended install method.Does it run on Intel Macs too, or only Apple Silicon?Only Apple Silicon Macs are supported, running macOS 14 or later; there is no mention of Intel Mac support.
Only Apple Silicon Macs are supported, running macOS 14 or later; there is no mention of Intel Mac support.Where do I get the GTA V game files?You need to supply your own .zip of the original game data (the folder containing data/ and b/, with game.wasm and shaders/) — essentially the same files the official web port uses — and Muguet will prompt for that zip on first run.
You need to supply your own .zip of the original game data (the folder containing data/ and b/, with game.wasm and shaders/) — essentially the same files the official web port uses — and Muguet will prompt for that zip on first run.How does multiplayer actually work?One player hosts from the launcher (or runs the standalone muguet-server binary on any machine), and other players join using that host's address over UDP port 47520.
One player hosts from the launcher (or runs the standalone muguet-server binary on any machine), and other players join using that host's address over UDP port 47520.Do I need a paid Apple developer account?No, it also works with a free developer account if you build with FREE=1 and your own BUNDLEID, though you'll need AltStore to get the resulting .ipa onto your iOS device.
No, it also works with a free developer account if you build with FREE=1 and your own BUNDLEID, though you'll need AltStore to get the resulting .ipa onto your iOS device.Can an iPhone run this comfortably?It needs an iOS 15 or later device, and the README recommends around 8 GB of RAM for a smooth experience; you must also enable the increased memory limit entitlement.
It needs an iOS 15 or later device, and the README recommends around 8 GB of RAM for a smooth experience; you must also enable the increased memory limit entitlement.