Komendy

Komendy to serce produktu — wykonują się z konsoli serwera, więc działają tak samo, jak gdybyś wpisał je w konsoli.

Wpisuj je bez ukośnika na początku (ukośnik i tak zostanie usunięty).
Jedna komenda = jedna linia, maksymalnie 1000 znaków.
Produkt może mieć do 50 komend.

Ustawienia komendy

Przy każdej komendzie wybierasz:

Ustawienie	Opcje
Kiedy	Po zakupie — od razu po opłaceniu. Gdy gracz wejdzie na serwer — przy najbliższym wejściu gracza (zawsze wymaga gracza online).
Wariant	Każdy wariant albo tylko wybrany wariant.
Serwer	Wszystkie serwery albo jeden wybrany.
Gracz online	Domyślnie jak w ustawieniu produktu „Wymaga gracza online”; możesz to wymusić: Czekaj, aż gracz będzie online albo Wykonaj od razu, nawet offline.

„Po wygaśnięciu” i „Po zwrocie pieniędzy”

W edytorze są też wyzwalacze Po wygaśnięciu i Po zwrocie pieniędzy, ale obecnie się nie wykonują. Do rang czasowych używaj addtemp w LuckPerms (przykład niżej) — wtedy ranga zniknie sama, nawet gdy serwer był wyłączony.

Placeholdery

Kliknij Wstaw: nad komendą, żeby dodać placeholder. Przed wysłaniem na serwer zostaną podmienione na dane zamówienia.

Placeholder	Wartość	Przykład
`{player}`	Nick gracza z zamówienia	`Notch`
`{uuid}`	UUID gracza (puste, jeśli nieznane)	`069a79f4-44e9-4726-a5be-fca90e38aaf5`
`{price}`	Zapłacona kwota	`20.00`
`{tier}`	Nazwa wybranego wariantu	`30 dni`
`{quantity}`	Liczba sztuk	`1`
`{order_number}`	Numer zamówienia w sklepie	`1042`
`{transaction_id}`	Identyfikator zamówienia	`cm3x…`
`{expires_at}`	Data wygaśnięcia (ISO 8601) lub puste	`2026-12-05T12:00:00.000Z`

Nick jest sprawdzany przed wstawieniem do komendy (2–16 znaków: litery, cyfry, _, opcjonalnie prefiks . lub * dla graczy Bedrock). Gracz nie przemyci więc do konsoli spacji ani dodatkowych argumentów.

Przykłady

lp user {player} parent addtemp vip 30d

LuckPerms sam zdejmie rangę po 30 dniach. Kolejny zakup przy aktywnej randze — w zależności od ustawień LuckPerms — przedłuży ją albo nadpisze (addtemp … accumulate sumuje czas).

lp user {player} parent addtemp vip 30d accumulate

lp user {player} parent add vip

give {player} diamond 64

Ustaw Kiedy: Gdy gracz wejdzie na serwer albo włącz Wymaga gracza online — /give nie zadziała, gdy gracza nie ma na serwerze.

crates key give {player} legendarny 1

Składnia zależy od Twojego pluginu skrzynek (np. ExcellentCrates, CrazyCrates).

eco give {player} 10000

broadcast &d{player} &7kupił &fVIP&7! Dziękujemy!

Szablony w edytorze

Nad listą komend są gotowe szablony:

Ranga LuckPerms — dodaje lp user {player} parent add {ranga}. Dla rang czasowych zamień ją na addtemp z liczbą dni, jak w przykładzie wyżej, i usuń dodaną komendę „Po wygaśnięciu”.
Ogłoszenie na czacie — broadcast z nickiem gracza.
Przedmiot do ekwipunku — give {player} diamond 1, wykonywane po wejściu gracza.

Różne komendy dla wariantów

Produkt VIP z wariantami 30 dni, 90 dni i Na zawsze:

Komenda	Wariant
`lp user {player} parent addtemp vip 30d accumulate`	Tylko: 30 dni
`lp user {player} parent addtemp vip 90d accumulate`	Tylko: 90 dni
`lp user {player} parent add vip`	Tylko: Na zawsze
`broadcast &d{player} &7kupił &fVIP {tier}&7!`	Każdy wariant

Gracz offline

Komendy oznaczone jako wymagające gracza online plugin zapisuje w lokalnej bazie na serwerze i wykonuje, gdy gracz wejdzie — także po restarcie serwera. Domyślnie czeka 2 sekundy po wejściu, żeby LuckPerms zdążył wczytać gracza (join-delay-ticks w konfiguracji).

Liczbę czekających dostaw dla gracza pokażesz placeholderem %stillshop_pending% (PlaceholderAPI).

Ponowne próby

Jeśli serwer nie potwierdzi wykonania (np. padł w trakcie), komenda wraca do kolejki i jest ponawiana z rosnącym odstępem — do 5 razy. Każda komenda wykonuje się najwyżej raz: plugin pamięta wykonane komendy i nie powtórzy ich po ponownym dostarczeniu.