XIV 1.0 Apple Silicon Installer

One-command FFXIV 1.0 install for Apple Silicon Macs.

Shell

Installer

MIT

macOS

Apple Silicon

XIV 1.0 Apple Silicon Installer

Bahamut is the new home of the FINAL FANTASY XIV 1.23b development I am working on moving forward. If you'd like to participate as a developer or tester, or try our hosted server, join our Discord: https://discord.gg/GUDC2pDNGD

A single-command installer that brings the original FINAL FANTASY XIV 1.0 — the 2010 release, not A Realm Reborn — up on an Apple Silicon Mac. Given the retail install disc or its ISO, install.sh handles every step through to a playable ffxivboot.exe.

Under the hood it downloads the Sikarugir wrapper Frameworks and a CrossOver-built Wine engine, provisions a dedicated Wine prefix, and drives the stock ffxivsetup.exe through to completion. Everything it produces lives inside ./target/ next to the script — no Homebrew, no /usr/local, and no admin rights required.

This repository ships the installer and its documentation. It does not redistribute the FFXIV 1.0 client; you must supply your own retail disc or ISO.

Created with Claude.

Features

One idempotent script. Re-running skips any step whose output already exists, so failed runs can be resumed without cleanup.
Self-contained runtime. Sikarugir Frameworks and the CrossOver Wine engine install under target/runtime/. Removing the repository removes the install.
Rosetta 2 auto-install. The bundled Wine engine is x86_64; the script invokes softwareupdate on your behalf if Rosetta is absent.
Automatic disc discovery. Scans /Volumes/*/ for ffxivsetup.exe — no path arguments to pass.
Local ISO staging. Copies disc contents into target/iso/disc1/ before launching the installer, so the install survives ejecting the original medium.
Post-install verification. Confirms ffxivboot.exe, ffxivupdater.exe, ffxivconfig.exe, and the expected data/ / client/ archive layout before declaring success.

Requirements

Apple Silicon Mac running macOS.
FINAL FANTASY XIV 1.0 install disc, or its ISO mounted under /Volumes/, with ffxivsetup.exe at the root.
Rosetta 2 — installed automatically by the script if missing.
Internet access on first run for the wrapper template and Wine engine downloads.

Installation

./install.sh

The script runs unattended until the InstallShield GUI appears, at which point it hands control to you for the manual click-through. Accept all defaults; in particular, leave the install path at C:\Program Files (x86)\SquareEnix\FINAL FANTASY XIV so the verification step can find the expected file layout.

Launching the game

After install.sh reports "Install verified.":

cd target
source ./wine-env.sh
"$WINE" "$WINEPREFIX/drive_c/Program Files (x86)/SquareEnix/FINAL FANTASY XIV/ffxivboot.exe"

wine-env.sh exports WINEPREFIX, WINE, WINESERVER, and the library paths the bundled engine expects. Source it from any shell session before invoking Wine directly.

Repository layout

After a successful install, the layout of target/ is:

target/
├── runtime/
│   ├── Frameworks/      bundled dylibs from the Sikarugir wrapper
│   └── wswine.bundle/   CrossOver Wine engine (bin/, lib/, share/)
├── prefix/              WINEPREFIX — the Wine C: drive
├── iso/disc1/           local copy of the install disc contents
└── wine-env.sh          source to activate the local Wine

Troubleshooting

Symptom	Likely cause and resolution
`No mounted volume under /Volumes/ contains ffxivsetup.exe`	The ISO isn't mounted, or the mounted disc isn't the 1.0 client. Double-click the 1.0 `.iso` in Finder and re-run the script.
`Wine engine failed to execute`	Rosetta 2 is not active. Run `softwareupdate --install-rosetta --agree-to-license` and retry.
Verification reports too few `data/` or `client/` subdirectories	The InstallShield GUI was cancelled, or a non-default install path was chosen. Delete `target/prefix/drive_c/Program Files (x86)/SquareEnix/` and run `install.sh` again.

Licensing and attribution

The installer script and the documentation in this repository are distributed under the MIT License. See LICENSE.md for the full terms and a per-component breakdown of the third-party software fetched at runtime — the Sikarugir wrapper, the CrossOver Wine engine (Wine itself is LGPL-2.1-or-later), and the FFXIV 1.0 client (© SQUARE ENIX CO., LTD., not redistributed).

Sister projects

Garlemald Server — Rust port of Project Meteor's FFXIV 1.23b server emulator (lobby / world / map) that the install produced by this script can connect to.
Garlemald Client — cross-platform Rust launcher that detects the install produced by this script and drives it against a private server.

Community

Note: development has moved from the Garlemald Discord to the Bahamut Discord. The link below points there now.

Development discussion, bug reports, and direct contact with the maintainer happen on the Bahamut Discord:

https://discord.gg/GUDC2pDNGD