Накратко
За да напишеш скрипт в 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 playground в браузъра. Смени там стойност и го пусни пак, за да видиш какво ще се промени.
| Код | Идея | Какво означава |
|---|---|---|
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, преди да публикуваш.