diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1ebeb38
--- /dev/null
+++ b/README.md
@@ -0,0 +1,108 @@
+# ⛏️ Veinmining
+
+![Minecraft](https://img.shields.io/badge/Minecraft-1.21.1-blue)
+![Loader](https://img.shields.io/badge/NeoForge-21.1.208%2B-green)
+![License](https://img.shields.io/badge/License-All%20Rights%20Reserved-red)
+![Dependencies](https://img.shields.io/badge/Dependencies-None-lightgrey)
+![Side](https://img.shields.io/badge/Side-Client%20%26%20Server-orange)
+
+**Veinmining** is a simple yet powerful **NeoForge enchantment mod** that allows players to mine entire ore veins with a single break.  
+No complex keybinds, no GUI — just **enchant your pickaxe** and start mining smarter, not harder.
+
+---
+
+## ✨ Features
+
+- ⛏️ **Veinmining enchantment** — mine entire ore veins at once  
+- 📊 **3 enchantment levels** — I, II, III for increased range  
+- 🔧 **Universal compatibility** — works with vanilla and modded pickaxes  
+- 🪨 **Auto-detection** — recognizes all vanilla and modded ores  
+- 📚 **Enchanting table support** — obtain it naturally through enchanting  
+- 🔄 **Smart algorithm** — prevents lag with optimized block searching  
+- 💎 **XP & durability** — uses tool durability and grants experience like normal mining  
+- 🎒 **Automatic drops** — all mined blocks drop items as expected  
+- 🌐 **Multi-language support** (`en_us`, `fr_fr`)  
+- 🚫 **No dependencies** — works out of the box  
+
+---
+
+## 🎮 How It Works
+
+1. **Enchant your pickaxe** with the Veinmining enchantment (found in enchanting tables, anvils, or villager trades)
+2. **Break any ore block** — the enchantment will automatically detect and mine the entire vein
+3. **Collect your loot** — all blocks drop normally and consume durability per block mined
+
+### 📈 Enchantment Levels
+
+| Level | Max Blocks | Description |
+|-------|------------|-------------|
+| **Veinmining I** | 16 blocks | Mines small to medium ore veins |
+| **Veinmining II** | 32 blocks | Mines large ore veins |
+| **Veinmining III** | 64 blocks | Mines massive ore veins |
+
+---
+
+## ⚙️ Technical Details
+
+### 🔍 Compatible Items
+- ✅ All vanilla pickaxes (Wood, Stone, Iron, Gold, Diamond, Netherite)
+- ✅ All modded pickaxes (any item containing `pickaxe` in its name)
+
+### 🪨 Compatible Blocks
+- ✅ All vanilla ores (Coal, Iron, Gold, Diamond, Emerald, Copper, etc.)
+- ✅ All Nether ores (Nether Gold, Nether Quartz, Ancient Debris)
+- ✅ All modded ores (any block containing `ore` in its name)
+
+---
+
+## 🧩 Compatibility
+
+| Requirement | Version |
+|--------------|----------|
+| **Minecraft** | 1.21.1 |
+| **Loader** | NeoForge **21.1.208 or newer** |
+| **Environment** | Client & Server |
+| **Dependencies** | None |
+
+---
+
+## 🔧 Installation
+
+### Client & Server
+1. Download the latest **Veinmining** `.jar`
+2. Place it in your `mods/` folder
+3. Launch Minecraft/Server
+4. Enchant your pickaxe and start mining!
+
+---
+
+## 🎯 Obtaining the Enchantment
+
+| Method | Availability |
+|--------|--------------|
+| **Enchanting Table** | ✅ Available at all levels |
+| **Anvil** | ✅ Combine enchanted books |
+| **Villager Trading** | ✅ Librarian trades |
+| **Loot Chests** | ✅ Found in dungeon/temple loot |
+| **Command** | `/give @p diamond_pickaxe[enchantments={levels:{"veinmining:veinmining":3}}]` |
+---
+
+## 🧑‍💻 Author
+
+**Veinmining** was created by **UltraLion**  
+🌐 [https://ultralion.xyz](https://ultralion.xyz)
+
+---
+
+## 📜 License
+
+This mod is distributed under the **All Rights Reserved** license.  
+Redistribution or modification without explicit permission from the author is prohibited.
+
+---
+
+### 📸 Screenshots
+
+![Replace this with a description](https://cdn.modrinth.com/data/cached_images/d7a0281ee8b904859a69d69795edf1428e0bbec4.png) ![Replace this with a description](https://cdn.modrinth.com/data/cached_images/6560376791eeedaa58914ce90892a8a2092f10d1.png) ![Replace this with a description](https://cdn.modrinth.com/data/cached_images/54c84b2cd94495e313c1797e683bec4cd50388ef.png)
+
+---