Notatki operatora

Datapack: funkcje .mcfunction i scoreboardy w Minecraft

Część trzecia serii o datapackach. Tu robi się ciekawie: piszemy własne funkcje w plikach .mcfunction, podpinamy je pod tagi minecraft:tick i minecraft:load, a scoreboardu używamy jako licznika i timera. Na końcu składamy z tego prosty, działający przykład mechaniki. Składnia opisana dla Minecraft 1.21 i nowszych, bo właśnie tam zmieniły się nazwy folderów.

Opublikowano 4 czerwca 2026 · ~9 min czytania

Pliki .mcfunction: reguły, których łatwo nie złamać

W części pierwszej powstał szkielet datapacku. Teraz dokładamy do niego logikę. Funkcja to zwykły plik tekstowy z rozszerzeniem .mcfunction, w którym każda linia to jedna komenda. Trzy reguły, które trzeba mieć w głowie od początku:

• Bez ukośnika na początku. W grze na czacie piszesz /say czesc. W pliku funkcji ten sam wpis wygląda tak: say czesc. Ukośnik w funkcji to błąd, gra nie wykona takiej linii.
• Komentarze od znaku #. Linia zaczynająca się od hasha jest pomijana, więc opisuj nią, co robi dany fragment. Puste linie też są ignorowane, możesz nimi rozdzielać sekcje, żeby plik dało się czytać.
• Komendy wykonują się po kolei, z góry na dół. Nie ma tu pętli ani warunków w stylu zwykłego programowania, logikę budujesz z komendy execute i ze scoreboardu.

Funkcje leżą w folderze data/<przestrzen>/function/. To ważny szczegół wersyjny: od Minecraft 1.21 ten folder nazywa się function w liczbie pojedynczej (wcześniej był functions). Jeśli używasz starszego poradnika, najczęstszą przyczyną tego, że funkcja nie działa na 1.21, jest właśnie stara nazwa folderu z literą s na końcu.

Funkcję uruchamiasz z czatu komendą /function <przestrzen>:<nazwa>, na przykład /function moj_pack:powitanie dla pliku data/moj_pack/function/powitanie.mcfunction. Po każdej zmianie w plikach wywołaj /reload, żeby gra wczytała nową wersję.

# data/moj_pack/function/powitanie.mcfunction
# Prosta funkcja: napis na czacie i dzwiek dla wszystkich graczy

say Datapack zaladowany
playsound minecraft:entity.player.levelup master @a

Tagi funkcji: tick i load

Samo napisanie funkcji nie sprawia, że gra ją odpala. Albo wywołujesz ją ręcznie komendą /function, albo podpinasz pod tag funkcji, czyli plik JSON, który mówi grze: te funkcje uruchamiaj automatycznie. Tagi leżą w data/minecraft/tags/function/, i tu znów liczba pojedyncza function od wersji 1.21. Dwa wbudowane tagi załatwiają większość potrzeb:

• minecraft:tick, gra odpala te funkcje na początku każdego ticka, czyli 20 razy na sekundę. To jest pętla gry. Tu trafia logika, którą trzeba sprawdzać cały czas: timery, liczniki, warunki na graczach.
• minecraft:load, gra odpala te funkcje raz, przy starcie świata i przy każdym /reload. To miejsce na konfigurację: utworzenie celów scoreboardu, ustawienie wartości startowych, wypisanie komunikatu, że pack wstał.

Plik tagu to JSON z tablicą values, w której wpisujesz pełne nazwy funkcji (przestrzeń i nazwa). Tak wygląda podpięcie funkcji startowej pod load:

// data/minecraft/tags/function/load.json
{
  "values": [
    "moj_pack:start"
  ]
}

I analogicznie pętla co ticka:

// data/minecraft/tags/function/tick.json
{
  "values": [
    "moj_pack:petla"
  ]
}

Scoreboard: licznik, którym sterujesz komendami

Scoreboard to wbudowany system liczb przypisanych do graczy i do tak zwanych fałszywych graczy. Dla mechaniki datapacku to po prostu pamięć na wartości całkowite. Pracujesz na celach (objectives), które najpierw trzeba utworzyć.

Tworzenie celu

Cel zakładasz raz, najlepiej w funkcji z tagu load:

scoreboard objectives add timer dummy
scoreboard objectives add kliki dummy

