diff --git a/Warps.md b/Warps.md
new file mode 100644
index 0000000..6932a90
--- /dev/null
+++ b/Warps.md
@@ -0,0 +1,173 @@
+# Warps
+
+Das Warp-System erlaubt offentliche Teleportpunkte fur alle Spieler.
+
+---
+
+## Was sind Warps?
+
+Warps sind **offentliche** Teleportpunkte, die alle Spieler nutzen konnen. Perfekt fur:
+- Marktplatze
+- Arenen
+- Offentliche Farmen
+- Sehenswurdigkeiten
+- Community-Projekte
+
+---
+
+## Befehle
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/setwarp <name>` | Erstellt einen neuen Warp |
+| `/warps` | Offnet die Warp-GUI |
+| `/delwarp <name>` | Loscht einen eigenen Warp |
+
+---
+
+## Warp erstellen
+
+### Schritt fur Schritt
+
+1. Gehe zu dem Ort, den du als Warp setzen willst
+2. (Optional) Nimm ein Item in die Hand als Icon
+3. Tippe `/setwarp <name>`
+4. Fertig!
+
+### Beispiele
+
+```
+/setwarp marktplatz
+/setwarp arena
+/setwarp farm
+/setwarp shop
+```
+
+### Mit Icon
+
+Das Item in deiner Hand wird als Icon in der Warp-GUI angezeigt!
+
+1. Nimm z.B. einen Diamanten in die Hand
+2. Tippe `/setwarp diamantmine`
+3. Der Warp hat jetzt ein Diamant-Icon
+
+Wenn du nichts in der Hand hast, wird das Standard-Icon verwendet (OAK_SIGN).
+
+---
+
+## Warp-GUI
+
+```
+/warps
+```
+
+Offnet eine GUI mit allen offentlichen Warps:
+- Jeder Warp ist ein Item (mit Icon)
+- Klicke auf einen Warp zum Teleportieren
+- Zeigt den Warp-Namen und Ersteller
+- Mehrere Seiten mit Pfeilen zum Blattern
+
+---
+
+## Warp loschen
+
+```
+/delwarp <name>
+```
+
+**Wichtig:** Du kannst nur deine EIGENEN Warps loschen! Admins konnen alle loschen.
+
+---
+
+## Warp-Limit
+
+### Standard-Limit
+
+Jeder Spieler kann standardmassig **5 Warps** erstellen.
+
+### Limit andern
+
+In config.yml:
+```yaml
+maxWarpsPerPlayer: 5
+```
+
+### Unbegrenzte Warps
+
+Permission vergeben:
+```
+survivalplus.warps.unlimited
+```
+
+Mit LuckPerms:
+```
+/lp user Steve permission set survivalplus.warps.unlimited true
+/lp group vip permission set survivalplus.warps.unlimited true
+```
+
+---
+
+## Permissions
+
+| Permission | Beschreibung | Standard |
+|------------|-------------|----------|
+| `survivalplus.setwarp` | Warps erstellen | Alle |
+| `survivalplus.warps` | Warp-GUI offnen | Alle |
+| `survivalplus.delwarp` | Eigene Warps loschen | Alle |
+| `survivalplus.warps.unlimited` | Unbegrenzte Warps | Nein |
+
+---
+
+## Unterschied zu Homes
+
+| | Homes | Warps |
+|---|-------|-------|
+| Sichtbarkeit | Privat | Offentlich |
+| Wer kann nutzen | Nur Besitzer | Alle Spieler |
+| Typischer Einsatz | Eigene Basis | Server-Orte |
+
+---
+
+## Haufige Fragen
+
+### Kann ich fremde Warps loschen?
+
+Nein, nur eigene Warps. Admins konnen alle loschen.
+
+### Wie andere ich das Icon eines Warps?
+
+Losche den Warp und erstelle ihn neu mit dem gewunschten Item in der Hand.
+
+### Werden Warps nach Inaktivitat geloscht?
+
+Nein, Warps bleiben permanent.
+
+### Kann ich Warps verstecken?
+
+Nein, alle Warps sind offentlich und in der GUI sichtbar.
+
+---
+
+## Technische Details
+
+Warps werden gespeichert in:
+```
+plugins/SurvivalPlus/warps.yml
+```
+
+Format:
+```yaml
+warpname:
+  owner: spieler-uuid
+  world: world
+  x: 100.5
+  y: 64.0
+  z: -200.5
+  yaw: 180.0
+  pitch: 0.0
+  icon: DIAMOND
+```
+
+---
+
+Zuruck zu: [[Home]] | Siehe auch: [[Homes]]