Komendy
Status mostu, przeładowanie, podgląd kluczy i czyszczenie cache.
Plugin rejestruje jedną komendę z czterema podkomendami.
Komendy
| Komenda | Co robi |
|---|---|
/grzybciorynekweb status | Stan mostu, połączenie z rynkiem, serwer HTTP |
/grzybciorynekweb reload | Przeładowuje config.yml i restartuje serwer HTTP |
/grzybciorynekweb key | Informacje o skonfigurowanych kluczach |
/grzybciorynekweb cache | Stan cache |
/grzybciorynekweb cache clear | Czyści cache |
Alias: /grynekweb. Wywołanie komendy bez argumentu działa jak status.
Komenda ma podpowiedzi po Tabie — dla pierwszego argumentu podpowiada
status, reload, key, cache, a po cache podpowiada clear.
Uprawnienie
| Uprawnienie | Domyślnie |
|---|---|
grybciorynekweb.admin | operatorzy |
Uwaga na literówkę w nazwie uprawnienia
Węzeł nazywa się grybciorynekweb.admin — bez „z" po „g". Tak jest zapisany
w plugin.yml pluginu.
Jeśli nadajesz uprawnienia przez LuckPermsa i wpiszesz intuicyjne
grzybciorynekweb.admin, nie zadziała. Wpisuj dokładnie:
/lp group admin permission set grybciorynekweb.admin truestatus
Pierwsza rzecz do sprawdzenia, gdy coś nie działa. Pokazuje, czy:
- most połączył się z GrzybcioRynkiem,
- serwer HTTP nasłuchuje i na jakim porcie,
- uwierzytelnianie jest włączone,
- strumień SSE działa.
/grzybciorynekweb statusAlternatywa bez wchodzenia do gry — health check przez HTTP:
curl http://127.0.0.1:8765/api/v1/healthreload
/grzybciorynekweb reloadPrzeładowuje konfigurację i restartuje serwer HTTP. Używaj po każdej zmianie
config.yml — zmiany portu, kluczy, CORS-u i limitów wchodzą w życie bez restartu
całego serwera.
Otwarte strumienie SSE zostaną zerwane
Restart serwera HTTP zamyka aktywne połączenia. Klienci powinni same się połączyć ponownie, ale warto o tym pamiętać przy przeładowywaniu w godzinach szczytu.
key
/grzybciorynekweb keyPokazuje informacje o skonfigurowanych kluczach — ich nazwy i uprawnienia. Przydaje się do sprawdzenia, czy klucz w ogóle został wczytany po zmianie konfiguracji.
Nie pokazuj tego na streamie
Zanim wywołasz tę komendę podczas nagrywania albo udostępniania ekranu, upewnij się,
że nie masz włączonego streamu. Ta sama zasada co przy zrzutach ekranu z config.yml.
cache
/grzybciorynekweb cachePokazuje stan cache. Żeby go wyczyścić:
/grzybciorynekweb cache clearPrzydaje się, gdy:
- zmieniłeś coś w rynku i chcesz, żeby strona od razu to zobaczyła,
- testujesz, czy problem wynika z cache, czy z samych danych,
- właśnie skróciłeś TTL i chcesz wyrzucić stare wpisy.
Czyszczenie cache to nie jest rutynowa czynność
Cache istnieje po to, żeby ruch ze strony nie obciążał serwera gry. Czyszczenie go regularnie (na przykład zadaniem cyklicznym) przekreśla cały sens — zmiany na żywo i tak lecą przez SSE.
Typowa kolejność przy diagnozie
/grzybciorynekweb statusCzy most w ogóle wstał i połączył się z rynkiem?
curl http://127.0.0.1:8765/api/v1/healthCzy serwer HTTP odpowiada lokalnie?
curl -H "X-API-Key: twoj-klucz" http://127.0.0.1:8765/api/v1/listings?limit=1Czy klucz jest akceptowany i czy dane wracają?
/grzybciorynekweb keyCzy klucz, którego używasz, jest tym, który plugin wczytał?
Jeśli wszystkie cztery kroki przechodzą, a strona dalej nie działa — problem jest po stronie strony albo CORS-u. Patrz Problemy.