Kryterium dummy oznacza, że gra nie zmienia tej wartości sama. To Ty nią sterujesz komendami, więc nadaje się idealnie na własne liczniki i timery. (Istnieją kryteria, które gra aktualizuje automatycznie, na przykład liczące zgony czy skoki, ale do własnej mechaniki najczęściej chcesz właśnie dummy.)

Ustawianie i zmiana wartości

Trzy komendy, które robią 90 procent roboty:

Komenda	Co robi
scoreboard players set <cel> <obiekt> <liczba>	Ustawia wynik na konkretną liczbę (na przykład zeruje licznik).
scoreboard players add <cel> <obiekt> <liczba>	Dodaje liczbę do wyniku (zwiększa licznik o krok).
scoreboard players operation <cel> <obiekt> <op> <zrodlo> <obiekt2>	Działanie między dwoma wynikami (kopiowanie, dodawanie, minimum, maksimum i tak dalej).

W miejscu <cel> wpisujesz nick gracza, selektor (na przykład @s) albo fałszywego gracza. Fałszywy gracz to dowolna nazwa, której nie ma w świecie, używana jako globalny schowek na jedną liczbę. Z przyzwyczajenia zapisuje się ją z hashem na początku, na przykład #t, żeby było widać, że to nie prawdziwy gracz. Hash nie ma magicznego znaczenia w składni, to tylko konwencja, ale dodatkowo sprawia, że taki wpis nie pojawia się przypadkiem przy selektorach graczy.

Operacje w scoreboard players operation mają stałe symbole:

• = przypisanie (kopiuje wynik źródła do celu)
• +=, -=, *= dodawanie, odejmowanie, mnożenie
• /= dzielenie całkowite w dół, %= reszta z dzielenia
• < bierze mniejszą z dwóch wartości, > większą, >< zamienia wyniki miejscami

Timer w tagu tick

Najprostsza pętla czasu: w funkcji odpalanej co ticka zwiększasz licznik o jeden, a gdy dobije do progu, wykonujesz akcję i zerujesz go. Dwadzieścia ticków to jedna sekunda, więc próg 20 daje akcję raz na sekundę.

# data/moj_pack/function/petla.mcfunction
# Uruchamiane co tick z tagu minecraft:tick

# zwieksz licznik o 1
scoreboard players add #t timer 1

# gdy licznik dojdzie do 20 (jedna sekunda):
#  - wykonaj akcje (tu: dzwiek dla wszystkich)
#  - wyzeruj licznik
execute if score #t timer matches 20.. run playsound minecraft:block.note_block.pling master @a
execute if score #t timer matches 20.. run scoreboard players set #t timer 0

Zapis matches 20.. to przedział: dwadzieścia i więcej. Używamy go zamiast samego 20, bo gdyby z jakiegoś powodu licznik przeskoczył próg (na przykład po lagu serwera), warunek i tak się złapie. Sprawdzanie konkretnej liczby przedziałem to typowa ostrożność w mechanikach na tick.

execute as @a at @s if score: warunki na graczach

Komenda execute to sposób na warunki i na zmianę tego, kto i gdzie wykonuje akcję. Łańcuch buduje się z podkomend, a zamyka go zawsze run z właściwą komendą na końcu. Cztery podkomendy, które tu używamy:

• as @a, ustawia wykonawcę po kolei na każdego gracza online. Od tego miejsca @s oznacza tego jednego, aktualnie przetwarzanego gracza.
• at @s, przenosi miejsce wykonania na pozycję wykonawcy (czyli tego gracza), dzięki czemu efekty i cząsteczki pojawiają się przy nim.
• if score @s <obiekt> matches <przedzial>, sprawdza wynik tego gracza na scoreboardzie i przepuszcza dalej tylko tych, którzy spełniają warunek.
• run <komenda>, wykonuje komendę. Występuje raz, na końcu łańcucha.

Złożone razem dają wzorzec, który czyta się jak zdanie: dla każdego gracza, w jego pozycji, jeśli jego wynik spełnia warunek, wykonaj komendę.

# dla kazdego gracza, ktory ma kliki >= 10,
# zagraj dzwiek przy nim i wypisz mu komunikat
execute as @a at @s if score @s kliki matches 10.. run playsound minecraft:entity.player.levelup master @s
execute as @a if score @s kliki matches 10.. run tellraw @s {"text":"Gratulacje, 10 klikniec!","color":"green"}

