Tutorial · Basics ng scripting

Paano mag-script sa Roblox Studio: guide para sa mga baguhan

Ang scripting, o programming, sa Roblox Studio ay pagsusulat ng Luau, ang version ng Roblox ng Lua language, sa mga script na idinadagdag mo sa place. Nagsisimula ang guide na ito sa blangkong Baseplate: bubuksan mo ang Output window, isusulat ang unang script, babaguhin ang isang part mula sa code, magre-react sa player na tumapak sa pad, at susubukan ang LocalScript, at habang nasa daan, matututunan mo ang variables, functions, conditions, loops at events.

In-update Nobyembre 20, 202623 minutong basaIsinulat ni

Sa madaling salita

Para magsulat ng script sa Roblox Studio, i-hover ang ServerScriptService sa Explorer, pindutin ang + at mag-insert ng Script. Bubuksan ito ng Studio sa Script Editor. Magsulat ng Luau, halimbawa print("Hello"), pindutin ang Play (F5) at basahin ang resulta sa Output window (menu na Window o tab na Script). Tumatakbo ang Script sa server at binabago ang lahat para sa lahat; ang LocalScript sa StarterPlayerScripts ay tumatakbo sa device ng isang player.

  • Unahing matutunan ang apat na idea: variables (local coins = 3), functions (local function name() ... end), if conditions at events (part.Touched:Connect(...)). Ang apat na script ng guide na ito ay binuo mula sa mga ito, kasama ang loops at tables.
  • Gamitin ang task.wait(), hindi wait(). Minamarkahan ng reference ng Roblox ang global na wait() bilang deprecated at pinalitan ng task.wait().
  • Sa display settings ng Output window, i-on ang Show Context para ipakita ng bawat linya kung galing ito sa Server o sa Client.
Sa page na ito
  1. Bago magsimula
  2. 1. Unang script
  3. 2. Baguhin ang part
  4. 3. Events
  5. 4. Unang LocalScript
  6. 5. Test
  7. Saan ilalagay ang scripts
  8. Pagbasa ng mga error
  9. Mga lumang tutorial
  10. Practice
  11. Ano ang susunod
  12. Common errors
  13. Gamit ang RoCode
  14. Mga madalas itanong
  15. Mga source at dagdag na babasahin

Bago magsimula: Studio, Baseplate at ang Output window

IllustrationApat na script sa iisang playtest: nagpapalit ng kulay bawat segundo ang part na ColourChanger, ang pagtapak sa Pad ay ginagawa itong dilaw nang 2 segundo para sa lahat ng player at isinusulat ang pangalan mo sa Output, at ginagawang mas transparent ng E ang Pad sa screen na ito lang.

Kailangan mo ng Roblox Studio at Roblox account, at wala nang iba: walang code editor, walang plugin. Bawat script sa guide na ito ay tina-type sa sariling Script Editor ng Studio.

  1. I-install ang Roblox Studio, ang libreng app ng Roblox para sa Windows at Mac, at mag-log in gamit ang Roblox account.
  2. Buksan ang Studio. May mga template sa start page: piliin ang Baseplate. Makakakuha ka ng sahig na may 4x4 grid texture at SpawnLocation, ang lugar kung saan lumalabas ang avatar mo kapag naglalaro.
  3. Kung hindi nakikita ang mga window na Explorer at Properties, buksan sila mula sa menu na Window o tab na Home. Inililista ng Explorer ang lahat ng object sa place; ipinapakita ng Properties ang settings ng naka-select.
  4. Buksan ang Output mula sa menu na Window o tab na Script. Dito lumalabas ang mga mensahe at error ng scripts mo.
  5. Sa display settings ng Output window, i-on ang Show Context, na minamarkahan ang bawat mensahe bilang Client o Server, at ang Show Source, na ipinapakita ang script at line number kung saan ito nanggaling.
Ang apat na script na isusulat mo
ScriptTypeSaan nakalagayAno ang itinuturo
FirstScriptScriptServerScriptServiceVariables, function, if condition, loops at table
ColourChangerScriptSa loob ng Part sa WorkspacePagbago ng properties, script.Parent at loop na may wait
TouchPadScriptSa loob ng Part na pinangalanang PadEvents, paghahanap sa player na humawak sa part, at debounce
MyFirstLocalScriptLocalScriptStarterPlayerScripts, sa loob ng StarterPlayerCode sa device ng isang player, pagpindot ng keys at ano ang naiiwan sa device na iyon
Explorer sa dulo (mga object lang ng guide na ito)
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

Hakbang 1: isulat ang unang script

  1. Sa Explorer, i-hover ang ServerScriptService, pindutin ang + at piliin ang Script (shortcut na Ctrl+I o ⌘I sa Mac). Gagawa ang Studio ng script at bubuksan ito sa Script Editor.
  2. I-right click ang bagong script, piliin ang Rename at pangalanan itong FirstScript. Hindi binabago ng pangalan ang ginagawa ng script, pero sinasabi nito kung aling script ang nag-print ng ano.
  3. Nagsisimula ang mga bagong script sa isang linya, print("Hello world!"). Burahin ito at i-paste ang code sa ibaba.
  4. Pindutin ang Play (F5), habang naka-select ang Test sa listahan sa kaliwa nito. Magsisimula ang Studio ng playtest at ilalagay ang avatar sa SpawnLocation.
  5. Basahin ang mga linya sa Output, saka pindutin ang Stop (Shift+F5). Ibinabalik din ng Stop ang lahat ng object sa estado bago pinindot ang Play, kaya babalik ang lahat ng inilipat o pinalitan mo ng kulay habang naglalaro.
