Getting Started
Mac Setup (Apple Silicon)
Running Crushbone natively on Apple Silicon Macs via CrossOver 26 and GPTK 2.x.
Crushbone runs on Apple Silicon Macs (M1/M2/M3/M4) via CrossOver 26 with GPTK 2.x enabled. This is a working, tested setup — the server's primary playtest rig runs this way.
Prerequisites
- Apple Silicon Mac (M1/M2/M3/M4).
- macOS 14 (Sonoma) or later.
- CrossOver 26 installed (commercial, codeweavers.com).
- Sufficient disk space (~8 GB for client + bottle).
Steps
1. Install CrossOver and enable GPTK
- Install CrossOver 26 from Codeweavers.
- In CrossOver preferences, enable GPTK 2.x (Apple's Game Porting Toolkit).
2. Create a Crushbone bottle
- Open CrossOver.
- Create a new bottle. Name:
Crushbone-RoF2. - Windows type: Windows 10 (important; Windows 11 compatibility is less stable).
3. Install the client
- Download
crushbone-client-v1.0.zipfrom the Get Started page (or Discord#downloads). - Unzip to
~/Games/everquest_rof2/— NOT~/Downloads. macOS TCC permissions block the Dock from reaching~/Downloads, which breaks running the game by double-click. - Point the CrossOver bottle at
~/Games/everquest_rof2/.
4. Install the winmm.dll shim
The CPUHighSpeedFix shim is bundled with the client. It prevents the game clock from running at 2× speed on Apple Silicon.
If you need to force Wine to load the shim, set WINEDLLOVERRIDES="winmm=n,b" in the bottle's environment.
5. Launch
In CrossOver, open the Crushbone-RoF2 bottle and use Run Command:
- Command:
~/Games/everquest_rof2/eqgame.exe - Arguments:
patchme
Hit Save as Launcher so you can re-run with one click. Always launch with the patchme argument — without it, the client tries to reach a patch server that doesn't exist and hangs.
First login: blank account form. Create an account in-game, then a character. Server-select dropdown will show Crushbone (Alpha Testing).
Troubleshooting
- Client crashes on right-click merchant — swap the bad UI XML. See Client XML crashes.
- Game runs 2× speed — winmm.dll shim not loaded. Verify the CPUHighSpeedFix shim is in the client dir and Wine is overriding the system winmm.
- Can't find game window — check that CrossOver shows the bottle as running.
- Black screen on login — GPTK 2.x must be enabled.
Future: CBZ (Crushbone Zeal)
The server's own client QoL mod is CBZ — Crushbone Zeal. It's being built on solar984's framework. When released, install via the same directory drop as the winmm.dll shim.
