Soccer hinzugefügt

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.