Гид

1. Проверьте набор инструментов перед началом

Эта инструкция требует старого интерфейса скриптов-обёрток GPTK на Apple silicon. В README GPTK 1.0 (архивная копия) указаны macOS 14 Sonoma, Rosetta 2, Xcode 15 или его Command Line Tools и Homebrew для x86-64. Для игр, работающих через трансляцию, рекомендуется не менее 16 ГБ памяти. Это не инструкция для Intel Mac, CrossOver или современной версии GPTK; совместимость с более новыми версиями набора не установлена.

1. Скачайте набор из раздела загрузок Apple; может потребоваться вход в Apple Account. Следуя README из своего пакета, установите его среду Wine, библиотеки графического моста и скрипты запуска.
2. Убедитесь, что пакет содержит gameportingtoolkit и gameportingtoolkit-no-esync, причём оба принимают первым аргументом каталог префикса, а вторым — путь к исполняемому файлу Windows в кавычках. Для приведённой ниже команды создания префикса также нужна его установка game-porting-toolkit через Homebrew для x86-64.
3. Выполните эти команды в Terminal, чтобы проверить доступность обоих скриптов из этой установки набора:

command -v gameportingtoolkit
command -v gameportingtoolkit-no-esync

Если одного из скриптов нет или ваш пакет использует другие команды, остановитесь и завершите настройку по его документации. Не смешивайте компоненты разных выпусков набора. Оставьте место для набора инструментов, префикса, игры и будущих модов; лаунчер показывает оценку объёма загрузки игры.

2. Используйте отдельную среду Windows

Префикс содержит виртуальный диск C:, реестр и пользовательские файлы Windows в Wine. Среда выполнения, лаунчер и игра должны использовать один и тот же префикс.

В этих командах используется ~/eldewrito-prefix. Если такая папка уже есть, выберите свободное имя и последовательно замените eldewrito-prefix во всех командах. Храните ElDewrito в собственном префиксе, отдельно от других игр и старых установок.

В среде Homebrew для x86-64, подготовленной на шаге 1, создайте префикс с помощью Wine из набора инструментов:

WINEPREFIX="$HOME/eldewrito-prefix" "$(brew --prefix game-porting-toolkit)/bin/wine64" winecfg

В Wine configuration выберите Windows 10, нажмите Apply и закройте окно. Если оно не открывается, исправьте установку набора инструментов, прежде чем продолжать. Выполните все дополнительные действия по настройке графического моста или префикса, указанные в README вашего пакета.

В Finder выберите Go > Go to Folder и откройте ~/eldewrito-prefix/drive_c. Программы Windows видят эту папку как C:\. Создайте внутри папку EDSetup для двух установщиков.

3. Установите среду выполнения Windows Desktop

1. Скачайте launcher.exe со страницы загрузки или из релизов проекта лаунчера.
2. Скачайте у Microsoft установщик .NET Desktop Runtime 6.0.36 для Windows x64 с именем windowsdesktop-runtime-6.0.36-win-x64.exe.
3. Скопируйте оба файла в папку drive_c/EDSetup префикса. Это исполняемые установщики, а не архивы для распаковки. Храните их отдельно от конечной папки игры.
4. Запустите установщик среды выполнения этой командой, завершите установку и закройте его:

gameportingtoolkit "$HOME/eldewrito-prefix" 'C:\EDSetup\windowsdesktop-runtime-6.0.36-win-x64.exe'

Внутри префикса используйте Windows x64 Desktop Runtime, даже на Mac с Apple silicon. Он установит компоненты Windows .NET 6, необходимые лаунчеру; среда выполнения для macOS и SDK не нужны.

4. Установите ElDewrito в этот префикс

Откройте установочный лаунчер в том же префиксе:

gameportingtoolkit "$HOME/eldewrito-prefix" 'C:\EDSetup\launcher.exe'

