From 44b96b5064005502ba0ce6812a06fcbb51d14bf0 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 26 Mar 2026 21:15:05 +0000
Subject: [PATCH 1/2] Initial plan


From 471b95d6a9326c9e3e09d2648efb14d2ad4b935b Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 26 Mar 2026 21:16:46 +0000
Subject: [PATCH 2/2] Add comprehensive README.md for mod-expedition

Agent-Logs-Url: https://github.com/OGSteam/mod-expedition/sessions/412c564a-3703-47b9-aa77-050a328e7e68

Co-authored-by: darknoon29 <13015521+darknoon29@users.noreply.github.com>
---
 README.md | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 61 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5818f5f..daaf5da 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,61 @@
-# mod-expedition
+# mod-expedition (eXpedition)
+
+[![License: GPL-2.0](https://img.shields.io/badge/License-GPL%202.0-blue.svg)](https://opensource.org/licenses/GPL-2.0)
+
+Module OGSpy permettant de suivre et d'analyser vos expéditions dans OGame.
+
+## Description
+
+**eXpedition** est un module pour [OGSpy](https://github.com/ogsteam/ogspy) qui enregistre et classe automatiquement vos rapports d'expédition. Il s'intègre avec le plugin **Xtense 2** pour importer les rapports directement depuis votre navigateur.
+
+### Types d'expéditions suivis
+
+| Type | Description |
+|------|-------------|
+| Ressources | Métal, Cristal, Deutérium ou Antimatière récoltés |
+| Vaisseaux | Flotte récupérée lors de l'expédition |
+| Marchand | Visite d'un représentant marchand |
+| Attaques | Rencontres avec des pirates ou des espèces inconnues |
+| Items | Objets obtenus (boosters de ressources, KRAKEN, DETROID, NEWTRON) |
+| Nul | Expéditions sans résultat notable |
+
+### Fonctionnalités
+
+- **Statistiques** : visualisation de vos résultats d'expédition par période et par type
+- **Hall of Fame** : classements des meilleurs joueurs (ressources, vaisseaux, cumul)
+- **Détail** : consultation du détail de chaque expédition avec filtrage par date
+- **Import automatique** : intégration avec Xtense 2 pour un import automatique des rapports
+
+## Prérequis
+
+- PHP >= 7.2.0
+- OGSpy >= 3.3.6
+- Module Xtense 2 (recommandé pour l'import automatique)
+
+## Installation
+
+1. Téléchargez la dernière version depuis la [page des releases](https://github.com/ogsteam/mod-expedition/releases).
+2. Décompressez l'archive dans le dossier `mod/` de votre installation OGSpy.
+3. Depuis le panneau d'administration OGSpy, installez le module **eXpedition**.
+4. Assurez-vous que le module Xtense 2 est installé pour profiter de l'import automatique des rapports.
+
+## Mise à jour
+
+Depuis le panneau d'administration OGSpy, lancez la mise à jour du module **eXpedition**. Le script `update.php` gère les migrations de base de données entre les versions.
+
+## Utilisation
+
+Une fois installé et activé, le module est accessible via le menu **Expeditions** de votre OGSpy. Les rapports d'expédition sont importés automatiquement grâce au plugin Xtense 2 installé dans votre navigateur.
+
+## Support
+
+- **Issues** : [GitHub Issues](https://github.com/ogsteam/mod-expedition/issues)
+- **Discord** : [OGSteam Discord](https://discord.gg/Azcb67b)
+
+## Auteurs
+
+- **DarkNoon** – Lead Developer – [GitHub](https://github.com/darknoon29)
+
+## Licence
+
+Ce projet est sous licence [GPL-2.0](https://opensource.org/licenses/GPL-2.0).