Można też porównywać dwa wyniki zamiast sprawdzać przedział, na przykład if score @s kliki >= #cel kliki z operatorami <, <=, =, >=, >. Przedział (matches) jest jednak czytelniejszy do prostych progów.

schedule function: opóźnienie i własna pętla

Nie wszystko musi chodzić co ticka. Gdy chcesz coś zrobić za chwilę, użyj schedule function:

schedule function moj_pack:krok 20t

To odpali funkcję moj_pack:krok za 20 ticków, czyli za sekundę. Czas podajesz z sufiksem: t to ticki (domyślne, można pominąć), s to sekundy (20 ticków), d to dzień gry (24000 ticków). Pełna składnia to schedule function <funkcja> <czas> [append|replace], a zaplanowane wywołanie skasujesz przez schedule clear <funkcja>.

Sztuczka: funkcja może zaplanować samą siebie, tworząc własną, rzadszą pętlę bez obciążania tagu tick. To wygodne dla mechanik, które mają działać na przykład co 5 sekund, a nie co tick:

# data/moj_pack/function/krok.mcfunction
say tik co 5 sekund
schedule function moj_pack:krok 5s

Taką pętlę rozkręcasz raz, na przykład w funkcji z tagu load, jednym wywołaniem schedule function moj_pack:krok 5s, a dalej podtrzymuje się sama.

Tagi encji: oznaczanie, żeby nie powtórzyć akcji

Tag encji to etykieta przypięta do gracza lub innej encji. Nie myl go z tagiem funkcji, to zupełnie co innego. Tag encji nadajesz i zdejmujesz komendą tag:

• tag @s add nagrodzony, dodaje etykietę nagrodzony do wykonawcy.
• tag @s remove nagrodzony, zdejmuje ją.
• tag @s list, wypisuje etykiety encji.

Po nadaniu tagu możesz wybierać tylko oznaczone encje selektorem z filtrem tag, na przykład @a[tag=nagrodzony] (gracze z tagiem) albo @a[tag=!nagrodzony] (gracze bez niego). To rozwiązuje klasyczny problem: jak nadać nagrodę dokładnie raz, a nie co tick? Oznaczasz gracza po nagrodzeniu i pomijasz oznaczonych przy kolejnych sprawdzeniach.

Działający przykład: nagroda za warunek

Składamy wszystko w jedną kompletną mechanikę. Cel: gdy gracz uzbiera 64 sztuki diamentów w ekwipunku, dostaje jednorazowo efekt i komunikat. Liczbę diamentów wykryjemy przez sprawdzenie ekwipunku, a tag encji dopilnuje, żeby nagroda padła tylko raz.

1. Konfiguracja w tagu load

// data/minecraft/tags/function/load.json
{
  "values": [
    "moj_pack:start"
  ]
}

# data/moj_pack/function/start.mcfunction
# uruchamiane raz przy starcie i przy /reload

scoreboard objectives add timer dummy
say Mechanika nagrody zaladowana

2. Pętla w tagu tick

// data/minecraft/tags/function/tick.json
{
  "values": [
    "moj_pack:petla"
  ]
}

# data/moj_pack/function/petla.mcfunction
# uruchamiane co tick

# licznik 0..19 -> sprawdzamy warunek raz na sekunde, nie co tick
scoreboard players add #t timer 1
execute if score #t timer matches 20.. run function moj_pack:sprawdz
execute if score #t timer matches 20.. run scoreboard players set #t timer 0

3. Sprawdzenie warunku i nagroda

# data/moj_pack/function/sprawdz.mcfunction
# dla kazdego gracza, ktory NIE byl jeszcze nagrodzony
# i ma w ekwipunku co najmniej 64 diamenty:
#  - nadaj nagrode w jego pozycji
#  - oznacz go tagiem, zeby nie nagrodzic ponownie

execute as @a[tag=!nagroda_diamenty,nbt={Inventory:[{id:"minecraft:diamond",Count:64b}]}] at @s run function moj_pack:nagroda

# data/moj_pack/function/nagroda.mcfunction
# wykonawca to gracz, ktory spelnil warunek; miejsce = jego pozycja

