Plugin Minecraft SCore

🔌 Informazioni su SCore

SCore è il plugin core/libreria prodotto da Ssomar per केंदrare le funzionalità condivise usate in tutta la loro suite di plugin. Espone editor in-game e funzionalità runtime su cui fanno affidamento altri plugin Ssomar, e può anche essere usato da solo per creare ed eseguire proiettili personalizzati, gestire variabili ed eseguire comandi personalizzati impacchettati.

🎯 Scopo

SCore esiste per fornire una base riutilizzabile agli autori di plugin (in particolare alla famiglia di plugin Ssomar) così che le funzionalità vengano implementate una sola volta e usate da più plugin. È pensato per sviluppatori e amministratori di server che eseguono uno o più plugin Ssomar o che vogliono avere a disposizione sul proprio server le sue meccaniche riutilizzabili.

⚙️ Funzionalità

• Editor in-game per creare e modificare proiettili personalizzati.
• Proiettili personalizzati runtime che possono essere lanciati o attivati.
• Variabili globali e per giocatore con tipi (NUMBER, STRING, LIST).
• Supporto ai placeholder per le variabili (token placeholder da usare in altri plugin/configurazioni).
• Framework per l’esecuzione di comandi impacchettati/personalizzati accessibile dalla console del server o da altri plugin.
• Progettato per essere usato come dipendenza da altri plugin Ssomar.

🧩 A chi è rivolto

• Proprietari di server che usano plugin Ssomar (ExecutableItems, ExecutableBlocks, ecc.).
• Sviluppatori che hanno bisogno di una libreria riutilizzabile per proiettili, variabili ed esecuzione di comandi personalizzati.
• Amministratori che desiderano editor leggeri integrati nel server per queste funzionalità.

🏗️ Casi d’uso di esempio

• Un server usa SCore insieme a ExecutableItems per definire e lanciare comportamenti di proiettili personalizzati.
• Un admin crea variabili globali o per giocatore e le espone come placeholder per menu o altri plugin.
• Uno sviluppatore di plugin si affida a SCore per riutilizzare l’archiviazione delle variabili e il packaging dei comandi su più plugin.

⌨️ Comandi

Note: la documentazione ufficiale documenta anche i token placeholder per le variabili (ad esempio %score_variables_<var_name>% e %score_variables_<var_name>_int%). I nodi di permesso non sono elencati nei metadati del plugin di riferimento.

⚙️ Installazione

📥 Configurazione

• Scarica il .jar ufficiale di SCore per la versione del plugin corrispondente.
• Metti il file .jar nella directory plugins/ del server.
• Riavvia il server e controlla la console per confermare che SCore sia stato caricato.
• Se usi altri plugin Ssomar, installa la build di SCore che corrisponde al loro suffisso di versione, come consigliato dal progetto (abbinando la build di SCore alla build del plugin dipendente).

🧠 Note tecniche

• Piattaforme supportate confermate: Bukkit, Spigot, Paper, Purpur, Folia.
• Le versioni di Minecraft supportate confermate includono: da 1.21.x fino a 1.8.x (elencate dal progetto).
• I metadati del progetto indicano una licenza restrittiva (ARR / All Rights Reserved), mentre la distribuzione del progetto fa anche riferimento a un repository Git per i contributi; questi elementi compaiono insieme nei metadati ufficiali.
• SCore è pensato per essere installato come libreria/dipendenza per altri plugin Ssomar; espone funzionalità chiamate da altri plugin a runtime.

🤝 Quando questo plugin è utile

Se usi plugin Ssomar o hai bisogno di un sistema già pronto nel server per proiettili personalizzati e placeholder di variabili, SCore fornisce il runtime condiviso e gli editor su cui fanno affidamento quei plugin, senza richiedere di reimplementare gli stessi meccanismi.