Script sa ServerScriptService na pinangalanang FirstScript
-- Script sa ServerScriptService na pinangalanang FirstScript.
-- Ang una mong Luau: variables, function, if condition, loop at table.
-- Pindutin ang Play (F5) at basahin ang resulta sa Output window.

-- Ang variable ay pangalan na nag-iimbak ng value
local gameName = "Coin Run"
local coinsToWin = 3

-- Ang function ay may pangalang block ng code na puwedeng patakbuhin kahit ilang beses.
-- Ang name at goal ay mga parameter nito; ibinabalik ng return ang value sa tumawag dito.
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

-- Ang if condition ay nagpapatakbo ng code kapag totoo lang ang condition
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

-- Inuulit ng for loop ang code nang takdang bilang ng beses
for count = 1, coinsToWin do
	print("Coin number", count)
end

-- Nag-iimbak ang table ng listahan ng values; dinadaanan sila ng loop na ito nang sunod-sunod
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
	print(position, colour) --> 1 Red, saka 2 Green, saka 3 Blue
end

Lahat ng nasa linya pagkatapos ng -- ay comment: nilalaktawan ito ng Luau, kaya puwede kang mag-iwan ng notes para sa sarili mo. Ipinapakita ng mga comment na --> kung ano ang pini-print ng linya.

Dapat ipakita ng Output ang walong linyang ito, halo sa mga mensahe ng Studio mismo. Kapag maraming value ang natanggap ng print, naglalagay ito ng space sa pagitan nila. Kapag naka-on ang Show Context at Show Source, may marka pa ang bawat linya na Server at FirstScript kasama ang line number.

Output (inaasahan)
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

Itugma ang bawat linya sa code na nag-print nito. Mamaya, gagawin mo rin ito sa mga error message, kaya magagamit mo ang habit na ito.

Puro Luau lang ang gamit ng FirstScript, walang Roblox objects, kaya gumagana rin ito sa libreng Luau playground sa browser. Palitan doon ang isang value at patakbuhin ulit para makita kung ano ang magbabago.

Ano ang ginagawa ng bawat bahagi ng FirstScript
CodeIdeaAno ang ibig sabihin
local gameName = "Coin Run"VariablePangalan na nag-iimbak ng value. Ang local ay nangangahulugang ang script lang na ito o ang block na kinalalagyan nito ang puwedeng gumamit nito. Ang text sa loob ng quotes ay string; ang 3 ay number. Case-sensitive ang mga pangalan, kaya ang coinsToWin at CoinsToWin ay dalawang magkaibang variable.
local function describe(name: string, goal: number): stringFunctionMay pangalang block ng code na puwedeng patakbuhin kahit ilang beses. Ang name at goal ay mga parameter nito: mga value na ipinapasa sa bawat tawag. Ang : string at : number ay opsyonal na type annotations. Ginagamit sila ng Luau para magbabala tungkol sa mga mali sa Script Editor; pareho pa rin ang takbo ng code kahit wala sila.
returnReturn valueIbinibigay ang value sa code na tumawag sa function. Pini-print ng print(describe(gameName, coinsToWin)) ang ibinalik ng describe.
`{name}: collect {goal} coins to win`String interpolationPuwedeng may values ang text sa loob ng backticks: pinapalitan ng Luau ang {name} at {goal} ng kasalukuyan nilang values.
if, elseif, else, endIf conditionChine-check ng Luau ang mga condition mula itaas pababa at pinapatakbo lang ang unang totoo. Ang coinsToWin ay 3, hindi ito mas malaki sa 5, pero mas malaki sa 1, kaya "That is a short game" lang ang napi-print.
for count = 1, coinsToWin doNumeric for loopPinapatakbo ang code sa loob nang isang beses para sa bawat numero mula 1 hanggang coinsToWin, kung saan ang count ay 1, saka 2, saka 3.
{ "Red", "Green", "Blue" } at for position, colour in colours doTable at loopParang listahan ang table; tinatawag ito ng Luau na array. Nagsisimula sa 1 ang mga posisyon, hindi sa 0. Dinadaanan ng loop ang bawat item at ibinibigay ang posisyon at value nito.

Bawat block na nagbubukas sa salitang function, if, for o while ay isinasara ng salitang end. Kapag may isang end na kulang, hindi tatakbo ang buong script; ipinapakita ng section na pagbasa ng mga error kung anong mensahe ang makukuha mo.

Hakbang 2: baguhin ang isang part mula sa script

Nagiging kapaki-pakinabang ang scripts kapag may binabago sila sa mundo. Ang mga setting na nakikita mo sa Properties window, halimbawa Color, Transparency o Anchored ng isang part, ay mga property, at kaya rin silang i-set ng script.

  1. Sa tab na Home, pindutin ang Part. Magdadagdag ang Studio ng block sa Workspace. Hindi mahalaga ang pangalan nito.
  2. Sa Explorer, i-hover ang bagong part, pindutin ang + at mag-insert ng Script. Pangalanan itong ColourChanger at palitan ang laman nito ng code sa ibaba.
  3. Pindutin ang Play. Nagiging pula ang part, saka asul, saka berde, nagpapalit bawat segundo, at umuulit.
