Plik strefy

Każda strefa to osobny plik w folderze zones/. Nazwa pliku bez .yml jest ID strefy, którego używasz w komendach i placeholderach (zones/spawn-afk.yml to strefa spawn-afk). Po zmianach użyj /szpontafkzone reload.

Notatka

Pliki stref nigdy nie są zmieniane automatycznie przy aktualizacjach pluginu. Komenda set nie nadpisuje twoich ręcznych zmian w pliku.

Ustawienia strefy

Klucz	Domyślnie	Opis
enabled	true	Włącza lub wyłącza strefę bez usuwania pliku. Wyłączona strefa nikogo nie liczy i nie daje nagród.
display-name	ID strefy	Nazwa pokazywana graczom jako {zone_name}.
priority	0	Gdy strefy na siebie zachodzą, gracz jest liczony tylko w strefie o najwyższym priorytecie. Przy równych priorytetach wygrywa ID wcześniejsze alfabetycznie. Dowolna liczba całkowita.
permission	''	Uprawnienie potrzebne, żeby być liczonym w strefie, np. szpontafkzone.zone.vip. Gracze bez niego są traktowani tak, jakby byli poza strefą. '' oznacza każdego gracza.

Wskazówka

Uprawnienia, których nie deklaruje żaden plugin, są rejestrowane z domyślną wartością false, więc operatorzy też nie mają ich automatycznie.

Obszar (region)

Klucz	Domyślnie	Opis
type	CUBOID	CUBOID to prostopadłościan między pos1 i pos2, w którym oba bloki narożne należą do strefy. WORLDGUARD to istniejący region WorldGuard podany w worldguard-id.
world	wymagany	Nazwa świata, np. world albo world_nether.
pos1, pos2		Narożniki obszaru (tylko CUBOID), we współrzędnych bloku: x, y, z.
worldguard-id	''	ID regionu WorldGuard (tylko WORLDGUARD), np. spawn-afk.

region:
  type: CUBOID
  world: world
  pos1:
    x: 0
    y: 64
    z: 0
  pos2:
    x: 5
    y: 69
    z: 5
  worldguard-id: ''

Obszar CUBOID zmienisz w grze na dwa sposoby:

• stań w rogu i użyj /szpontafkzone set <strefa> pos1 (albo pos2);
• zaznacz oba rogi różdżką i użyj /szpontafkzone set <strefa> selection.

Uwaga

Gracz jest liczony, gdy blok, w którym ma stopy, leży w strefie. Strefa powinna więc mieć co najmniej 3 bloki wysokości.

Akcje przy wejściu i wyjściu

Klucz	Domyślnie	Opis
enter-actions	[]	Akcje wykonywane, gdy gracz zaczyna być liczony w strefie: wchodzi do niej, teleportuje się do niej albo dołącza do serwera w jej obszarze.
leave-actions	[]	Akcje wykonywane, gdy gracz przestaje być liczony w strefie, np. wychodzi z niej albo się z niej teleportuje. Nie są wykonywane, gdy gracz wychodzi z serwera.

Dostępne placeholdery: {player}, {uuid}, {zone}, {zone_name}, {prefix}.

enter-actions:
  - '[message] {prefix}Jesteś w strefie &f{zone_name}&7. Zostań tu, aby zbierać nagrody.'
leave-actions:
  - '[actionbar] &7Opuszczasz strefę &f{zone_name}&7.'

Ważne

Te akcje wykonują się przy każdym wejściu i wyjściu, także u graczy, którzy nie zbierają nagród (tryb gry, limit IP). Gracz może je wywołać ponownie, wychodząc i wchodząc. Nie dawaj tu nagród i unikaj linii [broadcast] i [console], które działają na cały serwer.

Składnię linii opisuje strona Akcje.

Nagrody (rewards)

Sekcja rewards zawiera nagrody strefy, każdą z własnym licznikiem, wyświetlaniem i rangami. Opisują je strony Nagrody i rangi oraz Pasek bossa, napis i tytuł.