CyderBits

Run legacy Windows games on Mac — DirectDraw & GDI first.

Built for 2D and classic Win32 graphics (DirectDraw, GDI). DXVK, Vulkan, and modern 3D pipelines are not supported yet.

CyderBits builds CrossOver-based Wine on Apple Silicon and ships two tools: Cyder — a one-click .exe launcher — and CyderBits — a packager that wraps .exe files as double-clickable macOS .app bundles.

Languages: English · 繁體中文

Cyder (launcher)

What	Open any Windows .exe with one shared Wine prefix
Engine	Shared Wine under ~/Library/Application Support/Cyder/Engines/
Docs	docs/cyder.md

bash scripts/create-cyder-app.sh
open dist/Cyder.app

CyderBits (packager)

What	Pick a Windows .exe → get a macOS game .app
Prefix	Per-game bottle under ~/Library/Application Support/Cyder/Bottles/ (Phase 1)
Docs	docs/cyderbits.md

bash scripts/create-cyderbits-app.sh
open dist/CyderBits.app

Validation game

Development and smoke tests target BlueCG (魔力寶貝), a DirectDraw PE32 title. Place the game files locally as BlueCrossgateNew/ (not in git).

bash scripts/run-bluecg.sh

Wine sources

Wine is built from the CrossOver open-source release — extract into sources/ (see CodeWeavers CrossOver Source). The tree used at build time is sources/wine/.

bash scripts/build-wine.sh
bash scripts/sign-wine.sh

Requirements

• macOS 12+ (13+ recommended)
• Apple Silicon + Rosetta 2 (Wine is an x86_64 build)
• Several GB disk for Wine sources, .brew-x86, and build outputs (most paths are .gitignored)

Quick start

1. Build Wine (first time; slow)

bash scripts/build-wine.sh
bash scripts/sign-wine.sh

2. Validate with BlueCG

bash scripts/run-bluecg.sh
bash scripts/enable-mac-retina-hires.sh   # optional Retina + 200% DPI

3. Run or wrap any EXE

# Cyder launcher — open .exe directly
bash scripts/create-cyder-app.sh
open dist/Cyder.app

# CyderBits packager — wrap .exe as a game .app
bash scripts/create-cyderbits-app.sh
open dist/CyderBits.app
# or: python3 scripts/cyder_create_game_app.py --gui

Repository layout

├── logo/                       # cyderbits.png (app icon), cyderbits-transparent.png (README)
├── config/entitlements.plist   # Wine JIT / dyld signing entitlements
├── patches/                    # Optional source patches
├── scripts/                    # Build, run, packaging
├── tests/                      # Script smoke tests
├── docs/                       # Guides (see docs/README.md)
├── sources/wine/               # CrossOver Wine sources (.gitignore)
├── .brew-x86/                  # Project-local x86_64 Homebrew (.gitignore)
├── install/wine-x86_64/        # Wine install prefix (.gitignore)
└── BlueCrossgateNew/           # BlueCG game + prefix (.gitignore)

Tests

bash tests/test-env-x86_64.sh
bash tests/test-build-wine.sh
bash tests/test-sign-wine.sh
bash tests/test-run-bluecg.sh
bash tests/test-verify-bluecg.sh

Documentation

• docs/README.md — index
• docs/cyder.md — Cyder launcher
• docs/cyderbits.md — CyderBits packager
• docs/bluecg.md — BlueCG workflow
• docs/scripts.md — script reference
• docs/superpowers/ — design specs

Sources and licensing

Wine sources come from the CrossOver open-source release. Game files and large binaries are not in git; obtain them separately (e.g. BlueCG).