Script sa kahit anong part sa Workspace na pinangalanang ColourChanger
-- Script sa loob ng Part sa Workspace, na pinangalanang ColourChanger.
-- Binabago ng scripts ang parehong properties na nakikita sa Properties window.
-- Binibigyan nito ang part nito ng bagong kulay bawat segundo, para sa lahat ng player.

local part = script.Parent :: BasePart -- ang part na kinalalagyan ng script na ito

local colours = {
	Color3.fromRGB(255, 85, 85), -- pula
	Color3.fromRGB(85, 170, 255), -- asul
	Color3.fromRGB(85, 255, 127), -- berde
}

part.Anchored = true -- nananatili ang naka-anchor na part kung saan mo ito inilagay

local index = 1
while true do
	part.Color = colours[index]
	index = index % #colours + 1 -- 1, 2, 3, saka 1 ulit
	task.wait(1) -- hinto nang isang segundo (deprecated ang lumang wait())
end
  • Ang script.Parent ay ang object na kinalalagyan ng script, dito ang part. I-drag ang script sa ibang part, at iyon ang babaguhin nito.
  • Ang :: BasePart ay type cast. Sinasabi nito sa Script Editor na part ang parent, para ma-check ang mga property na ginagamit. Ginagamit lang ng Luau ang types para sa mga babala at suggestion, kaya hindi binabago ng cast ang ginagawa ng linya.
  • Ang part.Color at part.Anchored ay ang parehong properties sa Properties window, na may parehong pangalan. American spelling ang gamit ng Roblox, kaya Color ang pangalan ng property, kahit ColourChanger ang pangalan ng script.
  • Pinapanatili ng Anchored = true ang part sa puwesto: sabi ng reference ng Roblox, hindi kailanman gumagalaw ang naka-anchor na part dahil sa gravity, collisions o ibang physics.
  • Binabasa ng colours[index] ang isang item ng listahan. Ang #colours ay ang haba ng listahan, 3, at ang % ay nagbibigay ng remainder ng division, kaya ang index % #colours + 1 ay nagbibilang ng 1, 2, 3, 1, 2, 3.
  • Walang katapusang umuulit ang while true do, kaya napakahalaga ng task.wait(1) sa loob. Sabi ng documentation ng Roblox, laging maglagay ng delay gaya ng task.wait() sa infinite loop: kung wala ito, magha-hang ang game at magka-crash ang Studio.

Ang ColourChanger ay Script, kaya tumatakbo ito sa server, at nakikita ng lahat ng player ang parehong kulay nang sabay. Ipinapakita ng hakbang 4 ang ibang uri ng script.

Hakbang 3: mag-react sa player gamit ang event

Karamihan sa game code ay naghihintay na may mangyari: may pumasok na player, may humawak sa part, may pinindot na button. Tinatawag ito ng Roblox na events. Para magpatakbo ng code kapag nag-fire ang event, ikinokonekta mo ang isang function dito.

  1. Mag-insert ng isa pang Part at pangalanan itong eksaktong Pad, na malaking P. Iwanan ito nang direkta sa Workspace, hindi sa folder o model, dahil doon ito hinahanap ng LocalScript sa hakbang 4.
  2. Gawin itong patag na pad na puwedeng tapakan, halimbawa i-set ang Size sa 6, 1, 6 sa Properties window. Ilagay ito sa sahig malapit sa SpawnLocation at i-check ang Anchored para hindi ito gumalaw.
  3. I-hover ang Pad, pindutin ang +, mag-insert ng Script, pangalanan itong TouchPad at i-paste ang code sa ibaba.
  4. Pindutin ang Play at tumapak sa pad. Nagiging dilaw ito nang 2 segundo, at sinasabi ng Output ang pangalan mo.
Script sa Workspace.Pad na pinangalanang TouchPad
-- Script sa loob ng Part sa Workspace na pinangalanang Pad, script na pinangalanang TouchPad.
-- Events: kapag tumapak ang player sa pad, umiilaw ito ng dilaw, at isinusulat ng Output kung sino iyon.
-- Pinipigilan ng debounce ang code na mag-trigger nang maraming beses bawat segundo habang nakatayo ang player dito.

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 -- naka-cooldown pa mula sa nakaraang touch
	end
	-- Ang character ay ang Model na kinalalagyan ng body part (o sombrero) na humawak sa pad
	local character = otherPart:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	if not player then
		return -- maluwag na part o NPC ang humawak, hindi player
	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)
