PEGASUS POUR MAC - GUIDE D'INSTALLATION (1 page)
================================================

Version de test signée "ad hoc" (signature technique, sans compte Apple, non notariée) : macOS peut demander
une confirmation la première fois.

1. QUEL FICHIER ?
   - Mac avec puce Apple (M1, M2, M3, M4...) : Pegasus-Mac-arm64.tar.gz   (ou .zip)
   - Mac Intel (en général avant fin 2020)    : Pegasus-Mac-x64.tar.gz     (ou .zip)
   Pas sûr ? Menu Pomme > "À propos de ce Mac" : "Puce Apple..." = arm64, "Processeur Intel..." = x64.
   Si vous avez pris le fichier Intel sur un Mac à puce Apple, ça marche quand même : le lanceur le détecte et installe
   tout seul le jeu pour puce Apple (sinon le jeu tournerait via Rosetta, nettement plus lent).

2. INSTALLER
   Préférez le fichier .tar.gz (le plus fiable). Double-cliquez dessus dans Téléchargements : il donne "Pegasus.app".
   Si Safari ou le Finder dit "La décompression a échoué", ouvrez Terminal et collez, selon votre fichier :

       cd ~/Downloads && tar -xzf Pegasus-Mac-arm64.tar.gz          (puce Apple, fichier .tar.gz)
       cd ~/Downloads && tar -xzf Pegasus-Mac-x64.tar.gz            (Mac Intel, fichier .tar.gz)
       cd ~/Downloads && ditto -x -k Pegasus-Mac-arm64.zip .        (si vous n'avez que le .zip ; remplacez arm64 par x64 pour Intel)

   Vérifier que le téléchargement n'est pas abîmé (comparez avec la ligne du fichier SHA256SUMS.txt) :

       shasum -a 256 ~/Downloads/Pegasus-Mac-arm64.tar.gz

   Si les deux empreintes sont différentes, retéléchargez le fichier (connexion coupée en cours de route).
   Ensuite, glissez Pegasus.app dans le dossier Applications.

3. LE PREMIER LANCEMENT (app signée "ad hoc", pas encore validée par Apple)
   Cette version porte une signature technique ad hoc : macOS ne doit plus la déclarer "endommagée". En revanche
   Apple ne la connaît pas (pas de compte développeur, pas de notarisation) : selon votre méthode, macOS peut demander
   UNE confirmation, une seule fois. Dans tous les cas, ne double-cliquez pas avant d'avoir lu ce qui suit.

   MÉTHODE 1 - la plus simple, sans aucun avertissement (Terminal, puces Apple ET Intel)
   Copiez ces lignes (remplacez arm64 par x64 sur un Mac Intel), puis Entrée :

       cd ~/Downloads && tar -xzf Pegasus-Mac-arm64.tar.gz && mv Pegasus.app /Applications/
       xattr -dr com.apple.quarantine /Applications/Pegasus.app
       open /Applications/Pegasus.app

   (tar lancé depuis Terminal ne marque pas l'app comme "téléchargée" ; la ligne xattr l'assure si vous avez extrait
   autrement. Si un fichier Pegasus.app existe déjà dans Applications, supprimez-le d'abord.)

   MÉTHODE 2 - sans Terminal (double-clic sur le .tar.gz puis glisser Pegasus.app dans Applications)
   - macOS 14 ou plus ancien : clic droit sur Pegasus.app > Ouvrir > Ouvrir.
   - macOS 15 ou plus récent : double-cliquez (macOS refuse), puis Réglages Système > Confidentialité et sécurité,
     descendez jusqu'à "Pegasus a été bloqué" > Ouvrir quand même (mot de passe de votre Mac). Une seule fois.

   Si macOS affiche encore "endommagé" : envoyez à l'équipe une capture d'écran et le résultat de ces deux commandes :

       codesign -dv --verbose=2 /Applications/Pegasus.app 2>&1 | head -20
       codesign --verify --deep --strict --verbose=2 /Applications/Pegasus.app

   Dernier recours (signature faite sur votre Mac, sans compte Apple) :

       xattr -cr /Applications/Pegasus.app
       codesign --force --deep --sign - /Applications/Pegasus.app
       open /Applications/Pegasus.app

   Le moteur du jeu que le lanceur installe ensuite est préparé tout seul par le lanceur.

4. JOUER
   - Connectez-vous avec votre compte du site (e-mail + mot de passe, ou "Connexion par le site" pour Google).
   - Le lanceur télécharge le jeu (environ 150 Mo), puis Jouer ouvre le jeu.
     Au premier lancement, le jeu télécharge ses données (plusieurs Go) : prévoyez de la place et un peu de patience.
   - Les mises à jour se font toutes seules à chaque ouverture du lanceur.

5. EN CAS DE PROBLÈME
   - Un message d'erreur précis s'affiche dans le lanceur (fichier, étape, code). Notez-le.
   - Installation bloquée ou abîmée (par exemple après une mise à jour du lanceur) : fermez Pegasus, puis dans Terminal :

       rm -rf "$HOME/Library/Application Support/Pegasus/game"

     Relancez Pegasus : il retélécharge le jeu proprement. Vos réglages (dossier profile) sont conservés.
   - Si le jeu se ferme tout de suite : envoyez aussi ~/Library/Application Support/Pegasus/profile/game-output.log
   - Options > "Vérifier et réparer" : contrôle chaque fichier et retélécharge ceux qui sont abîmés.
   - Options > "Journal" : le fichier à envoyer au support (Discord) avec une capture d'écran.
   - Le jeu et ses réglages sont dans : ~/Library/Application Support/Pegasus
     (Finder > Aller > Aller au dossier... > collez ce chemin). Options > "Ouvrir le dossier" y mène aussi.

6. SI C'EST LENT
   Le jeu a un "Mode performance (Mac)", activé par défaut sur Mac : il retire le flou des fenêtres et les animations
   décoratives, limite le profil graphique proposé au premier lancement et la finesse Retina de l'image du monde.
   a) Au tout premier lancement le jeu vous propose un profil de qualité graphique ("QUALITÉ GRAPHIQUE") : prenez celui
      marqué RECOMMANDÉ, ou "PETIT PC" si ça ne suffit pas. Vous le changez plus tard : Options > Graphismes.
   b) Déjà installé avant ce paquet, et toujours lent ? Dans le jeu : Options > Graphismes > choisissez "PETIT PC" dans
      la liste des profils (le choix déjà enregistré n'est pas modifié tout seul), vérifiez que "Mode performance (Mac)"
      est coché, et que "Textures 4K" est décoché. Relancez le jeu (le profil et la netteté s'appliquent au lancement).
   c) Au premier lancement le jeu télécharge ses données (plusieurs Go) : il est lent tant que ce n'est pas fini.
   d) Laissez la fenêtre du lanceur ouverte pendant que vous jouez (elle sert les fichiers du jeu).
   e) Fermez les applications lourdes (navigateur avec beaucoup d'onglets, vidéo...) et branchez le Mac sur secteur
      (en mode économie d'énergie, macOS bride le processeur et la carte graphique).
   f) Si votre Mac est puissant et que vous préférez l'image nette avec les effets : décochez "Mode performance (Mac)".
   g) Moniteur d'activité (Spotlight > Moniteur d'activité), onglet CPU : regardez "Electron" et "Electron Helper (GPU)".
      GPU quasi à 0 % alors que le processeur est saturé : l'accélération graphique n'est probablement pas utilisée.
      Essai : créez ~/Library/Application Support/Pegasus/gpu-flags.txt avec UNE ligne :
         --ignore-gpu-blocklist --enable-gpu-rasterization
      puis relancez le jeu depuis le lanceur (supprimez le fichier pour annuler).
   h) Envoyez-nous (Discord) : le modèle de votre Mac (Menu Pomme > À propos), la version de macOS, le fichier
      ~/Library/Application Support/Pegasus/profile/game-output.log et le Journal (Options > Journal), qui contient
      la configuration de votre machine et la vitesse des fichiers servis au jeu.

7. DÉSINSTALLER
   Options > "Désinstaller" (vos réglages sont conservés), puis glissez Pegasus.app à la corbeille.

Version Mac en test : merci de signaler tout souci (écran noir, lenteurs, plantage) avec votre modèle de Mac
et la version de macOS.
