Plugin Minecraft SCore

🔌 Despre SCore

SCore este pluginul de bază/bibliotecă produs de Ssomar pentru a centraliza funcționalitatea partajată folosită în întreaga lor suită de pluginuri. Oferă editori în joc și funcții runtime de care se bazează alte pluginuri Ssomar și poate fi folosit și separat pentru a crea și rula proiectile personalizate, a gestiona variabile și a executa comenzi personalizate împachetate.

🎯 Scop

SCore există pentru a oferi o bază reutilizabilă pentru autorii de pluginuri (în special familia de pluginuri Ssomar), astfel încât funcțiile să fie implementate o singură dată și folosite de mai multe pluginuri. Este destinat dezvoltatorilor și administratorilor de server care rulează unul sau mai multe pluginuri Ssomar sau care vor ca mecanicile sale reutilizabile să fie disponibile pe serverul lor.

⚙️ Funcții

• Editor în joc pentru crearea și editarea proiectilelor personalizate.
• Proiectile personalizate runtime care pot fi lansate sau declanșate.
• Variabile globale și per jucător cu tipuri (NUMBER, STRING, LIST).
• Suport pentru placeholdere pentru variabile (tokenuri placeholder pentru utilizare în alte pluginuri/configurații).
• Cadru de execuție a comenzilor împachetate/personalizate, accesibil din consola serverului sau din alte pluginuri.
• Conceput pentru a fi folosit ca dependență de alte pluginuri Ssomar.

🧩 Pentru cine este

• Proprietari de servere care rulează pluginuri Ssomar (ExecutableItems, ExecutableBlocks etc.).
• Dezvoltatori care au nevoie de o bibliotecă reutilizabilă pentru proiectile, variabile și execuția comenzilor personalizate.
• Administratori care doresc editori ușori, direct pe server, pentru aceste funcții.

🏗️ Exemple de utilizare

• Un server folosește SCore împreună cu ExecutableItems pentru a defini și lansa comportamente de proiectile personalizate.
• Un admin creează variabile globale sau per jucător și le expune ca placeholdere pentru meniuri sau alte pluginuri.
• Un dezvoltator de plugin depinde de SCore pentru a reutiliza stocarea variabilelor și împachetarea comenzilor în mai multe pluginuri.

⌨️ Comenzi

Note: documentația oficială descrie și tokenurile placeholder pentru variabile (de ex. %score_variables_<var_name>% și %score_variables_<var_name>_int%). Nodurile de permisiune nu sunt listate în metadatele pluginului referit.

⚙️ Instalare

📥 Configurare

• Descărcați .jar-ul oficial SCore pentru versiunea de plugin corespunzătoare.
• Plasați fișierul .jar în directorul plugins/ al serverului.
• Reporniți serverul și verificați consola serverului pentru a confirma că SCore a fost încărcat.
• Dacă rulați alte pluginuri Ssomar, instalați build-ul SCore care se potrivește cu sufixul versiunii lor, așa cum recomandă proiectul (potrivirea build-ului SCore cu build-ul pluginului dependent).

🧠 Note tehnice

• Platforme suportate confirmate: Bukkit, Spigot, Paper, Purpur, Folia.
• Versiunile Minecraft suportate confirmate includ: 1.21.x până la 1.8.x (listate de proiect).
• Metadatele proiectului listează o etichetă de licență restrictivă (ARR / All Rights Reserved), iar distribuția proiectului face referire și la un repository Git pentru contribuții; aceste elemente apar împreună în metadatele oficiale.
• SCore este conceput să fie instalat ca bibliotecă/dependință pentru alte pluginuri Ssomar; expune funcții pe care alte pluginuri le apelează la runtime.

🤝 Când este util acest plugin

Dacă rulați pluginuri Ssomar sau aveți nevoie de un sistem gata făcut, direct pe server, pentru proiectile personalizate și placeholdere de variabile, SCore oferă runtime-ul comun și editorii pe care se bazează acele pluginuri, fără să fie nevoie să reimplementați aceleași mecanici.