Paano napupunta ang TouchPad mula sa touch hanggang sa player
CodeAno ang ginagawa
pad.Touched:Connect(onTouched)Ikinokonekta ang function sa Touched event ng pad, kaya pinapatakbo ng Roblox ang onTouched tuwing may humahawak sa pad, at ipinapasa ang part na humawak.
otherPartAng part na humawak sa pad: paa, binti, hawakan ng sombrero o tool sa kamay ng player. Hindi ito kailanman ang player mismo, kaya inaalam ng sumunod na dalawang linya kung kanino ito.
otherPart:FindFirstAncestorOfClass("Model")Umaakyat mula sa part na ito papunta sa unang ancestor na eksaktong Model ang class, ibig sabihin ang character. Dahil kailangang eksaktong tugma ang class name, nilalaktawan nito ang sombrero (class na Accessory) at ang tool sa kamay (class na Tool).
Players:GetPlayerFromCharacter(character)Ibinabalik ang Player na may-ari ng character na ito, o nil kung walang may-ari ang character, halimbawa NPC. Nilalaktawan ng character and sa unahan ang tawag kapag walang nahanap na model, at nananatiling nil ang player.
if not player then return endHumihinto dito para sa lahat ng hindi player. Lumalabas nang maaga sa function ang return.

Bakit kailangan ng debounce ang pad

Nagbababala ang page ng Roblox tungkol sa debounce na nagfa-fire nang ilang beses nang sunod-sunod ang Touched habang magkadikit ang mga part, at may ilang body part ang naglalakad na character. Kung walang check, ang isang tapak sa pad ay puwedeng mag-print ng maraming linya at paulit-ulit na i-restart ang dilaw na ilaw.

Ang variable na busy ang debounce. Sine-set ito ng unang touch sa true, at bawat touch sa susunod na 2 segundo ay umaabot sa if busy then return end at humihinto. Pagkatapos ng task.wait(COOLDOWN_SECONDS), ibinabalik ng pad ang kulay nito, at nagiging false ulit ang busy. Naka-capital letters ang COOLDOWN_SECONDS dahil setting ito na hindi nagbabago habang naglalaro: ganito ang payo ng Roblox sa pagpapangalan ng constants.

Iisa ang debounce ng pad na ito para sa lahat, kaya hindi pinapansin ang pangalawang player na tumapak sa loob ng 2 segundong iyon. Okay iyon para sa umiilaw na pad. Ang pad na nagbibigay ng rewards ay dapat may cooldown para sa bawat player, gaya ng coin pad sa guide sa leaderboard.

Hakbang 4: ang unang LocalScript at kung paano ito naiiba

Ang tumatakbong game ay isang server kasama ang isang client para sa bawat player. Lahat hanggang ngayon ay Script, na tumatakbo sa server, kaya umaabot ang mga pagbabago nito sa lahat ng player. Ang LocalScript ay tumatakbo sa device ng isang player. Doon pinoproseso ang pagpindot ng keys, camera at on-screen menus, dahil ang device lang na iyon ang may alam sa mga ito.

  1. Sa Explorer, i-expand ang StarterPlayer, i-hover ang StarterPlayerScripts, pindutin ang + at mag-insert ng LocalScript. Pangalanan itong MyFirstLocalScript at i-paste ang code sa ibaba.
  2. Pindutin ang Play. Ipapakita ng Output ang Hello, at ang pangalan mo na may markang Client.
  3. I-click ang game window at pindutin ang E. Nagiging mas transparent ang pad. Pindutin ulit ang E para ibalik ito.
  4. Habang tumatakbo ang playtest, pindutin ang toggle na Client/Server sa testing controls ng Studio para lumipat sa server copy ng game. Doon, hindi transparent ang pad: walang nalaman ang server tungkol sa pagbabago.
LocalScript sa StarterPlayerScripts na pinangalanang MyFirstLocalScript
-- LocalScript sa StarterPlayer > StarterPlayerScripts na pinangalanang MyFirstLocalScript.
-- Tumatakbo ang LocalScript sa device ng isang player. Pindutin ang E: nagiging mas transparent ang Pad
-- sa screen mo lang, dahil ang pagbabago sa part mula rito ay hindi umaabot sa server o sa iba.

local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")

local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- lumalabas sa Output na may markang Client

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	if gameProcessed then
		return -- napunta ang key sa ibang bagay, halimbawa pag-type sa chat
	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)
  • Ang Players.LocalPlayer ay ang player na may-ari ng device kung saan tumatakbo ang script. Dine-define ito ng Roblox para lang sa LocalScript at sa mga ModuleScript na nire-require nila, kaya hindi ito magagamit ng server code.
  • Nagfa-fire ang UserInputService.InputBegan kapag nagsimula ang player ng pagpindot ng key, click o tap. Ang gameProcessed ay true kapag nagamit na ng engine ang input na ito, halimbawa click sa button o key sa chat bar, kaya hindi ito pinapansin ng script.
  • Ibinabalik ng workspace:FindFirstChild("Pad") ang child na pinangalanang Pad, o nil kung wala. Chine-check ng pad:IsA("BasePart") na part talaga ito bago baguhin ng script ang Transparency nito.
  • Ang if pad.Transparency == 0 then 0.6 else 0 ay if expression: pumipili ito ng isa sa dalawang value. Ang Transparency na 0 ay ganap na nakikita, ang 1 ay invisible.
  • Magandang pangalawang LocalScript ang sprint script sa Shift: nakikinig ito sa isang key at binabago ang WalkSpeed ng character.
