Ръководство · Основи на скриптовете

Как да пишеш скриптове в Roblox Studio: ръководство за начинаещи

Скриптовете, или програмирането, в Roblox Studio означава да пишеш на Luau, версията на езика Lua от Roblox, в скриптове, които добавяш в плейса. Това ръководство започва от празен Baseplate: ще отвориш прозореца Output, ще напишеш първия си скрипт, ще промениш парт от кода, ще реагираш на играч, стъпил на площадка, и ще пробваш LocalScript, а по пътя ще разбереш променливите, функциите, условията, циклите и събитията.

Обновено 20 ноември 2026 г.20 мин четенеАвтор:

Накратко

За да напишеш скрипт в 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.
На тази страница
  1. Преди да започнеш
  2. 1. Първи скрипт
  3. 2. Промени парт
  4. 3. Събития
  5. 4. Първи LocalScript
  6. 5. Тест
  7. Къде да слагаш скриптове
  8. Четене на грешки
  9. Стари уроци
  10. Практика
  11. Какво следва
  12. Common errors
  13. С RoCode
  14. Често задавани въпроси
  15. Източници и какво да прочетеш

Преди да започнеш: Studio, Baseplate и прозорецът Output

ИлюстрацияЧетири скрипта в един плейтест: партът ColourChanger сменя цвета си всяка секунда, стъпка върху Pad го прави жълт за 2 секунди за всички играчи и пише името ти в Output, а E прави Pad по-прозрачен само на този екран.

Трябват ти Roblox Studio и акаунт в Roblox и нищо друго: нито редактор на код, нито плъгин. Всеки скрипт от това ръководство се пише в собствения Script Editor на Studio.

  1. Инсталирай Roblox Studio, безплатното приложение на Roblox за Windows и Mac, и влез с акаунта си в Roblox.
  2. Отвори Studio. На началната страница има шаблони: избери Baseplate. Ще получиш под с текстура на мрежа 4x4 и SpawnLocation, мястото, където се появява аватарът ти при игра.
  3. Ако прозорците Explorer и Properties не се виждат, отвори ги от менюто Window или от раздела Home. Explorer изброява всички обекти в плейса; Properties показва настройките на избрания.
  4. Отвори Output от менюто Window или от раздела Script. Тук се появяват съобщенията и грешките на скриптовете ти.
  5. В настройките за показване на прозореца Output включи Show Context, който отбелязва всяко съобщение като Client или Server, и Show Source, който показва скрипта и номера на реда, от който идва.
Четирите скрипта, които ще напишеш
СкриптТипКъде еКакво учи
FirstScriptScriptServerScriptServiceПроменливи, функция, условие if, цикли и таблица
ColourChangerScriptВътре в Part в WorkspaceПромяна на свойства, script.Parent и цикъл с изчакване
TouchPadScriptВътре в Part с име PadСъбития, намиране на играча, докоснал парта, и debounce
MyFirstLocalScriptLocalScriptStarterPlayerScripts, вътре в StarterPlayerКод на устройството на един играч, натискания на клавиши и какво остава на това устройство
Explorer накрая (само обектите от това ръководство)
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: напиши първия си скрипт

  1. В Explorer задръж курсора върху ServerScriptService, натисни + и избери Script (клавишна комбинация Ctrl+I или ⌘I на Mac). Studio ще създаде скрипта и ще го отвори в Script Editor.
  2. Щракни с десния бутон върху новия скрипт, избери Rename и го наречи FirstScript. Името не променя това, което прави скриптът, но казва кой скрипт какво е отпечатал.
  3. Новите скриптове започват с един ред, print("Hello world!"). Изтрий го и постави кода по-долу.
  4. Натисни Play (F5), като избереш Test в списъка вляво от него. Studio ще пусне плейтест и ще постави аватара на SpawnLocation.
  5. Прочети редовете в Output, после натисни Stop (Shift+F5). Stop също връща всички обекти в състоянието отпреди натискането на Play, затова всичко, което си преместил или пребоядисал по време на играта, ще се върне.
Script в ServerScriptService с име FirstScript
-- 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 с номера на реда.

Output (очакван)
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 в браузъра. Смени там стойност и го пусни пак, за да видиш какво ще се промени.