effect give @s minecraft:hero_of_the_village 200 0
playsound minecraft:ui.toast.challenge_complete master @s
tellraw @s {"text":"Nagroda za 64 diamenty odebrana!","color":"gold"}
tag @s add nagroda_diamenty

Jak to działa razem: tag load przy starcie zakłada cel timer. Tag tick co ticka podbija licznik, a raz na sekundę odpala sprawdz i zeruje licznik. Funkcja sprawdz wybiera tylko graczy, którzy jeszcze nie mają etykiety nagroda_diamenty i mają w ekwipunku pełny stos diamentów, i dla każdego z nich odpala nagroda w jego pozycji. Ta z kolei daje efekt, gra dźwięk, pisze komunikat i nadaje etykietę, więc przy kolejnym sprawdzeniu gracz jest już pomijany przez filtr tag=!nagroda_diamenty.

Najczęstsze problemy

• Funkcja w ogóle się nie odpala. Sprawdź nazwę folderu: od 1.21 to function i tags/function w liczbie pojedynczej. Stare poradniki używają functions i to najczęstsza przyczyna ciszy na 1.21+.
• Komendy nie działają, a wcześniej działały na czacie. Upewnij się, że w pliku nie ma ukośnika na początku linii. W funkcji piszesz say, nie /say.
• Tag tick lub load nic nie robi. Pliki tick.json i load.json muszą leżeć w data/minecraft/tags/function/, a nie w przestrzeni Twojego packa. W values wpisuj pełne nazwy funkcji z przestrzenią.
• Akcja powtarza się w kółko. Brakuje warunku lub tagu encji, który ją wyłącza po wykonaniu. W pętli tick wszystko bez warunku dzieje się 20 razy na sekundę.
• Zmiany nie widać w grze. Po edycji plików zawsze wywołaj /reload. Bez tego gra trzyma starą wersję datapacku w pamięci.

Najczęstsze pytania

Czy komendy w pliku .mcfunction zaczynają się od ukośnika?

Nie. Każda komenda zajmuje jedną linię i jest bez ukośnika na początku (say czesc, a nie /say czesc). Komentarze zaczynasz od #, a puste linie są ignorowane.

Jaka jest różnica między minecraft:tick a minecraft:load?

Funkcje z minecraft:load odpalają się raz przy starcie i przy /reload (tam zakładasz cele scoreboardu). Funkcje z minecraft:tick odpalają się co tick, 20 razy na sekundę (tam żyje pętla mechaniki). Oba tagi to pliki JSON z tablicą values, w data/minecraft/tags/function/.

Jak zrobić timer albo licznik na scoreboardzie?

Załóż cel dummy (scoreboard objectives add timer dummy), w tagu tick zwiększaj go o jeden (scoreboard players add #t timer 1), a po dojściu do progu wykonaj akcję i wyzeruj (scoreboard players set #t timer 0). Zapis z hashem, jak #t, to fałszywy gracz służący jako globalny schowek na liczbę.

Co dokładnie robi execute as @a at @s if score @s ... run ...?

as @a ustawia każdego gracza po kolei jako wykonawcę (od tej chwili @s to ten gracz), at @s przenosi miejsce wykonania na jego pozycję, if score sprawdza jego wynik, a run wykonuje komendę dla tych, którzy spełnili warunek. run zawsze kończy łańcuch i może wystąpić raz.

Do czego służy schedule function i tagi encji?

schedule function nazwa czas odpala funkcję z opóźnieniem (np. 20t to sekunda), a funkcja może planować samą siebie, tworząc własną pętlę. Tagi encji (tag @s add nazwa) oznaczają encje, dzięki czemu selektorem @a[tag=nazwa] wybierasz tylko oznaczone, na przykład żeby nie nadać nagrody dwa razy.

Co dalej w serii

Powiązane

• Datapack z funkcjami działa od razu na każdym serwerze Minecraft Java. Jeśli nie chcesz stawiać serwera od zera i wolisz wrzucać packi przez panel, gotowy serwer znajdziesz w hostingu Minecraft Java w Supercraft, masz dostęp do plików świata i konsolę z komendą /reload pod ręką.
• Hosting serwera Minecraft: VPS vs zarządzany, dobór i koszt
• Serwer Minecraft ze znajomymi: jak postawić i co wybrać
• Jak zrobić serwer Minecraft krok po kroku