Corestone

CoreStatus

CoreStatus utrzymuje na kanale Discorda jedną wiadomość o stanie serwera Minecraft: online lub offline, gracze, TPS, czas działania i inne dane. Wysyła też krótkie wiadomości o starcie i zatrzymaniu serwera, o wejściach i wyjściach graczy oraz o długo niskim TPS. Wszystko idzie przez webhooki Discorda. Nie trzeba hostować bota ani zakładać konta.

Na proxy Velocity lub BungeeCord plugin utrzymuje jedną zbiorczą wiadomość o całej sieci.

English: the guide in English

Wymagania

  • Jeden jar dla Papera, Purpura, Folii, Spigota, Velocity i BungeeCord (także Waterfall).
  • Serwery: Minecraft od 1.20.6 do 26.3. Proxy: Velocity 3.5 lub nowsze, BungeeCord lub Waterfall.
  • Java 21 lub nowsza, także na proxy. Wersja serwera może wymagać nowszej Javy: Minecraft 26.x wymaga Javy 25.
  • Kanał Discorda, na którym można utworzyć webhook (uprawnienie „Zarządzanie webhookami”).
  • Serwer, który łączy się z discord.com przez HTTPS.

Testowane na Paperze 1.21.4 i 26.3, Folii 26.3, Spigocie 26.2, Velocity 3.5.1 i Waterfall 1.21 (build 615), każde na prawdziwym serwerze, z atrapą Discorda.

Instalacja

  1. Pobierz CoreStatus-1.0.0.jar.
  2. Wrzuć go do folderu plugins serwera lub proxy.
  3. Uruchom serwer. CoreStatus zapisze plugins/CoreStatus/config.yml i napisze w konsoli, że nie ustawiono adresu webhooka. Na Discorda nic jeszcze nie trafia.
  4. Utwórz webhook (następna sekcja) i wklej jego adres do configu.
  5. Wpisz /corestatus reload albo zrestartuj serwer.

Tworzenie webhooka

  1. W Discordzie otwórz ustawienia kanału, na którym ma być widać status.

  2. Przejdź do Integracje, potem Webhooki, potem Nowy webhook.

  3. Ustaw nazwę i obrazek, jeśli to potrzebne, i wybierz Kopiuj adres URL webhooka.

  4. Otwórz plugins/CoreStatus/config.yml i wklej adres w status.webhook:

    status:
  webhook: "https://discord.com/api/webhooks/123/abc…"

    Powyższy adres jest zmyślony. Należy wkleić własny.

  5. Wpisz /corestatus reload. Wiadomość ze statusem pojawi się na kanale w ciągu kilku sekund.

  6. Wpisz /corestatus test, aby sprawdzić, czy każdy webhook działa.

Status oraz wiadomości o starcie i zatrzymaniu pasują do kanału publicznego. Ostrzeżenie o niskim TPS (i wejścia oraz wyjścia) lepiej wysyłać na kanał dla administracji: wystarczy utworzyć drugi webhook i wpisać go w low-tps.webhook (join-leave.webhook), zobacz Więcej niż jeden webhook.

Adres webhooka jest tajny: każdy, kto go ma, może pisać na kanale. Nie wolno udostępniać config.yml z adresem w środku ani wklejać adresu na kanale pomocy. Jeśli adres wycieknie, trzeba usunąć webhook w Discordzie i utworzyć nowy. CoreStatus nigdy nie wypisuje w konsoli całego adresu: token jest ukryty.

Na proxy

Na Velocity i BungeeCord pierwsze uruchomienie zapisuje inny config.yml, dla wiadomości o sieci. Wklej adres w network.webhook, ustaw network.enabled na true, wypisz serwery w network.servers i wpisz /corestatus reload. Zobacz Tryb sieci.

Serwery za proxy też mogą mieć CoreStatus, każdy z własną wiadomością ze statusem i własnym configiem.

Pliki

CoreStatus trzyma pliki w plugins/CoreStatus na każdej platformie, także na Velocity.

Plik Co to jest
config.yml Ustawienia. Zapisywany przy pierwszym uruchomieniu.
data.yml To, co CoreStatus pamięta między uruchomieniami: id każdej edytowanej wiadomości ze statusem i czas, kiedy serwer był ostatnio widziany jako działający. Nie należy go edytować.
messages_en.yml, messages_pl.yml Opcjonalne. Własne teksty. CoreStatus ich nie tworzy: zobacz Zmiana tekstów.

Prywatność

  • Brak telemetrii. CoreStatus nie zbiera ani nie wysyła statystyk i nie sprawdza aktualizacji.
  • Połączenia idą tylko na adresy webhooków ustawione w config.yml, na discord.com.
  • Status domyślnie pokazuje do 10 nicków graczy. Aby wyłączyć listę, ustaw status.show.player-list: 0. Wiadomości o wejściach i wyjściach (join-leave.enabled) również podają nicki; są domyślnie wyłączone.
  • Gracze w vanish (metadane vanished, których używają SuperVanish, PremiumVanish i EssentialsX) nie wchodzą do licznika, listy ani do wiadomości o wejściach i wyjściach.

W tym przewodniku

Linki