AuRO Whisky MacOS Setup

uaRO on Apple Silicon, via Whisky

**This repo is one file that installs the uaRO Windows game on your Mac by talking to an AI, not by reading instructions yourself.**

[`SKILL.md`](./SKILL.md) is a self-contained playbook written *for an AI coding agent* (Claude Code, OpenAI Codex, or GitHub Copilot) to read and execute, not for a human to follow by hand. Hand it the file, say "install uaRO," and it drives the whole thing end to end. Curious what that actually involves? Open `SKILL.md` — it's all in there.

Want AzzyAI (the third-party mercenary/homunculus auto-attack AI) too — installing it fresh, or already have it but it won't actually attack anything? Both are a separate, later-stage topic covered in [`AZZYAI_FIXES.md`](./AZZYAI_FIXES.md), not this file.

The problem this solves

[uaRO](https://uaro.net/) (a Ragnarok Online private server) is a Windows-only game protected by **Gepard Shield 3.0** anti-cheat. The obvious approach — run it in a **Windows 11** VM (VMware Fusion) — turned into a dead end:

• More virtual CPUs → Gepard threw an error almost immediately.
• Fewer virtual CPUs → avoided the error, but the game stuttered badly within seconds.
• Disabling Windows Defender, or whitelisting the game instead → no effect either way.
• Every Visual C++ Redistributable from 2005 through 2026, x86/x64/ARM → no effect.
• Every graphics tweak (resolution, texture quality, DirectX version, graphics device, windowed vs. fullscreen) → no effect.

None of it mattered, because the actual blocker was never performance — it was Gepard Shield not working well with the **Windows 11 on ARM** processor that a VM on Apple Silicon has to run.

The fix, and what made it hard

**Whisky** (a lightweight macOS Wine wrapper) sidesteps the problem: it translates the game's x86 Windows calls directly on macOS, no ARM Windows kernel involved. But Whisky itself is discontinued and broken in non-obvious ways:

• Its Homebrew cask and Wine-runtime download endpoint are both dead