From f74701ecbe0e3b039491b7507e5776a93f44e67a Mon Sep 17 00:00:00 2001
From: M_Viper <admin@m-viper.de>
Date: Thu, 26 Feb 2026 23:40:00 +0000
Subject: [PATCH] README.md aktualisiert

---
 README.md | 293 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 292 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4982008..2dd3003 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,293 @@
-# Fu-ball
+# ⚽ Fußball Plugin — Vollständiges Minecraft Fußball-Minigame
 
+Ein professionelles Fußball-Plugin für Spigot/Paper 1.21+
+
+---
+
+## 📦 Installation
+
+1. **Java 21+** und **Spigot/Paper 1.21.x** benötigt
+2. Plugin bauen: `mvn package` → `target/Fussball.jar`
+3. JAR in den `/plugins/` Ordner deines Servers kopieren
+4. Server (neu)starten
+5. *(Optional)* [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) installieren für `%fussball_...%` Platzhalter
+
+---
+
+## 🎮 Features
+
+| Feature | Beschreibung |
+|---|---|
+| ⚽ Echter Ball | ArmorStand mit Fußball-Textur, echten Physics & Reibung |
+| 👥 Teams | Automatische Team-Zuweisung mit Auto-Balance (Rot vs. Blau) |
+| 🥅 Tor-Erkennung | Region-basierte Tore mit Trajectory-Check |
+| 🎉 Tor-Effekte | Feuerwerk, Titel, Action-Bar Tor-Replay, Sound |
+| 📊 Scoreboard | Live-Spielstand, Zeit, Halbzeit-Anzeige, Team-Farbnamen |
+| 🔴 BossBar | Timer mit Farbwechsel (grün→gelb→rot) + Spielstand |
+| ⏸ Halbzeit | 30s Pause nach der 1. Halbzeit, danach 2. Halbzeit |
+| ⏰ Verlängerung | 10 Minuten extra bei Unentschieden nach regulärer Zeit |
+| 🥊 Elfmeterschießen | 5 Runden pro Team, Early-Termination, Sudden-Death |
+| 💪 Aufladbarer Schuss | Shift halten = Power aufbauen (0–100%), Action-Bar zeigt Ladestand |
+| 💬 Team-Chat | Nachrichten nur ans eigene Team, Zuschauer sehen alles |
+| 👀 Zuschauer-Modus | Spiele zuschauen im Spectator-Mode mit BossBar & Scoreboard |
+| 🏆 MVP-System | Bester Torschütze wird am Ende gekrönt |
+| 📈 Persistente Stats | Tore, Schüsse, Siege, Niederlagen, Siegquote — serverübergreifend gespeichert |
+| 🔢 Warteschlange | Automatische Queue wenn Arena voll |
+| 🏷 PlaceholderAPI | `%fussball_goals%`, `%fussball_wins%` etc. für andere Plugins |
+| 🚪 Schilder | Join-Schilder mit Live-Status für jede Arena |
+| 🛡 Anti-Grief | Kein Block-Abbauen/-Platzieren, kein Item-Drop/-Pickup im Spiel |
+| 💊 God-Mode | Spieler sterben nicht, Hunger eingefroren, Respawn an Team-Spawn |
+| 🔧 Debug-Befehl | Region-Visualisierung, Ball-Position, Aus-Seite für Admins |
+
+---
+
+## 🔧 Arena Setup (Schritt für Schritt)
+
+### 1. Arena erstellen
+```
+/fb create StadionXL
+```
+
+### 2. Grundpositionen setzen
+Gehe jeweils an die gewünschte Stelle und führe den Befehl aus:
+
+```
+/fb setup StadionXL lobby       → Lobby-Wartebereich (Spieler landen hier beim Joinen/Verlassen)
+/fb setup StadionXL center      → Mittelpunkt des Spielfeldes
+/fb setup StadionXL ballspawn   → Wo der Ball erscheint (Anstoss-Punkt, Mitte)
+/fb setup StadionXL redspawn    → Startposition rotes Team
+/fb setup StadionXL bluespawn   → Startposition blaues Team
+```
+
+### 3. Tore definieren (je 2 diagonal gegenüberliegende Ecken)
+```
+# Rotes Tor
+/fb setup StadionXL redgoalmin    → Untere Ecke des roten Tors
+/fb setup StadionXL redgoalmax    → Obere gegenüberliegende Ecke
+
+# Blaues Tor
+/fb setup StadionXL bluegoalmin   → Untere Ecke des blauen Tors
+/fb setup StadionXL bluegoalmax   → Obere gegenüberliegende Ecke
+```
+
+### 4. Spielfeld-Grenzen setzen *(optional, aber empfohlen)*
+Ohne Feldgrenzen gibt es keine Aus-Erkennung (Einwurf/Ecke/Abstoß).
+```
+/fb setup StadionXL fieldmin    → Eine Ecke des Spielfelds
+/fb setup StadionXL fieldmax    → Die gegenüberliegende Ecke
+```
+
+### 5. Spieler-Einstellungen anpassen *(optional)*
+```
+/fb setup StadionXL minplayers 2    → Mindestanzahl zum Starten (Standard: 2)
+/fb setup StadionXL maxplayers 10   → Maximale Spielerzahl (Standard: 10)
+/fb setup StadionXL duration 300    → Spielzeit in Sekunden, 1. + 2. Halbzeit zusammen (Standard: 300)
+```
+
+### 6. Setup überprüfen
+```
+/fb setup StadionXL info
+```
+Alle Pflichtfelder müssen **§a✔** zeigen. Erst dann ist die Arena spielbereit.
+
+---
+
+## 📋 Alle Commands
+
+### Spieler-Commands
+| Command | Beschreibung |
+|---|---|
+| `/fb join <arena>` | Einem Spiel beitreten (bei voller Arena → Warteschlange) |
+| `/fb leave` | Spiel verlassen / Zuschauen beenden / Warteschlange verlassen |
+| `/fb spectate <arena>` | Einem laufenden Spiel als Zuschauer beiwohnen |
+| `/fb list` | Alle Arenen mit Status und Spieleranzahl anzeigen |
+| `/fb stats [spieler]` | Eigene oder fremde Statistiken anzeigen |
+| `/fb top [goals\|wins]` | Bestenliste der Top-Torschützen oder Top-Sieger |
+| `/fb`, `/soccer` | Aliase für `/fussball` |
+
+### Admin-Commands *(Berechtigung: `fussball.admin`)*
+| Command | Beschreibung |
+|---|---|
+| `/fb create <name>` | Neue Arena erstellen |
+| `/fb delete <name>` | Arena löschen |
+| `/fb setup <arena> <option>` | Arena konfigurieren (siehe Setup-Guide) |
+| `/fb setup <arena> info` | Alle gesetzten Positionen anzeigen |
+| `/fb stop <arena>` | Laufendes Spiel sofort beenden |
+| `/fb debug <arena>` | Tor-/Feld-Regionen und Ball-Position debuggen |
+
+---
+
+## 🎮 Spielablauf
+
+```
+Spieler joinen per Schild oder /fb join
+    → Countdown startet (10 Sek.)
+    → Spieler teleportieren zu Team-Spawns
+    → Fußball erscheint in der Mitte
+
+── 1. HALBZEIT ──────────────────────────────────────────
+    Spieler rennen gegen den Ball → automatischer Kick
+    Shift halten → Schuss lädt auf → loslassen = Powerschuss
+    Ball ins Tor → Punkt! (Feuerwerk + Pause + Neuaufstellung)
+    Bei Aus → Einwurf / Ecke / Abstoß je nach Situation
+
+── HALBZEIT-PAUSE (30 Sek.) ─────────────────────────────
+    Spielstand wird angezeigt, Spieler bleiben auf dem Feld
+
+── 2. HALBZEIT ──────────────────────────────────────────
+    Spielzeit läuft ab...
+
+── BEI GLEICHSTAND: VERLÄNGERUNG (10 Min.) ──────────────
+    Wer zuerst trifft, gewinnt (Golden Goal)
+    Bei weiterem Gleichstand...
+
+── ELFMETER-SCHIEßEN ────────────────────────────────────
+    5 Schüsse pro Team (abwechselnd)
+    Schütze hat 15 Sekunden pro Versuch
+    Early-Termination wenn Ergebnis feststeht
+    Dann: Sudden Death (je 1 Schuss) bis Entscheidung
+
+── SPIELENDE ────────────────────────────────────────────
+    Sieger + MVP werden bekannt gegeben
+    Statistiken werden gespeichert
+    Alle zurück zur Lobby
+```
+
+---
+
+## 💪 Aufladbarer Schuss
+
+| Aktion | Effekt |
+|---|---|
+| Rechtsklick auf Ball | Normaler Schuss |
+| Linksklick auf Ball | Normaler Schuss |
+| **Shift halten** (max 1.5s) | Schuss lädt auf |
+| Shift loslassen | Schuss mit aufgebauter Power |
+| 100% Ladung erreicht | Auto-Fire |
+
+Die Action-Bar zeigt den Ladefortschritt:
+```
+⚽ Schuss-Power: ████████░░ 80%
+```
+Ab 70% Ladung erscheinen Feuer-Partikel am Ball. Volle Ladung = 3.8× normale Kraft + mehr Loft.
+
+---
+
+## 💬 Team-Chat
+
+Spieler im Spiel schreiben automatisch nur ans eigene Team:
+```
+§c[ROT] §fSpielerName§7: Ich stehe frei links!
+```
+- **`!Nachricht`** → Global-Broadcast an alle Spieler im Spiel (nur Admins)
+- Zuschauer sehen alle Team-Chats mit `[Zuschauer]`-Label
+
+---
+
+## 🚪 Join-Schilder erstellen
+
+1. Schild platzieren
+2. In die erste Zeile `[Fussball]` schreiben
+3. In die zweite Zeile den Arena-Namen schreiben
+4. Rechtsklick auf das Schild → Spiel beitreten
+
+Das Schild zeigt automatisch den aktuellen Status:
+```
+[⚽]
+StadionXL
+§c● 4/10
+Klick zum Joinen
+```
+
+Farb-Legende: `§a●` = Wartet · `§e●` = Startet · `§c●` = Läuft · `§d●` = Elfmeter · `§7●` = Endet
+
+---
+
+## 📈 Statistiken & Bestenliste
+
+```
+/fb stats               → Eigene Statistiken
+/fb stats Notch         → Statistiken von "Notch"
+/fb top goals           → Top 10 Torschützen
+/fb top wins            → Top 10 nach Siegen
+```
+
+Gespeicherte Werte pro Spieler:
+- ⚽ Tore · 👟 Schüsse · 🏆 Siege · ❌ Niederlagen · ➖ Unentschieden · 📊 Gespielte Spiele · 📈 Siegquote %
+
+Alle Daten werden in `plugins/Fussball/stats.yml` dauerhaft gespeichert.
+
+---
+
+## 🏷 PlaceholderAPI
+
+Wenn PlaceholderAPI installiert ist, sind folgende Platzhalter verfügbar:
+
+| Platzhalter | Wert |
+|---|---|
+| `%fussball_goals%` | Tore gesamt |
+| `%fussball_kicks%` | Schüsse gesamt |
+| `%fussball_wins%` | Siege gesamt |
+| `%fussball_losses%` | Niederlagen gesamt |
+| `%fussball_draws%` | Unentschieden gesamt |
+| `%fussball_games%` | Gespielte Spiele |
+| `%fussball_winrate%` | Siegquote (z.B. `67.5`) |
+| `%fussball_ingame%` | `true` / `false` |
+| `%fussball_arena%` | Name der aktuellen Arena oder `–` |
+| `%fussball_score%` | Aktueller Spielstand z.B. `2 : 1` oder `–` |
+
+---
+
+## 🔑 Berechtigungen
+
+| Permission | Beschreibung | Standard |
+|---|---|---|
+| `fussball.admin` | Alle Admin-Commands | OP |
+| `fussball.play` | Spielen, Zuschauen, Stats | Alle |
+
+---
+
+## 📁 Dateistruktur
+
+```
+plugins/Fussball/
+├── config.yml      → Plugin-Einstellungen (Ball-Power, Defaults)
+├── arenas.yml      → Gespeicherte Arenen (auto-generiert)
+├── signs.yml       → Gespeicherte Join-Schilder (auto-generiert)
+└── stats.yml       → Spieler-Statistiken (auto-generiert)
+```
+
+---
+
+## 🏟 Tipps für ein gutes Spielfeld
+
+- **Feldgröße:** Mindestens **30×20 Blöcke** empfohlen (größer = mehr Spaß)
+- **Tore:** Ca. **5 Blöcke breit, 3 Blöcke hoch** (genug Platz für den ArmorStand-Ball)
+- **Boden:** Gras, Terrakotta oder Smaragd-Blöcke für Optik
+- **Begrenzung:** Zäune, Mauern oder Glas als Spielfeld-Rand
+- **fieldmin/fieldmax immer setzen!** Sonst gibt es keinen Aus-Befehl (Einwurf/Ecke/Abstoß)
+- **Lobby außerhalb** des Spielfelds platzieren, damit Spieler nach dem Spiel nicht auf dem Feld stehen
+
+---
+
+## ⚙ Kompatibilität
+
+| Anforderung | Version |
+|---|---|
+| Spigot / Paper | **1.21.x** |
+| Java | **21+** |
+| PlaceholderAPI | optional, jede Version |
+
+Mehrere Arenen gleichzeitig möglich. Jede Arena läuft komplett unabhängig.
+
+---
+
+## 🐛 Bekannte Eigenheiten
+
+- Der Ball ist ein **ArmorStand** – er kann durch enge Durchgänge (< 1 Block) stecken bleiben. Tore daher mindestens **2 Blöcke breit** bauen.
+- Spieler müssen **Adventure-Mode** haben – Commands die den Spielmodus ändern (z.B. durch andere Plugins) können das Spiel stören.
+- Die Halbzeit teilt die `duration`-Einstellung in zwei Hälften. Wer 5 Minuten Gesamtspielzeit will, setzt `duration 300`.
+
+---
+
+*Erstellt mit ❤️ von M_Viper — viel Spaß beim Fußballspielen!*
\ No newline at end of file