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.