Files
ReshadePluginsCore/README.md
2026-03-10 17:41:55 +00:00

93 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)