✦ MasterCosmetics ✦

by MasterCraft

Versione 1.0.0 • Paper / Purpur 1.20.6 – 1.21.x • Richiede MythicMobs


Cos'è MasterCosmetics?

MasterCosmetics è un plugin avanzato per server Minecraft che porta i cosmetici a un livello completamente nuovo. A differenza dei plugin tradizionali che si limitano a mostrare particelle statiche, MasterCosmetics sfrutta la potenza di MythicMobs per eseguire skill personalizzate sui player in risposta a eventi di gioco precisi.


Non esiste alcuna GUI: tutto è configurato tramite il file config.yml, permettendo un controllo totale su ogni aspetto del plugin senza dover navigare menu in-game. Gli admin assegnano i cosmetici ai player con un semplice comando, e i player li attivano con /mc equip.


Caratteristiche principali

● Trigger system completo — 11 eventi diversi che attivano le skill MythicMobs

● Sistema Pet — mob personalizzati che seguono il player, con skill proprie

● Nessuna GUI — configurazione 100% da YAML, massima flessibilità

● Sistema di ownership — i player possono usare solo i cosmetici che hanno ricevuto

● Persistenza dati — i cosmetici equipaggiati vengono salvati tra sessioni

● Compatibilità — Paper, Purpur, Spigot dalla 1.20.6 alla 1.21.x

● Skill su player o sul pet — ogni skill può essere eseguita dal pet o dal suo proprietario


Dipendenze

● MythicMobs (softdepend) — necessario per eseguire le skill. Senza MM i cosmetici si equipaggiano ma non producono effetti visivi.


Comandi


Chiave

Default

Descrizione

/mc list

—

Mostra tutti i cosmetici attualmente equipaggiati dal player

/mc equip <id>

—

Attiva o disattiva (toggle) un cosmetico. Richiede di possedere il cosmetico.

/mc unequip <id>

—

Rimuove un cosmetico specifico senza toggle

/mc unequipall

—

Rimuove tutti i cosmetici attivi in un colpo solo

/mc give <player> <id>

—

[Admin] Assegna un cosmetico a un player. Senza questo il player non può usarlo.

/mc remove <player> <id>

—

[Admin] Revoca un cosmetico a un player e lo deequipa se attivo

/mc reload

—

[Admin] Ricarica il config senza riavviare il server. I cosmetici vengono riapplicati ai player online.


Permessi

Chiave

Default

Descrizione

mastercosmetics.use

true

Permette di usare /mc list, equip, unequip, unequipall

mastercosmetics.admin

op

Permette /mc give, remove, reload


Sistema Trigger

Ogni cosmetico definisce una lista di trigger nel config. Quando un trigger scatta, la skill MythicMobs configurata viene eseguita sul player (o sul pet, nel caso dei cosmetici pet). È possibile assegnare più trigger allo stesso cosmetico.


Trigger

Quando si attiva

ALWAYS

Eseguito ogni N tick continuamente. Usa "interval: N" per controllare la frequenza (20 tick = 1 secondo). Ideale per aure e effetti persistenti.

ON_SPAWN

Si attiva quando il player entra nel server o respawna dopo la morte. Utile per effetti di benvenuto o respawn drammatici.

ON_DEATH

Si attiva nel momento in cui il player muore. Perfetto per effetti dell'anima o esplosioni finali.

ON_KILL_PLAYER

Si attiva quando il player elimina un altro player. Ideale per effetti di vittoria in PvP.

ON_KILL_MOB

Si attiva quando il player uccide qualsiasi mob. Utile per effetti di caccia o farming.

ON_HIT_PLAYER

Si attiva ad ogni colpo che il player assesta a un altro player. Ottimo per trail di sangue o effetti di impatto.

ON_HIT_MOB

Si attiva ad ogni colpo su un mob qualsiasi. Simile a ON_HIT_PLAYER ma per PvE.

ON_JUMP

Si attiva una volta ad ogni salto del player. Perfetto per burst di particelle o sonic booms.

ON_FLY_TICK

Eseguito ogni N tick mentre il player vola (elytra o volo creativo). Usa "interval: N".

ON_WALK

Eseguito ogni N tick mentre il player cammina a terra. Si interrompe quando si ferma.

ON_IDLE

Eseguito ogni N tick mentre il player è fermo a terra. Si interrompe quando si muove.


Riferimento Config

Sezione: settings

Chiave

Default

Descrizione

debug

false

Se true, stampa nei log ogni operazione interna: skill eseguite, attributi applicati, pathfinding dei pet. Utile per trovare problemi, da disattivare in produzione.

prefix

&8[&5..&8]

Il prefisso che appare davanti a ogni messaggio del plugin in chat. Supporta i codici colore &.


Sezione: messages

Tutti i messaggi visibili ai player. Supportano i codici colore & e i seguenti placeholder:


Chiave

Default

Descrizione

equip

...

Messaggio quando un player equipa un cosmetico. Placeholder: {name} = nome display del cosmetico.

unequip

...

Messaggio quando rimuove un cosmetico. Placeholder: {name}.

unequip-all

...

Messaggio quando usa /mc unequipall.

no-permission

...

Mostrato quando un player non ha il permesso per un'azione.

not-found

...

Mostrato quando l'ID del cosmetico non esiste. Placeholder: {id}.

not-owned

...

Mostrato quando un player tenta di equipaggiare un cosmetico che non possiede.

