# 🎮 Installation GTA V sur Mac M4 Pro

## ✅ Script d'installation automatique créé

**Emplacement:** `scripts/setup-gta5-mac.sh`

---

## 🚀 LANCEMENT RAPIDE

```bash
cd ~/Documents/MyRoadTrip
./scripts/setup-gta5-mac.sh
```

Le script fait TOUT automatiquement :
- ✅ Vérifie Mac M4 + Rosetta 2
- ✅ Installe XQuartz + Wine + GPTK
- ✅ Configure Wine prefix 64-bit
- ✅ Installe DXVK + DirectX + VCRun
- ✅ Active Metal + Esync/Fsync
- ✅ Installe Whisky (interface)
- ✅ Crée script de lancement GTA V

**Durée:** 15-30 minutes (dépend de ta connexion)

---

## 📋 CE QUE LE SCRIPT INSTALLE

| Composant | Pourquoi | Performance |
|-----------|----------|-------------|
| **XQuartz** | GUI Wine | Requis |
| **Wine Stable** | Exécute Windows sur Mac | Base |
| **Game Porting Toolkit** | DirectX → Metal | +300% FPS |
| **DXVK** | DirectX → Vulkan → Metal | +150% FPS |
| **MoltenVK** | Backend Vulkan | Stable |
| **Esync/Fsync** | Sync CPU optimisé | +20% FPS |
| **VCRun 2015-2022** | DLL Windows | Compatibilité |
| **.NET 4.8** | Rockstar Launcher | Requis |
| **DirectX 9/10/11** | GTA V render | Requis |
| **Whisky** | Interface graphique | Facile |

---

## ⚙️ OPTIMISATIONS ACTIVÉES

```bash
# Variables d'environnement (ajoutées à ~/.zprofile)
export WINEPREFIX="$HOME/wine-games"
export WINE_D3D_CONFIG="metal"              # DirectX → Metal (Apple)
export WINEESYNC=1                          # +15% FPS
export WINEFSYNC=1                          # +25% FPS
export WINEDEBUG=-all                       # Pas de logs (gain perf)
export DXVK_HUD=0                           # Pas d'overlay
export MTL_SHADER_VALIDATION=0              # Metal optimisé
```

**Renderer:** Vulkan → Metal (via MoltenVK)  
**DirectX:** 9/10/11 → DXVK → Vulkan → Metal  
**Multithreading:** ON  
**Large Address Aware:** ON (4GB+ RAM)

---

## 🎯 APRÈS L'INSTALLATION

### 1️⃣ Redémarre ta session
```bash
# XQuartz nécessite une nouvelle session
# Déconnexion/reconnexion ou reboot
```

### 2️⃣ Configure ton disque Windows
```bash
winecfg
```
- Onglet **Drives**
- Clic **Add**
- Letter: `D:`
- Path: `/Volumes/Systeme`
- ✅ Coche "Show dot files"

### 3️⃣ Option A: Via Whisky (RECOMMANDÉ)
```bash
# Ouvre Whisky depuis Applications
open -a Whisky
```

**Dans Whisky:**
1. Create New Bottle
2. Import existing prefix: `~/wine-games`
3. Add Program → GTA5.exe
4. Launch

**Avantages Whisky:**
- Interface graphique
- D3DMetal intégré
- DXVK auto-configuré
- Gestion GPU automatique
- Sandbox par jeu

### 4️⃣ Option B: Via script direct
```bash
# Édite le chemin GTA V
nano ~/launch-gta5.sh

# Modifie cette ligne:
GTA5_PATH="/Volumes/Systeme/Program Files/Rockstar Games/Grand Theft Auto V"

# Lance GTA V
~/launch-gta5.sh
```

### 5️⃣ Si GTA V via Steam
```bash
# Installe Steam dans Wine
winetricks steam

# Connecte-toi à Steam
# Télécharge GTA V
# Lance via Steam
```

---

## 🔧 TROUBLESHOOTING

### ❌ "Wine command not found"
```bash
# Réinstalle Wine
brew reinstall --cask wine-stable
```

