config.yml

Ustawienia globalne. Każda strefa ma osobny plik w zones/, a wiadomości są w lang/.

Po zmianach użyj /szpontafkzone reload. Wyjątki są opisane przy opcjach, które wymagają restartu.

Ogólne

Klucz	Domyślnie	Opis
`language`	`en`	Język wszystkich wiadomości, czyli plik `lang/<language>.yml`. W zestawie są `en` i `pl`, ale możesz dodać własny język (zobacz Języki i wiadomości). Nowe pliki stref też powstają w tym języku: `en` albo `pl`, a każdy inny język dostaje angielski szablon.
`text-format`	`LEGACY`	Sposób zapisu tekstów: `LEGACY` (kody `&a`, hex, gradienty) albo `MINIMESSAGE`. Zobacz Formatowanie tekstu.
`debug`	`false`	Dodatkowe linie `[debug]` w konsoli: wejścia i wyjścia ze stref, powód, dla którego gracz nie zbiera, i każde losowanie nagrody. Przydaje się przy ustawianiu stref, ale na działającym serwerze zostaw `false`.

update-checker

Raz przy starcie, w tle, sprawdza, czy jest nowa wersja SzpontAFKZone. Szczegóły są na stronie Aktualizacje.

Klucz	Domyślnie	Opis
`enabled`	`true`	`true` sprawdza i wypisuje wynik w konsoli, `false` nigdy nie sprawdza. Zmiana wymaga restartu.
`notify-on-join`	`true`	Informuje też graczy z uprawnieniem `szpontafkzone.notify.update` (domyślnie operatorów) przy wejściu na serwer. `false` pisze tylko w konsoli.

commands

Klucz	Domyślnie	Opis
`aliases`	`[afkzone]`	Dodatkowe nazwy komendy `/szpontafkzone`: tylko `a-z`, `0-9`, `-` i `_`, bez polskich liter. `[]` oznacza brak. Zmiana wymaga restartu. Nazwa zajęta przez inny plugin zostaje pominięta z ostrzeżeniem w konsoli.
`subcommand-aliases`	`set: [ustaw]`	Dodatkowe nazwy podkomend, np. tłumaczenia, w zapisie `<podkomenda>: [nazwy]`. Dozwolone są litery (także polskie), cyfry, `-` i `_`, bez spacji. Angielskie nazwy działają zawsze. `{}` oznacza brak. Zmiana działa po `reload`.

Podkomendy, którym możesz nadać aliasy: help, reload, wand, pos1, pos2, create, set, delete, enable, disable, list, info, tp, show.

commands:
  aliases:
    - afkzone
  subcommand-aliases:
    set:
      - ustaw

hooks

Integracja działa tylko wtedy, gdy dany plugin jest zainstalowany. false każe go ignorować, nawet jeśli jest na serwerze.

Klucz	Domyślnie	Opis
`placeholderapi`	`true`	Placeholdery innych pluginów (`%...%`) działają we wszystkich tekstach i akcjach, a SzpontAFKZone dodaje własne. Zobacz PlaceholderAPI.
`worldguard`	`true`	Strefa może używać regionu WorldGuard jako obszaru. Przy `false` takie strefy są nieaktywne. Zobacz WorldGuard.

progress

Co dzieje się z licznikami nagród gracza. Więcej na stronie Postęp i ochrona przed nadużyciami.

Klucz	Domyślnie	Opis
`on-leave`	`PAUSE`	Gdy gracz wychodzi ze strefy: `PAUSE` zatrzymuje liczniki tej strefy, które ruszają dalej przy następnej wizycie, a `RESET` sprawia, że przy następnej wizycie liczą od zera.
`on-quit`	`SAVE`	Gdy gracz wychodzi z serwera: `SAVE` zapisuje liczniki w danych gracza, które działają dalej po ponownym wejściu (także po restarcie), a `RESET` sprawia, że po ponownym wejściu liczą od zera.

anti-abuse

Klucz	Domyślnie	Opis
`allowed-gamemodes`	`[SURVIVAL, ADVENTURE]`	Tryby gry, w których gracze zbierają nagrody: `SURVIVAL`, `CREATIVE`, `ADVENTURE`, `SPECTATOR`. Przy pustej liście `[]` nikt nie zbiera nagród.
`reward-vanished-players`	`false`	Czy gracze na vanishu zbierają nagrody. `false` traktuje ich tak, jakby byli poza każdą strefą.
`ip-limit.enabled`	`false`	Włącza limit graczy z jednego adresu IP w tej samej strefie.
`ip-limit.max-players`	`1`	Ilu graczy z jednego adresu IP może jednocześnie zbierać nagrody w tej samej strefie. Co najmniej 1.

displays

Klucz	Domyślnie	Opis
`join-separator`	`' &8\| '`	Wstawiany między teksty kilku nagród, gdy więcej niż jedna pokazuje napis nad paskiem przedmiotów albo tytuł. Gracz widzi naraz tylko jeden napis i jeden tytuł. Zapisany w formacie z `text-format`.

Pasek bossa, napis i tytuł ustawiasz dla każdej nagrody w pliku strefy. Zobacz Pasek bossa, napis i tytuł.

wand

Różdżka do zaznaczania (/szpontafkzone wand).

Klucz	Domyślnie	Opis
`item`	`BLAZE_ROD`	Przedmiot różdżki: nazwa materiału (`BLAZE_ROD`) albo ID (`minecraft:blaze_rod`). Rogi zaznaczają tylko różdżki dane komendą `/szpontafkzone wand`. Inne przedmioty tego typu działają normalnie.
`particle`	`FLAME`	Cząsteczka rysująca zaznaczenie i granice stref. Działają tylko cząsteczki bez dodatkowych danych, np. `FLAME`, `SOUL_FIRE_FLAME`, `END_ROD`, `ELECTRIC_SPARK`.
`preview-seconds`	`10`	Jak długo, w sekundach, rysowane są granice po ustawieniu rogu i po `/szpontafkzone show`. Zakres 1–300.