Plugin Minecraft ServerSigns

🔌 O ServerSigns

ServerSigns to wtyczka do Minecrafta, która pozwala administratorom serwera przypisywać komendy, wiadomości i inne działania do tabliczek oraz innych bloków. Gdy gracz wejdzie w interakcję ze skonfigurowanym ServerSign, wtyczka może wykonywać komendy wysyłane przez serwer, wysyłać sformatowane wiadomości, ogłaszać tekst, zmieniać grupy lub uruchamiać inne predefiniowane działania skierowane do gracza albo serwera.

🎯 Cel

ServerSigns rozwiązuje problem uruchamiania złożonych działań po stronie serwera z obiektów w świecie gry bez niestandardowych modów klienta. Jest przydatny w konfiguracjach hub/lobby, przy tabliczkach wyboru trybu gry, wyzwalaczach teleportacji lub łączenia z serwerami oraz w każdej sytuacji, w której chcesz, aby klikalny blok w grze wykonywał komendy lub działania w imieniu gracza albo serwera.

⚙️ Funkcje

• Przypisywanie działań do tabliczek i innych typów bloków (komendy, wiadomości, broadcasty, dodawanie/usuwanie grup, podszywanie się pod czat itp.).
• Obsługa tworzenia menu opcji (prośba do graczy o wybór przed wykonaniem).
• Obsługa integracji z PlaceholderAPI, aby używać zmiennych PAPI w wiadomościach, gdy PlaceholderAPI jest obecne.
• Obsługa tłumaczeń (wiele plików językowych / katalog translations).
• Zestaw komend dla administratorów do tworzenia, edytowania i zarządzania ServerSigns.
• Używa Metrics/bStats do anonimowych statystyk użycia.

🧩 Dla kogo jest przeznaczony

Dla właścicieli i administratorów serwerów, którzy chcą oferować graczom klikalne interakcje z tabliczkami w grze: operatorów hubów/lobby, organizatorów minigier, serwerów SMP używających tabliczek do uruchamiania komend oraz administratorów preferujących wyzwalacze w świecie gry zamiast systemów opartych na czacie lub wyłącznie GUI.

🏗️ Przykładowe zastosowania

• Tabliczka w hubie uruchamiająca komendę wysyłającą gracza na serwer backend SkyWars.
• Tabliczka przyznająca tymczasową lub stałą grupę serwera po kliknięciu.
• Lobby, w którym kliknięcie różnych tabliczek rozgłasza wiadomości lub uruchamia skrypty po stronie serwera.

⌨️ Komendy

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik jar ServerSigns i umieść go w katalogu plugins/ swojego serwera.
• Uruchom serwer, aby wygenerować domyślne pliki i foldery.
• Zatrzymaj serwer, edytuj plugins/ServerSigns/config.yml i dodaj własne tłumaczenia w plugins/ServerSigns/translations, jeśli to potrzebne.
• Uruchom serwer ponownie i sprawdź w konsoli, czy wtyczka została załadowana. Użyj /svs reloadconfig, aby przeładować konfigurację w trakcie działania.

📦 Zależności

• PlaceholderAPI (opcjonalnie): gdy jest obecne, ServerSigns obsługuje zmienne PAPI w wiadomościach.

🧾 Konfiguracja

• ServerSigns tworzy plik config.yml oraz katalog translations w folderze wtyczki. Pliki tłumaczeń pozwalają dostosować wiadomości i prefiksy.

🧠 Uwagi techniczne

• Platforma: wtyczka Bukkit/Spigot (spakowana jako standardowy plik jar wtyczki).
• Obsługiwane wersje Minecrafta: testowane na starszych i nowszych wersjach; podany zakres testów obejmuje 1.7 do 1.19.
• Kod źródłowy i śledzenie problemów są dostępne w repozytorium GitHub projektu. Projekt używa licencji AGPL-3.0.
• Wtyczka raportuje anonimowe metryki przez Metrics/bStats.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli potrzebujesz klikalnych wyzwalaczy w świecie gry, które uruchamiają komendy i działania skierowane do serwera lub gracza (dla lobby, tabliczek trybu gry lub procesów zarządzanych przez administratorów), ServerSigns oferuje konfigurowalny system do przypisywania tych zachowań do tabliczek i innych bloków z tłumaczeniami oraz opcjonalną obsługą PlaceholderAPI.