CrazyCrates — un plugin per aggiungere casse personalizzate e bauli premio su Minecraft

CrazyCrates — un plugin per aggiungere casse personalizzate e bauli premio su Minecraft

CrazyCrates permette di aggiungere casse (crates) su un server Minecraft. Ogni cassa è un blocco nel mondo o un elemento in un menu che il giocatore apre con una chiave per ricevere un premio casuale. Il plugin offre 11 tipi diversi di animazioni, due tipi di chiavi — fisiche (oggetti nell'inventario) e virtuali (salvate nel database) — e un sistema di probabilità basato sul peso invece delle percentuali. È distribuito gratuitamente. 

Menu principale /crates con casse mostrate come oggetti nell'inventario 

Tipi di casse 

Ogni cassa sul server è un file .yml separato nella cartella crates/. Il file ha un parametro CrateType, che determina l'animazione di apertura.

Al primo avvio, il plugin genera 6 esempi pronti all'uso che coprono 5 tipi confermati. Puoi aprirne uno qualsiasi per un test senza chiave con il comando /crazycrates forceopen <nome_file> <nickname>.

Tutte le casse di base disponibili 

Scroll - nell'inventario appare un nastro orizzontale di oggetti, che scorre, rallenta gradualmente e si ferma sull'oggetto vincente al centro. Questo tipo è usato da due esempi — CrateExample.yml e AdvancedExample.yml.

Esecuzione di CrateExample — un nastro orizzontale di oggetti scorre e si ferma su quello vincente

Cosmic — nell'inventario appaiono vari premi tra cui scegliere. Il giocatore clicca su quello che vuole prendere. Se non viene selezionato nulla in 10 secondi, il plugin assegna un premio automaticamente. Casino — una cassa con livelli (tiers). L'animazione determina prima il livello, poi al suo interno — il premio specifico. 

QuadCrate — all'apertura, quattro blocchi-cassa fisici spawnano intorno al giocatore nel mondo. Il giocatore si avvicina a ciascuno e li apre uno per uno — ognuno dà un premio separato. 

Wonder — appare una finestra con l'inventario completo da cui gli oggetti scompaiono gradualmente; quello che rimane sarà il premio.

Chiavi

Ogni cassa usa la propria chiave. Una chiave fisica — è un normale oggetto con aspetto, nome e descrizione (lore) personalizzati, che il giocatore tiene nel suo inventario. Una chiave virtuale non occupa spazio — è memorizzata nel database del plugin ed è vincolata all'account del giocatore.

Di default, un blocco-cassa fisico accetta entrambi i tipi. Il comportamento può essere modificato in config.yml separatamente per ogni combinazione.

Se l'inventario del giocatore è pieno alla ricezione di una chiave, il plugin la converte in una virtuale o la fa cadere a terra — a seconda delle impostazioni. Tentare di aprire una cassa senza chiave respingerà il giocatore.

Gli amministratori possono dare e togliere chiavi anche a giocatori offline, distribuire una chiave a tutti i giocatori online contemporaneamente tramite un solo comando, o dare una chiave casuale di tutte le casse disponibili. I giocatori con il permesso appropriato possono trasferire le proprie chiavi virtuali ad altri.

Chiave fisica di una cassa — un oggetto con descrizione personalizzata

Sistema di probabilità 

La probabilità di ogni premio non è determinata in percentuali, ma dal peso — il parametro Weight nel file della cassa. Più alto è il valore del peso, più spesso esce il premio; più basso è, meno spesso esce.

Il raggio massimo è la somma di tutti i pesi nella cassa. Se tre premi hanno pesi di 10, 15 e 25, il raggio è 50. La probabilità del primo è del 20%, del secondo — 30%, e del terzo — 50%.

Il vantaggio di questo approccio rispetto alle percentuali: non c'è bisogno di assicurarsi che la somma non superi 100. Si possono semplicemente impostare valori relativi e aggiungere nuovi premi senza ricalcolare il resto.

Comandi

Il comando principale del plugin è /crazycrates, con gli alias /crates e /cc. I giocatori hanno accesso solo a /keys (vedere le proprie chiavi) e /crates (aprire il menu).

Comandi admin:

• /crazycrates give e /crazycrates take — dare o togliere una chiave a un giocatore specifico, anche offline.

• /crazycrates giveall — distribuire una chiave a tutti i giocatori online simultaneamente.

• /crazycrates forceopen — aprire una cassa per un giocatore gratuitamente, senza chiave.

• /crazycrates editor — modalità piazzamento casse nel mondo: punti a un blocco e ci leghi una cassa.

• /crazycrates debug — ottenere tutti i premi della cassa in una volta per testare le impostazioni.

• /crazycrates mass-open — apertura di massa di un numero specificato di casse alla volta.

• /crazycrates reload — ricaricare tutte le configurazioni senza riavviare il server.

• /crazycrates migrate — importare casse da altri plugin o convertire vecchi formati di file.

I permessi sono divisi in tre wildcard: crazycrates.players.* per i giocatori, crazycrates.admin.* per gli admin, crazycrates.schematic.* per lavorare con le schematics. Un giocatore può essere escluso da una distribuzione di massa /giveall tramite un permesso separato.

Configurazione

Tutti i file del plugin si trovano nella cartella plugins/CrazyCrates/. Il principale è config.yml, dove si concentrano le impostazioni globali del server. Le casse sono salvate nella sottocartella crates/ — ognuna in un file separato. La cartella examples/ contiene esempi degli sviluppatori, ma non dovresti modificarli: viene sovrascritta completamente a ogni /crazycrates reload. Tutti i testi dei messaggi sono spostati in messages.yml e modificati separatamente.

In config.yml, dovresti prestare attenzione a un paio di cose. Gli ologrammi sopra le casse appaiono automaticamente se sul server è installato DecentHolograms, FancyHolograms o CMI — il plugin li rileverà da solo. Se non ce n'è nessuno, semplicemente non ci saranno ologrammi. I messaggi per i giocatori possono essere inviati in chat o nella action bar — a seconda di come è configurato il server. La registrazione delle azioni con chiavi e casse è abilitata separatamente per la console e per il file; i log dei file vengono archiviati in uno zip al riavvio.

Ogni cassa è configurata nel suo file personale. Oltre al tipo di animazione e alla lista dei premi, si definisce l'aspetto della chiave fisica, il testo dell'ologramma sopra il blocco, la dimensione e il design della finestra di anteprima, i suoni durante lo scorrimento e alla fine, oltre alla possibilità di rilanciare (reroll) il premio se il risultato non è soddisfacente.

Conclusione

CrazyCrates aggiunge sistemi di animazione sia per gli store delle donazioni che per la progressione di gioco in survival. Il sistema di probabilità a peso è più comodo delle percentuali durante le modifiche frequenti — non c'è bisogno di ricalcolare l'intera lista ogni volta.

Per i server PvP e survival con un sistema di donazioni, CrazyCrates è una scelta conveniente. Per un server semplice dove serve una sola cassa senza animazioni, QuickCrate e una configurazione minima saranno sufficienti.