give-done

...

Messaggio admin dopo /mc give. Placeholder: {name}, {player}.

remove-done

...

Messaggio admin dopo /mc remove. Placeholder: {name}, {player}.

reload

...

Messaggio admin dopo /mc reload.

list-header

...

Intestazione della lista cosmetici equipaggiati.

list-entry

...

Riga per ogni cosmetico nella lista. Placeholder: {id}, {category}.

list-empty

...

Mostrato se il player non ha cosmetici attivi.


Configurare un cosmetico

Ogni cosmetico è definito nella sezione cosmetics: del config con un ID univoco (senza spazi). Ecco tutti i campi disponibili:


Chiave

Default

Descrizione

display-name

—

Nome del cosmetico mostrato nei messaggi in chat. Supporta codici colore &.

category

misc

Categoria di appartenenza (particles, auras, trails, pets, ecc.). Usata solo per organizzazione e nella lista /mc list.

description

—

Descrizione testuale del cosmetico. Non mostrata in-game di default, ma disponibile per espansioni future.

mythicmobs-skill

—

Nome ESATTO della skill definita in MythicMobs che viene eseguita quando scatta un trigger. Case-sensitive. Lascia vuoto ("") se il cosmetico usa solo il pet.

triggers

[]

Lista di trigger che attivano la skill sul player. Vedi sezione Trigger per tutti i tipi disponibili. Può contenere più trigger contemporaneamente.

pet

—

Sezione opzionale per configurare un pet. Se presente e enabled: true, uno specifico mob viene spawnato come compagno del player.


Configurare un Pet

La sezione pet: all'interno di un cosmetico permette di spawnare un mob personalizzato che segue il player. Il pet non può essere colpito dal proprio proprietario (sempre), e può essere reso immune a qualsiasi danno con l'opzione immune: true.


Chiave

Default

Descrizione

enabled

false

Abilita o disabilita il pet per questo cosmetico. Se false, la sezione pet viene ignorata completamente.

mob-type

PIG

Il tipo di mob da spawnare. Deve corrispondere a un EntityType Bukkit valido (PANDA, COW, WOLF, FOX, BEE, ecc.). Case-insensitive.

name

&7Pet

Il nome mostrato sopra il pet. Supporta codici colore & e il placeholder {player} che viene sostituito con il nome del proprietario.

scale

1.0

Fattore di scala del mob. 0.5 = metà dimensione, 1.0 = normale, 2.0 = doppio. Richiede Paper/Purpur 1.20.5+. Su versioni precedenti viene ignorato.

follow-distance

3.0

Distanza in blocchi dal player oltre la quale il pet tenta di avvicinarsi. Se supera followDistance×4, il pet si teletrasporta dietro al player.

immune

false

Se true, il pet è completamente invulnerabile a qualsiasi fonte di danno: fuoco, cadute, attacchi, esplosioni, ecc.

move-speed

0.3

Velocità di movimento del pet. Valori tipici: 0.2 (lento) → 0.35 (normale) → 0.7 (veloce). Modifica l'attributo GENERIC_MOVEMENT_SPEED.

always-skill

""

Skill MythicMobs eseguita periodicamente dal pet, indipendentemente dai trigger. Come il trigger ALWAYS ma gestita dal pet stesso.

always-interval

40

Frequenza in tick di always-skill. 20 = ogni secondo, 40 = ogni 2 secondi.

always-caster

pet

Chi esegue always-skill: "pet" = la skill viene castata dal pet (effetti visivi intorno al pet), "player" = viene castata dal player (effetti intorno al player).

trigger-skill

""

Skill MythicMobs eseguita quando scatta uno dei trigger nella lista triggers del pet.

trigger-caster

pet

Chi esegue trigger-skill: "pet" o "player". Funziona come always-caster ma per i trigger.

triggers

[]

Lista di trigger che attivano trigger-skill per il pet. Usa gli stessi nomi dei trigger del player (ON_KILL_MOB, ON_HIT_PLAYER, ON_SPAWN, ecc.).


Valori move-speed di riferimento

Chiave

Default

Descrizione

0.15

—

Molto lento — adatto per pet decorativi grandi e imponenti

0.25

—

Lento — buono per pet di grossa taglia come panda giganti

0.30

—

Velocità vanilla di default per la maggior parte dei mob

0.35

—

Leggermente più veloce — raccomandato per pet normali

0.50

—

Veloce — simile a un cavallo al trotto

0.70

—

Molto veloce — per pet agili come volpi o gatti


Note importanti

Come aggiungere un cosmetico

1. Crea la skill in MythicMobs (file .yml nella cartella skills di MM).

2. Aggiungi il cosmetico nel config di MasterCosmetics con il nome della skill.

3. Fai /mc reload per ricaricare senza riavviare.

4. Usa /mc give <player> <id> per assegnare il cosmetico al player.

5. Il player usa /mc equip <id> per attivarlo.


Debug

Attiva debug: true nel config per vedere nei log del server ogni skill eseguita, ogni attributo applicato e ogni errore di pathfinding. Ricorda di reimpostarlo a false in produzione.


Compatibilità scale e pathfinding

L'attributo SCALE per ridimensionare i pet richiede Paper/Purpur 1.20.5 o superiore. Il pathfinding NMS funziona su tutte le versioni tramite reflection. Se il pet non cammina, scatta automaticamente il teleport quando supera followDistance×4 blocchi di distanza.