Plugin Minecraft ExcellentCrates

🔌 Informazioni su ExcellentCrates

ExcellentCrates è un plugin Minecraft per server Spigot/Paper che implementa un sistema di crates (lootbox) completo. Si concentra su tipi di crate configurabili, gestione delle chiavi (virtuali e fisiche) e definizioni flessibili delle ricompense che gli amministratori del server possono gestire principalmente tramite un editor GUI in gioco.

🎯 Scopo

Il plugin risolve il problema di creare, configurare e presentare ricompense basate su crate su un server senza richiedere modifiche manuali ai file. È pensato per proprietari e amministratori di server che vogliono usare crate di ricompensa (per eventi, ricompense giornaliere, funzionalità monetizzate o progressione dei giocatori) mantenendo configurazione e anteprime accessibili in gioco.

⚙️ Funzionalità

• Editor GUI in gioco per creare e gestire crate, chiavi e ricompense.
• Supporto per chiavi fisiche e virtuali (le chiavi virtuali impediscono scambi/condivisioni).
• Ologrammi integrati ed effetti particellari per i blocchi crate (per alcune funzioni di ologramma potrebbero essere necessari plugin opzionali).
• Crate Blocks: collega le crate a blocchi/zone fisiche per l’interazione con le crate nel mondo.
• GUI personalizzate di anteprima e GUI personalizzate di apertura per ogni crate.
• Tipi di ricompensa: ricompense oggetto e ricompense comando.
• Supporto bundle: più stack di oggetti per ricompensa (limite documentato fino a 27 oggetti per ricompensa oggetto) e comandi illimitati per ricompensa comando.
• Rarità e pesi per bilanciare la probabilità delle ricompense.
• Traguardi e funzionalità di apertura massiva.
• Cooldown di apertura e costo di apertura per giocatore (l’integrazione con l’economia è implicita nella funzione di costo di apertura).
• Requisiti di permesso e di chiave per crate e ricompense.
• Limiti di ricompensa (globali e per giocatore) e trasmissione/log delle ricompense.
• Supporto a PlaceholderAPI indicato dalle fonti ufficiali.

🧩 A chi è rivolto

• Server Spigot/Paper pubblici e privati che usano le crate per eventi, monetizzazione o coinvolgimento dei giocatori.
• Amministratori di server che preferiscono un editor in gioco rispetto alla modifica manuale dei file YAML.

🏗️ Esempi d’uso

• Configura una crate con rarità e ricompense pesate, posiziona un blocco crate nello spawn e dai ai giocatori chiavi virtuali per aprirla.
• Crea anteprime delle crate e ologrammi in modo che i giocatori possano esaminare le ricompense prima di spendere le chiavi.
• Usa l’apertura massiva e i traguardi per organizzare eventi a tempo limitato o premiare i giocatori attivi.

⚙️ Installazione

📥 Configurazione

• Scarica il JAR ufficiale del plugin e inseriscilo nella directory plugins/ del tuo server su una build del server confermata compatibile (Spigot o Paper).
• Riavvia il server e controlla la console per confermare che il plugin sia stato caricato.
• Se il plugin richiede la dipendenza del motore companion, installa il plugin dipendente richiesto (nightcore) prima o insieme a ExcellentCrates.

📦 Dipendenze

• Richiesta: nightcore (motore del plugin), come indicato dalle fonti ufficiali.
• Facoltativa: ProtocolLib o PacketEvents per funzionalità avanzate di ologramma; PlaceholderAPI è supportato per i placeholder nei testi.

🧠 Note tecniche

• Software server supportato confermato: Spigot e Paper.
• Requisito minimo di versione del server confermato: 1.21.8 o superiore (come indicato dal progetto).
• Requisito Java confermato: Java 21 o successivo.
• Il supporto per Folia e Forge non è esplicitamente disponibile.
• Il repository del progetto riporta una licenza GPL-3.0.

🤝 Quando questo plugin è utile

Se ti serve un sistema di crate configurabile in gioco con chiavi virtuali/fisiche, ologrammi e definizioni flessibili delle ricompense (oggetti, comandi, rarità e limiti) per un server Spigot/Paper, ExcellentCrates offre queste funzioni e un flusso di lavoro nell’editor che mantiene gran parte della configurazione gestibile senza modifiche manuali ai file.