Какво прави всяка част на FirstScript
КодИдеяКакво означава
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Условие ifLuau проверява условията отгоре надолу и изпълнява само първото вярно. 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 на парт, са свойства и скриптът също може да ги задава.

  1. В раздела Home натисни Part. Studio ще добави блок в Workspace. Името му няма значение.
  2. В Explorer задръж курсора върху новия парт, натисни + и вмъкни Script. Преименувай го на ColourChanger и замени съдържанието му с кода по-долу.
  3. Натисни Play. Партът става червен, после син, после зелен, сменя се веднъж в секунда и започва отначало.
Script в който и да е парт в Workspace с име ColourChanger
-- 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 ги нарича събития. За да изпълниш код, когато събитието се задейства, свързваш функция към него.

  1. Вмъкни още един Part и го преименувай точно на Pad, с главно P. Остави го направо в Workspace, не в папка и не в модел, защото LocalScript от стъпка 4 го търси там.
  2. Направи го плоска площадка, на която можеш да застанеш, например задай Size на 6, 1, 6 в прозореца Properties. Сложи го на пода до SpawnLocation и отметни Anchored, за да не се движи.
  3. Задръж курсора върху Pad, натисни +, вмъкни Script, преименувай го на TouchPad и постави кода по-долу.
  4. Натисни Play и застани на площадката. Тя пожълтява за 2 секунди, а Output казва името ти.
Script в Workspace.Pad с име TouchPad
-- 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)
Как TouchPad стига от докосването до играча
КодКакво прави
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 работи на устройството на един играч. Натисканията на клавиши, камерата и екранните менюта се обработват там, защото само това устройство знае за тях.

  1. В Explorer разгъни StarterPlayer, задръж курсора върху StarterPlayerScripts, натисни + и вмъкни LocalScript. Преименувай го на MyFirstLocalScript и постави кода по-долу.
  2. Натисни Play. Output ще покаже Hello, и името ти с отметка Client.
  3. Щракни в прозореца на играта и натисни E. Площадката става по-прозрачна. Натисни E пак, за да я върнеш.
  4. Докато плейтестът тече, натисни превключвателя Client/Server в контролите за тестване на Studio, за да минеш към сървърното копие на играта. Там площадката е непрозрачна: сървърът не е разбрал нищо за промяната.
LocalScript в StarterPlayerScripts с име MyFirstLocalScript
-- 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, LocalScript и ModuleScript
ТипКъде работиДокъде стигат променитеЗа каквоОбикновено е в
ScriptНа сървъраДо всички играчиПравилата на играта: монети, щети, врати, рундове, запазванеServerScriptService или вътре в парт, докато учиш
LocalScriptНа устройството на един играчСамо до това устройство, освен движението на собствения персонажВход, камера, екранни менюта, ефекти за един играчStarterPlayerScripts или StarterGui
ModuleScriptНа страната, която извиква require() за негоТам, където стигат и тези на скрипта, който го е заредилКод, общ за няколко скриптаReplicatedStorage за двете страни, ServerScriptService само за сървъра

Какво може да промени измамник

Приеми, че измамникът контролира всичко на своето устройство. Той може да пуска свои LocalScript и да променя твоите, затова може да направи прозрачна площадката или каквото и да е друго на своя екран. Тук това е безобидно: прозрачността е само за вида и остава на неговото устройство. Точно затова всичко важно го решава Script на сървъра.

Сървърният Script също не е автоматично безопасен. TouchPad работи на сървъра, но устройството на всеки играч управлява физиката на неговия персонаж и документацията на Roblox за сигурност посочва сред нещата, които клиентът може да прави с контролираните от него партове, управлението на момента, в който се задейства Touched, или пълното му блокиране. За светеща площадка това няма значение. За площадка, която плаща, проверявай и това, което сървърът следи сам, като правилото в ръководството за оби, че чекпойнтите се зачитат само поред.

