Коротко
Щоб написати скрипт у Roblox Studio, наведіть курсор на ServerScriptService в Explorer, натисніть + і вставте Script. Studio відкриє його в Script Editor. Напишіть Luau, наприклад print("Hello"), натисніть Play (F5) і прочитайте результат у вікні Output (меню Window або вкладка Script). Script виконується на сервері й змінює все для всіх; LocalScript у StarterPlayerScripts виконується на пристрої одного гравця.
- Спершу вивчіть чотири ідеї: змінні (
local coins = 3), функції (local function name() ... end), умови if і події (part.Touched:Connect(...)). Чотири скрипти цього гайду побудовані з них, плюс цикли й таблиці. - Використовуйте
task.wait(), а неwait(). Довідник Roblox позначає глобальнийwait()застарілим і заміненим наtask.wait(). - У налаштуваннях відображення вікна Output увімкніть Show Context, щоб кожен рядок показував, прийшов він із Server чи з Client.
На цій сторінці
Перед початком: Studio, Baseplate і вікно Output
Потрібні Roblox Studio й акаунт Roblox, і більше нічого: ні редактора коду, ні плагіна. Кожен скрипт цього гайду набирається у власному Script Editor Studio.
- Установіть Roblox Studio, безкоштовний застосунок Roblox для Windows і Mac, і увійдіть через акаунт Roblox.
- Відкрийте Studio. На стартовій сторінці є шаблони: виберіть Baseplate. Ви отримаєте підлогу з текстурою сітки 4x4 і SpawnLocation, місце, де з'являється ваш аватар під час гри.
- Якщо вікон Explorer і Properties не видно, відкрийте їх з меню Window або вкладки Home. Explorer перелічує всі об'єкти плейсу; Properties показує налаштування виділеного.
- Відкрийте Output з меню Window або вкладки Script. Тут з'являються повідомлення й помилки ваших скриптів.
- У налаштуваннях відображення вікна Output увімкніть Show Context, який позначає кожне повідомлення як Client або Server, і Show Source, який показує скрипт і номер рядка, звідки воно прийшло.
| Скрипт | Тип | Де лежить | Чого навчає |
|---|---|---|---|
FirstScript | Script | ServerScriptService | Змінні, функція, умова if, цикли й таблиця |
ColourChanger | Script | Усередині Part у Workspace | Зміна властивостей, script.Parent і цикл з очікуванням |
TouchPad | Script | Усередині Part з іменем Pad | Події, пошук гравця, що торкнувся парта, і debounce |
MyFirstLocalScript | LocalScript | StarterPlayerScripts, усередині StarterPlayer | Код на пристрої одного гравця, натискання клавіш і що залишається на цьому пристрої |
Workspace
Baseplate Part
SpawnLocation SpawnLocation
Part Part new
ColourChanger Script new
Pad Part new
TouchPad Script new
ServerScriptService
FirstScript Script new
StarterPlayer
StarterPlayerScripts
MyFirstLocalScript LocalScript new
Крок 1: напишіть перший скрипт
- В Explorer наведіть курсор на ServerScriptService, натисніть + і виберіть Script (поєднання Ctrl+I або ⌘I на Mac). Studio створить скрипт і відкриє його в Script Editor.
- Натисніть на новий скрипт правою кнопкою, виберіть Rename і назвіть його
FirstScript. Ім'я не змінює того, що робить скрипт, але каже, який скрипт що надрукував. - Нові скрипти починаються з одного рядка,
print("Hello world!"). Видаліть його й вставте код нижче. - Натисніть Play (F5), вибравши Test у списку ліворуч від неї. Studio запустить плейтест і поставить аватар на SpawnLocation.
- Прочитайте рядки в Output, потім натисніть Stop (Shift+F5). Stop також повертає всі об'єкти до стану перед натисканням Play, тому все, що ви зсунули або перефарбували під час гри, повернеться.
-- Script у ServerScriptService з іменем FirstScript.
-- Ваш перший Luau: змінні, функція, умова if, цикл і таблиця.
-- Натисніть Play (F5) і прочитайте результат у вікні Output.
-- Змінна це ім'я, яке зберігає значення
local gameName = "Coin Run"
local coinsToWin = 3
-- Функція це іменований блок коду, який можна запускати скільки завгодно разів.
-- name і goal це її параметри; return повертає значення тому, хто її викликав.
local function describe(name: string, goal: number): string
return `{name}: collect {goal} coins to win`
end
print(describe(gameName, coinsToWin)) --> Coin Run: collect 3 coins to win
-- Умова if виконує код, лише коли умова істинна
if coinsToWin > 5 then
print("That is a long game")
elseif coinsToWin > 1 then
print("That is a short game")
else
print("One coin and you win")
end
-- Цикл for повторює код задану кількість разів
for count = 1, coinsToWin do
print("Coin number", count)
end
-- Таблиця зберігає список значень; цей цикл обходить їх по черзі
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
print(position, colour) --> 1 Red, потім 2 Green, потім 3 Blue
end
Усе після -- у рядку це коментар: Luau його пропускає, тому можна залишати собі нотатки. Коментарі --> показують, що друкує рядок.
Output має показати ці вісім рядків упереміш із повідомленнями самого Studio. Коли print отримує кілька значень, він ставить між ними пробіл. З увімкненими Show Context і Show Source кожен рядок ще позначений Server і FirstScript з номером рядка.
Coin Run: collect 3 coins to win
That is a short game
Coin number 1
Coin number 2
Coin number 3
1 Red
2 Green
3 Blue
Зіставте кожен рядок із кодом, який його надрукував. Пізніше ви робитимете те саме з повідомленнями про помилки, тож звичка знадобиться.
FirstScript використовує лише чистий Luau без об'єктів Roblox, тому він працює й у безкоштовній пісочниці Luau у браузері. Змініть там значення й запустіть знову, щоб побачити, що зміниться.
| Код | Ідея | Що це означає |
|---|---|---|
local gameName = "Coin Run" | Змінна | Ім'я, яке зберігає значення. local означає, що користуватися ним може лише цей скрипт або блок, у якому воно стоїть. Текст у лапках це рядок; 3 це число. Імена чутливі до регістру, тому coinsToWin і CoinsToWin це дві різні змінні. |
local function describe(name: string, goal: number): string | Функція | Іменований блок коду, який можна запускати скільки завгодно разів. name і goal це її параметри: значення, які передаються під час кожного виклику. : string і : number це необов'язкові анотації типів. Luau використовує їх, щоб попереджати про помилки в Script Editor; без них код працює так само. |
return | Значення, що повертається | Віддає значення коду, який викликав функцію. print(describe(gameName, coinsToWin)) друкує те, що поверне describe. |
`{name}: collect {goal} coins to win` | Інтерполяція рядків | Текст у зворотних лапках може містити значення: Luau замінює {name} і {goal} їхніми поточними значеннями. |
if, elseif, else, end | Умова if | Luau перевіряє умови згори вниз і виконує лише першу істинну. coinsToWin дорівнює 3, це не більше за 5, але більше за 1, тому друкується лише «That is a short game». |
for count = 1, coinsToWin do | Числовий цикл for | Виконує код усередині по разу для кожного числа від 1 до coinsToWin, де count дорівнює 1, потім 2, потім 3. |
{ "Red", "Green", "Blue" } і for position, colour in colours do | Таблиця й цикл | Таблиця як список, Luau називає це масивом. Позиції починаються з 1, а не з 0. Цикл обходить кожен елемент і дає його позицію та значення. |
Кожен блок, який відкривається словом function, if, for або while, закривається словом end. Один пропущений end не дає запуститися всьому скрипту; розділ читання помилок показує, яке повідомлення ви отримаєте.
Крок 2: змініть парт зі скрипта
Скрипти стають корисними, коли змінюють щось у світі. Налаштування, які ви бачите у вікні Properties, наприклад Color, Transparency або Anchored у парта, це властивості, і скрипт теж може їх задавати.
- На вкладці Home натисніть Part. Studio додасть блок у Workspace. Його ім'я неважливе.
- В Explorer наведіть курсор на новий парт, натисніть + і вставте Script. Перейменуйте його на
ColourChangerі замініть вміст кодом нижче. - Натисніть Play. Парт стає червоним, потім синім, потім зеленим, змінюючись раз на секунду, і починає знову.
-- Script усередині Part у Workspace, з іменем ColourChanger.
-- Скрипти змінюють ті самі властивості, що видно у вікні Properties.
-- Цей дає своєму парту новий колір щосекунди, для всіх гравців.
local part = script.Parent :: BasePart -- парт, усередині якого лежить цей скрипт
local colours = {
Color3.fromRGB(255, 85, 85), -- червоний
Color3.fromRGB(85, 170, 255), -- синій
Color3.fromRGB(85, 255, 127), -- зелений
}
part.Anchored = true -- закріплений парт залишається там, де ви його поставили
local index = 1
while true do
part.Color = colours[index]
index = index % #colours + 1 -- 1, 2, 3, потім знову 1
task.wait(1) -- пауза на одну секунду (старий wait() застарів)
end
script.Parentце об'єкт, усередині якого лежить скрипт, тут парт. Перетягніть скрипт в інший парт, і він змінюватиме той.:: BasePartце приведення типу. Воно каже Script Editor, що батьківський об'єкт це парт, щоб перевіряти використані властивості. Luau використовує типи лише для попереджень і підказок, тому приведення не змінює того, що робить рядок.part.Colorіpart.Anchoredце ті самі властивості, що у вікні Properties, з тими самими іменами. Roblox використовує американське написання, тому властивість називаєтьсяColor, хоча скрипт називається ColourChanger.Anchored = trueтримає парт на місці: довідник Roblox каже, що закріплений парт ніколи не рухається через гравітацію, зіткнення чи іншу фізику.colours[index]читає один елемент списку.#coloursце довжина списку, 3, а%дає остачу від ділення, томуindex % #colours + 1рахує 1, 2, 3, 1, 2, 3.while true doповторюється безкінечно, томуtask.wait(1)усередині такий важливий. Документація Roblox каже завжди ставити затримку на кшталтtask.wait()у безкінечний цикл: без неї гра зависає, а Studio падає.
ColourChanger це Script, тому він працює на сервері, і всі гравці бачать той самий колір одночасно. Крок 4 показує інший вид скрипта.
Крок 3: реагуйте на гравця через подію
Більша частина ігрового коду чекає, поки щось станеться: гравець зайшов, парта торкнулися, кнопку натиснули. Roblox називає це подіями. Щоб виконати код, коли подія спрацьовує, до неї підключають функцію.
- Вставте ще один Part і перейменуйте його точно на
Pad, з великою P. Залиште його просто у Workspace, не в папці й не в моделі, бо LocalScript на кроці 4 шукає його там. - Зробіть його пласким майданчиком, на який можна стати, наприклад задайте
Sizeрівним6, 1, 6у вікні Properties. Поставте його на підлогу поруч зі SpawnLocation і позначте Anchored, щоб він не рухався. - Наведіть курсор на Pad, натисніть +, вставте Script, перейменуйте його на
TouchPadі вставте код нижче. - Натисніть Play і станьте на майданчик. Він жовтіє на 2 секунди, а Output називає ваше ім'я.
-- Script усередині Part у Workspace з іменем Pad, скрипт з іменем TouchPad.
-- Події: коли гравець наступає на майданчик, він світиться жовтим, а Output пише, хто це був.
-- Debounce не дає коду спрацьовувати багато разів на секунду, поки гравець стоїть на ньому.
local Players = game:GetService("Players")
local pad = script.Parent :: BasePart
local COOLDOWN_SECONDS = 2
local normalColour = pad.Color
local busy = false
local function onTouched(otherPart: BasePart)
if busy then
return -- ще триває перезаряджання після минулого дотику
end
-- Персонаж це Model, у якій лежить частина тіла (або шапка), що торкнулася майданчика
local character = otherPart:FindFirstAncestorOfClass("Model")
local player = character and Players:GetPlayerFromCharacter(character)
if not player then
return -- торкнувся вільний парт або NPC, а не гравець
end
busy = true
print(`{player.Name} stepped on the pad`)
pad.Color = Color3.fromRGB(255, 220, 0)
task.wait(COOLDOWN_SECONDS)
pad.Color = normalColour
busy = false
end
pad.Touched:Connect(onTouched)
| Код | Що робить |
|---|---|
pad.Touched:Connect(onTouched) | Підключає функцію до події Touched майданчика, тому Roblox запускає onTouched щоразу, коли щось торкається майданчика, і передає парт, що торкнувся. |
otherPart | Парт, який торкнувся майданчика: стопа, нога, ручка шапки або інструмент у руці гравця. Це ніколи не сам гравець, тому наступні два рядки з'ясовують, кому він належить. |
otherPart:FindFirstAncestorOfClass("Model") | Піднімається від цього парта до першого предка, чий клас рівно Model, тобто до персонажа. Оскільки ім'я класу має збігатися точно, він пропускає шапку (клас Accessory) та інструмент у руці (клас Tool). |
Players:GetPlayerFromCharacter(character) | Повертає Player, чий це персонаж, або nil, якщо це нічий персонаж, наприклад NPC. character and попереду пропускає виклик, якщо модель не знайдено, і player залишається nil. |
if not player then return end | Зупиняється тут для всього, що не гравець. return виходить із функції достроково. |
Навіщо майданчику debounce
Сторінка Roblox про debounce попереджає, що Touched спрацьовує кілька разів поспіль, поки парти дотикаються, а в персонажа, що йде, кілька частин тіла. Без перевірки один крок на майданчик міг би надрукувати багато рядків і знову й знову перезапускати жовте світіння.
Змінна busy і є debounce. Перший дотик ставить її в true, і кожен дотик у наступні 2 секунди доходить до if busy then return end і зупиняється. Після task.wait(COOLDOWN_SECONDS) майданчик повертає колір, а busy знову стає false. COOLDOWN_SECONDS написано великими літерами, бо це налаштування, яке не змінюється під час гри: так Roblox радить називати константи.
Цей майданчик має один debounce на всіх, тому другий гравець, що наступив у ці 2 секунди, ігнорується. Для майданчика, що світиться, це нормально. Майданчик, який видає нагороди, має тримати перезаряджання для кожного гравця, як майданчик з монетами в гайді з таблиці лідерів.
Крок 4: перший LocalScript і чим він відрізняється
Запущена гра це один сервер плюс по клієнту на кожного гравця. Усе досі було Script, який працює на сервері, тому його зміни доходять до всіх гравців. LocalScript працює на пристрої одного гравця. Натискання клавіш, камера й екранні меню обробляються там, бо про них знає лише цей пристрій.
- В Explorer розгорніть StarterPlayer, наведіть курсор на StarterPlayerScripts, натисніть + і вставте LocalScript. Перейменуйте його на
MyFirstLocalScriptі вставте код нижче. - Натисніть Play. Output покаже
Hello,і ваше ім'я з позначкою Client. - Клацніть по вікну гри й натисніть E. Майданчик стає прозорішим. Натисніть E знову, щоб повернути його.
- Поки плейтест триває, натисніть перемикач Client/Server в елементах тестування Studio, щоб перейти до серверної копії гри. Там майданчик непрозорий: сервер нічого не дізнався про зміну.
-- LocalScript у StarterPlayer > StarterPlayerScripts з іменем MyFirstLocalScript.
-- LocalScript працює на пристрої одного гравця. Натисніть E: Pad стає прозорішим лише
-- на вашому екрані, бо зміна парта звідси не доходить ні до сервера, ні до інших.
local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")
local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- з'являється в Output з позначкою Client
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed then
return -- клавіша пішла на інше, наприклад на набір тексту в чаті
end
if input.KeyCode == Enum.KeyCode.E then
local pad = workspace:FindFirstChild("Pad")
if pad and pad:IsA("BasePart") then
pad.Transparency = if pad.Transparency == 0 then 0.6 else 0
end
end
end)
Players.LocalPlayerце гравець, на чиєму пристрої працює скрипт. Roblox визначає його лише для LocalScript і ModuleScript, які вони підключають, тому серверний код не може його використовувати.UserInputService.InputBeganспрацьовує, коли гравець починає натискання клавіші, клік або дотик.gameProcessedдорівнюєtrue, коли рушій уже використав цей ввід, наприклад клік по кнопці або клавішу в рядку чату, тому скрипт його ігнорує.workspace:FindFirstChild("Pad")повертає нащадка з іменем Pad абоnil, якщо його немає.pad:IsA("BasePart")перевіряє, що це справді парт, перш ніж скрипт змінить йогоTransparency.if pad.Transparency == 0 then 0.6 else 0це if-вираз: він вибирає одне з двох значень. Transparency 0 означає повністю видимий, 1 невидимий.- Скрипт спринту на Shift добре підходить як другий LocalScript: він слухає клавішу й змінює WalkSpeed персонажа.
| Тип | Де працює | Куди доходять зміни | Для чого | Зазвичай лежить у |
|---|---|---|---|---|
| Script | На сервері | До всіх гравців | Правила гри: монети, шкода, двері, раунди, збереження | ServerScriptService або всередині парта, поки вчитеся |
| LocalScript | На пристрої одного гравця | Лише на цей пристрій, крім руху свого персонажа | Ввід, камера, екранні меню, ефекти для одного гравця | StarterPlayerScripts або StarterGui |
| ModuleScript | На тому боці, який викликає для нього require() | Туди ж, куди й у скрипта, що його підключив | Код, спільний для кількох скриптів | ReplicatedStorage для обох боків, ServerScriptService лише для сервера |
Що може змінити читер
Вважайте, що читер контролює все на своєму пристрої. Він може запускати свої LocalScript і змінювати ваші, тому може зробити прозорим майданчик або що завгодно ще на своєму екрані. Тут це нешкідливо: прозорість лише для вигляду й залишається на його пристрої. Саме тому все важливе вирішує Script на сервері.
Серверний Script теж не безпечний автоматично. TouchPad працює на сервері, але пристрій кожного гравця керує фізикою його персонажа, і документація Roblox з безпеки називає серед того, що клієнт може робити з підконтрольними партами, керування моментом спрацювання Touched або повне його блокування. Для майданчика, що світиться, це неважливо. Для майданчика, який платить, перевіряйте ще й те, що сервер відстежує сам, як правило в гайді з обі, що чекпоінти зараховуються лише по черзі.
Крок 5: протестуйте всі чотири скрипти разом
- Очистіть Output через Ctrl+K (⌘K на Mac) і натисніть Play (F5). Output покаже вісім рядків FirstScript з позначкою Server і ваш рядок Hello з позначкою Client. Парт ColourChanger змінює колір щосекунди.
- Станьте на майданчик. Він жовтіє на 2 секунди, а Output один раз показує ваше ім'я і «stepped on the pad». Походіть по ньому: новий рядок з'являється не частіше ніж раз на 2 секунди, а не при кожному спрацюванні Touched.
- Натисніть E. Майданчик стає напівпрозорим (Transparency 0.6). Натисніть E знову, і він непрозорий.
- Натисніть Stop. У списку тестування виберіть Server & Clients, поставте 2 клієнти й натисніть Play (або F7). Studio відкриє вікно сервера і два вікна клієнтів. В одному клієнті натисніть E: майданчик стане прозорішим там, а інший клієнт і сервер покажуть його непрозорим. Натисніть End Session, коли закінчите.
- Зламайте щось навмисно. Перейменуйте Pad на
Pad2і запустіть гру. Крок на майданчик усе ще робить його жовтим, бо TouchPad знаходить свій парт черезscript.Parent, а не за ім'ям. Натискання E тепер нічого не робить, і помилки немає:FindFirstChild("Pad")повернувnil, а перевіркаif pad and ...тихо пропустила решту. Додайтеprint(pad)на рядок післяFindFirstChild, запустіть і натисніть E: Output покажеnil. Такий print найшвидший спосіб зрозуміти, чому скрипт нічого не робить. Зупиніть гру, видаліть рядок із print і поверніть парту ім'я Pad.
Куди класти скрипти
Від того, де лежить скрипт, залежить, чи запуститься він узагалі, і Studio не попереджає, якщо він не запуститься ніколи. Для ваших наступних скриптів:
| Контейнер | Що класти | Чому |
|---|---|---|
| ServerScriptService | Скрипти з більшістю правил гри: нагороди, раунди, збереження | Вони працюють на сервері, і нічого з ServerScriptService не надсилається гравцям. |
| Усередині парта у Workspace | Script, який стосується одного парта, як ColourChanger і TouchPad | Нормально, поки вчитеся: парт це script.Parent. Для справжніх проєктів Roblox радить натомість позначати парти тегами (див. нижче). |
| StarterPlayerScripts, усередині StarterPlayer | Більшість LocalScript: ввід, камера, ефекти для одного гравця | Кожен гравець отримує свою копію під час входу. |
| StarterGui | LocalScript усередині ScreenGui, які керують екранним меню | Кожен гравець отримує свою копію інтерфейсу. |
| ReplicatedStorage | ModuleScript, які підключає і серверний, і клієнтський код | Його бачать обидва боки. LocalScript або Script з налаштуваннями за замовчуванням тут ніколи не запуститься. |
Сторінка Roblox про розташування скриптів радить узагалі не класти скрипти прямо в парти у Workspace: позначте парти тегами й працюйте з ними з одного ModuleScript через CollectionService. Скрипт усередині парта все одно найпростіший старт, і для одного-двох об'єктів, поки ви вчитеся, це нормально. Гайд з дверей показує шаблон із тегами, з одним скриптом на всі двері, а гайд про клієнт і сервер містить повну таблицю, які контейнери які скрипти запускають.
Коли щось пішло не так: читайте Output
Помилки показуються в Output червоним. Кожна починається з того, де вона сталася, повного імені скрипта й номера рядка, а потім каже, що не так. Натисніть на помилку, і Studio відкриє скрипт на цьому рядку. Наприклад, якщо ви видалите перевірку if not player з TouchPad, а на майданчик упаде вільний парт, Output покаже:
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'
Помилки в тому, як написано код, наприклад пропущений end, видно ще до натискання Play: Script Editor підкреслює їх червоним, а вікно Script Analysis (кнопка Analysis на вкладці Script) їх перелічує. Скрипт із такою помилкою не запускається взагалі, навіть рядки вище за неї.
| Повідомлення | Що означає | Як виправити |
|---|---|---|
Colour is not a valid member of Part "Workspace.Part" | У цього об'єкта немає нічого з таким точним ім'ям. Тут властивість пишеться Color. | Звірте написання й великі літери з вікном Properties або Explorer. Докладніше про цю помилку. |
attempt to index nil with 'Name' | Код прочитав щось, тут .Name, у значення nil. У прикладі вище player був nil, бо майданчика торкнувся вільний парт. | З'ясуйте, чому значення nil, і перевіряйте його через if перед використанням. Докладніше про цю помилку. |
Expected 'end' (to close 'then' at line 2), got <eof> | У if на рядку 2 немає парного end. Для функції повідомлення каже to close 'function', а <eof> означає кінець файлу. | Додайте пропущений end, орієнтуючись на рядок у дужках, а не на останній. Іноді повідомлення закінчується фразою «did you forget to close ... at line N?». Це здогад Luau за відступами, і він може вказувати не на той блок, тому спершу перевірте рядок у дужках. Докладніше про синтаксичні помилки. |
Якщо скрипт нічого не робить і Output теж порожній, зазвичай скрипт лежить там, де ніколи не запускається, або чекає на подію, яка не спрацьовує. У гайді з помилок є чек-лист для мовчазних скриптів і докладніше про читання Output.
Що старі туторіали зі скриптингу роблять інакше
Якщо ви вчитеся ще й за відео та дописами на форумах, вам трапляться старі шаблони. Ось важливі, з причиною, чому кожен із них проблема.
| Туторіал | Проблема | Цей гайд |
|---|---|---|
Робить паузу через wait(1) | Довідник Roblox позначає глобальний wait() застарілим і каже, що його замінив task.wait(). | task.wait(1) |
Знаходить персонажа через otherPart.Parent, як в уроці Roblox про лаву | Коли парта торкається шапка або інструмент у руці, otherPart.Parent це Accessory або Tool, а не персонаж, тому Humanoid не знаходиться і дотик губиться. | FindFirstAncestorOfClass("Model"), потім GetPlayerFromCharacter |
Використовує Touched без debounce | Touched спрацьовує кілька разів поспіль за один крок, тому код виконується знову й знову. | Прапорець busy і перезаряджання |
| Кладе LocalScript усередину парта у Workspace | LocalScript там ніколи не запускається. Він працює лише з місць, що належать одному гравцю. | LocalScript у StarterPlayerScripts (чому) |
Пише part.Touched:connect(...) або table.getn(list) | Гайд Roblox з іменування каже, що API в camelCase здебільшого застарілі, а довідник перелічує лише Connect. table.getn застарів на користь #list. | :Connect(...) і #list |
| Змінює монети або завдає шкоди в LocalScript | Зміна залишається на пристрої цього гравця, тому її більше ніхто не бачить і сервер її не враховує. | Правила гри в Script на сервері |
Практика: три зміни, які варто спробувати
Змінювати код навчає більше, ніж читати його. Спробуйте це у своєму плейсі по одному й натискайте Play після кожного.
- Нехай майданчик дає очко. Додайте скрипт Leaderstats з кроку 1 гайду з таблиці лідерів. Потім у TouchPad після
busy = trueзнайдіть папку гравцяleaderstatsі додайте 1 до значенняCoins. Підказка:player:FindFirstChild("leaderstats"), потімleaderstats:FindFirstChild("Coins"), потімcoins.Value += 1. Майданчик з монетами в гайді з таблиці лідерів це готова версія, з перезаряджанням для кожного гравця. - Нехай ColourChanger ще й змінює прозорість. Зробіть так, щоб ColourChanger щосекунди змінював і
Transparencyпарта. Підказка: додайте другу таблицю чисел від 0 до 1, наприклад{ 0, 0.3, 0.6 }, і задавайте з неїpart.Transparencyна рядку післяpart.Color, з тим самимindex. - Надрукуйте колір майданчика. Нехай MyFirstLocalScript друкує
Colorмайданчика під час натискання E. Підказка:print(pad.Color)усередині блокаif pad and pad:IsA("BasePart"). Натисніть E, поки майданчик жовтий: клієнт бачить колір, заданий сервером, бо зміни на сервері доходять до всіх клієнтів.
Що вчити далі
Тепер ви використали деталі, з яких побудовано більшість ігрових скриптів. Добрий порядок далі:
- LocalScript vs Script vs ModuleScript: де працює кожен тип скрипта і що він може змінювати, глибше, ніж крок 4.
- RemoteEvents: як LocalScript просить сервер щось зробити і як сервер перевіряє запит.
- Таблиця лідерів: ваші перші характеристики, створені й змінювані на сервері.
- Ваша перша гра: коротка траса з лавою, монетами й фінішним майданчиком на двох серверних скриптах, потім публікація.
- Потім виберіть систему: GUI магазину, система раундів, чекпоінти в обі, екран завантаження або анімація за натисканням клавіші. Коли щось ламається, гайд з помилок у скриптах допомагає прочитати повідомлення. Гайд із чекпоінтів поки англійською.
Власні туторіали Roblox Coding fundamentals (англійською) добре доповнюють цей гайд: шість серій від змінних і функцій через умови, цикли, масиви й словники до організації коду в ModuleScript, з маленькими проєктами в Studio.
Поширені помилки та рішення
Більшість проблем із першими скриптами це ім'я, що не збігається, скрипт не в тому місці або цикл без очікування. Тримайте Output відкритим під час тесту.
Studio зависає або перестає відповідати після натискання Play
У циклі while true do немає очікування, тому більше нічого не може виконатися. Документація Roblox каже, що безкінечний цикл без затримки на кшталт task.wait() вішає гру й валить Studio. Ставте task.wait() у кожен безкінечний цикл, як у ColourChanger.
Нічого не відбувається, коли я стаю на майданчик
Перевірте, що TouchPad це Script, а не LocalScript, лежить прямо всередині парта Pad, не вимкнений, і що властивість CanTouch у майданчика позначена. Потім зробіть print("touched", otherPart.Name) першим рядком усередині onTouched. Якщо це не друкується, подія не спрацьовує; якщо друкується, проблема нижче.
Натискання E нічого не робить
MyFirstLocalScript має бути LocalScript усередині StarterPlayerScripts: LocalScript у Workspace або ServerScriptService ніколи не запускається. Парт має називатися точно Pad і лежати прямо у Workspace. Спершу клацніть по вікну гри й переконайтеся, що не друкуєте в чаті, бо скрипт ігнорує клавіші, які гра вже використала.
Парт змінюється на моєму екрані, але не в інших гравців
Зміну зробив LocalScript, тому вона залишилася на вашому пристрої. Робіть її в серверному Script або нехай LocalScript попросить сервер через RemoteEvent.
ColourChanger працює всередині парта, але ламається в ServerScriptService
Він використовує script.Parent як свій парт. У ServerScriptService батьківський об'єкт це ServerScriptService, у якого немає Anchored чи Color, тому Output показує помилку «not a valid member». Тримайте його всередині парта або дайте парту ім'я й шукайте його за ім'ям, наприклад local part = workspace:WaitForChild("ColourPart") :: BasePart.
Output узагалі нічого не показує
Перевірте, що вікно Output відкрите (меню Window або вкладка Script) і не стоїть фільтр: Output можна фільтрувати за типом повідомлень, за Client або Server і за текстом. Якщо воно відкрите й усе одно порожнє, скрипт, імовірно, не запускався. Дивіться чек-лист для скриптів, які нічого не роблять.
Якщо застрягли: RoCode
Якщо ви застрягли на скрипті у своєму плейсі, RoCode може розібрати його разом із вами. RoCode це незалежний ШІ-агент для Roblox Studio, не від Roblox: ви пишете у веб-чаті, а його плагін для Studio створює й редагує скрипти у вашому Explorer.
Поки ви вчитеся, корисний режим Ask: скрипти пишете ви, а RoCode читає те, що вже є, і відповідає на запитання.
Поясни рядок за рядком, що робить скрипт TouchPad усередині парта Pad і чому в ньому використовується debounce.
- У режимі Ask використовує лише інструменти читання, наприклад Search Scripts і Read Script, і нічого не змінює в плейсі
- Якщо щось треба виправити, каже, що і де він змінив би, і пропонує перемкнутися на Build
- У режимі Build редагує скрипти на місці, потім перевіряє кожен через Check Script. Це перевірка компіляції, а не перевірка типів і не плейтест
- Читає Output Studio інструментом Check Output, зокрема рядки Server і Client вашого останнього плейтесту, навіть після натискання Stop
У режимі Build з плагіном 3.9 або новішим RoCode може запустити короткий плейтест і прочитати помилки, а з 3.9.11 або новішим керувати тестовим персонажем, але під час гри він не робить скриншотів, тому на майданчик ви все одно стаєте самі. Як RoCode підключається до Studio.
Поширені запитання
Де писати скрипти в Roblox Studio?
В Explorer наведіть курсор на контейнер, наприклад ServerScriptService, натисніть + і виберіть Script. Studio відкриє його в Script Editor, де ви пишете Luau. Серверні скрипти зазвичай лежать у ServerScriptService; LocalScript у StarterPlayerScripts або StarterGui.
Як запустити скрипт у Roblox Studio?
Натисніть Play (F5). Studio запустить плейтест, і кожен увімкнений Script у ServerScriptService або Workspace виконається одразу на старті гри; LocalScript у StarterPlayerScripts виконаються, коли ви зайдете в плейтест. Run (виберіть у списку поруч із Play або натисніть F8) запускає гру без аватара, тому для цього гайду використовуйте Play. Stop (Shift+F5) завершує тест. Щоб відкрити наявний скрипт, двічі клацніть по ньому в Explorer.
Яку мову програмування використовує Roblox?
Luau. Roblox описує її як швидку, маленьку, безпечну мову скриптів із поступовою типізацією, що походить від Lua 5.1, тому більшість туторіалів з Lua все ще корисні. Luau додає можливості на кшталт інтерполяції рядків у зворотних лапках і необов'язкових анотацій типів, а Roblox додає свої бібліотеки й об'єкти, наприклад task.wait.
Чим Script відрізняється від LocalScript?
Script працює на сервері, і його зміни доходять до всіх гравців. LocalScript працює на пристрої одного гравця, для вводу, камери й екранних меню, і його зміни партів, значень та інтерфейсу залишаються на цьому пристрої. Гайд про клієнт і сервер (англійською) розбирає обидва, плюс ModuleScript.
Чи можна писати скрипти в Roblox Studio на телефоні чи iPad?
Сторінка встановлення Roblox описує Studio як безкоштовний застосунок для Windows і Mac і не називає версій для телефона чи планшета, тому для скриптів потрібен комп'ютер.
Чому мій скрипт нічого не робить і не показує помилки?
Зазвичай він лежить там, де такий скрипт не запускається (LocalScript у Workspace або Script у StarterPlayerScripts), він вимкнений або подія, на яку він чекає, не спрацьовує. У гайді з помилок є чек-лист.
Скільки часу потрібно, щоб навчитися скриптингу в Roblox?
Чесного числа ніхто не назве: це залежить від того, скільки ви будуєте. Найбільше допомагає часто писати маленькі скрипти у своєму плейсі. Змінюйте чотири скрипти звідси, спробуйте завдання для практики, потім пройдіть гайд з першої гри і додавайте по одній системі.
Джерела та що почитати
- Roblox Creator Docs: Luau (англійською). що таке Luau і звідки він
- Roblox Creator Docs: Roblox Studio setup (англійською). Windows і Mac, системні вимоги
- Roblox Creator Docs: Output (англійською). відкриття Output, фільтри, Show Context і Show Source
- Roblox Creator Docs: Studio testing modes (англійською). Play, Run, Stop, перемикач Client/Server і Server & Clients
- Roblox Creator Docs: Script Editor (англійською). де відкриваються нові скрипти і Script Analysis
- Roblox Creator Docs: Script types and locations (англійською). де працює кожен тип скрипта і теги замість скриптів у партах
- Roblox Creator Docs: Script (англійською). коли Script починає працювати
- Roblox Creator Docs: Control structures (англійською). умови, цикли і чому безкінечному циклу потрібне очікування
- Roblox Creator Docs: Events (англійською). Connect і що Touched передає функції
- Roblox Creator Docs: Debounce patterns (англійською). чому Touched спрацьовує кілька разів за один дотик
- Roblox Creator Docs: wait (англійською). глобальний wait() і task.wait()
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (англійською). що клієнт може робити зі своїм персонажем
- Roblox Creator Docs: Coding fundamentals (англійською). серія Roblox для початківців
Як перевірявся код: кожен скрипт на цій сторінці проходить сувору перевірку типів Luau з визначеннями Roblox API (luau-lsp, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.