From 406fb7055b951c6ae63d297c9184331d7617b719 Mon Sep 17 00:00:00 2001
From: M_Viper <admin@m-viper.de>
Date: Thu, 19 Mar 2026 06:18:11 +0000
Subject: [PATCH] =?UTF-8?q?Arena-Setup=20hinzugef=C3=BCgt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Arena-Setup.-.md | 101 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 101 insertions(+)
 create mode 100644 Arena-Setup.-.md

diff --git a/Arena-Setup.-.md b/Arena-Setup.-.md
new file mode 100644
index 0000000..5c7c496
--- /dev/null
+++ b/Arena-Setup.-.md
@@ -0,0 +1,101 @@
+# Arena-Setup
+
+---
+
+## Schnell-Setup (Minimalanforderung)
+
+```
+/fb create MeineArena
+/fb setup MeineArena lobby
+/fb setup MeineArena redspawn
+/fb setup MeineArena bluespawn
+/fb setup MeineArena ballspawn
+/fb setup MeineArena center
+/fb setup MeineArena redgoalmin
+/fb setup MeineArena redgoalmax
+/fb setup MeineArena bluegoalmin
+/fb setup MeineArena bluegoalmax
+/fb setup MeineArena info
+```
+
+Alle Positionen werden von deinem aktuellen Standort übernommen. Nach dem Setup kannst du sofort mit `/fb join MeineArena` testen.
+
+---
+
+## Pflicht-Punkte
+
+Diese Punkte müssen gesetzt sein, damit `isSetupComplete` auf `true` steht:
+
+| Punkt | Befehl | Hinweis |
+| --- | --- | --- |
+| Lobby | `/fb setup <arena> lobby` | Wartebereich vor Spielstart |
+| Roter Spawn | `/fb setup <arena> redspawn` | Anstoßposition des roten Teams |
+| Blauer Spawn | `/fb setup <arena> bluespawn` | Anstoßposition des blauen Teams |
+| Ball-Spawn | `/fb setup <arena> ballspawn` | Mittelpunkt; auch Standard-Elfmeterpunkt |
+| Feldmittelpunkt | `/fb setup <arena> center` | Grundlage für Abseits- und Hälftenberechnung |
+| Rotes Tor Min | `/fb setup <arena> redgoalmin` | Erste Ecke der Tor-Hitbox |
+| Rotes Tor Max | `/fb setup <arena> redgoalmax` | Gegenüberliegende Ecke der Tor-Hitbox |
+| Blaues Tor Min | `/fb setup <arena> bluegoalmin` | Erste Ecke der Tor-Hitbox |
+| Blaues Tor Max | `/fb setup <arena> bluegoalmax` | Gegenüberliegende Ecke der Tor-Hitbox |
+
+---
+
+## Optionale Punkte
+
+| Punkt | Befehl | Hinweis |
+| --- | --- | --- |
+| Spielfeld Min | `/fb setup <arena> fieldmin` | Aktiviert Aus-/Einwurf-/Ecken-Erkennung |
+| Spielfeld Max | `/fb setup <arena> fieldmax` | Gegenüberliegende Feldecke |
+| Roter Strafraum Min | `/fb setup <arena> redpenaltymin` | Sonst automatisch aus Tor + config berechnet |
+| Roter Strafraum Max | `/fb setup <arena> redpenaltymax` | |
+| Blauer Strafraum Min | `/fb setup <arena> bluepenaltymin` | Sonst automatisch berechnet |
+| Blauer Strafraum Max | `/fb setup <arena> bluepenaltymax` | |
+| Elfmeterpunkt Rot | `/fb setup <arena> redpenaltyspot` | Standard: `ballspawn` |
+| Elfmeterpunkt Blau | `/fb setup <arena> bluepenaltyspot` | Standard: `ballspawn` |
+| Zuschauer-Spawn | `/fb setup <arena> spectatorspawn` | Standard: automatischer Feldrand |
+
+---
+
+## Numerische Einstellungen
+
+| Befehl | Standard | Beschreibung |
+| --- | --- | --- |
+| `/fb setup <arena> minplayers <n>` | 2 | Mindestspielerzahl für Auto-Start |
+| `/fb setup <arena> maxplayers <n>` | 10 | Maximale Spielerzahl |
+| `/fb setup <arena> duration <s>` | 300 | Halbzeit-Dauer in Sekunden (z. B. 300 = 5 Min) |
+
+---
+
+## Tor-Hitbox richtig setzen
+
+Die Tor-Hitbox ist ein unsichtbares 3D-Rechteck. Wird der Ball in diesem Bereich erkannt, zählt es als Tor.
+
+**Empfehlung:** Die Hitbox etwas **größer** als den sichtbaren Torrahmen wählen (mindestens 1–2 Blöcke Tiefe), damit schräge Schüsse zuverlässig erkannt werden.
+
+```
+Beispiel rotes Tor:
+  redgoalmin → stehe an der unteren linken vorderen Ecke
+  redgoalmax → stehe an der oberen rechten hinteren Ecke
+```
+
+Mit `/fb debug <arena>` kannst du die Hitbox live überprüfen.
+
+---
+
+## Setup-Status prüfen
+
+```
+/fb setup <arena> info
+```
+
+Zeigt alle gesetzten Punkte mit ✔ / ✗ und ob das Setup vollständig ist.
+
+---
+
+## Arena löschen
+
+```
+/fb delete <arena>
+```
+
+> ⚠️ Das Löschen einer Arena ist dauerhaft und kann nicht rückgängig gemacht werden. Laufende Spiele werden vorher automatisch beendet.