Plugin Minecraft MyCommand

🔌 Informazioni su MyCommand

MyCommand è un plugin per Minecraft che permette di creare comandi personalizzati, alias e interfacce interattive basate sui comandi senza scrivere Java. Fornisce un sistema basato su YAML per definire comandi che eseguono altri comandi, inviano testo formattato, aprono GUI, attivano script e interagiscono con gli eventi.

🎯 Scopo

MyCommand è pensato per gli amministratori di server che hanno bisogno di comandi personalizzati flessibili, scorciatoie e interfacce di amministrazione/utente. Risolve il problema di aggiungere comportamenti su misura ai comandi (ritardi, warmup, cooldown, completamento con tab, placeholder) e interazioni leggere con GUI senza sviluppare un plugin completo.

⚙️ Funzionalità

• Creare nuovi comandi e alias, con registrazione opzionale per il completamento con tab.
• Eseguire più comandi da un singolo comando personalizzato (esecuzione da console o dal giocatore).
• Ritardi, warmup e cooldown per i comandi.
• Sovrascrivere altri comandi o fornire scorciatoie/alias.
• Trigger di comandi da oggetti, blocchi, cartelli, libri, NPC e item frame.
• Elementi GUI: IconMenu basato su chest, ActionBar, BossBar, Title, Scoreboard, Anvil GUI e Sign GUI.
• Supporto ai placeholder e a condizioni in stile script per comportamenti dinamici.
• Integrazione con l'economia (opzionale tramite Vault) e alcune funzioni economiche standalone.
• Supporto agli eventi del giocatore (join/quit/morte) e alle attività pianificate.
• Database personalizzato dei giocatori opzionale basato su SQL e supporto multi-file per comandi illimitati.
• Funzionalità legate a BungeeCord e una variante separata lato Bungee per i comandi lato proxy.
• Richieste HTTP (GET/POST) e supporto alla formattazione MiniMessage dove disponibile.
• Utilizza bStats per il reporting delle metriche.

🧩 Per chi è

• Server Survival e SMP che vogliono comandi e menu personalizzati senza programmare.
• Server con forte componente amministrativa o economica che necessitano di flussi personalizzati per shop/comandi.
• Reti proxy che richiedono un comportamento dei comandi centralizzato o lato proxy.
• Gestori di server che hanno bisogno di condizioni in script e placeholder per output dinamici.

🏗️ Casi d'uso di esempio

• Definire un singolo comando che esegue una sequenza di comandi della console per aprire uno shop, dare oggetti e registrare l'acquisto.
• Creare menu GUI per punizioni/teletrasporto usando voci di chest GUI e prompt anvil/sign.
• Fornire alias brevi che rimandano a comandi più lunghi di cambio server BungeeCord con completamento con tab.

⌨️ Comandi

La documentazione ufficiale elenca comandi amministrativi per gestire il plugin. Tra gli esempi documentati dal progetto ci sono:

(Consulta la documentazione ufficiale dei comandi del plugin per l'elenco completo e la sintassi esatta.)

🔐 Permessi

Il progetto documenta nodi di permesso per le azioni amministrative. Tra gli esempi nell'elenco ufficiale dei permessi ci sono:

| Permission | Description | Default | |---|---|---|---| | mycommand.reload | Permesso per ricaricare la configurazione di MyCommand. | non specificato | | mycommand.book.make | Permesso per creare libri dai comandi personalizzati. | non specificato |

(Consulta la documentazione dei permessi del plugin per la mappa completa dei permessi.)

⚙️ Installazione

📥 Configurazione

• Scarica il plugin ufficiale .jar e inseriscilo nella cartella plugins/ del tuo server.
• Avvia o riavvia il server e controlla i log della console per confermare che il plugin sia stato caricato.
• Se il plugin non si carica, verifica che i plugin di supporto richiesti/opzionali (vedi Dipendenze) siano presenti o aggiornati.

📦 Dipendenze

• ProtocolLib — indicato come importante se il plugin non si carica o per alcune funzionalità.
• Vault — opzionale, richiesto per le integrazioni con l'economia.
• PlaceholderAPI — opzionale, per un supporto esteso ai placeholder.

Installa solo le dipendenze confermate per le funzionalità desiderate; molte integrazioni sono opzionali.

🧠 Note tecniche

• Il plugin si configura tramite file YAML e supporta più file di comandi per evitare limiti sui comandi.
• Lo storage SQL è disponibile per il database personalizzato dei giocatori (opzionale) e sono supportate configurazioni multi-file.
• Esiste un componente separato di BungeeCord per la gestione dei comandi lato proxy.
• Il progetto invia metriche tramite bStats.
• La formattazione MiniMessage e il supporto al completamento con tab sono disponibili negli ambienti supportati.

🤝 Quando questo plugin è utile

Se hai bisogno di comandi personalizzati flessibili basati su file, scripting condizionale e flussi di comando basati su GUI senza scrivere Java, MyCommand offre una piattaforma configurabile per queste esigenze e aggiunge integrazioni con proxy ed economia quando necessario.