🔌 O PlugManX

PlugManX to wtyczka Minecraft do zarządzania wtyczkami w trakcie działania serwera Bukkit/Spigot. Udostępnia komendy w grze i w konsoli do sprawdzania zainstalowanych wtyczek, kontrolowania ich cyklu życia (włączanie/wyłączanie/ładowanie/wyładowywanie/przeładowywanie/ponowne uruchamianie) oraz tworzenia list wtyczek do debugowania lub audytu.

🎯 Cel

Wtyczka jest przeznaczona dla administratorów serwerów i deweloperów, którzy muszą zarządzać lub debugować wtyczki po stronie serwera bez pełnego restartu serwera. To przede wszystkim wtyczka narzędziowa i pomocnicza do utrzymania oraz rozwiązywania problemów.

⚙️ Funkcje

  • Włączanie, wyłączanie, ponowne uruchamianie (wyłącz+włącz), ładowanie, przeładowywanie (wyładuj+wczytaj) i wyładowywanie wtyczek w czasie działania.
  • Lista zainstalowanych wtyczek w kolejności alfabetycznej, opcjonalnie z wersjami.
  • Wyświetlanie szczegółowych informacji o wtyczce (wersja, autorzy, komendy itp.).
  • Lista komend zarejestrowanych przez wtyczkę i sprawdzanie, która wtyczka odpowiada za daną komendę.
  • Uzupełnianie nazw wtyczek i komend tabem.
  • Zrzut listy wtyczek i wersji do pliku.
  • Sprawdzanie, czy wtyczka jest aktualna względem zasobu online (zachowanie sprawdzania aktualizacji jest opisane przez projekt).
  • Obsługa uprawnień z węzłami komend; domyślnie komendy wymagają uprawnień operatora.

🧩 Dla kogo

  • Administratorów i operatorów serwerów, którzy potrzebują sterowania wtyczkami „na żywo”.
  • Serwerów deweloperskich lub testowych, na których często zmieniają się wtyczki.
  • Małych i średnich serwerów survival/SMP lub prywatnych, gdzie restart jest uciążliwy.

🏗️ Przykładowe zastosowania

  • Administrator wyłącza wadliwą wtyczkę bez restartu serwera, aby przywrócić stabilność.
  • Deweloper ładuje świeżo zbudowany plik jar wtyczki na serwer testowy, gdy gracze są nadal online.
  • Utworzenie pliku zrzutu z nazwami i wersjami wtyczek, aby ułatwić rozwiązywanie problemów lub inwentaryzację komponentów serwera.

⌨️ Komendy

KomendaOpisUprawnienieDostęp
/plugman helpPokazuje informacje pomocy.plugman.helpAdmin
/plugman list [-v]Wyświetla wtyczki w kolejności alfabetycznej. Użyj -v, aby uwzględnić wersje.plugman.listAdmin
/plugman info [plugin]Wyświetla informacje o wtyczce.plugman.infoAdmin
/plugman dumpZapisuje nazwy i wersje wtyczek do pliku.plugman.dumpAdmin
/plugman usage [plugin]Wyświetla komendy zarejestrowane przez wtyczkę.plugman.usageAdmin
/plugman lookup [command]Znajduje wtyczkę, do której zarejestrowana jest komenda.plugman.lookupAdmin
`/plugman enable [pluginall]`Włącza wtyczkę.plugman.enable / plugman.enable.all
`/plugman disable [pluginall]`Wyłącza wtyczkę.plugman.disable / plugman.disable.all
`/plugman restart [pluginall]`Uruchamia ponownie wtyczkę (wyłącz/włącz).plugman.restart / plugman.restart.all
/plugman load [plugin]Ładuje wtyczkę.plugman.loadAdmin
`/plugman reload [pluginall]`Przeładowuje (wyładuj/wczytaj) wtyczkę.plugman.reload / plugman.reload.all
/plugman unload [plugin]Wyładowuje wtyczkę.plugman.unloadAdmin
`/plugman check [pluginall] -f`Sprawdza, czy wtyczka jest aktualna.plugman.check / plugman.check.all

🔐 Uprawnienia

UprawnienieOpisDomyślnie
plugman.adminUmożliwia użycie wszystkich komend PlugMan.op
plugman.updateUmożliwia użytkownikowi widzieć komunikaty o aktualizacjach.op
plugman.helpUmożliwia użycie komendy help.op
plugman.listUmożliwia użycie komendy list.op
plugman.infoUmożliwia użycie komendy info.op
plugman.dumpUmożliwia użycie komendy dump.op
plugman.usageUmożliwia użycie komendy usage.op
plugman.lookupUmożliwia użycie komendy lookup.op
plugman.enableUmożliwia użycie komendy enable.op
plugman.enable.allUmożliwia użycie komendy enable all.op
plugman.disableUmożliwia użycie komendy disable.op
plugman.disable.allUmożliwia użycie komendy disable all.op
plugman.restartUmożliwia użycie komendy restart.op
plugman.restart.allUmożliwia użycie komendy restart all.op
plugman.loadUmożliwia użycie komendy load.op
plugman.reloadUmożliwia użycie komendy reload.op
plugman.reload.allUmożliwia użycie komendy reload all.op
plugman.unloadUmożliwia użycie komendy unload.op
plugman.checkUmożliwia użycie komendy check.op
plugman.check.allUmożliwia użycie komendy check all.op

⚙️ Instalacja

📥 Konfiguracja

  • Pobierz oficjalny plik .jar PlugManX i umieść go w katalogu plugins/ serwera.
  • Uruchom serwer ponownie, aby załadować wtyczkę, i potwierdź komunikaty startowe w konsoli.

🧾 Konfiguracja

  • Projekt dostarcza plik config.yml jako część zasobów; wtyczka zapisuje lub używa pliku konfiguracyjnego przy pierwszym uruchomieniu.

🧠 Uwagi techniczne

  • Projekt jest rozpowszechniany na licencji MIT.
  • Komendy i węzły uprawnień są opisane przez projekt; domyślnie węzły wymagają uprawnień operatora.
  • Repozytorium projektu i pliki konfiguracyjne są utrzymywane w repozytorium źródłowym wtyczki.
  • Wtyczka wykonuje operacje w czasie działania, które mogą wpływać na stan wtyczek; używanie operacji wyładuj/wczytaj w czasie działania może powodować niestabilność z niektórymi wtyczkami i zwykle jest zalecane do administracji i debugowania, a nie na produkcyjnych serwerach o wysokiej dostępności.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli chcesz sprawdzać lub kontrolować zainstalowane wtyczki bez przerywania sesji graczy, PlugManX zapewnia zwięzły zestaw komend do zarządzania wtyczkami w czasie działania oraz funkcje raportowania, które upraszczają krótkoterminową podmianę wtyczek, debugowanie i inwentaryzację.

Serwery z pluginem PlugManX

Strona pluginu PlugManX pokazuje serwery, na których monitoring znalazł ten plugin, używaną platformę i wersję.

Plugin może dodawać komendy, ekonomię, bezpieczeństwo, uprawnienia dostępu, minigry, integracje i inne mechaniki. Rzeczywista rola PlugManX zależy od ustawień serwera.

Dane są generowane automatycznie z technicznych odpowiedzi serwerów. Jeśli serwer trzyma listę pluginów prywatnie, może używać PlugManX, ale nie pojawiać się w tej sekcji.

Użyj listy serwerów z PlugManX, aby porównać projekty, sprawdzić wspierane wersje lub znaleźć przykłady użycia pluginu na publicznych serwerach.