Plugin Minecraft CommandButtons

🔌 O CommandButtons

CommandButtons to plugin Minecraft do przypisywania komend do interakcji z blokami. Umożliwia administratorom serwera podłączanie zestawów komend do bloków (przycisków, znaków, płyt naciskowych lub klikalnych bloków), tak aby komendy uruchamiały się, gdy gracz wejdzie w interakcję z skonfigurowanym blokiem. Plugin obsługuje uruchamianie komend jako konsola i/lub jako gracz, który aktywował blok, oraz oferuje edytor GUI w grze do zarządzania przyciskami i ich właściwościami.

🎯 Cel

Plugin rozwiązuje problem tworzenia interaktywnych elementów świata, które wykonują akcje administracyjne lub związane z rozgrywką, bez konieczności wpisywania komend przez graczy. Typowe zastosowania obejmują tablice teleportów, selektory kitów, akcje do kupienia i niestandardowe mechaniki wyzwalane przez interakcje z blokami.

⚙️ Funkcje

• Podłączanie nieograniczonej liczby komend do jednego przycisku komend (komendy konsoli i gracza).
• Edytor GUI w grze do tworzenia i edytowania przycisków komend oraz lokalizacji.
• Cooldowny dla pojedynczych graczy i globalne; cooldowny zachowują się po restarcie serwera.
• Opcjonalna integracja z ekonomią przez Vault, aby pobierać opłaty za użycie przycisków.
• Niestandardowe węzły uprawnień ograniczające użycie konkretnych przycisków.
• Konfigurowalne wiadomości przez plik messages.
• Wiele lokalizacji dla jednego przycisku komend, dzięki czemu jedna konfiguracja może działać na wielu blokach.
• Podstawowe komendy do tworzenia, edytowania i ponownego wczytywania danych pluginu.

🧩 Dla kogo

• Administratorzy serwerów i budowniczowie, którzy chcą klikalnych elementów świata uruchamiających komendy.
• Serwery minigier i lobby potrzebujące interaktywnych menu lub tablic teleportów/wyboru kitów.
• Serwery korzystające z pluginów ekonomicznych i chcące mechaniki opłat za użycie.

🏗️ Przykładowe zastosowania

• Tablica teleportów na spawnie, gdzie każdy przycisk teleportuje klikającego gracza do innej areny.
• Ściana wyboru kitów: naciśnięcie przycisku uruchamia zestaw komend dających kity i wiadomości.
• Akcja do kupienia: przycisk pobiera walutę w grze i wykonuje komendę nagrody.

⌨️ Komendy

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik jar pluginu i umieść go w katalogu plugins/ serwera.
• Uruchom ponownie serwer i sprawdź logi konsoli, aby potwierdzić, że plugin został poprawnie załadowany.
• Użyj podanych komend /commandbuttons, aby tworzyć i edytować konfiguracje przycisków w grze.

📦 Zależności

• Opcjonalnie: Vault, aby włączyć funkcje pobierania opłat ekonomicznych. Do korzystania z funkcji opłaty za użycie wymagany jest plugin ekonomiczny integrujący się z Vault (na przykład EssentialsX economy).

🧠 Uwagi techniczne

• Plugin udostępnia edytor GUI i tworzy pliki konfiguracji/wiadomości do personalizacji.
• Cooldowny są zachowywane po restartach serwera.
• Obsługiwane są zarówno tryb wykonywania komend przez konsolę, jak i przez gracza; komendy wykonywane jako gracz będą używać uprawnień tego gracza (komendy wymagające wyższych uprawnień niż ma gracz nie uruchomią się, gdy zostaną wykonane jako gracz).
• Funkcje ekonomiczne wymagają Vault i obsługiwanego pluginu ekonomicznego.

🤝 Kiedy ten plugin jest przydatny

Użyj CommandButtons, gdy potrzebujesz konfigurowalnych akcji powiązanych z lokalizacją, uruchamianych przez interakcje graczy (przyciski, znaki, płyty) z wbudowanymi cooldownami, sprawdzaniem uprawnień i opcjonalnymi kosztami ekonomicznymi, zarządzanych przez edytor w grze.