diff --git a/README.md b/README.md
index 5a837cb..9276fe5 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,89 @@
 # Hamalron JDR
 
-Par Alkonost
+_Hamalron_ est un jeu de rôle sur table médiéval-fantastique dark fantasy créé par **Alkonost**. Ce système Foundry VTT vous permet de jouer à _Hamalron_ en utilisant son mécanisme original : **le tirage de cartes de tarot** en remplacement des dés.
+
+Par **Uberwald** (LeRatierBretonnien).
+
+- **Site** : https://www.uberwald.me/gitea/public/fvtt-hamalron
+- **Forum** : https://www.uberwald.me
+
+## Installation
+
+1. Dans Foundry VTT, allez dans **Systèmes** → **Installer un système**.
+2. Collez l'URL du manifest :
+   ```
+   https://www.uberwald.me/gitea/public/fvtt-hamalron/raw/branch/main/system.json
+   ```
+3. Cliquez sur **Installer**.
+
+## Compatibilité
+
+| Foundry VTT | Version |
+|-------------|---------|
+| minimum     | 14      |
+| vérifiée    | 14      |
+
+## Fonctionnalités
+
+### Système de tarot
+
+- **Pas de dés** : toutes les résolutions se font par tirage de cartes de tarot.
+- **Gestionnaire de deck** complet : pioche, défausse, redistribution, collecte des mains.
+- **74 cartes de tarot** (22 atouts + 56 numérotées : Bâton, Coupe, Denier, Épée) + le Mat.
+- Implémentation des règles de **tirage sous tension** (pioche MJ avec bonus de difficulté).
+- Jet d'**initiative** par tirage automatique d'une carte au début du combat.
+- **Tests d'épreuve** : dialogue de difficulté, tirage de carte, résistance d'objectif.
+
+### Personnages
+
+- **10 caractéristiques** (Force, Agilité, Esprit, etc.) avec valeurs et modificateurs.
+- **Compétences** liées aux caractéristiques, maîtrises, spécialisations.
+- **Blessures incapacitantes** à la perte d'une carte Épée (malus -2, bannière).
+- **Récupération des résistances** : Denier/Coupe (test difficulté 7), Épée (tirage +1/test), Bâton (tirage +1).
+- **Main de tarot** : les personnages peuvent recevoir jusqu'à 8 cartes en main.
+
+### Équipement et combat
+
+- **Armes** : dégâts, type, mains requises, portée.
+- **Armures** : protection, type.
+- **Équipement** divers.
+
+### Magie
+
+- **Lancement de sortilèges** : dialogue complet avec choix du rang, modificateurs circonstanciels.
+- **Grille 3×3 de modificateurs** : Puissance magique / Sur-sollicitation du Néant / Blessure.
+- **Rang de magicien** : influence le nombre de cartes tirées.
+- **Table des échecs magiques** : conséquences en cas d'échec.
+- Interface de **pioche** intégrée au dialogue de lancement.
+
+### Univers
+
+- **Peuples** jouables avec description et traits.
+- **Langues** et factions.
+- **Régions** géographiques.
+- **Tarot divinatoire** : cartes avec description ésotérique.
+
+### Interface et confort
+
+- **Drag & drop** des compétences, sorts, armes et acteurs vers la barre de raccourcis.
+- **Boutons "Sous tension" et "Opposé"** sur les messages de chat.
+- **Bouton Tarot** rapide pour tirer une carte depuis le chat.
+- **Bouton Actions** pour les actions complexes.
+- **Bouton Épreuve** pour les tests de difficulté avec sélection de carte et choix de difficulté.
+- **Fiches personnage et PNJ** complètes avec onglets.
+- **Compendium** système intégré (78 cartes de tarot pré-créées).
+
+## Utilisation
+
+1. Créez un monde avec le système **Hamalron JDR**.
+2. Ouvrez le **Gestionnaire de deck de tarot** (bouton dans la barre des outils MJ ou `game.system.api.openTarotDeckManager()`).
+3. Créez vos personnages et PNJ via les fiches appropriées.
+4. Utilisez le chat pour lancer des épreuves, des attaques, ou des sorts.
+
+## Licence
+
+Code : **CC BY-NC-SA 4.0** (Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International)
+
+Droits d'auteur : © LeRatierBretonnien / www.uberwald.me
+
+Les contenus artistiques et littéraires appartiennent à leurs auteurs respectifs (Alkonost).