diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..26a24f1
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,30 @@
+# SurvivalMechanics ![Java](https://img.shields.io/badge/Java-17+-blue) ![Spigot](https://img.shields.io/badge/API-1.21-green) ![Build](https://img.shields.io/badge/Build-Maven-orange)
+
+**Version:** 1.0-SNAPSHOT  
+**Author:** [M_Viper](mailto:admin@m-viper.de)  
+**Minecraft API:** 1.21  
+
+> ⚡ Ein realistisches Survival-Erlebnis mit Hunger, Durst, Müdigkeit, Temperatur, Ausdauer, Verletzlichkeit und Hygiene.
+
+---
+
+## ✨ Features
+
+- 🥖 **Hunger**- & **Durst**-System mit Multiplikatoren (Biom, Nacht, Kampf, Sprint)
+- 💤 **Müdigkeit** → Spieler werden langsamer, Effekte bei kritischen Werten
+- 🌡️ **Temperatur** → abhängig vom Biom, Wetter, Wärmequellen
+- 🏃 **Ausdauer (Stamina)** → beeinflusst Sprint, Sprung & Kampf
+- 🛡️ **Verletzlichkeit (Vulnerability)** → steigert Schaden & Statusprobleme
+- 🧼 **Hygiene** → schlechtere Hygiene = erhöhte Verletzlichkeit
+- 📊 Anzeige über ActionBar & Scoreboard (vollständig konfigurierbar)
+- ⚙️ Vollständig **anpassbare `config.yml`** & Übersetzbare `lang.yml`
+
+---
+
+## 🚀 Installation
+
+1. Plugin-JAR herunterladen.
+2. In den `plugins/`-Ordner deines Servers legen.
+3. Server starten oder Plugin mit `/reload` laden.
+4. `config.yml` und `lang.yml` werden beim ersten Start erstellt.
+