Nagrody i rangi

Każda nagroda ma własny licznik, a rangi z uprawnień decydują, co gracz dostaje i z jaką szansą.

Nagrody

Sekcja rewards w pliku strefy zawiera nagrody. Każda ma własny licznik czasu, własne wyświetlanie i własne rangi oraz działa niezależnie od pozostałych. Szablon ma dwie nagrody:

guaranteed: dawana za każdym razem, gdy licznik dobiegnie końca (szansa 100% w każdej randze);
bonus: działa tak samo, ale nagroda wypada tylko z szansą przypisaną randze gracza.

ID nagród wybierasz sam: możesz je zmieniać, dodawać nowe nagrody i usuwać istniejące. ID może mieć od 1 do 32 znaków: małe litery a-z, cyfry i pojedyncze myślniki, bez polskich liter i spacji. Pojawia się w placeholderach, np. %szpontafkzone_time_left_bonus%.

Klucz	Domyślnie	Opis
`enabled`	`true`	Włącza lub wyłącza nagrodę.
`interval-seconds`	`600`	Czas w strefie potrzebny do jednej nagrody, w sekundach (600 = 10 minut). Co najmniej 1.
`visible-without-tier`	`false`	Co widzą gracze bez pasującej rangi. `false`: nic, bo nagroda jest ukryta, a jej licznik nie działa. `true`: wyświetlanie i licznik, ale bez nagrody.
`boss-bar`, `action-bar`, `title`		Wyświetlanie postępu. Zobacz Pasek bossa, napis i tytuł.
`tiers`		Rangi tej nagrody (niżej).

Rangi

Rangi decydują, kto dostaje którą nagrodę. Gracz dostaje rangę o najwyższym priorytecie spośród tych, do których ma uprawnienie. ID rang podlegają tym samym zasadom co ID nagród.

Klucz	Domyślnie	Opis
`priority`	`0`	Wyższa liczba wygrywa, gdy gracz pasuje do kilku rang. Dowolna liczba całkowita.
`display-name`	ID rangi	Nazwa pokazywana jako `{tier_name}`.
`permission`	`''`	Uprawnienie potrzebne do tej rangi. `''` oznacza każdego gracza.
`chance-percent`	`100`	Szansa na nagrodę, gdy licznik dobiegnie końca, w procentach: 0–100, z ułamkami pisanymi z kropką lub przecinkiem (np. `12.5` albo `12,5`). `100` oznacza zawsze.
`actions`	`[]`	Akcje wykonywane, gdy licznik dobiegnie końca i losowanie się uda.
`fail-actions`	`[]`	Akcje wykonywane, gdy losowanie się nie uda (tylko przy `chance-percent` poniżej 100).

Przykład

Bonus co 10 minut: 10% szansy dla wszystkich, 45% dla VIP-ów.

rewards:
  bonus:
    enabled: true
    interval-seconds: 600
    visible-without-tier: false
    boss-bar:
      enabled: true
      text: '&6Bonus za &e{time_left} &8- &7szansa: &e{chance}%'
      color: YELLOW
    tiers:
      default:
        priority: 10
        display-name: 'Gracz'
        permission: ''
        chance-percent: 10
        actions:
          - '[console] give {player} gold_ingot 1'
          - '[sound] minecraft:ui.toast.challenge_complete;0.5;1.0'
        fail-actions:
          - '[message] {prefix}Tym razem bez bonusu &8(&7szansa: &e{chance}%&8)&7.'
      vip:
        priority: 20
        display-name: 'VIP'
        permission: szpontafkzone.tier.vip
        chance-percent: 45
        actions:
          - '[console] give {player} gold_ingot 2'

Prawdziwe nagrody to zwykle komendy konsoli, np. [console] give {player} diamond 1 albo [console] eco give {player} 100 (pieniądze, wymaga pluginu ekonomii). Przeczytaj ostrzeżenie o [console] na stronie Akcje.