4.6 KiB
Jagged Alliance 3 (GOG) — runbook Mac / Apple Silicon
Машина: M1 Pro, macOS Sonoma+, bottle Whisky GOG-Install (9ee55e7c-a58e-411e-a93f-30530d4f1073).
Проверено: 2026-05-28 (установка) · 2026-06-17 (CrossOver удалён; запуск только Whisky).
Связанные документы: JA3_MAC_WITHOUT_GALAXY.md, TROUBLESHOOTING.md, GOG_GALAXY_7H_RCA.md.
Примечание (2026-06): CrossOver и связанные скрипты (
run-ja3-crossover.sh,JA3-GOG,JA3-WINE,sync-ja3-saves.sh) удалены с машины. Запуск JA3 — только через Whisky GOG-Install.
1. Быстрый путь (канон)
Установка (один раз, Whisky)
# Offline backup (5 файлов) в ~/Games/
bash ~/code/local_machine/scripts/games/gog/install-ja3-innoextract.sh
bash ~/code/local_machine/scripts/games/gog/finish-ja3-layout.sh
Запуск (каждый раз)
bash ~/code/local_machine/scripts/games/gog/run-ja3.sh
- Cmd+Tab → окно
JA3.exe - Swap: «залипший» swap после Wine не блокирует запуск — только предупреждение. Стоп: swap ≥ 4096 MB без Wine, или swap ≥ 1200 MB пока Wine/JA3 ещё работают →
reset-ja3-whisky.sh/ reboot. Обход:JA3_IGNORE_SWAP=1 - Задержка cold start: 15–60 с до появления окна — норма
2. Графика: Whisky vs D3D12
JA3 на Windows использует DirectX 12. На Apple Silicon рабочий путь раньше был CrossOver + D3DMetal — CrossOver снят.
Сейчас: run-ja3.sh запускает игру в Whisky GOG-Install:
- с GPTK/D3DMetal в bottle (если установлен Game Porting Toolkit) — D3D12;
- иначе DXVK D3D11 fallback (
-graphicsapi d3d11).
При ошибке Failed to initialize graphics subsystem / dxgi.dll not found:
brew install --cask gcenx/wine/game-porting-toolkit
bash ~/code/local_machine/scripts/games/gog/install-gptk-whisky.sh
bash ~/code/local_machine/scripts/games/gog/configure-ja3-d3dmetal.sh
bash ~/code/local_machine/scripts/games/gog/run-ja3.sh
3. Пути на диске
| Что | Путь |
|---|---|
| Игра (Whisky) | …/Containers/com.franke.Whisky/Bottles/9ee55e7c-…/drive_c/GOG Games/Jagged Alliance 3/ |
| Сейвы | …/drive_c/users/eternal/AppData/Roaming/Jagged Alliance 3/<account_id>/ |
| Логи JA3 | …/AppData/Roaming/Jagged Alliance 3/logs/JA3.exe-*.log |
4. Скрипты
| Скрипт | Назначение |
|---|---|
install-ja3-innoextract.sh |
Установка из offline backup |
finish-ja3-layout.sh |
CommonLua, реестр GOG |
run-ja3.sh |
Канон запуска |
reset-ja3-whisky.sh |
Остановить JA3/Wine в GOG-Install |
emergency-stop.sh |
Полный стоп GOG/Wine |
prepare-ja3-d3dmetal.sh / configure-ja3-d3dmetal.sh |
D3DMetal в Whisky |
Удалено (CrossOver): run-ja3-crossover.sh, setup-ja3-crossover.sh, run-ja3-wine.sh, sync-ja3-saves.sh, fix-ja3-crossover-mouse.sh.
5. Антипаттерны
| Не делать | Вместо |
|---|---|
launch-galaxy.sh / Galaxy CEF для JA3 |
run-ja3.sh |
Whisky Run JA3.exe без CWD |
run-ja3.sh (start /d) |
Дважды подряд run-ja3.sh без reset при живом JA3 |
reset-ja3-whisky.sh |
| Galaxy web-stub для JA3 | offline innoextract |
6. Быстрые команды
| Действие | Команда |
|---|---|
| Запуск | bash ~/code/local_machine/scripts/games/gog/run-ja3.sh |
| Стоп | bash ~/code/local_machine/scripts/games/gog/reset-ja3-whisky.sh |
| Стоп всё GOG/Wine | bash ~/code/local_machine/scripts/games/gog/emergency-stop.sh |
| Проверить процесс | pgrep -fl 'JA3\.exe' |
| Обход swap | JA3_IGNORE_SWAP=1 bash …/run-ja3.sh |
Полный цикл:
bash ~/code/local_machine/scripts/games/gog/reset-ja3-whisky.sh
bash ~/code/local_machine/scripts/games/gog/run-ja3.sh