Script, LocalScript at ModuleScript
TypeSaan tumatakboSaan umaabot ang mga pagbabagoPara saanKaraniwang nakalagay sa
ScriptSa serverSa lahat ng playerMga rule ng game: coins, damage, mga pinto, rounds, savingServerScriptService o sa loob ng part, habang nag-aaral
LocalScriptSa device ng isang playerSa device na iyon lang, maliban sa galaw ng sarili niyang characterInput, camera, on-screen menus, effects para sa isang playerStarterPlayerScripts o StarterGui
ModuleScriptSa side na tumatawag ng require() para ditoKung saan umaabot ang sa script na nag-requireCode na pinagsasaluhan ng ilang scriptReplicatedStorage para sa dalawang side, ServerScriptService para sa server lang

Ano ang kayang baguhin ng exploiter

Ipagpalagay na kontrolado ng exploiter ang lahat sa device niya. Kaya niyang magpatakbo ng sarili niyang LocalScripts at baguhin ang sa iyo, kaya kaya niyang gawing transparent ang pad o kahit ano pa sa screen niya. Walang pinsala iyon dito: pang-itsura lang ang transparency at naiiwan sa device niya. Kaya nga ang Script sa server ang nagdedesisyon sa lahat ng mahalaga.

Hindi rin awtomatikong ligtas ang server Script. Tumatakbo sa server ang TouchPad, pero kontrolado ng device ng bawat player ang physics ng character niya, at kasama sa sinasabi ng security documentation ng Roblox na kayang gawin ng client sa mga part na kontrolado niya ang pagkontrol kung kailan nagfa-fire ang Touched o ang tuluyang pagharang dito. Hindi iyon mahalaga para sa umiilaw na pad. Para sa pad na nagbabayad, i-check din ang mga bagay na sinusubaybayan mismo ng server, gaya ng rule sa guide sa obby na sunod-sunod lang binibilang ang mga checkpoint.

Hakbang 5: i-test ang apat na script nang sabay

  1. Linisin ang Output gamit ang Ctrl+K (⌘K sa Mac) at pindutin ang Play (F5). Ipapakita ng Output ang walong linya ng FirstScript na may markang Server at ang Hello line mo na may markang Client. Nagpapalit ng kulay bawat segundo ang part na ColourChanger.
  2. Tumapak sa pad. Nagiging dilaw ito nang 2 segundo, at isang beses ipinapakita ng Output ang pangalan mo at "stepped on the pad". Maglakad-lakad dito: lumalabas ang bagong linya nang hindi hihigit sa isang beses bawat 2 segundo, hindi sa bawat pag-fire ng Touched.
  3. Pindutin ang E. Nagiging medyo transparent ang pad (Transparency 0.6). Pindutin ulit ang E, at hindi na ito transparent.
  4. Pindutin ang Stop. Sa testing list, piliin ang Server & Clients, mag-set ng 2 client at pindutin ang Play (o F7). Magbubukas ang Studio ng server window at dalawang client window. Sa isang client, pindutin ang E: magiging mas transparent ang pad doon, at ipapakita ito ng isa pang client at ng server na hindi transparent. Pindutin ang End Session kapag tapos ka na.
  5. Sadyang sirain ang isang bagay. Palitan ang pangalan ng Pad sa Pad2 at patakbuhin ang game. Ang pagtapak sa pad ay ginagawa pa rin itong dilaw, dahil hinahanap ng TouchPad ang part nito gamit ang script.Parent, hindi ayon sa pangalan. Ang pagpindot ng E ay wala nang ginagawa, at walang error: nagbalik ang FindFirstChild("Pad") ng nil, at tahimik na nilaktawan ng check na if pad and ... ang iba pa. Magdagdag ng print(pad) sa linya pagkatapos ng FindFirstChild, patakbuhin at pindutin ang E: ipapakita ng Output ang nil. Ang ganitong print ang pinakamabilis na paraan para maintindihan kung bakit walang ginagawa ang script. Ihinto ang game, burahin ang linya na may print at ibalik ang pangalang Pad sa part.

Saan ilalagay ang scripts

Nakadepende sa kinalalagyan ng script kung tatakbo ba ito, at hindi nagbababala ang Studio kung hindi ito kailanman tatakbo. Para sa mga susunod mong script:

Saan ilalagay ang bawat uri ng script
ContainerAno ang ilalagayBakit
ServerScriptServiceScripts na may karamihan sa mga rule ng game: rewards, rounds, savingTumatakbo sila sa server, at walang ipinapadala sa mga player mula sa ServerScriptService.
Sa loob ng part sa WorkspaceScript na para sa isang part, gaya ng ColourChanger at TouchPadOkay habang nag-aaral: ang part ay script.Parent. Para sa totoong projects, payo ng Roblox na lagyan na lang ng tags ang mga part (tingnan sa ibaba).
StarterPlayerScripts, sa loob ng StarterPlayerKaramihan sa LocalScripts: input, camera, effects para sa isang playerBawat player ay nakakakuha ng sariling kopya pagpasok.
StarterGuiLocalScripts sa loob ng ScreenGui na kumokontrol sa on-screen menuBawat player ay nakakakuha ng sariling kopya ng UI.
ReplicatedStorageModuleScripts na nire-require ng server code at ng client codeNakikita ito ng dalawang side. Ang LocalScript o Script na default ang settings ay hindi kailanman tatakbo dito.

