Minecraft-Plugin SCore

🔌 Über SCore

SCore ist das Kern-/Bibliotheks-Plugin von Ssomar, das gemeinsame Funktionen zentral bündelt, die in der gesamten Plugin-Suite verwendet werden. Es stellt In-Game-Editoren und Laufzeitfunktionen bereit, auf die andere Ssomar-Plugins angewiesen sind, und kann außerdem eigenständig genutzt werden, um benutzerdefinierte Projektile zu erstellen und auszuführen, Variablen zu verwalten und verpackte benutzerdefinierte Befehle auszuführen.

🎯 Zweck

SCore bietet Plugin-Autoren (insbesondere der Ssomar-Plugin-Familie) eine wiederverwendbare Grundlage, damit Funktionen einmal implementiert und von mehreren Plugins genutzt werden können. Es richtet sich an Entwickler und Server-Administratoren, die ein oder mehrere Ssomar-Plugins betreiben oder die wiederverwendbaren Mechaniken auf ihrem Server nutzen möchten.

⚙️ Funktionen

• In-Game-Editor zum Erstellen und Bearbeiten benutzerdefinierter Projektile.
• Benutzerdefinierte Projektile zur Laufzeit, die ausgelöst oder gestartet werden können.
• Globale und spielerbezogene Variablen mit Typen (NUMBER, STRING, LIST).
• Placeholder-Unterstützung für Variablen (Placeholder-Tokens für die Verwendung in anderen Plugins/Konfigurationen).
• Framework zur Ausführung verpackter/benutzerdefinierter Befehle, zugänglich über die Serverkonsole oder andere Plugins.
• Entwickelt, um von anderen Ssomar-Plugins als Abhängigkeit genutzt zu werden.

🧩 Für wen es gedacht ist

• Serverbetreiber, die Ssomar-Plugins ausführen (ExecutableItems, ExecutableBlocks usw.).
• Entwickler, die eine wiederverwendbare Bibliothek für Projektile, Variablen und die Ausführung benutzerdefinierter Befehle benötigen.
• Administratoren, die leichte In-Server-Editoren für diese Funktionen möchten.

🏗️ Beispielanwendungen

• Ein Server nutzt SCore zusammen mit ExecutableItems, um benutzerdefinierte Projektilverhalten zu definieren und auszulösen.
• Ein Admin erstellt globale oder spielerbezogene Variablen und stellt sie als Platzhalter für Menüs oder andere Plugins bereit.
• Ein Plugin-Entwickler nutzt SCore, um Variablenspeicherung und Befehlsverpackung über mehrere Plugins hinweg wiederzuverwenden.

⌨️ Befehle

Hinweise: Die offizielle Dokumentation beschreibt auch Placeholder-Tokens für Variablen (z. B. %score_variables_<var_name>% und %score_variables_<var_name>_int%). Berechtigungsknoten sind in den referenzierten Plugin-Metadaten nicht aufgeführt.

⚙️ Installation

📥 Einrichtung

• Lade die offizielle SCore-.jar für die passende Plugin-Version herunter.
• Lege die .jar-Datei in das Verzeichnis plugins/ des Servers.
• Starte den Server neu und prüfe die Serverkonsole, um zu bestätigen, dass SCore geladen wurde.
• Wenn du andere Ssomar-Plugins verwendest, installiere den SCore-Build, der zum Versionssuffix dieser Plugins passt, wie vom Projekt empfohlen (SCore-Build an den abhängigen Plugin-Build anpassen).

🧠 Technische Hinweise

• Bestätigte unterstützte Plattformen: Bukkit, Spigot, Paper, Purpur, Folia.
• Bestätigte unterstützte Minecraft-Versionen umfassen: 1.21.x bis hinunter zu 1.8.x (vom Projekt aufgelistet).
• Die Projektmetadaten enthalten ein restriktives Lizenzlabel (ARR / All Rights Reserved), während die Projektverteilung außerdem auf ein Git-Repository für Beiträge verweist; diese Angaben erscheinen gemeinsam in den offiziellen Metadaten.
• SCore ist dafür gedacht, als Bibliothek/Abhängigkeit für andere Ssomar-Plugins installiert zu werden; es stellt Funktionen bereit, die andere Plugins zur Laufzeit aufrufen.

🤝 Wann dieses Plugin nützlich ist

Wenn du Ssomar-Plugins betreibst oder ein fertiges In-Server-System für benutzerdefinierte Projektile und Variable-Placeholders brauchst, bietet SCore die gemeinsame Laufzeit und die Editoren, auf die diese Plugins angewiesen sind, ohne dass du dieselben Mechaniken selbst neu implementieren musst.