### ❌ "XQuartz crash"
```bash
# Redémarre ta session (déconnexion/reconnexion)
# Relance XQuartz
open -a XQuartz
```

### ❌ GTA V crash au lancement
```bash
# Vérifie les DLL manquantes
winetricks vcrun2019 d3dx11_43

# Vérifie DXVK
winetricks dxvk

# Mode debug (voir les erreurs)
export WINEDEBUG=+all
wine GTA5.exe
```

### ❌ FPS trop bas
```bash
# Vérifie Metal
echo $WINE_D3D_CONFIG  # Doit afficher "metal"

# Vérifie Esync/Fsync
echo $WINEESYNC $WINEFSYNC  # Doit afficher "1 1"

# Force renderer Vulkan
winetricks settings renderer=vulkan

# Réduis qualité graphique in-game
# GTA V → Settings → Graphics → Medium/High
```

### ❌ "Rockstar Launcher crash"
```bash
# Réinstalle .NET
winetricks dotnet48

# Ou bypass launcher (si version Steam/Epic)
wine GTA5.exe -scOfflineOnly
```

---

## 📊 PERFORMANCES ATTENDUES (Mac M4 Pro)

| Résolution | Qualité | FPS estimé |
|------------|---------|------------|
| 1920x1080 | Bas | 60-80 FPS |
| 1920x1080 | Moyen | 45-60 FPS |
| 1920x1080 | Élevé | 30-45 FPS |
| 2560x1440 | Moyen | 35-50 FPS |
| 2560x1440 | Élevé | 25-35 FPS |

**Note:** Mac M4 Pro = 16-core GPU → performances similaires à GTX 1060/RX 580

---

## 🛠️ COMMANDES UTILES

```bash
# Vérifier Wine
wine --version

# Vérifier prefix
ls -lh ~/wine-games

# Ouvrir config Wine
winecfg

# Installer DLL manquante
winetricks nomDLL

# Liste DLL installées
winetricks list-installed

# Nettoyer cache Winetricks
rm -rf ~/.cache/winetricks

# Recréer prefix (ATTENTION: supprime tout)
rm -rf ~/wine-games
WINEARCH=win64 wineboot -i

# Logs Wine
tail -f ~/gta5-setup.log

# Benchmarker FPS
# In-game: Activer FPS counter Steam ou MSI Afterburner
```

---

## 📂 STRUCTURE CRÉÉE

```
~/wine-games/              # Wine prefix (environnement Windows virtuel)
  ├── drive_c/             # Disque C: virtuel
  ├── dosdevices/          # Liens disques
  └── system.reg           # Registre Windows

~/launch-gta5.sh           # Script lancement direct

~/gta5-setup.log           # Log installation

~/.zprofile                # Variables environnement (backup créé)
```

---

## 🚨 IMPORTANT

1. **Redémarre ta session** après installation (XQuartz)
2. **Utilise Whisky** pour interface facile (recommandé)
3. **Metal activé** = gain énorme de perf (vérifie `WINE_D3D_CONFIG=metal`)
4. **GTA V légal uniquement** (Steam/Epic/Rockstar)
5. **Backup ton prefix** avant modifs: `tar -czf wine-games-backup.tar.gz ~/wine-games`

---

## 📖 RESSOURCES

- **Whisky:** https://github.com/Whisky-App/Whisky
- **GPTK Apple:** https://developer.apple.com/games/game-porting-toolkit/
- **Wine HQ:** https://www.winehq.org/
- **DXVK:** https://github.com/doitsujin/dxvk

---

## ✅ CHECKLIST

- [ ] Script lancé: `./scripts/setup-gta5-mac.sh`
- [ ] Session redémarrée (XQuartz)
- [ ] Disque Windows configuré dans `winecfg`
- [ ] Whisky installé et configuré
- [ ] GTA V ajouté dans Whisky
- [ ] Premier lancement testé
- [ ] FPS acceptable (30+)

---

**Bon jeu ! 🎮**