Payo ng page ng Roblox tungkol sa script locations na huwag nang maglagay ng scripts nang direkta sa mga part sa Workspace: lagyan ng tags ang mga part at gamitin sila mula sa isang ModuleScript gamit ang CollectionService. Ang script sa loob ng part pa rin ang pinakasimpleng simula, at okay ito para sa isa o dalawang object habang nag-aaral ka. Ipinapakita ng guide sa mga pinto ang pattern na may tags, na may iisang script para sa lahat ng pinto, at nasa guide sa client at server ang buong table kung aling containers ang nagpapatakbo ng aling scripts.

Kapag may nagkamali: basahin ang Output

Pula ang mga error sa Output. Nagsisimula ang bawat isa sa kung saan ito nangyari, ang buong pangalan ng script at ang line number, saka sinasabi kung ano ang mali. I-click ang error, at bubuksan ng Studio ang script sa linyang iyon. Halimbawa, kung buburahin mo ang check na if not player sa TouchPad, at may maluwag na part na mahulog sa pad, ipapakita ng Output:

Output (halimbawa)
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'

Ang mga mali sa pagkakasulat ng code, halimbawa kulang na end, ay nakikita na bago pa pindutin ang Play: sinasalungguhitan sila ng pula ng Script Editor, at inililista sila ng Script Analysis window (button na Analysis sa tab na Script). Ang script na may ganitong error ay hindi tatakbo kahit kaunti, kahit ang mga linya sa itaas nito.

Tatlong error na dapat makilala
MensaheAno ang ibig sabihinPaano ayusin
Colour is not a valid member of Part "Workspace.Part"Walang kahit ano ang object na ito na may ganitong eksaktong pangalan. Dito, Color ang spelling ng property.Ikumpara ang spelling at malalaking titik sa Properties window o Explorer. Higit pa tungkol sa error na ito.
attempt to index nil with 'Name'May binasa ang code, dito ang .Name, mula sa value na nil. Sa halimbawa sa itaas, nil ang player dahil maluwag na part ang humawak sa pad.Alamin kung bakit nil ang value, at i-check ito gamit ang if bago gamitin. Higit pa tungkol sa error na ito.
Expected 'end' (to close 'then' at line 2), got <eof>Walang katapat na end ang if sa line 2. Para sa function, sinasabi ng mensahe ang to close 'function', at ang <eof> ay nangangahulugang dulo ng file.Idagdag ang kulang na end, batay sa linya sa loob ng parentheses, hindi sa huling linya. Minsan nagtatapos ang mensahe sa "did you forget to close ... at line N?". Hula iyon ng Luau batay sa indentation, at puwedeng maling block ang tinuturo nito, kaya i-check muna ang linya sa parentheses. Higit pa tungkol sa syntax errors.

Kung walang ginagawa ang script at wala ring laman ang Output, kadalasan nasa lugar ang script kung saan hindi ito kailanman tumatakbo, o naghihintay ito ng event na hindi nagfa-fire. Sa guide sa mga error, may checklist para sa tahimik na scripts at higit pa tungkol sa pagbasa ng Output.

Ano ang ibang ginagawa ng mga lumang scripting tutorial

Kung nag-aaral ka rin mula sa mga video at forum post, makakakita ka ng mga lumang pattern. Narito ang mahahalaga, kasama ang dahilan kung bakit problema ang bawat isa.

Mga pattern mula sa lumang tutorial at ano ang ginagawa ng guide na ito sa halip
TutorialProblemaAng guide na ito
Humihinto gamit ang wait(1)Minamarkahan ng reference ng Roblox ang global na wait() bilang deprecated at sinasabing pinalitan ito ng task.wait().task.wait(1)
Hinahanap ang character gamit ang otherPart.Parent, gaya sa lesson ng Roblox tungkol sa lavaKapag sombrero o tool sa kamay ang humawak sa part, Accessory o Tool ang otherPart.Parent, hindi ang character, kaya hindi nahahanap ang Humanoid at nawawala ang touch.FindFirstAncestorOfClass("Model"), saka GetPlayerFromCharacter
Gumagamit ng Touched nang walang debounceNagfa-fire ang Touched nang ilang beses nang sunod-sunod sa isang tapak, kaya paulit-ulit tumatakbo ang code.Flag na busy at cooldown
Naglalagay ng LocalScript sa loob ng part sa WorkspaceHindi kailanman tumatakbo doon ang LocalScript. Tumatakbo lang ito mula sa mga lugar na pag-aari ng isang player.LocalScript sa StarterPlayerScripts (bakit)
Nagsusulat ng part.Touched:connect(...) o table.getn(list)Sabi ng naming guide ng Roblox, karamihan sa mga camelCase API ay deprecated na, at Connect lang ang nakalista sa reference. Deprecated na ang table.getn pabor sa #list.:Connect(...) at #list
Binabago ang coins o nagbibigay ng damage sa LocalScriptNaiiwan ang pagbabago sa device ng player na iyon, kaya walang ibang nakakakita nito at hindi ito binibilang ng server.Mga rule ng game sa Script sa server

Practice: tatlong pagbabago na dapat subukan

