Guide

1. Vérifier le toolkit avant de continuer

Cette procédure exige l’ancienne interface de scripts de GPTK sur un Mac avec puce Apple. Le README de GPTK 1.0 (copie archivée) indique macOS 14 Sonoma, Rosetta 2, Xcode 15 ou ses Command Line Tools, et Homebrew x86-64 comme prérequis. Il recommande au moins 16GB de mémoire pour les jeux exécutés par traduction. Cette procédure ne concerne ni les Mac Intel, ni CrossOver, ni les versions actuelles de GPTK ; sa compatibilité avec les versions plus récentes du toolkit n’est pas établie.

1. Récupérez le toolkit dans les téléchargements Apple ; une connexion à un compte Apple peut être nécessaire. Suivez le README fourni avec votre paquet pour installer son environnement Wine, les bibliothèques de passerelle graphique et les scripts de lancement.
2. Vérifiez que le paquet fournit gameportingtoolkit et gameportingtoolkit-no-esync, qui prennent tous deux le dossier du préfixe en premier argument et le chemin Windows de l’exécutable entre guillemets en second. La commande de création du préfixe ci-dessous exige aussi son installation Homebrew x86-64 de game-porting-toolkit.
3. Exécutez ces commandes dans Terminal pour vérifier que les deux scripts de cette installation du toolkit sont disponibles :

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

Si l’un des scripts manque ou si votre paquet utilise d’autres commandes, arrêtez-vous ici et terminez sa configuration documentée. Ne mélangez pas des composants de versions différentes du toolkit. Prévoyez de la place pour le toolkit, le préfixe, le jeu et les futurs mods ; le lanceur fournit une estimation d’espace pour le téléchargement du jeu.

2. Utiliser un environnement Windows distinct

Un préfixe contient le lecteur C: virtuel de Wine, son registre et les fichiers utilisateur Windows. L’environnement d’exécution, le lanceur et le jeu doivent tous utiliser le même préfixe.

Ces commandes utilisent ~/eldewrito-prefix. Si ce dossier existe déjà, choisissez un nom inutilisé et remplacez eldewrito-prefix de manière cohérente dans toutes les commandes. Gardez ElDewrito dans son propre préfixe, séparé des autres jeux et des anciennes installations.

Dans l’environnement Homebrew x86-64 préparé à l’étape 1, créez le préfixe avec le Wine du toolkit :

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

Dans Wine configuration, sélectionnez Windows 10, puis Apply, et fermez la fenêtre. Si elle ne s’ouvre pas, corrigez l’installation du toolkit avant de continuer. Effectuez les éventuelles étapes de configuration de la passerelle graphique ou du préfixe demandées par le README de votre paquet.

Dans Finder, utilisez Go > Go to Folder pour ouvrir ~/eldewrito-prefix/drive_c. Pour les programmes Windows, il s’agit de C:\. Créez-y un dossier nommé EDSetup pour les deux installateurs.

3. Installer l’environnement d’exécution de bureau Windows

1. Téléchargez launcher.exe depuis la page de téléchargement ou les versions du projet du lanceur.
2. Téléchargez le programme d’installation Microsoft .NET Desktop Runtime 6.0.36 pour Windows x64, nommé windowsdesktop-runtime-6.0.36-win-x64.exe.
3. Copiez les deux fichiers dans le dossier drive_c/EDSetup du préfixe. Ce sont des installateurs exécutables, pas des archives à extraire. Gardez-les à part du dossier définitif du jeu.
4. Lancez l’installateur de l’environnement d’exécution avec cette commande, terminez l’installation et fermez-le :

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

Utilisez Windows x64 Desktop Runtime dans le préfixe, même sur un Mac avec puce Apple. Il fournit les composants Windows .NET 6 nécessaires au lanceur ; vous n’avez besoin ni de l’environnement d’exécution macOS ni du SDK.

4. Installer ElDewrito dans ce préfixe

Ouvrez le lanceur d’installation avec le même préfixe :

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

