Minecraft-Plugin UltraCosmetics

🔌 Über UltraCosmetics

UltraCosmetics ist ein Spigot/Paper-Minecraft-Plugin, das einem Server eine breite Palette an Spieler-Cosmetics und visuellen Effekten hinzufügt. Es bietet ein GUI-basiertes Menü sowie Systeme für Pets, Mounts, Gadgets, Partikeleffekte, Projektil-Effekte, Todeseffekte, Emotes, Hüte, Morphs, Suits und Schatztruhen. Das Projekt ist Open Source und wird auf GitHub gepflegt.

🎯 Zweck

UltraCosmetics wurde entwickelt, um Serverbetreibern ein modulares Cosmetics-System bereitzustellen, mit dem Spieler kosmetische Gegenstände und Effekte über ein In-Game-Menü aufrufen und ausrüsten können. Es erfüllt den Bedarf an kosmetischer Anpassung ohne Einfluss auf das Gameplay und an monetarisierbaren Cosmetic-Inhalten, während die Funktionalität von den eigentlichen Spielmechaniken getrennt bleibt.

⚙️ Funktionen

• GUI-Menü zum Durchsuchen und Ausrüsten von Cosmetics.
• Cosmetic-Kategorien wie Pets, Mounts, Gadgets, Hats, Particle Effects, Projectile Effects, Death Effects, Emotes, Morphs und Suits.
• Schatztruhen-Funktion zum Freischalten von Cosmetics.
• Konfigurierbarer Speicher für freigeschaltete Cosmetics (Spieler-Datendateien oder ein SQL-Backend, wie vom Projekt unterstützt).
• Übersetzungsunterstützung (mehrere vom Projekt gepflegte Sprachen).

🧩 Für wen es gedacht ist

Für Serverbesitzer und Administratoren, die ihren Spigot- oder Paper-Servern kosmetische Inhalte hinzufügen möchten: öffentliche Minigame-/Lobby-Server, SMP-Netzwerke mit Cosmetic-Shops und jeder Server, der spielerorientierte kosmetische Anpassungen ohne Änderung des Kern-Gameplays möchte.

🏗️ Beispielanwendungen

• Ein Cosmetics-Menü in der Lobby bereitstellen, damit Spieler Pets und Partikeleffekte ausrüsten können.
• Staff oder Spielern über Befehle oder das GUI Zugriff auf besondere Gadgets oder Emotes geben.
• Schatztruhen verwenden, um Spielern zufällige kosmetische Belohnungen zu geben.
• Freischaltungen von Spieler-Cosmetics in den Datendateien des Servers oder in einer verbundenen SQL-Datenbank speichern, wenn dies konfiguriert ist.

⌨️ Befehle

(Hinweis: Diese Befehlssyntax stammt aus der Projektdokumentation zur Nutzung der Schatztruhe.)

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Lade die offizielle Plugin-JAR von den offiziellen Distributionsseiten des Projekts herunter.
• Lege die JAR in das Verzeichnis plugins/ des Spigot- oder Paper-Servers.
• Starte den Server neu und prüfe die Konsolenlogs, um zu bestätigen, dass das Plugin geladen wurde.

📦 Abhängigkeiten

• Im Projekt-README sind standardmäßig keine erforderlichen Drittanbieter-Abhängigkeiten angegeben. (Externe Abhängigkeiten nur hinzufügen, wenn sie ausdrücklich konfiguriert sind.)

🧾 Konfiguration

• Das Plugin verwendet Konfigurations- und Datendateien; standardmäßig werden freigeschaltete Cosmetics in Spieler-Datendateien oder in einer verbundenen SQL-Datenbank gespeichert, wenn dies konfiguriert ist.
• Ein Projekt-Wiki und ein Quick-Start-Guide bieten Einrichtungsoptionen und Konfigurationsdetails.

🧠 Technische Hinweise

• Unterstützt offiziell Spigot- und Paper-Serversoftware.
• Das Projekt bietet Kompatibilitäts-Hinweise für unterschiedliche Projektversionen; siehe die Projektdokumentation für die exakt unterstützten Minecraft-Bereiche pro Release.
• Der Quellcode wird unter der GNU Affero General Public License v3.0 veröffentlicht.
• Fehlerberichte und Entwicklung laufen über das Projekt-Repository.

🤝 Wann dieses Plugin nützlich ist

Wenn du ein gepflegtes, GUI-gesteuertes Cosmetics-System für einen Spigot- oder Paper-Server brauchst, das viele Cosmetic-Kategorien und konfigurierbaren Speicher für freigeschaltete Inhalte unterstützt, bietet UltraCosmetics eine Open-Source-Option mit Dokumentation im Repository und Community-Support.