Minecraft-plugin SCore

🔌 Om SCore

SCore er kerne-/bibliotek-pluginet, som er udviklet af Ssomar, for at samle delt funktionalitet, der bruges på tværs af deres pluginsuite, ét sted. Det tilbyder in-game editors og runtime-funktioner, som andre Ssomar-plugins er afhængige af, og kan også bruges selvstændigt til at oprette og køre brugerdefinerede projektiler, administrere variabler og udføre pakkede brugerdefinerede kommandoer.

🎯 Formål

SCore findes for at give et genanvendeligt fundament for plugin-udviklere (specifikt Ssomar-pluginfamilien), så funktioner implementeres én gang og bruges af flere plugins. Det er målrettet udviklere og serveradministratorer, som kører et eller flere Ssomar-plugins, eller som ønsker at have dets genanvendelige mekanikker tilgængelige på deres server.

⚙️ Funktioner

• In-game editor til at oprette og redigere brugerdefinerede projektiler.
• Runtime-brugerdefinerede projektiler, som kan affyres eller trigges.
• Globale og spiller-specifikke variabler med typer (NUMBER, STRING, LIST).
• Understøttelse af placeholders til variabler (placeholder-tokens til brug i andre plugins/konfigurationer).
• Rammeværk til udførelse af pakkede/brugerdefinerede kommandoer, som er tilgængeligt fra serverkonsollen eller andre plugins.
• Designet til at blive brugt som en afhængighed af andre Ssomar-plugins.

🧩 Hvem er det til

• Serverejere, der kører Ssomar-plugins (ExecutableItems, ExecutableBlocks osv.).
• Udviklere, der har brug for et genanvendeligt bibliotek til projektiler, variabler og udførelse af brugerdefinerede kommandoer.
• Administratorer, der ønsker lette in-server editors til disse funktioner.

🏗️ Eksempler på brug

• En server bruger SCore sammen med ExecutableItems til at definere og starte brugerdefinerede projektiladfærd.
• En admin opretter globale eller spiller-specifikke variabler og eksponerer dem som placeholders til menuer eller andre plugins.
• En pluginudvikler er afhængig af SCore for at genbruge variabellagring og kommando-emballering på tværs af flere plugins.

⌨️ Kommandoer

Bemærkninger: den officielle dokumentation beskriver også placeholder-tokens for variabler (f.eks. %score_variables_<var_name>% og %score_variables_<var_name>_int%). Tilladelsesnoder er ikke angivet i de refererede pluginmetadata.

⚙️ Installation

📥 Opsætning

• Download den officielle SCore .jar til den matchende pluginversion.
• Placer .jar-filen i serverens plugins/-mappe.
• Genstart serveren og tjek serverkonsollen for at bekræfte, at SCore er indlæst.
• Hvis du kører andre Ssomar-plugins, så installer den SCore-build, der matcher deres versionssuffix, som projektet anbefaler (match SCore-build med det afhængige plugins build).

🧠 Tekniske noter

• Bekræftede understøttede platforme: Bukkit, Spigot, Paper, Purpur, Folia.
• Bekræftede understøttede Minecraft-versioner omfatter: 1.21.x ned til 1.8.x (angivet af projektet).
• Projektmetadataene angiver en restriktiv licensetiket (ARR / All Rights Reserved), mens projektets distribution også henviser til et Git-repositorium til bidrag; disse elementer optræder sammen i de officielle metadata.
• SCore er beregnet til at blive installeret som et bibliotek/en afhængighed for andre Ssomar-plugins; det eksponerer funktioner, som andre plugins kalder ved runtime.

🤝 Hvornår dette plugin er nyttigt

Hvis du kører Ssomar-plugins eller har brug for et færdigt in-server system til brugerdefinerede projektiler og variabel-placeholders, leverer SCore den delte runtime og de editors, som disse plugins er afhængige af, uden at du selv behøver at genimplementere de samme mekanikker.