Plugin Minecraft MyCommand

🔌 O MyCommand

MyCommand to plugin do Minecrafta, który pozwala tworzyć własne komendy, aliasy i interaktywne interfejsy oparte na komendach bez pisania w Javie. Oferuje system oparty na YAML do definiowania komend, które uruchamiają inne komendy, wysyłają sformatowany tekst, otwierają GUI, wyzwalają skrypty i współpracują z eventami.

🎯 Cel

MyCommand jest przeznaczony dla administratorów serwerów, którzy potrzebują elastycznych własnych komend, skrótów i interfejsów admina/użytkownika. Rozwiązuje problem dodawania niestandardowego zachowania komend (opóźnienia, warmupy, cooldowny, tab-completion, placeholdery) oraz lekkich interakcji z GUI bez tworzenia pełnego pluginu.

⚙️ Funkcje

• Tworzenie nowych komend i aliasów, opcjonalnie rejestrowanych do tab-completion.
• Uruchamianie wielu komend z jednej własnej komendy (wykonanie z konsoli lub przez gracza).
• Opóźnienia, warmupy i cooldowny dla komend.
• Nadpisywanie innych komend lub oferowanie skrótów/aliasów.
• Wyzwalanie komend z przedmiotów, bloków, znaków, książek, NPC i item frame’ów.
• Elementy GUI: IconMenu oparte na skrzyni, ActionBar, BossBar, Title, Scoreboard, Anvil GUI i Sign GUI.
• Wsparcie placeholderów i warunków w stylu skryptowym dla dynamicznego działania.
• Integracja z ekonomią (opcjonalnie przez Vault) oraz kilka niezależnych funkcji ekonomicznych.
• Obsługa eventów gracza (dołączenie/wyjście/śmierć) i zadań harmonogramu.
• Opcjonalna własna baza danych graczy oparta na SQL i obsługa wielu plików dla nieograniczonej liczby komend.
• Funkcje związane z BungeeCord oraz osobna wersja po stronie Bungee do komend po stronie proxy.
• Żądania HTTP (GET/POST) i wsparcie formatowania MiniMessage tam, gdzie jest dostępne.
• Do raportowania metryk używa bStats.

🧩 Dla kogo jest

• Serwery Survival i SMP, które chcą własnych komend i menu bez kodowania.
• Serwery mocno administracyjne lub ekonomiczne, które potrzebują własnych przepływów sklepu/komend.
• Sieci proxy wymagające scentralizowanego lub proxy-side zachowania komend.
• Operatorzy serwerów, którzy potrzebują skryptowych warunków i placeholderów do dynamicznych wyników.

🏗️ Przykładowe zastosowania

• Zdefiniowanie jednej komendy, która uruchamia sekwencję komend konsoli, aby otworzyć sklep, dać przedmioty i zapisać zakup.
• Tworzenie menu GUI do kar/teleportacji z użyciem pozycji w chest GUI oraz promptów anvil/sign.
• Udostępnianie krótkich aliasów mapowanych na dłuższe komendy przełączania serwera BungeeCord z tab-completion.

⌨️ Komendy

Oficjalna dokumentacja zawiera komendy administracyjne do zarządzania pluginem. Przykłady opisane przez projekt obejmują:

(Patrz oficjalna dokumentacja komend pluginu, aby zobaczyć pełną listę i dokładną składnię.)

🔐 Uprawnienia

Projekt dokumentuje node’y uprawnień dla działań administracyjnych. Przykłady z oficjalnej listy uprawnień obejmują:

| Permission | Description | Default | |---|---|---|---| | mycommand.reload | Uprawnienie do przeładowania konfiguracji MyCommand. | nieokreślone | | mycommand.book.make | Uprawnienie do tworzenia książek z własnych komend. | nieokreślone |

(Patrz dokumentacja uprawnień pluginu, aby zobaczyć pełną mapę uprawnień.)

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plugin .jar i umieść go w folderze plugins/ na serwerze.
• Uruchom lub zrestartuj serwer i sprawdź logi konsoli, aby potwierdzić, że plugin został załadowany.
• Jeśli plugin nie chce się załadować, sprawdź, czy wymagane/opcjonalne pluginy wspierające (patrz Zależności) są obecne lub zaktualizowane.

📦 Zależności

• ProtocolLib — wskazywany jako ważny, jeśli plugin się nie ładuje lub dla niektórych funkcji.
• Vault — opcjonalny, wymagany do integracji z ekonomią.
• PlaceholderAPI — opcjonalny, do rozszerzonej obsługi placeholderów.

Instaluj tylko te zależności, które są potwierdzone dla potrzebnych funkcji; wiele integracji jest opcjonalnych.

🧠 Notatki techniczne

• Plugin konfiguruje się przez pliki YAML i obsługuje wiele plików komend, aby ominąć limity komend.
• Dla własnej bazy danych graczy dostępny jest storage SQL (opcjonalny), a konfiguracje wieloplikowe są obsługiwane.
• Istnieje osobny komponent BungeeCord do obsługi komend po stronie proxy.
• Projekt raportuje metryki przez bStats.
• Formatowanie MiniMessage i wsparcie tab-completion są dostępne w obsługiwanych środowiskach.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz elastycznych, opartych na plikach własnych komend, skryptów warunkowych i przepływów komend opartych na GUI bez pisania w Javie, MyCommand zapewnia konfigurowalną platformę do takich zadań i w razie potrzeby dodaje integracje z proxy oraz ekonomią.