Mas marami kang natututunan sa pagbabago ng code kaysa sa pagbasa nito. Subukan ang mga ito sa place mo nang isa-isa at pindutin ang Play pagkatapos ng bawat isa.

  • Pagbigayin ng point ang pad. Idagdag ang Leaderstats script mula sa hakbang 1 ng guide sa leaderboard. Saka sa TouchPad, pagkatapos ng busy = true, hanapin ang folder na leaderstats ng player at dagdagan ng 1 ang value ng Coins. Hint: player:FindFirstChild("leaderstats"), saka leaderstats:FindFirstChild("Coins"), saka coins.Value += 1. Ang coin pad sa guide sa leaderboard ang handang version, na may cooldown para sa bawat player.
  • Pabaguhin din ng transparency ang ColourChanger. Gawin na bawat segundo, binabago rin ng ColourChanger ang Transparency ng part. Hint: magdagdag ng pangalawang table ng mga numero mula 0 hanggang 1, halimbawa { 0, 0.3, 0.6 }, at i-set mula rito ang part.Transparency sa linya pagkatapos ng part.Color, gamit ang parehong index.
  • I-print ang kulay ng pad. Ipa-print sa MyFirstLocalScript ang Color ng pad kapag pinindot ang E. Hint: print(pad.Color) sa loob ng block na if pad and pad:IsA("BasePart"). Pindutin ang E habang dilaw ang pad: nakikita ng client ang kulay na sine-set ng server, dahil umaabot sa lahat ng client ang mga pagbabago sa server.

Ano ang susunod na pag-aaralan

Nagamit mo na ngayon ang mga bahagi na bumubuo sa karamihan ng game scripts. Magandang pagkakasunod-sunod pagkatapos nito:

  1. LocalScript vs Script vs ModuleScript: kung saan tumatakbo ang bawat uri ng script at ano ang kaya nitong baguhin, mas malalim kaysa sa hakbang 4.
  2. RemoteEvents: paano humihingi ang LocalScript sa server na may gawin at paano chine-check ng server ang request.
  3. Leaderboard: ang mga una mong stats, na ginagawa at binabago sa server.
  4. Ang una mong game: maikling course na may lava, coins at finish pad gamit ang dalawang server script, saka pag-publish.
  5. Pagkatapos, pumili ng system: shop GUI, round system, checkpoints sa obby, loading screen o animation sa pagpindot ng key. Kapag may nasira, tinutulungan ka ng guide sa mga error sa script na basahin ang mensahe. Nasa English pa lang ang guide sa checkpoints.

Ang sariling tutorials ng Roblox na Coding fundamentals (sa English) ay magandang dagdag sa guide na ito: anim na serye mula sa variables at functions, sa conditions, loops, arrays at dictionaries, hanggang sa pag-organize ng code sa ModuleScript, na may maliliit na project sa Studio.

Mga karaniwang error at solusyon

Karamihan sa mga problema sa unang scripts ay hindi tugmang pangalan, script na nasa maling lugar, o loop na walang wait. Panatilihing bukas ang Output habang nagte-test.

Nagha-hang o hindi na sumasagot ang Studio kapag pinindot ang Play

Walang wait ang while true do loop, kaya wala nang ibang makakatakbo. Sabi ng documentation ng Roblox, ang infinite loop na walang delay gaya ng task.wait() ay nagpapa-hang sa game at nagpapa-crash sa Studio. Maglagay ng task.wait() sa bawat infinite loop, gaya sa ColourChanger.

Walang nangyayari kapag tumapak ako sa pad

I-check na Script ang TouchPad, hindi LocalScript, na nasa direktang loob ito ng part na Pad, hindi naka-disable, at na naka-check ang property na CanTouch ng pad. Saka gawing unang linya sa loob ng onTouched ang print("touched", otherPart.Name). Kung hindi ito napi-print, hindi nagfa-fire ang event; kung napi-print, nasa ibaba ang problema.

Walang ginagawa ang pagpindot ng E

Dapat LocalScript ang MyFirstLocalScript sa loob ng StarterPlayerScripts: ang LocalScript sa Workspace o ServerScriptService ay hindi kailanman tumatakbo. Dapat eksaktong Pad ang pangalan ng part at direkta itong nasa Workspace. I-click muna ang game window at siguraduhing hindi ka nagta-type sa chat, dahil hindi pinapansin ng script ang mga key na nagamit na ng game.

Nagbabago ang part sa screen ko, pero hindi sa ibang player

LocalScript ang gumawa ng pagbabago, kaya naiwan ito sa device mo. Gawin ito sa server Script, o pahingiin ang LocalScript sa server gamit ang RemoteEvent.

Gumagana ang ColourChanger sa loob ng part, pero nasisira sa ServerScriptService

Ginagamit nito ang script.Parent bilang part nito. Sa ServerScriptService, ServerScriptService ang parent, na walang Anchored o Color, kaya nagpapakita ang Output ng error na "not a valid member". Panatilihin ito sa loob ng part, o bigyan ng pangalan ang part at hanapin ito ayon sa pangalan, halimbawa local part = workspace:WaitForChild("ColourPart") :: BasePart.

Walang ipinapakita ang Output kahit ano

I-check na bukas ang Output window (menu na Window o tab na Script) at walang naka-set na filter: puwedeng i-filter ang Output ayon sa uri ng mensahe, sa Client o Server, at sa text. Kung bukas ito at wala pa ring laman, malamang hindi tumakbo ang script. Tingnan ang checklist para sa scripts na walang ginagawa.

Kung na-stuck ka: RoCode

