From 1b9680bd4ecb94033f965b8fcc6e3e51edfd88aa Mon Sep 17 00:00:00 2001
From: M_Viper <admin@m-viper.de>
Date: Sun, 1 Feb 2026 21:41:01 +0000
Subject: [PATCH] =?UTF-8?q?Soccer=20hinzugef=C3=BCgt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Soccer.md | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 Soccer.md

diff --git a/Soccer.md b/Soccer.md
new file mode 100644
index 0000000..3c05ff1
--- /dev/null
+++ b/Soccer.md
@@ -0,0 +1,64 @@
+# Soccer Module
+
+Das **Soccer-Modul** ist eine interaktive Lobby-Komponente für **NexusLobby**.  
+Es implementiert einen physikbasierten Fußball auf Basis von ArmorStands und Custom-Skins.
+
+---
+
+## 📋 Features
+
+- **Physik-Engine**  
+  Automatisches Dribbling bei Annäherung und Schuss-Funktion per Linksklick.
+
+- **Custom Texture**  
+  Hochauflösender Fußball-Skin via Bukkit-Profile-API  
+  *(Minecraft 1.21+ kompatibel)*
+
+- **Interaction-Guard**  
+  Vollständiger Schutz gegen Diebstahl des Items oder Zerstörung des Entities.
+
+- **Smart-Respawn**  
+  Automatisches Zurücksetzen bei Inaktivität oder Verlust des Balls (Void).
+
+---
+
+## ⌨️ Administrative Commands
+
+Alle Befehle benötigen die Permission:
+
+```text
+nexuslobby.admin
+```
+
+---
+
+## ⌨️ Administrative Commands
+
+| Command | Aktion |
+|--------|--------|
+| `/nexuslobby ball setspawn` | Speichert den aktuellen Standort als permanenten Ball-Spawn |
+| `/nexuslobby ball respawn` | Erzwingt ein sofortiges Neuladen des Ball-Entities |
+
+---
+
+## 🛠 Konfiguration (`config.yml`)
+
+Die Werte werden unter dem `ball`-Pfad verwaltet:
+
+```yaml
+ball:
+  spawn: # (Wird automatisch via Command gesetzt)
+  respawn_delay: 60 # Zeit in Sekunden, bis der Ball bei Inaktivität respawnt
+```
+
+---
+
+## 🧱 Technische Spezifikationen
+
+- **Base-Entity:** ArmorStand (Small, Invisible)
+
+- **Texture-URL:**  
+  `http://textures.minecraft.net/texture/451f8cfcfb85d...`
+
+- **Spawn-Logik:**  
+  Nutzt einen Schwerkraft-Offset von `+0.5`, um Clipping-Fehler im Boden zu vermeiden.