Plugin Minecraft BKCommonLib

🔌 Informazioni su BKCommonLib

BKCommonLib è una libreria lato server e un plugin per server Minecraft che centralizza utilità di basso livello, helper di reflection, remapping a runtime e piccoli framework, così che altri plugin non debbano usare direttamente NMS (gli internals del server Minecraft). È progettato per essere un unico layer di compatibilità: quando Minecraft o i fork del server cambiano gli internals, BKCommonLib viene aggiornato in modo che i plugin dipendenti spesso non richiedano modifiche a loro volta.

🎯 Scopo

Fornire un layer stabile e riutilizzabile di compatibilità e utilità per sviluppatori di plugin e amministratori di server. BKCommonLib riduce la quantità di codice specifico per versione che gli autori dei plugin devono distribuire ed espone API di livello più alto per la gestione dei pacchetti, le conversioni, i framework dei comandi e altre operazioni di basso livello.

⚙️ Funzionalità

• Generazione e remapping delle classi a runtime tramite il sistema reflection/template di Mountiplex.
• Utilità integrate per il framework dei comandi (integrazione con Cloud Command Framework).
• Framework base per plugin con helper del ciclo di vita, controlli delle dipendenze e API pratiche per registrare listener e comandi.
• Utilità di conversione dei tipi (conversioni automatiche tra tipi Bukkit e tipi interni quando necessario).
• Utilità e livelli di compatibilità per molti fork e versioni del server, così che i plugin evitino l'uso diretto di NMS.

🧩 A chi è rivolto

• Sviluppatori di plugin che vogliono un layer di compatibilità multi-versione e utilità di reflection.
• Amministratori di server che gestiscono reti con molti plugin di terze parti che si affidano a una libreria di compatibilità comune.
• Operatori tecnici di server che necessitano di un comportamento coerente tra fork di Paper/Spigot.

🏗️ Casi d'uso di esempio

• Un plugin usa BKCommonLib per gestire le differenze di pacchetti tra le versioni di Minecraft, così il jar del plugin può rimanere invariato tra gli aggiornamenti.
• Uno sviluppatore usa le utilità del framework dei comandi incluse per implementare comandi annotati con supporto ai suggerimenti e gestione dei permessi.
• Un server esegue plugin che dipendono da BKCommonLib per ridurre la frequenza di aggiornamenti immediati dopo il rilascio di una versione di Minecraft.

⚙️ Installazione

📥 Configurazione

• Scarica il jar ufficiale di BKCommonLib dalla distribuzione ufficiale del plugin (metti il jar fornito nella cartella plugins/ del tuo server).
• Riavvia il server in modo che il plugin venga caricato all'avvio.
• Controlla l'output della console del server per i messaggi di avvio di BKCommonLib e verifica che sia stato inizializzato correttamente.

📦 Dipendenze

• BKCommonLib è distribuito come plugin-libreria; per la libreria principale non sono necessarie dipendenze aggiuntive di plugin Bukkit/Spigot.

🧠 Note tecniche

• Il software server compatibile confermato include fork di Spigot e Paper (il progetto elenca esplicitamente Spigot, PaperMC, Purpur e altri fork comuni).
• Il progetto dichiara compatibilità con le versioni di Minecraft 1.8 e successive quando si usa l'ultima build di BKCommonLib.
• BKCommonLib è rilasciato sotto licenza MIT.
• Il progetto include/ombra librerie di terze parti (ad esempio Cloud Command Framework, ASM, Javassist, Objenesis, SnakeYAML e Gson), come indicato dall'autore.

🤝 Quando questo plugin è utile

Se mantieni plugin o gestisci un server in cui più plugin hanno bisogno di un accesso coerente alle funzionalità di basso livello del server senza che ciascun plugin gestisca NMS, BKCommonLib offre un layer di compatibilità condiviso e utilità per sviluppatori che riducono il codice specifico per versione per plugin e il carico di manutenzione.