Un plugin cosmetico semplice, conveniente e user-friendly

Cosmetici che sembrano parte di Minecraft

StarCosmetic aggiunge slot dedicati per zaini e palloncini direttamente nell'inventario del giocatore. I giocatori possono gestire i loro cosmetici in modo naturale senza navigare in menu aggiuntivi o memorizzare comandi complicati.

• Clicca con il tasto destro per equipaggiare

• Shift + clic sinistro per disequipaggiare

• Trascina e rilascia gli oggetti direttamente nei loro slot cosmetici

• Nessun mod client-side richiesto

• Compatibile con i client e i pacchetti risorse di Minecraft vanilla

• Supporta Paper 1.21.4 e versioni successive

Gli zaini si muovono con il giocatore, mentre i palloncini presentano corde visibili, movimento flottante e animazioni basate sul momentum.

---

Caratteristiche principali

• Slot separati per zaini e palloncini

• Icone segnaposto personalizzabili per ogni slot

• Supporto per Custom Model Data e modelli di oggetti

• Compatibile con oggetti vanilla e oggetti personalizzati di altri plugin

• Impedisce l'ingresso di oggetti normali o digitati in modo errato negli slot cosmetici

• Movimento reattivo dello zaino senza ritardi evidenti

• Palloncini animati con corde e fisica del movimento

• I cosmetici sono visibili ai giocatori nelle vicinanze

• Modelli, posizioni e animazioni configurabili

---

Guida per il giocatore

Equipaggiare un cosmetico

Tieni un oggetto cosmetico registrato e clicca con il tasto destro. Il plugin lo sposta automaticamente nello slot di equipaggiamento corretto.

I giocatori possono anche aprire il loro inventario e trascinare l'oggetto nel suo slot cosmetico corrispondente. Gli oggetti non validi o i cosmetici del tipo sbagliato verranno rifiutati con una notifica.

---

Disequippare un cosmetico

Shift + clic sinistro su un cosmetico equipaggiato per spostarlo di nuovo nell'inventario del giocatore.

Se l'inventario è pieno, il cosmetico rimarrà equipaggiato per prevenire la perdita dell'oggetto.

Slot cosmetici

• Slot A — Zaino

• Slot B — Palloncino

Ogni slot ha il suo segnaposto configurabile. I proprietari del server possono personalizzarne il materiale, il Custom Model Data, il modello dell'oggetto e la visibilità del tooltip.

---

Registrazione di oggetti cosmetici

Solo gli operatori del server possono registrare nuovi oggetti cosmetici.

/scos save cosmetic [nome]
/scos save balloon [nome]

Esempi:

/scos save cosmetic red_backpack
/scos save balloon pink_balloon

Il nome è facoltativo. Se omesso, StarCosmetic genera automaticamente un identificatore unico.

Lo stesso oggetto non può essere registrato più di una volta o assegnato a più tipi di cosmetici. Se un oggetto è già stato registrato, il plugin visualizza il suo nome esistente.

---

Comandi

Registrare un oggetto

/scos save cosmetic [nome]
/scos save balloon [nome]

Dare un cosmetico a un giocatore

/scos give <giocatore> cosmetic <nome>
/scos give <giocatore> balloon <nome>

Eliminare un cosmetico registrato

/scos delete cosmetic <nome>
/scos delete balloon <nome>

Comandi aggiuntivi

/scos list
/scos reload

Tutti i comandi includono il completamento automatico per argomenti disponibili, nomi dei giocatori, tipi di cosmetici e oggetti registrati.

---

Permessi

starcosmetic.use

Consente ai giocatori di utilizzare gli slot cosmetici e equipaggiare oggetti registrati. Concesso a tutti i giocatori per impostazione predefinita.

starcosmetic.admin

Consente l'accesso ai comandi amministrativi. Concesso agli operatori del server per impostazione predefinita.

La registrazione di nuovi oggetti con /scos save è riservata direttamente agli operatori del server.

---

Sistema di zaini

• Renderizzato utilizzando un Armor Stand invisibile

• Si muove e ruota con il giocatore

• Regola la sua posizione mentre il giocatore si abbassa

• Visibile ai giocatori nelle vicinanze

• Posizione e dimensione dell'Armor Stand configurabili

Sistema di palloncini

• Renderizza il modello utilizzando un Armor Stand invisibile

• Include una corda visibile collegata al giocatore

• Presenta movimento basato su trascinamento e momentum

• Utilizza un'animazione di galleggiamento naturale

• Visibile ai giocatori nelle vicinanze

• Posizione e comportamento dell'animazione configurabili

Compatibilità con Minecraft vanilla

I giocatori possono connettersi utilizzando un client di Minecraft vanilla non modificato. Non sono richiesti mod client-side.

Le funzionalità supportate includono:

• Oggetti di Minecraft vanilla

• Custom Model Data

• Modelli di oggetti moderni

• Pacchetti risorse

• Oggetti personalizzati che memorizzano i loro dati all'interno dell'ItemStack

• Paper 1.21.4 e versioni successive (Test 1.21.4-26.1.2)

Gestione dello stato del giocatore

StarCosmetic gestisce automaticamente i cosmetici quando un giocatore:

• Entra nel server

• Esce dal server

• Viene disconnesso dal server

• Muore o rinasce

• Cambia mondo

• Si teletrasporta

Questo aiuta a prevenire la presenza di Armor Stands o entità di palloncini rimaste nel mondo.

File di configurazione

config.yml

Controlla gli slot cosmetici, i segnaposto, i modelli, il posizionamento degli zaini, le animazioni dei palloncini e i messaggi del plugin.

cosmetics.yml

Memorizza i dati completi dell'ItemStack degli zaini e dei palloncini registrati.

Gestire gli oggetti registrati tramite i comandi del plugin è consigliato invece di modificare manualmente questo file.

Pronto per lo sviluppo futuro

StarCosmetic è attivamente aperto al feedback della comunità, ai rapporti di bug e alle proposte di funzionalità.

Gli aggiornamenti futuri possono essere plasmati dalle esigenze dei giocatori e dei proprietari dei server, aiutando StarCosmetic a rimanere facile da usare, flessibile e adatto a una vasta gamma di server di Minecraft.

---

Add-on opzionale per pacchetto risorse

StarCosmetic include un add-on opzionale per pacchetto risorse contenente l'interfaccia GUI dell'inventario e le icone degli slot cosmetici mostrate nel video di presentazione.

Si prega di notare che la collezione di modelli di zaini e palloncini presentata nel video non è inclusa.

Il pacchetto add-on include:

• Asset GUI dell'inventario

• Icone degli slot per zaini e palloncini

• File di configurazione di ItemsAdder

• File di configurazione di Nexo

Questo add-on è opzionale. StarCosmetic può comunque essere utilizzato con il tuo pacchetto risorse, Custom Model Data, modelli di oggetti e design cosmetici personalizzati.