1
Soccer
M_Viper edited this page 2026-02-01 21:41:01 +00:00

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:

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:

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.