1. Sélectionnez Next et laissez le lanceur trouver la version disponible.
2. Choisissez une nouvelle destination pour le jeu. Pour les exemples ci-dessous, utilisez C:\Program Files\ElDewrito comme dossier définitif du jeu. Vérifiez la destination complète affichée par l’installateur afin de ne pas sélectionner par erreur un dossier imbriqué ElDewrito\ElDewrito.
3. Sélectionnez Install et laissez le téléchargement et l’installation se terminer. Empêchez le Mac de se mettre en veille et gardez la destination accessible. En cas d’échec, consultez Dépannage avant de supprimer ou de réinstaller quoi que ce soit.
4. Lorsque le lanceur propose Play, fermez-le. Dans Finder, ouvrez ~/eldewrito-prefix/drive_c/Program Files/ElDewrito et vérifiez qu’il contient launcher.exe et eldorado.exe. Si vous avez installé le jeu ailleurs, utilisez le chemin Windows de ce dossier dans les commandes restantes et son chemin Finder pour modifier les fichiers.

Installez la version 0.7 dans un nouveau dossier, pas par-dessus une copie de l’époque 0.6.1. Gardez votre ancienne installation et sauvegardez votre contenu personnel avant de le migrer ; consultez Installation.

5. Configurer les menus

La procédure communautaire désactive l’accélération GPU des menus web d’ElDewrito avec Game.CEFGpuEnable 0. Fermez le jeu et le lanceur avant de modifier cette préférence.

1. Dans le dossier du jeu installé, ouvrez data. Si dewrito_prefs.cfg existe, commencez par en faire une sauvegarde distincte et notez la valeur actuelle de Game.CEFGpuEnable.
2. Ouvrez data/dewrito_prefs.cfg dans un éditeur de texte brut. Remplacez le réglage Game.CEFGpuEnable existant par la ligne ci-dessous. Si le réglage est absent, ajoutez-le une seule fois. N’ajoutez pas une deuxième entrée contradictoire.
3. Si le fichier est absent, créez dans data un fichier de texte brut nommé exactement dewrito_prefs.cfg contenant cette ligne. Vérifiez que l’éditeur ne l’enregistre pas en texte enrichi et n’ajoute pas .txt.

Game.CEFGpuEnable 0

Pour annuler cette modification, rétablissez la valeur d’origine ou supprimez la ligne si vous l’avez ajoutée. Conservez les autres préférences du fichier.

6. Lancer le jeu, rejoindre une partie et rejouer plus tard

Connectez votre manette avant le lancement, puis démarrez le jeu installé :

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

Cette commande lance le jeu avec l’option ESYNC de Wine désactivée, dans le même préfixe que le lanceur.

1. Vérifiez que les menus répondent, puis configurez vos commandes et démarrez une partie locale pour vérifier les déplacements, la visée et le son. Gardez la fenêtre du jeu active pendant le test des commandes.
2. Ouvrez la liste des serveurs et rejoignez un serveur actif. Vous pouvez consulter l’activité sur la page des serveurs du site. Laissez le contenu personnalisé requis se télécharger. Il n’est pas nécessaire de rediriger des ports pour rejoindre un serveur.
3. Quittez normalement. Réutilisez la même commande et le même préfixe à chaque fois que vous revenez jouer.

Consultez Jouer pour les commandes et la connexion aux parties, ou Contenu personnalisé pour les mods.

Mises à jour et remise en état

Lancer directement eldorado.exe contourne le lanceur. Pour rechercher les mises à jour avec le lanceur, ouvrez le lanceur installé dans le même préfixe, pas la copie temporaire d’installation :

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

Fermez le jeu avant la mise à jour. Une fois le travail du lanceur terminé, fermez-le et utilisez la commande de lancement du jeu ci-dessus. Avant de changer le toolkit, de déplacer le jeu ou de modifier des préférences, quittez tous les programmes Windows du préfixe et sauvegardez les fichiers concernés. Incluez les dossiers de jeu ou personnels stockés hors du préfixe ; Wine peut aussi y accéder.

Si une fenêtre signale un environnement d’exécution manquant, vérifiez que son installateur et le lanceur ont utilisé le même préfixe. Pour une erreur de fichier introuvable, comparez le chemin Windows entre guillemets avec le fichier sous drive_c ; Program Files contient un espace, pas un tiret bas. Pour les autres problèmes, consultez Dépannage. Lorsque vous demandez de l’aide, indiquez la puce de votre Mac, la version de macOS, celle du toolkit/Wine et le texte de l’erreur.