Plugin Minecraft ColoredSigns

🔌 O Colored Signs

Colored Signs to plugin do Minecrafta, który umożliwia używanie kodów kolorów i formatowania na postawionych tabliczkach. Konwertuje stare kody kolorów (używając konfigurowalnego znaku, takiego jak &) i obsługuje hexowe kody kolorów 1.16+ w tekście tabliczek. Plugin udostępnia opcje konfiguracji dla znaku koloru, obsługi hex, trybu uprawnień oraz opcjonalnego edytora tabliczek.

🎯 Cel

Głównym celem pluginu jest przywrócenie i rozszerzenie formatowania tekstu na tabliczkach dla społeczności serwerowych, które chcą kolorowego lub sformatowanego tekstu, przy jednoczesnym zachowaniu kontroli przez uprawnienia i konfigurację. Skupia się na funkcjach kosmetycznych/formatowaniu tekstu, a nie na mechanikach rozgrywki.

⚙️ Funkcje

• Obsługa starych kodów kolorów przy użyciu konfigurowalnego znaku koloru (domyślnie &).
• Obsługa hexowych kodów kolorów RGB na tabliczkach (wymaga Spigot/Paper 1.16+).
• Opcjonalny edytor tabliczek (wymaga Spigot/Paper 1.18.2+, aby włączyć edycję tabliczki przez sneak+klik prawym).
• Kontrola oparta na uprawnieniach (opcjonalny tryb uprawnień) z granularnymi node'ami dla kolorów i formatowania.
• Opcje konfiguracji dostępne w pliku config (tryb debug, znak koloru, permission-mode, włączenie hex, włączenie edytora, opcje broadcast).

🧩 Dla kogo jest ten plugin

• Administratorów serwerów, którzy chcą kolorowych tabliczek dla graczy bez dawania dostępu wszystkim.
• Serwery SMP i survival, które używają tabliczek do sklepów, instrukcji lub tekstu roleplay.
• Serwery wymagające kontroli uprawnień dla tabliczek per kolor lub per format.

🏗️ Przykładowe zastosowania

• Pozwolić moderatorom tworzyć kolorowe tabliczki ogłoszeń, a zwykłym graczom zostawić zwykły tekst.
• Włączyć hexowe kody kolorów dla tematycznych hubów serwerowych i tabliczek kierunkowych.
• Używać edytora tabliczek, aby zaufany personel mógł poprawiać tekst bez zastępowania bloku tabliczki.

⌨️ Komendy

(Załączono tylko komendy udokumentowane przez oficjalne źródła.)

🔐 Uprawnienia

Musisz włączyć permission-mode w konfiguracji pluginu, aby te node'y były egzekwowane. Domyślne wartości nie są podane w oficjalnej konfiguracji (permission-mode domyślnie ma wartość false).

⚙️ Instalacja

📥 Konfiguracja

• Pobierz plik JAR pluginu z oficjalnego źródła i umieść go w katalogu plugins/ na serwerze.
• Uruchom ponownie serwer, aby plugin mógł utworzyć pliki konfiguracyjne i zarejestrować funkcje.
• Sprawdź konsolę serwera pod kątem komunikatów startowych potwierdzających, że plugin został załadowany.

📦 Zależności

• Autor nie dokumentuje wymaganych zależności firm trzecich.

🧾 Konfiguracja

• Plugin tworzy plik config z opcjami takimi jak color-character, permission-mode, enable-hex-color-codes, enable-sign-editor oraz przełącznikami broadcast.
• permission-mode (domyślnie: false) kontroluje, czy node'y uprawnień są egzekwowane.
• enable-hex-color-codes wymaga Spigot/Paper 1.16+, aby działać.
• enable-sign-editor wymaga Spigot/Paper 1.18.2+, aby włączyć edycję przez sneak+klik prawym.

🧠 Uwagi techniczne

• Potwierdzone wspierane oprogramowanie serwera: Spigot i Paper.
• Potwierdzony wymóg Java: minimum Java 8, zalecane Java 17.
• Autor udostępnia kod źródłowy na licencji GPL-3.0 oraz publiczny tracker zgłoszeń.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz kontrolowanego, konfigurowalnego formatowania tekstu na tabliczkach (w tym obsługi hex) z opcjonalną edycją tabliczek i uprawnieniami per kolor, Colored Signs oferuje te funkcje, jednocześnie pozwalając administratorom włączać lub wyłączać egzekwowanie uprawnień przez config.