Plugin Minecraft SCore

🔌 O SCore

SCore to podstawowy plugin/biblioteka stworzona przez Ssomar, służąca do centralizacji wspólnej funkcjonalności używanej w całym pakiecie ich pluginów. Udostępnia edytory w grze oraz funkcje czasu działania, z których korzystają inne pluginy Ssomar, a także może być używany samodzielnie do tworzenia i uruchamiania niestandardowych pocisków, zarządzania zmiennymi oraz wykonywania spakowanych niestandardowych komend.

🎯 Cel

SCore istnieje po to, by zapewnić wielokrotnego użytku fundament dla twórców pluginów (w szczególności rodziny pluginów Ssomar), dzięki czemu funkcje są implementowane raz i wykorzystywane przez wiele pluginów. Jest skierowany do twórców i administratorów serwerów, którzy uruchamiają jeden lub więcej pluginów Ssomar albo chcą mieć na serwerze dostęp do jego wielokrotnego użytku mechanik.

⚙️ Funkcje

• Edytor w grze do tworzenia i edycji niestandardowych pocisków.
• Niestandardowe pociski uruchamiane w czasie działania, które można wystrzelić lub wywołać.
• Zmienne globalne i per gracz z typami (NUMBER, STRING, LIST).
• Obsługa placeholderów dla zmiennych (tokeny placeholderów do użycia w innych pluginach/konfiguracjach).
• Framework do wykonywania spakowanych/niestandardowych komend dostępny z konsoli serwera lub innych pluginów.
• Zaprojektowany do użycia jako zależność przez inne pluginy Ssomar.

🧩 Dla kogo jest

• Właścicieli serwerów korzystających z pluginów Ssomar (ExecutableItems, ExecutableBlocks itp.).
• Twórców, którzy potrzebują wielokrotnego użytku biblioteki do pocisków, zmiennych i wykonywania niestandardowych komend.
• Administratorów szukających lekkich edytorów na serwerze do tych funkcji.

🏗️ Przykładowe zastosowania

• Serwer używa SCore razem z ExecutableItems do definiowania i uruchamiania niestandardowych zachowań pocisków.
• Administrator tworzy zmienne globalne lub per gracz i udostępnia je jako placeholdery do menu lub innych pluginów.
• Twórca pluginu opiera się na SCore, aby ponownie wykorzystywać magazyn zmiennych i pakietowanie komend w wielu pluginach.

⌨️ Komendy

Uwagi: oficjalna dokumentacja opisuje również tokeny placeholderów dla zmiennych (np. %score_variables_<var_name>% oraz %score_variables_<var_name>_int%). Węzły uprawnień nie są wymienione w metadanych powiązanego pluginu.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik .jar SCore dla odpowiedniej wersji pluginu.
• Umieść plik .jar w katalogu plugins/ serwera.
• Uruchom ponownie serwer i sprawdź konsolę, aby potwierdzić, że SCore został załadowany.
• Jeśli używasz innych pluginów Ssomar, zainstaluj build SCore zgodny z ich sufiksem wersji, zgodnie z zaleceniami projektu (dopasowując build SCore do buildu zależnego pluginu).

🧠 Uwagi techniczne

• Potwierdzone obsługiwane platformy: Bukkit, Spigot, Paper, Purpur, Folia.
• Potwierdzone obsługiwane wersje Minecrafta obejmują: od 1.21.x do 1.8.x (według listy projektu).
• Metadane projektu zawierają restrykcyjną etykietę licencji (ARR / All Rights Reserved), a dystrybucja projektu odwołuje się również do repozytorium Git dla współtwórców; te elementy występują razem w oficjalnych metadanych.
• SCore ma być instalowany jako biblioteka/zależność dla innych pluginów Ssomar; udostępnia funkcje, które inne pluginy wywołują w czasie działania.

🤝 Kiedy ten plugin jest przydatny

Jeśli używasz pluginów Ssomar albo potrzebujesz gotowego systemu na serwerze do niestandardowych pocisków i placeholderów zmiennych, SCore zapewnia współdzielony runtime i edytory, na których opierają się te pluginy, bez konieczności ponownego implementowania tych samych mechanik.