Corestone

Konfiguracja

plugins/AdminControl/config.yml. Brakujące klucze są dopisywane przy starcie bez ruszania twoich wartości. /ac reload wprowadza większość zmian; tabela mówi, które wymagają restartu. Większość codziennych ustawień (bezpieczeństwo, retencja, Discord, LuckPerms, zgłoszenia) jest zamiast tego w panelu, w Ustawienia → Serwer.

Ogólne

Klucz Domyślnie Znaczenie
config-version 1 Wersja układu pliku; nie zmieniaj.
language en Język komunikatów w grze i w konsoli: en albo pl. Tylko wartość startowa: gdy w panelu zapiszesz Ustawienia → Ogólne, używany jest domyślny język panelu.
server-name "" Nazwa tego serwera w sieci serwerów na jednej bazie MySQL (a-z, 0-9, _, -, najwyżej 32 znaki), najlepiej taka sama jak w velocity.toml (albo w sekcji servers pliku config.yml BungeeCorda). Puste: nazwa folderu serwera (z początkiem identyfikatora serwera po niej dla folderów takich jak container czy data, które dzielą wszystkie serwery hostingu). Zmiana wymaga restartu.

Panel (web)

Wszystkie klucze web.* wymagają restartu.

Klucz Domyślnie Znaczenie
web.enabled true Wyłącz panel, żeby używać AdminControl bez niego.
web.host 0.0.0.0 Adres, na którym nasłuchuje panel. Za reverse proxy na tym samym komputerze użyj 127.0.0.1.
web.port 8080 Port panelu.
web.base-path / Ścieżka, pod którą działa panel, np. /panel na wspólnej domenie.
web.public-url "" Publiczny adres panelu (https://panel.example.com), używany w linkach pokazywanych w grze i w konsoli.
web.hsts false Gdy panel jest dostępny przez https (public-url z https albo zaufane proxy, które to zgłasza): przeglądarki przez rok używają na tym hoście tylko https. Obejmuje każdy port hosta, więc zostaw wyłączone, gdy coś innego działa tam na zwykłym http (np. Dynmap albo BlueMap na innym porcie).

Baza danych (database)

Wszystkie klucze database.* wymagają restartu. Zobacz Bazę danych.

Klucz Domyślnie Znaczenie
database.type sqlite sqlite (plik w folderze pluginu) albo mysql (MySQL lub MariaDB; działa też mariadb, wielkość liter bez znaczenia). Serwer, który używał MySQL, nie przechodzi na nowy plik SQLite, gdy tej wartości nie da się odczytać: zostaje bez bazy, dopóki config.yml nie zostanie poprawiony.
database.sqlite.file data.db Nazwa pliku SQLite.
database.mysql.host localhost Host MySQL/MariaDB.
database.mysql.port 3306 Port.
database.mysql.database admincontrol Nazwa bazy.
database.mysql.user admincontrol Użytkownik.
database.mysql.password "" Hasło.
database.mysql.pool-size 6 Liczba utrzymywanych połączeń.
database.mysql.use-ssl true Szyfruje połączenie; certyfikat nie jest sprawdzany, więc działają też samopodpisane.
database.mysql.ssl-ca "" Certyfikat CA serwera bazy (.pem, pełna ścieżka). Gdy jest ustawiony, sprawdzany jest certyfikat i nazwa hosta, więc nikt między tym serwerem a bazą nie może się pod nią podszyć. Zalecane dla bazy na innym komputerze.

Moduły (modules)

Wyłączanie całych funkcji. Włączenie lub wyłączenie console, announcements, reports albo import wymaga restartu; pozostałe działają po /ac reload.

Klucz Domyślnie Znaczenie
modules.stats true Statystyki pulpitu i ich historia.
modules.punishments true Kary, szablony i reguły ostrzeżeń.
modules.chat true Dziennik czatu, filtry, sterowanie czatem.
modules.announcements true Ogłoszenia i ich rotacja.
modules.console true Konsola w panelu.
modules.reports true Zgłoszenia graczy.
modules.import true Import kar z innych pluginów.

Kary (punishments)

Klucz Domyślnie Znaczenie
punishments.shortcuts true Krótkie komendy (/ban, /mute, ...). Wyłącz, gdy ma je inny plugin; /ac ban działa zawsze. Wymaga restartu.
essentials.take-over-commands true Z EssentialsX: jego komendy kar (/ban, /tempban, /mute, /kick, ... także /essentials:ban, /eban) działają jako komendy AdminControl (zobacz Integracje). false: zostają przy Essentials.
bedrock.geysermc-skins true Głowy graczy Bedrock (Geyser i Floodgate) z API GeyserMC, które dostaje identyfikator Xbox gracza (zobacz Prywatność). false: domyślna głowa, nic nie jest wysyłane.
placeholders.sensitive false Udostępnia innym pluginom %admincontrol_mute_reason%, %admincontrol_punishments% i %admincontrol_open_reports% (zobacz Integracje). Działa po /ac reload.
punishments.mute-blocked-commands [msg, tell, w, r, me, whisper, reply, pm, m, t, emsg, etell, ewhisper, er, ereply, teammsg, tm, mail] Komendy, których wyciszony gracz nie może używać (bez ukośnika; blokowane także z prefiksem pluginu, np. minecraft:msg).

Czat (chat)

Klucz Domyślnie Znaczenie
chat.retention-days 30 Ile dni dziennik czatu trzyma wiadomości, 7–365. Tylko wartość startowa: gdy w panelu zapiszesz ustawienia retencji, używane są wartości z panelu.
chat.private-commands [msg, tell, w, whisper, pm, emsg, etell, ewhisper] Komendy zapisywane jako wiadomości prywatne: /<komenda> <gracz> <tekst>. Dopisz aliasy swojego pluginu do wiadomości.
chat.reply-commands [r, reply, er, ereply] Odpowiedzi do ostatniego rozmówcy prywatnego: /<komenda> <tekst>.

Komunikaty

messages_en.yml i messages_pl.yml zawierają każdy komunikat w grze w formacie MiniMessage (<green>, <bold>, <white><player></white>). Edytuj je dowolnie; /ac reload wprowadza zmiany. Zachowaj <placeholdery>, których komunikat już używa.

Ustawienia w panelu

Ustawienia → Serwer w panelu (wymaga settings.manage):

  • Ogólne: nazwa serwera, domyślny język, strefa czasowa, czy zapisywać wiadomości prywatne.
  • Bezpieczeństwo: wylogowanie po bezczynności (5–240 minut), limit sesji (1–72 godziny), biała lista IP, zaufane proxy.
  • Retencja danych: dziennik zdarzeń (30–1095 dni), czat (7–365), wiadomości prywatne (1–365), surowe statystyki (1–30), statystyki godzinowe (30–1095).
  • Zgłoszenia graczy: odstęp między zgłoszeniami (10–3600 sekund), przypomnienie o otwartych zgłoszeniach przy wejściu.
  • Integracje: webhook Discord i zdarzenia, synchronizacja grup LuckPerms. Zobacz Funkcje.