Kung na-stuck ka sa isang script sa place mo, kayang suriin ito ng RoCode kasama mo. Ang RoCode ay isang independent na AI agent para sa Roblox Studio, hindi galing sa Roblox: nagsusulat ka sa web chat, at ang Studio plugin nito ang gumagawa at nag-e-edit ng scripts sa Explorer mo.

Habang nag-aaral ka, kapaki-pakinabang ang Ask mode: ikaw ang nagsusulat ng scripts, at binabasa ng RoCode ang mga nandiyan na at sinasagot ang mga tanong.

Ang tina-type mo

Ipaliwanag nang linya por linya kung ano ang ginagawa ng TouchPad script sa loob ng part na Pad, at bakit ito gumagamit ng debounce.

Ang ginagawa ng RoCode
  • Sa Ask mode, mga reading tool lang ang ginagamit, halimbawa Search Scripts at Read Script, at walang binabago sa place
  • Kung may kailangang ayusin, sinasabi kung ano at saan nito babaguhin, at nagmumungkahing lumipat sa Build
  • Sa Build mode, ine-edit ang scripts sa puwesto, saka chine-check ang bawat isa gamit ang Check Script. Compile check ito, hindi type check at hindi playtest
  • Binabasa ang Output ng Studio gamit ang tool na Check Output, kasama ang mga linya ng Server at Client mula sa huli mong playtest, kahit pagkatapos pindutin ang Stop

Sa Build mode na may plugin 3.9 o mas bago, kayang magpatakbo ng RoCode ng maikling playtest at basahin ang mga error, at sa 3.9.11 o mas bago, kontrolin ang isang test character, pero hindi ito kumukuha ng screenshots habang naglalaro, kaya ikaw pa rin ang tatapak sa pad. Paano kumokonekta ang RoCode sa Studio.

Mga madalas itanong

Saan nagsusulat ng scripts sa Roblox Studio?

Sa Explorer, i-hover ang isang container, halimbawa ServerScriptService, pindutin ang + at piliin ang Script. Bubuksan ito ng Studio sa Script Editor, kung saan ka nagsusulat ng Luau. Karaniwang nasa ServerScriptService ang server scripts; ang LocalScripts ay nasa StarterPlayerScripts o StarterGui.

Paano patakbuhin ang script sa Roblox Studio?

Pindutin ang Play (F5). Magsisimula ang Studio ng playtest, at bawat naka-enable na Script sa ServerScriptService o Workspace ay tatakbo agad pagsimula ng game; ang LocalScripts sa StarterPlayerScripts ay tatakbo kapag pumasok ka sa playtest. Ang Run (piliin sa listahan katabi ng Play o pindutin ang F8) ay nagpapatakbo ng game nang walang avatar, kaya Play ang gamitin para sa guide na ito. Tinatapos ng Stop (Shift+F5) ang test. Para buksan ang dati nang script, i-double click ito sa Explorer.

Anong programming language ang gamit ng Roblox?

Luau. Inilalarawan ito ng Roblox bilang mabilis, maliit, ligtas na scripting language na may gradual typing, na nagmula sa Lua 5.1, kaya kapaki-pakinabang pa rin ang karamihan sa mga Lua tutorial. Nagdadagdag ang Luau ng mga feature gaya ng string interpolation sa backticks at opsyonal na type annotations, at nagdadagdag ang Roblox ng sarili nitong libraries at objects, halimbawa task.wait.

Ano ang pagkakaiba ng Script at LocalScript?

Tumatakbo ang Script sa server, at umaabot ang mga pagbabago nito sa lahat ng player. Tumatakbo ang LocalScript sa device ng isang player, para sa input, camera at on-screen menus, at naiiwan sa device na iyon ang mga binago nito sa parts, values at UI. Tinatalakay ng guide sa client at server (sa English) ang dalawa, kasama ang ModuleScript.

Puwede bang mag-script sa Roblox Studio sa phone o iPad?

Inilalarawan ng install page ng Roblox ang Studio bilang libreng app para sa Windows at Mac at walang binabanggit na version para sa phone o tablet, kaya kailangan ng computer para sa scripts.

Bakit walang ginagawa ang script ko at walang error na lumalabas?

Kadalasan nasa lugar ito kung saan hindi tumatakbo ang ganitong script (LocalScript sa Workspace o Script sa StarterPlayerScripts), naka-disable ito, o hindi nagfa-fire ang event na hinihintay nito. May checklist sa guide sa mga error.

Gaano katagal bago matutunan ang scripting sa Roblox?

Walang makapagbibigay ng tapat na numero: depende ito sa kung gaano ka kadalas mag-build. Pinakamakakatulong ang madalas na pagsusulat ng maliliit na script sa sarili mong place. Baguhin ang apat na script dito, subukan ang mga practice task, saka daanan ang guide sa unang game at magdagdag ng isang system sa bawat pagkakataon.

Mga source at dagdag na babasahin

Paano sinuri ang code: bawat script sa page na ito ay dumaan sa strict Luau type check gamit ang mga definition ng Roblox API (luau-lsp, Nobyembre 20, 2026). Nahuhuli ng type check ang maling pangalan ng API at maling type, pero hindi ang mga mali sa game logic, kaya i-test muna ang lahat sa Studio bago mag-publish.

Subukan ang RoCode sa sarili mong game.

Libreng credits araw-araw, walang card. I-install ang plugin, ilarawan ang feature, at tingnan kung ano ang lumabas sa Studio.