Plugin Minecraft PhoenixCrates

🔌 Informazioni su Phoenix Crates

Phoenix Crates è un plugin Minecraft per gestire sistemi di crate/ricompense su un server. Offre tipi di crate, chiavi (fisiche e virtuali), sequenze di apertura animate e un editor in-game per creare e gestire crate e ricompense senza modificare i file grezzi. Il progetto è pubblicato da Phoenix Plugins ed è disponibile in una versione gratuita e in una versione premium a pagamento con funzioni extra.

🎯 Scopo

Fornire agli amministratori del server un sistema di ricompense/crate configurabile che possa mostrare aperture animate, gestire chiavi e chiavi in stile valuta virtuale e permettere allo staff di creare o modificare crate e ricompense in gioco. È pensato per server che vogliono meccaniche in stile evento o negozio/ricompensa (per esempio: giveaway di ricompense, crate dello shop o premi evento).

⚙️ Funzionalità

• Più modalità di motore crate (blocco vanilla, modello vanilla, integrazione con Model Engine).
• Sequenze di apertura animate e animazioni di inattività con fasi e combinazioni configurabili.
• Chiavi fisiche e gestione delle chiavi virtuali (menu delle chiavi virtuali, comandi paga/trasferisci, dai/togli/imposta).
• Editor in-game per creare/modificare crate, chiavi, ricompense e animazioni.
• Tipi di ricompensa che includono ricompense casuali e selettive (il giocatore sceglie), reroll e ricompense garantite.
• Add-on ed extra premium (animazioni aggiuntive, supporto MySQL, API e installazione add-on nel piano premium).
• Supporto base alla visualizzazione Bedrock/Geyser per alcune animazioni e modelli.
• Strumenti lato server per l’anteprima e la gestione delle ricompense (limiti globali/per giocatore, reset dei cooldown).

🧩 A chi è rivolto

• Server Survival/SMP ed economy che presentano crate o sistemi di ricompensa.
• Server che vogliono aperture di crate animate/visive e supporto ai modelli (Model Engine).
• Amministratori che preferiscono un editor in-game per configurare le crate invece della modifica manuale dei file.

🏗️ Casi d’uso di esempio

• Dare ai giocatori chiavi virtuali che possono spendere in una GUI per aprire crate di cosmetici o oggetti.
• Creare crate a tema festivo con animazioni di apertura personalizzate e ricompense limitate.
• Usare l’editor in-game per migrare o ricostruire configurazioni di crate senza modificare YAML manualmente.

⌨️ Comandi

(I comandi sopra sono tratti dalla documentazione ufficiale di Phoenix Crates e dal riferimento ai comandi.)

🔐 Permessi

(Sono elencati solo i nodi di permesso documentati esplicitamente dal progetto.)

⚙️ Installazione

📥 Configurazione

• Scarica il JAR ufficiale del plugin Phoenix Crates oppure ottienilo dal canale di distribuzione ufficiale.
• Inserisci il JAR nella directory plugins/ del tuo server per un server supportato (vedi Note tecniche).
• Avvia o riavvia il server e controlla la console per confermare che il plugin sia stato caricato.
• Usa l’editor in-game o i comandi forniti per creare crate e chiavi; il plugin fornisce anche i comandi di reload e editor.

📦 Dipendenze

• Per impostazione predefinita non sono elencate dipendenze di terze parti obbligatorie. Il plugin si integra con sistemi opzionali come Model Engine per modelli personalizzati e fornisce placeholder citati nei changelog.

🧠 Note tecniche

• Software server supportato (come indicato dall’autore): Spigot e fork di Spigot, Paper e fork di Paper, e Folia.
• Versioni di Minecraft supportate: come documentato, Phoenix Crates (alla versione indicata) supporta Minecraft 1.20.4+ (il supporto per le versioni precedenti è stato rimosso con la release principale indicata).
• Integrazioni opzionali: Model Engine (modelli animati personalizzati), note di compatibilità GeyserMC per la visualizzazione Bedrock e placeholder di PlaceholderAPI menzionati negli aggiornamenti.
• Il progetto è offerto in livelli gratuito e premium; il premium aggiunge funzioni come supporto MySQL, accesso API pubblico, crate illimitate, animazioni aggiuntive e add-on.

🤝 Quando questo plugin è utile

Se hai bisogno di un sistema di crate configurabile e basato sulle animazioni, con editor in-game e supporto opzionale per modelli/Bedrock, Phoenix Crates offre sia elementi visivi per i giocatori sia strumenti amministrativi per gestire ricompense e chiavi dal server.