Luau w Roblox: język skryptów oraz Engine i Cloud API

18 sierpnia 2026 · 5 min czytania

Redakcja GameMapa · jak sprawdzamy fakty
Weryfikacja: Claude (AI) — факт-звірка з uk-оригіналом; носій мови НЕ перевіряв

Język, w którym pisze się logikę w Roblox, nazywa się Luau — tak nazywa go sama oficjalna dokumentacja platformy. Nie „język podobny do Lua”, nie „język skryptowy Roblox”, tylko konkretna nazwa z konkretnego źródła: create.roblox.com/docs/luau.

To nie jest kwestia pedanterii. Gdy szukasz odpowiedzi na techniczne pytanie, nazwa to klucz do właściwej dokumentacji. Wyszukanie jednego słowa prowadzi do oficjalnego działu, wyszukanie innego — do cudzych forów sprzed dekady.

Poniżej — co o języku i dokumentacji wiadomo z pierwotnego źródła, czym różnią się Engine API i Cloud API, i osobno — czego tutaj nie twierdzimy.

Co wiadomo na pewno

Faktów, które można poprzeć oficjalną dokumentacją, jest niewiele i wymieniamy je wprost, bez rozwlekania:

• Oficjalna dokumentacja Roblox nazywa język skryptów platformy Luau.
• Dokumentacja Luau znajduje się w osobnym dziale — create.roblox.com/docs/luau.
• Dla skryptów działających wewnątrz doświadczenia Roblox utrzymuje osobną dokumentację Engine API.
• Cloud API to inny zestaw interfejsów niż Engine API, mający własny dział dokumentacji.

Wszystko inne, co można przeczytać o Luau w sieci — składnia, typy, wydajność, historia — nie przywołujemy tutaj, bo nie możemy tego poprzeć naszymi źródłami. Właściwym miejscem na to jest sam dział dokumentacji.

Dlaczego język opisano w osobnym dziale

Sama struktura dokumentacji mówi coś użytecznego. Jeśli język jest opisany oddzielnie od dokumentacji Engine API, oznacza to, że są to dwie różne warstwy wiedzy:

• Język — to sposób, w jaki w ogóle piszesz kod: konstrukcje, zasady, składnia.
• API — to elementy, do których twój kod się odwołuje: obiekty i interfejsy platformy.

Praktyczny wniosek jest prosty. Gdy coś nie działa, najpierw zrozum, w której warstwie tkwi problem. Błąd w zapisie kodu — to sprawa działu Luau. „Nie wiem, jak odwołać się do konkretnej rzeczy w grze” — to sprawa Engine API. Mylenie tych warstw pochłania najwięcej czasu początkującym.

Engine API i Cloud API to nie to samo

Najczęstsza pułapka przy czytaniu przykładów z internetu: ktoś bierze fragment kodu z jednej części ekosystemu i próbuje zastosować go w innej.

Co z tego wynika dla ciebie:

Jeśli piszesz logikę wewnątrz własnego doświadczenia — twoją dokumentacją jest Engine API. Jeśli znaleziony przykład znajduje się w dziale Cloud API, nie jest „zepsuty” ani „nieaktualny” — dotyczy po prostu czegoś innego. Kopiowanie go do skryptu doświadczenia nie ma sensu.

⚠️ Czego tutaj nie twierdzimy: nie opisujemy, do jakich dokładnie zadań służy Cloud API, jakie ma możliwości i ograniczenia. Nasze źródła mówią tylko tyle, że to inny zestaw interfejsów z osobną dokumentacją. Wszystko bardziej szczegółowe — czytaj w samym dziale, a nie w streszczeniach.

Jak korzystać z dokumentacji, żeby nie tracić czasu

Kolejność, która oszczędza godziny:

1. Sformułuj pytanie jako „język” albo „platforma”. Pytanie o to, jak zapisać konstrukcję — to Luau. Pytanie o to, jak dostać się do czegoś w grze — to API.
2. Otwórz oficjalny dział, a nie wyszukiwarkę. Punkt startowy dla języka to create.roblox.com/docs/luau, dla reszty — create.roblox.com/docs.
3. Sprawdź, w jakim dziale leży przykład. Zanim skopiujesz kod, sprawdź jego „przynależność”: Luau, Engine API czy Cloud API.
4. Weryfikuj materiały zewnętrzne z oficjalnymi. Filmy i artykuły są wygodniejsze na pierwsze zrozumienie tematu, ale źródłem pierwotnym jest dokumentacja. Rozbieżność rozstrzyga się na jej korzyść.
5. Nie wyciągaj wniosków z milczenia. Jeśli czegoś nie ma w dokumentacji, to nie znaczy „niemożliwe” — znaczy „nieopisane w miejscu, w które akurat patrzysz”.

Czego celowo tutaj nie piszemy

Ten materiał jest celowo wąski. Nie podajemy tu:

• fragmentów kodu i „typowych szablonów” — starzeją się szybciej niż artykuły;
• porównań Luau z innymi językami;
• żadnych liczb: wersji, dat, rozmiarów, liczby funkcji. Nie ma liczby w sprawdzonym źródle — nie ma jej też w tekście;
• porad „którego języka uczyć się jako pierwszego” — to wybór, a nie fakt.

Jeśli potrzebujesz praktycznego startu w edytorze, a nie informacji o samym języku — to inny temat, który omówiliśmy osobno: pierwsze kroki w Roblox Studio.

Komu w ogóle potrzebny jest Luau

Graczowi — nie. Żeby uruchamiać cudze doświadczenia, wystarczy klient, konto i sprzęt, który udźwignie grę; o tym ostatnim piszemy w materiale o tym, na jakich urządzeniach działa Roblox.

Język jest potrzebny tym, którzy tworzą coś własnego: logika, zasady, zachowanie obiektów w doświadczeniu — wszystko to pisze się za pomocą skryptów. A jeśli celem nie jest „zrobić coś dla siebie”, tylko „żeby inni w to grali i żeby to coś przynosiło”, dalej jest już osobny temat wypłat — DevEx i wymiana Robux.

Zwróć uwagę na kolejność: najpierw język i dokumentacja, potem efekt. Nie odwrotnie. Osoby, które zaczynają od pytania „ile się na tym zarabia”, zwykle nie dochodzą do pierwszego działającego skryptu.

Krótko

Język skryptów Roblox nazywa się Luau, jego dokumentacja znajduje się w osobnym dziale create.roblox.com/docs/luau, a Engine API (dla skryptów wewnątrz doświadczenia) i Cloud API to różne zestawy interfejsów z różnymi działami dokumentacji. Zanim skopiujesz cudzy przykład kodu, sprawdź, z jakiego dokładnie działu pochodzi.