1. Нажмите Next и дождитесь, пока лаунчер найдёт доступный релиз.
2. Выберите новую папку игры. Для приведённых ниже примеров используйте C:\Program Files\ElDewrito как конечную папку игры. Проверьте полный путь в установщике, чтобы случайно не получить вложенную папку ElDewrito\ElDewrito.
3. Нажмите Install и дождитесь завершения загрузки и установки. Не позволяйте Mac уходить в сон и сохраняйте доступ к папке назначения. Если установка не удалась, загляните в «Решение проблем», прежде чем что-либо удалять или переустанавливать.
4. Когда лаунчер предложит Play, закройте его. В Finder откройте ~/eldewrito-prefix/drive_c/Program Files/ElDewrito и убедитесь, что там есть launcher.exe и eldorado.exe. Если вы выбрали другое место, подставляйте Windows-путь к этой папке в оставшиеся команды, а путь Finder используйте при редактировании файлов.

Устанавливайте 0.7 в новую папку, а не поверх копии времён 0.6.1. Сохраните старую установку и резервную копию личного контента перед переносом; см. «Установка».

5. Настройте меню

Инструкция сообщества отключает GPU-ускорение веб-меню ElDewrito командой Game.CEFGpuEnable 0. Перед изменением настройки закройте игру и лаунчер.

1. В папке установленной игры откройте data. Если dewrito_prefs.cfg уже существует, сначала сделайте отдельную резервную копию и запишите текущее значение Game.CEFGpuEnable.
2. Откройте data/dewrito_prefs.cfg в текстовом редакторе. Замените существующую настройку Game.CEFGpuEnable строкой ниже. Если настройки нет, добавьте её один раз. Не создавайте вторую конфликтующую запись.
3. Если файла нет, создайте в data обычный текстовый файл с точным именем dewrito_prefs.cfg и этой строкой. Убедитесь, что редактор не сохраняет его в формате rich text и не добавляет .txt.

Game.CEFGpuEnable 0

Чтобы отменить изменение, верните исходное значение настройки или удалите строку, если добавляли её сами. Сохраните остальные настройки в файле.

6. Запустите игру, подключитесь к матчу и запускайте её снова

Подключите геймпад до запуска, затем запустите установленную игру:

gameportingtoolkit-no-esync "$HOME/eldewrito-prefix" 'C:\Program Files\ElDewrito\eldorado.exe'

Эта команда запускает игру с отключённой опцией ESYNC в Wine, используя тот же префикс, что и лаунчер.

1. Убедитесь, что меню реагируют, затем настройте управление и запустите локальную игру для проверки движения, прицеливания и звука. Во время проверки ввода окно игры должно оставаться в фокусе.
2. Откройте список серверов и подключитесь к активному серверу. Активность можно посмотреть на странице серверов. Дождитесь загрузки необходимого пользовательского контента. Для подключения к серверу проброс портов не нужен.
3. Выйдите из игры обычным способом. Для следующих запусков используйте ту же команду и тот же префикс.

Об управлении и подключении читайте в разделе «Как играть», а о модах — в разделе «Пользовательский контент».

Обновления и восстановление

Прямой запуск eldorado.exe обходит лаунчер. Для проверки обновлений откройте установленный лаунчер в том же префиксе, а не временную установочную копию:

gameportingtoolkit "$HOME/eldewrito-prefix" 'C:\Program Files\ElDewrito\launcher.exe'

Перед обновлением закройте игру. Когда лаунчер завершит работу, закройте его и используйте команду запуска игры выше. Перед сменой набора инструментов, переносом игры или изменением настроек закройте все программы Windows в префиксе и сделайте резервную копию изменяемых файлов. Включите в неё игровые и личные папки за пределами префикса: Wine тоже может обращаться к ним.

Если появляется запрос отсутствующей среды выполнения, проверьте, что её установщик и лаунчер использовали один префикс. При ошибке отсутствующего файла сравните Windows-путь в кавычках с файлом внутри drive_c; в Program Files стоит пробел, а не подчёркивание. Для остальных проблем см. «Решение проблем». Обращаясь за помощью, укажите чип Mac, версию macOS, версию набора инструментов/Wine и текст ошибки.