Стъпка 5: тествай и четирите скрипта заедно

  1. Изчисти Output с Ctrl+K (⌘K на Mac) и натисни Play (F5). Output ще покаже осемте реда на FirstScript с отметка Server и твоя ред Hello с отметка Client. Партът ColourChanger сменя цвета си всяка секунда.
  2. Застани на площадката. Тя пожълтява за 2 секунди, а Output показва веднъж името ти и „stepped on the pad“. Походи по нея: нов ред се появява не по-често от веднъж на 2 секунди, а не при всяко задействане на Touched.
  3. Натисни E. Площадката става полупрозрачна (Transparency 0.6). Натисни E пак и тя е непрозрачна.
  4. Натисни Stop. В списъка за тестване избери Server & Clients, задай 2 клиента и натисни Play (или F7). Studio ще отвори прозорец на сървъра и два прозореца на клиенти. В единия клиент натисни E: площадката ще стане по-прозрачна там, а другият клиент и сървърът ще я показват непрозрачна. Натисни End Session, когато приключиш.
  5. Счупи нещо нарочно. Преименувай Pad на Pad2 и пусни играта. Стъпка на площадката още я прави жълта, защото TouchPad намира своя парт чрез script.Parent, а не по име. Натискането на E вече не прави нищо и грешка няма: FindFirstChild("Pad") е върнал nil, а проверката if pad and ... тихо е прескочила останалото. Добави print(pad) на реда след FindFirstChild, пусни и натисни E: Output ще покаже nil. Такъв print е най-бързият начин да разбереш защо скриптът не прави нищо. Спри играта, изтрий реда с print и върни на парта името Pad.

Къде да слагаш скриптовете

От това къде е скриптът зависи дали изобщо ще тръгне, а Studio не предупреждава, ако той никога не тръгне. За следващите ти скриптове:

Къде да слагаш всеки вид скрипт
КонтейнерКакво да слагашЗащо
ServerScriptServiceСкриптове с повечето правила на играта: награди, рундове, запазванеТе работят на сървъра и нищо от ServerScriptService не се праща на играчите.
Вътре в парт в WorkspaceScript, който се отнася до един парт, като ColourChanger и TouchPadНормално е, докато учиш: партът е script.Parent. За истински проекти Roblox съветва вместо това да отбелязваш партовете с тагове (виж по-долу).
StarterPlayerScripts, вътре в StarterPlayerПовечето LocalScript: вход, камера, ефекти за един играчВсеки играч получава свое копие при влизане.
StarterGuiLocalScript вътре в ScreenGui, които управляват екранно менюВсеки играч получава свое копие на интерфейса.
ReplicatedStorageModuleScript, които зареждат и сървърният, и клиентският кодВиждат го и двете страни. LocalScript или Script с настройки по подразбиране тук никога няма да тръгне.

Страницата на Roblox за местата на скриптовете съветва изобщо да не слагаш скриптове направо в партове в Workspace: отбележи партовете с тагове и работи с тях от един ModuleScript чрез CollectionService. Скрипт вътре в парт все пак е най-простото начало и за един или два обекта, докато учиш, това е нормално. Ръководството за врати показва шаблона с тагове, с един скрипт за всички врати, а ръководството за клиент и сървър съдържа пълната таблица кои контейнери кои скриптове пускат.

Когато нещо се обърка: чети Output

Грешките се показват в Output в червено. Всяка започва с това къде е станала, пълното име на скрипта и номера на реда, а после казва какво не е наред. Щракни върху грешката и Studio ще отвори скрипта на този ред. Например, ако изтриеш проверката if not player от TouchPad, а на площадката падне свободен парт, Output ще покаже:

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 без debounceTouched се задейства няколко пъти подред при една стъпка, затова кодът се изпълнява отново и отново.Флаг busy и презареждане
Слага LocalScript вътре в парт в WorkspaceLocalScript там никога не тръгва. Той работи само от места, които принадлежат на един играч.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, докато площадката е жълта: клиентът вижда цвета, зададен от сървъра, защото промените на сървъра стигат до всички клиенти.

Какво да учиш след това

Вече използва частите, от които са изградени повечето скриптове в игрите. Добър ред оттук нататък:

  1. LocalScript vs Script vs ModuleScript: къде работи всеки тип скрипт и какво може да променя, по-задълбочено от стъпка 4.
  2. RemoteEvents: как LocalScript моли сървъра да направи нещо и как сървърът проверява заявката.
  3. Класация: първите ти характеристики, създадени и променяни на сървъра.
  4. Първата ти игра: кратко трасе с лава, монети и финална площадка с два сървърни скрипта, после публикуване.
  5. После избери система: 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.

RoCode прави
  • В режим 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?

Честно число никой няма да ти каже: зависи от това колко строиш. Най-много помага да пишеш често малки скриптове в своя плейс. Променяй четирите скрипта оттук, пробвай задачите за практика, после мини ръководството за първа игра и добавяй по една система.

Източници и какво да прочетеш

Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.

Пробвай RoCode в своята игра.

Безплатни кредити всеки ден, без карта. Инсталирай плъгина, опиши функцията и виж какво се е появило в Studio.