A cross-platform launcher for FINAL FANTASY XIV v1.23b — the original 1.0 iteration of the game, not A Realm Reborn.
Garlemald Client detects an installed 1.x client, patches it forward to
2012.09.19.0001, runs the login handshake against a private server,
and launches ffxivgame.exe from the same Rust codebase on macOS
(including Apple Silicon), Linux, and Windows. On macOS and Linux it
also downloads and manages its own Wine runtime, so there is nothing
to install beyond the launcher itself.
Created with Claude.
- Single Rust codebase targeting macOS (Apple Silicon and Intel), Linux, and Windows
- Automatic detection of existing FFXIV 1.x installs — CrossOver bottles, Whisky prefixes, and manual Wine installs all work
- Self-managed Wine runtime on non-Windows hosts; no external Wine setup required
- CRC32-verified patch download and ZiPatch apply,
2010.09.18.0000→2012.09.19.0001 - Embedded WebView login flow with session-token handoff to the game binary
- Lobby hostname injected into the PE at launch time, so the same client binary can target any private server
Requires Rust 1.95.0 (pinned in rust-toolchain.toml; rustup
installs it automatically on first build). On Linux, gtk3 and
webkit2gtk-4.1 runtime libraries are needed for the login WebView.
cargo build --release
cargo run --releaseFor a distributable macOS .app bundle:
scripts/package-macos.sh # host arch, ad-hoc signed
scripts/package-macos.sh --universal # x86_64 + aarch64 fat binaryGarlemald Client derives from upstream projects under copyleft and
permissive licenses. See NOTICE.md for attribution to
Project Meteor Server, Seventh Umbral, and the wider FFXIV 1.0
preservationist community — plus a companion acknowledgment of
LandSandBoat (and its
DarkStar Project ancestor), the FFXI server emulator that the
sister project garlemald-server uses as its structural reference
for the XI-inherited portions of FFXIV 1.x gameplay. See
LICENSE.md for the full terms of the
GNU Affero General Public License, version 3 or later, under
which this project is distributed.
- Garlemald-Server — the Rust FFXIV 1.23b server (lobby / world / map) this launcher is designed to connect to.
- XIV-1.0-Apple-Silicon-Installer — helper for getting a working FFXIV 1.x install on Apple Silicon Macs, which Garlemald Client can then detect and drive.
Questions, bug reports, or just want to talk about the project? Join the Discord: