Ein einfaches, praktisches und benutzerfreundliches Kosmetik-Plugin

Kosmetika, die sich wie ein Teil von Minecraft anfühlen

StarCosmetic fügt dem Inventar des Spielers spezielle Rucksack- und Ballon-Slots hinzu. Spieler können ihre Kosmetika ganz natürlich verwalten, ohne zusätzliche Menüs navigieren oder komplizierte Befehle merken zu müssen.

• Rechtsklick, um auszustatten

• Shift + Linksklick, um abzulegen

• Ziehen und Ablegen von Gegenständen direkt in ihre Kosmetik-Slots

• Keine Client-seitigen Mods erforderlich

• Kompatibel mit Vanilla-Minecraft-Clients und Ressourcenpaketen

• Unterstützt Paper 1.21.4 und neuer

Rucksäcke bewegen sich mit dem Spieler, während Ballons sichtbare Leinen, schwebende Bewegungen und momentumbasierte Animationen bieten.

---

Hauptmerkmale

• Getrennte Slots für Rucksäcke und Ballons

• Anpassbare Platzhalter-Icons für jeden Slot

• Unterstützung für benutzerdefinierte Modell-Daten und Artikelmodelle

• Kompatibel mit Vanilla-Gegenständen und benutzerdefinierten Gegenständen aus anderen Plugins

• Verhindert, dass reguläre oder falsch eingegebene Gegenstände in Kosmetik-Slots gelangen

• Reaktionsschnelle Rucksackbewegung ohne merkliches Nachziehen

• Animierte Ballons mit Leinen und Bewegungsphysik

• Kosmetika sind für nahegelegene Spieler sichtbar

• Konfigurierbare Modelle, Positionen und Animationen

---

Spielerhandbuch

Ausstattung eines Kosmetikartikels

Halten Sie einen registrierten Kosmetikartikel und klicken Sie mit der rechten Maustaste. Das Plugin verschiebt ihn automatisch in den richtigen Ausrüstungs-Slot.

Spieler können auch ihr Inventar öffnen und den Artikel in den entsprechenden Kosmetik-Slot ziehen. Ungültige Artikel oder Kosmetika des falschen Typs werden mit einer Benachrichtigung abgelehnt.

---

Ablegen eines Kosmetikartikels

Shift + Linksklick auf einen ausgestatteten Kosmetikartikel, um ihn zurück ins Inventar des Spielers zu bewegen.

Wenn das Inventar voll ist, bleibt das Kosmetikartikel ausgestattet, um den Verlust von Gegenständen zu verhindern.

Kosmetik-Slots

• Slot A — Rucksack

• Slot B — Ballon

Jeder Slot hat seinen eigenen konfigurierbaren Platzhalter. Serverbesitzer können sein Material, benutzerdefinierte Modell-Daten, Artikelmodell und Tooltip-Sichtbarkeit anpassen.

---

Registrierung von Kosmetikartikeln

Nur Serverbetreiber können neue Kosmetikartikel registrieren.

\/scos save cosmetic [name]
\/scos save balloon [name]

Beispiele:

\/scos save cosmetic red_backpack
\/scos save balloon pink_balloon

Der Name ist optional. Wenn er weggelassen wird, generiert StarCosmetic automatisch eine eindeutige Kennung.

Dasselbe Element kann nicht mehr als einmal registriert oder mehreren Kosmetiktypen zugewiesen werden. Wenn ein Element bereits registriert wurde, zeigt das Plugin seinen bestehenden Namen an.

---

Befehle

Ein Element registrieren

\/scos save cosmetic [name]
\/scos save balloon [name]

Einem Spieler ein Kosmetikartikel geben

\/scos give <player> cosmetic <name>
\/scos give <player> balloon <name>

Einen registrierten Kosmetikartikel löschen

\/scos delete cosmetic <name>
\/scos delete balloon <name>

Zusätzliche Befehle

\/scos list
\/scos reload

Alle Befehle beinhalten die Tab-Vervollständigung für verfügbare Argumente, Spielernamen, Kosmetiktypen und registrierte Artikel.

---

Berechtigungen

starcosmetic.use

Erlaubt Spielern, die Kosmetik-Slots zu nutzen und registrierte Artikel auszustatten. Standardmäßig allen Spielern gewährt.

starcosmetic.admin

Erlaubt den Zugriff auf administrative Befehle. Standardmäßig Serverbetreibern gewährt.

Die Registrierung neuer Artikel mit \/scos save ist direkt auf Serverbetreiber beschränkt.

---

Rucksack-System

• Gerendert mit einem unsichtbaren Rüstungsstand

• Bewegt und rotiert sich mit dem Spieler

• Passt seine Position an, während der Spieler schleicht

• Sichtbar für nahegelegene Spieler

• Konfigurierbare Position und Rüstungsstandgröße

Ballon-System

• Modell wird mit einem unsichtbaren Rüstungsstand gerendert

• Beinhaltet eine sichtbare Leine, die mit dem Spieler verbunden ist

• Bietet Zieh- und momentumbasierte Bewegung

• Verwendet eine natürliche schwebende Animation

• Sichtbar für nahegelegene Spieler

• Konfigurierbare Position und Animationsverhalten

Kompatibilität mit Vanilla Minecraft

Spieler können sich mit einem unveränderten Vanilla-Minecraft-Client verbinden. Keine Client-seitigen Mods erforderlich.

Unterstützte Funktionen umfassen:

• Vanilla-Minecraft-Gegenstände

• Benutzerdefinierte Modell-Daten

• Moderne Artikelmodelle

• Ressourcenpakete

• Benutzerdefinierte Gegenstände, die ihre Daten innerhalb des ItemStacks speichern

• Paper 1.21.4 und neuer (Test 1.21.4-26.1.2)

Spielerstatusverwaltung

StarCosmetic verwaltet automatisch Kosmetika, wenn ein Spieler:

• Dem Server beitritt

• Den Server verlässt

• Vom Server getrennt wird

• Stirbt oder respawnt

• Welten wechselt

• Teleportiert

Dies hilft, zu verhindern, dass übrig gebliebene Rüstungsstände oder Ballon-Entitäten in der Welt verbleiben.

Konfigurationsdateien

config.yml

Steuert Kosmetik-Slots, Platzhalter, Modelle, Rucksackpositionierung, Ballonanime und Plugin-Nachrichten.

cosmetics.yml

Speichert die vollständigen ItemStack-Daten von registrierten Rucksäcken und Ballons.

Es wird empfohlen, registrierte Artikel über die Befehle des Plugins zu verwalten, anstatt diese Datei manuell zu bearbeiten.

Bereit für zukünftige Entwicklungen

StarCosmetic ist aktiv offen für Feedback der Community, Fehlerberichte und Vorschläge für Funktionen.

Zukünftige Updates können durch die Bedürfnisse der Spieler und Serverbesitzer gestaltet werden, um StarCosmetic benutzerfreundlich, flexibel und für eine breite Palette von Minecraft-Servern geeignet zu halten.

---

Optionales Ressourcenpaket-Add-on

StarCosmetic enthält ein optionales Ressourcenpaket-Add-on, das die Inventar-GUI und Kosmetik-Slot-Icons enthält, die im Showcase-Video gezeigt werden.

Bitte beachten Sie, dass die im Video gezeigte Sammlung von Rucksack- und Ballonmodellen nicht enthalten ist.

Das Add-on-Paket enthält:

• Inventar-GUI-Assets

• Rucksack- und Ballon-Slot-Icons

• ItemsAdder-Setup-Dateien

• Nexo-Setup-Dateien

Dieses Add-on ist optional. StarCosmetic kann weiterhin mit Ihrem eigenen Ressourcenpaket, benutzerdefinierten Modell-Daten, Artikelmodellen und benutzerdefinierten Kosmetikdesigns verwendet werden.