Files
ReshadePluginsCore/README.md

93 lines
4.1 KiB
Markdown
Raw Normal View History

2026-03-10 17:41:55 +00:00
# ReshadePluginsCore
**Framework modulaire C++ pour injection de comportements et fixes graphiques dans les jeux vidéo**
**Auteur :** Emmanuel AYME
---
## 🎯 Présentation
**ReshadePluginsCore** est un framework de plugins C++ permettant dinjecter et de contrôler des comportements dans les jeux vidéo, avec une architecture modulable pour différents moteurs (Unreal Engine 4/5, Unity).
Il offre notamment :
- **Fixes graphiques** : FOV (champde vision), ultra wide, DOF (profondeur de champ), aberrations chromatiques, brouillard, vignettage ...
- **Cheats / outils développeur** : console réactivée, time dilation, stealth mode...
- **Instrumentation runtime** : hooks sécurisés, AOB scans, offset resolution
- **Séparation Core / UI** pour des interfaces modulables via Reshade ou autres overlay
Le framework est conçu pour être **générique**, **réutilisable** et **performant**, permettant lintégration rapide de nouveaux jeux ou moteurs.
---
## ⚙️ Architecture
### 1. Core DLL
Le cœur du projet gère :
- **Chargement dynamique des modules**
- **Hooks sécurisés (SafetyHookMid)** pour linjection de code au runtime
- **AOB scans et calculs d'offsets** pour identifier les structures internes du jeu
- **Memory patching** pour ajuster le comportement des moteurs graphiques
- **API C++ exportée** (`SetFixEnabled`, `SetFixesEnabled`, `SetValues`, `GetGameInfos`) pour linteraction avec lUI
### 2. Modules principaux
| Module | Description |
|-------------------------|-------------|
| `FOVFixEnabled` | Déverrouille et ajuste le FOV des jeux UE / Unity |
| `UltraWideFixEnabled` | Active la prise en charge des écrans ultrawide |
| `DOFFixEnabled` | Désactive ou ajuste la profondeur de champ |
| `CAFixEnabled` | Désactive laberration chromatique |
| `VignettingFixEnabled` | Supprime ou ajuste le vignettage |
| `FogFixEnabled` | Ajuste ou supprime le brouillard |
| `EnableConsole` | Réactive la console développeur dans UE |
| `EnableCheats` | Applique les cheats `TimeDilation` et `Stealth` |
| `ProcessEvent` | Hook central pour récupérer et manipuler les événements du moteur |
| `Logger` | Suivi en temps réel des modifications et actions appliquées |
| `Autres fonctions` | Besoins spéciques pour fix ou autres |
### 3. Conception
- **Thread-safe** : initialisations atomiques, hooks et variables partagées sécurisées
- **Modulaire** : chaque fix peut être activé/désactivé indépendamment
- **Extensible** : support UE4/UE5, Unity, et potentiellement dautres moteurs via lAPI
- **Build simplifié** : solution Visual Studio avec `.sln` et dossier `Release/x64` prêt à lemploi
---
## 🚀 Fonctionnalités clés
- **Injection runtime** : modification directe des comportements de jeu sans source modifiable
- **Hooks dynamiques** : SafetyHookMid pour attacher du code de manière non intrusive
- **Offset & pattern scanning** : AOB scans batch pour trouver automatiquement les adresses critiques
- **Configuration persistante** : sauvegarde et chargement via fichier `.ini`
- **Instrumentation multi-moteurs** : abstraction pour UE / Unity
---
## 🛠️ Build & Dépendances
1. Cloner le repo `ReshadePluginsCore`
2. Ouvrir la solution `.sln` avec Visual Studio 2022+
3. Compiler en **Release/x64**
4. Déposer les `.dll` générées à côté des exécutables du jeu ciblé
5. Ajouter toute dépendance externe (ex. `zydis.dll` pour linjection/assembly)
---
## 📈 Points forts
- Maîtrise avancée du **C++ moderne**, y compris hooks et instrumentation mémoire
- Capacité à concevoir des **frameworks modulaires** et réutilisables
- Expérience pratique sur **Unreal Engine 4/5** et **Unity**
- Gestion de projet **multi-moteurs et multi-jeux**
- Compétences en **reverse engineering et debugging runtime**
- Documentation claire et orientée utilisateur pour intégration facile
---
## 🔗 Liens et contact
- Buy Me A Coffee : [https://buymeacoffee.com/k4sh44](https://buymeacoffee.com/k4sh44)