Tutoriaali · Skriptauksen perusteet

Miten kirjoittaa skriptejä Roblox Studiossa: opas aloittelijoille

Skriptaus eli ohjelmointi Roblox Studiossa tarkoittaa Luaun kirjoittamista, Robloxin version Lua-kielestä, skripteihin, jotka lisäät placeen. Tämä opas alkaa tyhjästä Baseplatesta: avaat Output-ikkunan, kirjoitat ensimmäisen skriptisi, muutat partia koodista, reagoit pelaajaan, joka astuu alustalle, ja kokeilet LocalScriptiä, ja matkan varrella opit muuttujat, funktiot, ehdot, silmukat ja tapahtumat.

Päivitetty 20. marraskuuta 202616 min lukuaikaKirjoittaja:

Lyhyesti

Kirjoittaaksesi skriptin Roblox Studiossa vie osoitin Explorerissa ServerScriptServicen päälle, paina + ja lisää Script. Studio avaa sen Script Editorissa. Kirjoita Luauta, esimerkiksi print("Hello"), paina Play (F5) ja lue tulos Output-ikkunasta (Window-valikko tai Script-välilehti). Script suoritetaan palvelimella ja muuttaa kaiken kaikille; LocalScript StarterPlayerScriptsissä suoritetaan yhden pelaajan laitteella.

  • Opettele ensin neljä ajatusta: muuttujat (local coins = 3), funktiot (local function name() ... end), if-ehdot ja tapahtumat (part.Touched:Connect(...)). Tämän oppaan neljä skriptiä on rakennettu niistä, sekä silmukoista ja taulukoista.
  • Käytä task.wait()-funktiota, älä wait()-funktiota. Robloxin hakuteos merkitsee globaalin wait()-funktion vanhentuneeksi ja korvatuksi task.wait()-funktiolla.
  • Ota Output-ikkunan näyttöasetuksista käyttöön Show Context, jotta jokainen rivi näyttää, tuliko se Serveriltä vai Clientiltä.
Tällä sivulla
  1. Ennen aloitusta
  2. 1. Ensimmäinen skripti
  3. 2. Partin muuttaminen
  4. 3. Tapahtumat
  5. 4. Ensimmäinen LocalScript
  6. 5. Testi
  7. Minne skriptit laitetaan
  8. Virheiden lukeminen
  9. Vanhat tutoriaalit
  10. Harjoitus
  11. Mitä seuraavaksi
  12. Common errors
  13. RoCodella
  14. Usein kysytyt kysymykset
  15. Lähteet ja lisälukemista

Ennen aloitusta: Studio, Baseplate ja Output-ikkuna

HavainnollistusNeljä skriptiä yhdessä testipelissä: ColourChanger-part vaihtaa väriä joka sekunti, askel Padille tekee siitä keltaisen 2 sekunniksi kaikille pelaajille ja kirjoittaa nimesi Outputiin, ja E tekee Padista läpikuultavamman vain tällä näytöllä.

Tarvitset Roblox Studion ja Roblox-tilin, etkä mitään muuta: et koodieditoria etkä lisäosaa. Jokainen tämän oppaan skripti kirjoitetaan Studion omassa Script Editorissa.

  1. Asenna Roblox Studio, Robloxin ilmainen sovellus Windowsille ja Macille, ja kirjaudu Roblox-tililläsi.
  2. Avaa Studio. Aloitussivulla on pohjia: valitse Baseplate. Saat lattian 4x4-ruudukkotekstuurilla ja SpawnLocationin, paikan, johon avatarisi ilmestyy pelatessa.
  3. Jos Explorer- ja Properties-ikkunat eivät näy, avaa ne Window-valikosta tai Home-välilehdeltä. Explorer luettelee kaikki placen objektit; Properties näyttää valitun objektin asetukset.
  4. Avaa Output Window-valikosta tai Script-välilehdeltä. Tänne ilmestyvät skriptiesi viestit ja virheet.
  5. Ota Output-ikkunan näyttöasetuksista käyttöön Show Context, joka merkitsee jokaisen viestin Clientiksi tai Serveriksi, ja Show Source, joka näyttää skriptin ja rivinumeron, josta viesti tuli.
Neljä skriptiä, jotka kirjoitat
SkriptiTyyppiMissä se onMitä se opettaa
FirstScriptScriptServerScriptServiceMuuttujat, funktio, if-ehto, silmukat ja taulukko
ColourChangerScriptPartin sisällä WorkspacessaOminaisuuksien muuttaminen, script.Parent ja silmukka odotuksella
TouchPadScriptPad-nimisen Partin sisälläTapahtumat, partiin koskeneen pelaajan etsiminen ja debounce
MyFirstLocalScriptLocalScriptStarterPlayerScripts, StarterPlayerin sisälläKoodi yhden pelaajan laitteella, näppäinpainallukset ja se, mikä jää tälle laitteelle
Explorer lopussa (vain tämän oppaan objektit)
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

Vaihe 1: kirjoita ensimmäinen skriptisi

  1. Vie Explorerissa osoitin ServerScriptServicen päälle, paina + ja valitse Script (pikanäppäin Ctrl+I tai ⌘I Macilla). Studio luo skriptin ja avaa sen Script Editorissa.
  2. Napsauta uutta skriptiä hiiren oikealla painikkeella, valitse Rename ja anna nimeksi FirstScript. Nimi ei muuta sitä, mitä skripti tekee, mutta kertoo, mikä skripti tulosti mitäkin.
  3. Uudet skriptit alkavat yhdellä rivillä, print("Hello world!"). Poista se ja liitä alla oleva koodi.
  4. Paina Play (F5), kun sen vasemmalla puolella olevasta listasta on valittu Test. Studio käynnistää testipelin ja asettaa avatarin SpawnLocationille.
  5. Lue Outputin rivit ja paina sitten Stop (Shift+F5). Stop myös palauttaa kaikki objektit tilaan, jossa ne olivat ennen Playn painamista, joten kaikki, mitä siirsit tai värjäsit pelin aikana, palaa ennalleen.
Script kohteessa ServerScriptService nimeltä FirstScript
-- Script ServerScriptServicessä, nimeltään FirstScript.
-- Ensimmäinen Luausi: muuttujat, funktio, if-ehto, silmukka ja taulukko.
-- Paina Play (F5) ja lue tulos Output-ikkunasta.

-- Muuttuja on nimi, joka säilyttää arvon
local gameName = "Coin Run"
local coinsToWin = 3

-- Funktio on nimetty koodilohko, jonka voi suorittaa niin monta kertaa kuin haluaa.
-- name ja goal ovat sen parametreja; return palauttaa arvon sille, joka sitä kutsui.
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-ehto suorittaa koodin vain, kun ehto on tosi
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-silmukka toistaa koodia annetun määrän kertoja
for count = 1, coinsToWin do
	print("Coin number", count)
end

-- Taulukko säilyttää listan arvoja; tämä silmukka käy ne läpi järjestyksessä
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
	print(position, colour) --> 1 Red, sitten 2 Green, sitten 3 Blue
end

Kaikki rivillä ---merkkien jälkeen on kommentti: Luau ohittaa sen, joten voit jättää itsellesi muistiinpanoja. -->-kommentit näyttävät, mitä rivi tulostaa.

Outputin pitäisi näyttää nämä kahdeksan riviä Studion omien viestien seassa. Kun print saa useita arvoja, se laittaa niiden väliin välilyönnin. Kun Show Context ja Show Source ovat päällä, jokaisessa rivissä on lisäksi merkintä Server ja FirstScript rivinumeroineen.

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

Yhdistä jokainen rivi koodiin, joka sen tulosti. Myöhemmin teet saman virheilmoitusten kanssa, joten tottumuksesta on hyötyä.

FirstScript käyttää vain puhdasta Luauta ilman Roblox-objekteja, joten se toimii myös selaimessa toimivassa ilmaisessa Luau-hiekkalaatikossa. Vaihda siellä jokin arvo ja aja uudelleen nähdäksesi, mikä muuttuu.

Mitä FirstScriptin kukin osa tekee
KoodiAjatusMitä se tarkoittaa
local gameName = "Coin Run"MuuttujaNimi, joka säilyttää arvon. local tarkoittaa, että sitä voi käyttää vain tämä skripti tai lohko, jossa se on. Lainausmerkeissä oleva teksti on merkkijono; 3 on luku. Nimissä isot ja pienet kirjaimet erotellaan, joten coinsToWin ja CoinsToWin ovat kaksi eri muuttujaa.
local function describe(name: string, goal: number): stringFunktioNimetty koodilohko, jonka voi suorittaa niin monta kertaa kuin haluaa. name ja goal ovat sen parametreja: arvoja, jotka välitetään jokaisessa kutsussa. : string ja : number ovat valinnaisia tyyppimerkintöjä. Luau käyttää niitä varoittaakseen virheistä Script Editorissa; ilman niitä koodi toimii samoin.
returnPaluuarvoAntaa arvon koodille, joka kutsui funktiota. print(describe(gameName, coinsToWin)) tulostaa sen, minkä describe palauttaa.
`{name}: collect {goal} coins to win`MerkkijonointerpolaatioTakahipsuissa oleva teksti voi sisältää arvoja: Luau korvaa {name}- ja {goal}-kohdat niiden nykyisillä arvoilla.
if, elseif, else, endIf-ehtoLuau tarkistaa ehdot ylhäältä alas ja suorittaa vain ensimmäisen toden. coinsToWin on 3, mikä ei ole suurempi kuin 5 mutta on suurempi kuin 1, joten vain «That is a short game» tulostetaan.
for count = 1, coinsToWin doNumeerinen for-silmukkaSuorittaa sisällä olevan koodin kerran jokaiselle luvulle 1:stä coinsToWin-arvoon, jolloin count on 1, sitten 2, sitten 3.
{ "Red", "Green", "Blue" } ja for position, colour in colours doTaulukko ja silmukkaTaulukko listana, Luau kutsuu tätä arrayksi. Paikat alkavat 1:stä eivätkä 0:sta. Silmukka käy läpi jokaisen alkion ja antaa sen paikan ja arvon.

Jokainen lohko, joka alkaa sanalla function, if, for tai while, suljetaan sanalla end. Yksi puuttuva end estää koko skriptin käynnistymisen; osio virheiden lukeminen näyttää, minkä viestin saat.

Vaihe 2: muuta partia skriptistä

Skripteistä tulee hyödyllisiä, kun ne muuttavat jotain maailmassa. Asetukset, jotka näet Properties-ikkunassa, esimerkiksi partin Color, Transparency tai Anchored, ovat ominaisuuksia, ja skripti voi myös asettaa niitä.

  1. Paina Home-välilehdellä Part. Studio lisää palikan Workspaceen. Sen nimellä ei ole väliä.
  2. Vie Explorerissa osoitin uuden partin päälle, paina + ja lisää Script. Nimeä se uudelleen ColourChanger ja korvaa sen sisältö alla olevalla koodilla.
  3. Paina Play. Part muuttuu punaiseksi, sitten siniseksi, sitten vihreäksi, vaihtuen kerran sekunnissa, ja aloittaa alusta.
Script kohteessa missä tahansa partissa Workspacessa nimeltä ColourChanger
-- Script Partin sisällä Workspacessa, nimeltään ColourChanger.
-- Skriptit muuttavat samoja ominaisuuksia, jotka näkyvät Properties-ikkunassa.
-- Tämä antaa partilleen uuden värin joka sekunti, kaikille pelaajille.

local part = script.Parent :: BasePart -- part, jonka sisällä tämä skripti on

local colours = {
	Color3.fromRGB(255, 85, 85), -- punainen
	Color3.fromRGB(85, 170, 255), -- sininen
	Color3.fromRGB(85, 255, 127), -- vihreä
}

part.Anchored = true -- ankkuroitu part pysyy siellä, mihin sen laitoit

local index = 1
while true do
	part.Color = colours[index]
	index = index % #colours + 1 -- 1, 2, 3, sitten taas 1
	task.wait(1) -- tauko yhdeksi sekunniksi (vanha wait() on vanhentunut)
end
  • script.Parent on objekti, jonka sisällä skripti on, tässä part. Vedä skripti toiseen partiin, niin se muuttaa sitä.
  • :: BasePart on tyyppimuunnos. Se kertoo Script Editorille, että vanhempi on part, jotta käytetyt ominaisuudet voidaan tarkistaa. Luau käyttää tyyppejä vain varoituksiin ja vihjeisiin, joten muunnos ei muuta sitä, mitä rivi tekee.
  • part.Color ja part.Anchored ovat samoja ominaisuuksia kuin Properties-ikkunassa, samoilla nimillä. Roblox käyttää amerikkalaista kirjoitusasua, joten ominaisuuden nimi on Color, vaikka skriptin nimi on ColourChanger.
  • Anchored = true pitää partin paikallaan: Robloxin hakuteoksen mukaan ankkuroitu part ei koskaan liiku painovoiman, törmäysten tai muun fysiikan vuoksi.
  • colours[index] lukee listasta yhden alkion. #colours on listan pituus, 3, ja % antaa jakojäännöksen, joten index % #colours + 1 laskee 1, 2, 3, 1, 2, 3.
  • while true do toistuu loputtomasti, joten sen sisällä oleva task.wait(1) on niin tärkeä. Robloxin dokumentaatio käskee aina laittamaan loputtomaan silmukkaan viiveen, kuten task.wait(): ilman sitä peli jumiutuu ja Studio kaatuu.

ColourChanger on Script, joten se toimii palvelimella, ja kaikki pelaajat näkevät saman värin samaan aikaan. Vaihe 4 näyttää toisenlaisen skriptin.

Vaihe 3: reagoi pelaajaan tapahtuman avulla

Suurin osa pelikoodista odottaa, että jotain tapahtuu: pelaaja liittyy, partiin kosketaan, painiketta painetaan. Roblox kutsuu näitä tapahtumiksi. Jotta koodi suoritetaan tapahtuman lauetessa, siihen yhdistetään funktio.

  1. Lisää vielä yksi Part ja nimeä se täsmälleen Pad, isolla P:llä. Jätä se suoraan Workspaceen, ei kansioon eikä malliin, koska vaiheen 4 LocalScript etsii sitä sieltä.
  2. Tee siitä tasainen alusta, jolle voi astua, esimerkiksi asettamalla Size-arvoksi 6, 1, 6 Properties-ikkunassa. Sijoita se lattialle SpawnLocationin viereen ja rastita Anchored, jotta se ei liiku.
  3. Vie osoitin Padin päälle, paina +, lisää Script, nimeä se uudelleen TouchPad ja liitä alla oleva koodi.
  4. Paina Play ja astu alustalle. Se muuttuu keltaiseksi 2 sekunniksi, ja Output kertoo nimesi.
Script kohteessa Workspace.Pad nimeltä TouchPad
-- Script Pad-nimisen Partin sisällä Workspacessa, skriptin nimi TouchPad.
-- Tapahtumat: kun pelaaja astuu alustalle, se hehkuu keltaisena, ja Output kirjoittaa, kuka se oli.
-- Debounce estää koodia laukeamasta monta kertaa sekunnissa, kun pelaaja seisoo sen päällä.

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 -- edellisen kosketuksen jäähdytys on yhä käynnissä
	end
	-- Hahmo on Model, jossa on alustaan koskenut ruumiinosa (tai hattu)
	local character = otherPart:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	if not player then
		return -- koski irrallinen part tai NPC eikä pelaaja
	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)
Miten TouchPad pääsee kosketuksesta pelaajaan
KoodiMitä se tekee
pad.Touched:Connect(onTouched)Yhdistää funktion alustan Touched-tapahtumaan, joten Roblox suorittaa onTouched-funktion aina, kun jokin koskee alustaan, ja välittää koskeneen partin.
otherPartPart, joka koski alustaan: jalkaterä, jalka, hatun kahva tai pelaajan kädessä oleva työkalu. Se ei koskaan ole itse pelaaja, joten kaksi seuraavaa riviä selvittävät, kenelle se kuuluu.
otherPart:FindFirstAncestorOfClass("Model")Nousee tästä partista ensimmäiseen esivanhempaan, jonka luokka on täsmälleen Model, eli hahmoon. Koska luokan nimen on vastattava täsmälleen, se ohittaa hatun (luokka Accessory) ja kädessä olevan työkalun (luokka Tool).
Players:GetPlayerFromCharacter(character)Palauttaa Playerin, jonka hahmo tämä on, tai nil, jos hahmo ei kuulu kenellekään, esimerkiksi NPC. Edessä oleva character and ohittaa kutsun, jos mallia ei löytynyt, ja player jää nil-arvoksi.
if not player then return endPysähtyy tähän kaiken sellaisen kohdalla, mikä ei ole pelaaja. return poistuu funktiosta etuajassa.

Miksi alusta tarvitsee debouncen

Robloxin debounce-sivu varoittaa, että Touched laukeaa useita kertoja peräkkäin, kun partit koskettavat toisiaan, ja kävelevällä hahmolla on useita ruumiinosia. Ilman tarkistusta yksi askel alustalle voisi tulostaa monta riviä ja käynnistää keltaisen hehkun yhä uudelleen.

Muuttuja busy on juuri debounce. Ensimmäinen kosketus asettaa sen arvoon true, ja jokainen kosketus seuraavien 2 sekunnin aikana päätyy kohtaan if busy then return end ja pysähtyy. task.wait(COOLDOWN_SECONDS)-kutsun jälkeen alusta palauttaa värinsä, ja busy on taas false. COOLDOWN_SECONDS on kirjoitettu isoilla kirjaimilla, koska se on asetus, joka ei muutu pelin aikana: näin Roblox neuvoo nimeämään vakiot.

Tällä alustalla on yksi yhteinen debounce kaikille, joten toinen pelaaja, joka astuu sille näiden 2 sekunnin aikana, ohitetaan. Hehkuvalle alustalle se on kunnossa. Palkintoja jakavan alustan pitää pitää jäähdytystä jokaiselle pelaajalle erikseen, kuten kolikkoalusta tulostaulukko-oppaassa.

Vaihe 4: ensimmäinen LocalScript ja miten se eroaa

Käynnissä oleva peli on yksi palvelin sekä yksi asiakas jokaista pelaajaa kohden. Kaikki tähän asti on ollut Scriptiä, joka toimii palvelimella, joten sen muutokset päätyvät kaikille pelaajille. LocalScript toimii yhden pelaajan laitteella. Näppäinpainallukset, kamera ja näytön valikot käsitellään siellä, koska vain tämä laite tietää niistä.

  1. Avaa Explorerissa StarterPlayer, vie osoitin StarterPlayerScriptsin päälle, paina + ja lisää LocalScript. Nimeä se uudelleen MyFirstLocalScript ja liitä alla oleva koodi.
  2. Paina Play. Output näyttää Hello, ja nimesi merkinnällä Client.
  3. Napsauta peli-ikkunaa ja paina E. Alusta muuttuu läpikuultavammaksi. Paina E uudelleen palauttaaksesi sen.
  4. Kun testipeli on käynnissä, paina Studion testausohjaimissa olevaa Client/Server-kytkintä siirtyäksesi pelin palvelinkopioon. Siellä alusta on läpinäkymätön: palvelin ei saanut tietää muutoksesta mitään.
LocalScript kohteessa StarterPlayerScripts nimeltä MyFirstLocalScript
-- LocalScript kohteessa StarterPlayer > StarterPlayerScripts, nimeltään MyFirstLocalScript.
-- LocalScript toimii yhden pelaajan laitteella. Paina E: Pad muuttuu läpikuultavammaksi vain
-- sinun näytölläsi, koska täältä tehty partin muutos ei päädy palvelimelle eikä muille.

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

local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- näkyy Outputissa merkinnällä Client

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	if gameProcessed then
		return -- näppäin meni muuhun, esimerkiksi tekstin kirjoittamiseen chattiin
	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 on pelaaja, jonka laitteella skripti toimii. Roblox määrittää sen vain LocalScripteille ja ModuleScripteille, jotka ne ottavat käyttöön, joten palvelimen koodi ei voi käyttää sitä.
  • UserInputService.InputBegan laukeaa, kun pelaaja aloittaa näppäimen painalluksen, napsautuksen tai kosketuksen. gameProcessed on true, kun moottori on jo käyttänyt tämän syötteen, esimerkiksi painikkeen napsautuksen tai näppäimen chatin rivillä, joten skripti ohittaa sen.
  • workspace:FindFirstChild("Pad") palauttaa Pad-nimisen jälkeläisen tai nil, jos sitä ei ole. pad:IsA("BasePart") tarkistaa, että se todella on part, ennen kuin skripti muuttaa sen Transparency-arvoa.
  • if pad.Transparency == 0 then 0.6 else 0 on if-lauseke: se valitsee toisen kahdesta arvosta. Transparency 0 tarkoittaa täysin näkyvää, 1 näkymätöntä.
  • Shift-juoksuskripti on hyvä toinen LocalScript: se kuuntelee näppäintä ja muuttaa hahmon WalkSpeediä.
Script, LocalScript ja ModuleScript
TyyppiMissä toimiiMihin muutokset päätyvätMihinYleensä sijaitsee
ScriptPalvelimellaKaikille pelaajillePelin säännöt: kolikot, vahinko, ovet, kierrokset, tallennusServerScriptService tai partin sisällä, kun opettelet
LocalScriptYhden pelaajan laitteellaVain tälle laitteelle, paitsi oman hahmon liikeSyöte, kamera, näytön valikot, tehosteet yhdelle pelaajalleStarterPlayerScripts tai StarterGui
ModuleScriptSillä puolella, joka kutsuu sille require()Samaan paikkaan kuin käyttöön ottaneen skriptin muutoksetKoodi, joka on yhteinen useille skripteilleReplicatedStorage molemmille puolille, ServerScriptService vain palvelimelle

Mitä huijari voi muuttaa

Oleta, että huijari hallitsee kaikkea omalla laitteellaan. Hän voi ajaa omia LocalScriptejään ja muuttaa sinun skriptejäsi, joten hän voi tehdä alustasta tai mistä tahansa muusta läpinäkyvän omalla näytöllään. Tässä se on harmitonta: läpinäkyvyys on vain ulkonäköä ja jää hänen laitteelleen. Juuri siksi kaiken tärkeän päättää palvelimen Script.

Palvelimen Scriptkään ei ole automaattisesti turvallinen. TouchPad toimii palvelimella, mutta jokaisen pelaajan laite ohjaa hänen hahmonsa fysiikkaa, ja Robloxin tietoturvadokumentaatio mainitsee asioiden joukossa, joita asiakas voi tehdä hallitsemillaan parteilla, Touched-tapahtuman laukeamishetken ohjaamisen tai sen täydellisen estämisen. Hehkuvalle alustalle sillä ei ole väliä. Maksavan alustan kohdalla tarkista lisäksi se, mitä palvelin seuraa itse, kuten obby-oppaan sääntö, että tarkistuspisteet hyväksytään vain järjestyksessä.

Vaihe 5: testaa kaikki neljä skriptiä yhdessä

  1. Tyhjennä Output painamalla Ctrl+K (⌘K Macilla) ja paina Play (F5). Output näyttää FirstScriptin kahdeksan riviä merkinnällä Server ja Hello-rivisi merkinnällä Client. ColourChanger-part vaihtaa väriä joka sekunti.
  2. Astu alustalle. Se muuttuu keltaiseksi 2 sekunniksi, ja Output näyttää kerran nimesi ja «stepped on the pad». Kävele sen päällä: uusi rivi ilmestyy enintään kerran 2 sekunnissa eikä jokaisella Touchedin laukeamisella.
  3. Paina E. Alusta muuttuu puoliläpinäkyväksi (Transparency 0.6). Paina E uudelleen, niin se on läpinäkymätön.
  4. Paina Stop. Valitse testauslistasta Server & Clients, aseta 2 asiakasta ja paina Play (tai F7). Studio avaa palvelinikkunan ja kaksi asiakasikkunaa. Paina yhdessä asiakkaassa E: alusta muuttuu siellä läpikuultavammaksi, mutta toinen asiakas ja palvelin näyttävät sen läpinäkymättömänä. Paina End Session, kun olet valmis.
  5. Riko jotain tahallaan. Nimeä Pad uudelleen Pad2 ja käynnistä peli. Askel alustalle tekee siitä yhä keltaisen, koska TouchPad löytää partinsa script.Parent-viittauksella eikä nimen perusteella. E:n painaminen ei nyt tee mitään, eikä virhettä tule: FindFirstChild("Pad") palautti nil, ja tarkistus if pad and ... ohitti hiljaa loput. Lisää print(pad) FindFirstChild-kutsun jälkeiselle riville, käynnistä ja paina E: Output näyttää nil. Tällainen print on nopein tapa ymmärtää, miksi skripti ei tee mitään. Pysäytä peli, poista print-rivi ja palauta partin nimeksi Pad.

Minne skriptit laitetaan

Skriptin sijainnista riippuu, käynnistyykö se ylipäätään, eikä Studio varoita, jos se ei käynnisty koskaan. Seuraavia skriptejäsi varten:

Minne kukin skriptityyppi laitetaan
SäiliöMitä sinne laitetaanMiksi
ServerScriptServiceSkriptit, joissa on useimmat pelin säännöt: palkinnot, kierrokset, tallennusNe toimivat palvelimella, eikä mitään ServerScriptServicestä lähetetä pelaajille.
Partin sisällä WorkspacessaScript, joka liittyy yhteen partiin, kuten ColourChanger ja TouchPadKelpaa, kun opettelet: part on script.Parent. Oikeissa projekteissa Roblox neuvoo sen sijaan merkitsemään partit tageilla (katso alla).
StarterPlayerScripts, StarterPlayerin sisälläUseimmat LocalScriptit: syöte, kamera, tehosteet yhdelle pelaajalleJokainen pelaaja saa oman kopionsa liittyessään.
StarterGuiLocalScriptit ScreenGuin sisällä, jotka ohjaavat näytön valikkoaJokainen pelaaja saa oman kopionsa käyttöliittymästä.
ReplicatedStorageModuleScriptit, jotka sekä palvelimen että asiakkaan koodi ottaa käyttöönMolemmat puolet näkevät sen. LocalScript tai Script oletusasetuksilla ei koskaan käynnisty täällä.

Robloxin skriptien sijainteja käsittelevä sivu neuvoo olemaan laittamatta skriptejä suoraan Workspacen partteihin lainkaan: merkitse partit tageilla ja käsittele niitä yhdestä ModuleScriptistä CollectionService-palvelulla. Skripti partin sisällä on silti yksinkertaisin alku, ja yhdelle tai kahdelle objektille se on kunnossa, kun opettelet. Ovi-opas näyttää tagimallin, jossa yksi skripti hoitaa kaikki ovet, ja asiakas ja palvelin -oppaassa on täysi taulukko siitä, mitkä säiliöt käynnistävät mitkäkin skriptit.

Kun jokin menee vikaan: lue Output

Virheet näkyvät Outputissa punaisella. Jokainen alkaa sillä, missä se tapahtui, skriptin täydellä nimellä ja rivinumerolla, ja kertoo sitten, mikä on vialla. Napsauta virhettä, niin Studio avaa skriptin tältä riviltä. Jos esimerkiksi poistat if not player -tarkistuksen TouchPadista ja alustalle putoaa irrallinen part, Output näyttää:

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

Virheet koodin kirjoitusasussa, esimerkiksi puuttuva end, näkyvät jo ennen Playn painamista: Script Editor alleviivaa ne punaisella, ja Script Analysis -ikkuna (Analysis-painike Script-välilehdellä) luettelee ne. Skripti, jossa on tällainen virhe, ei käynnisty lainkaan, eivät edes sen yläpuolella olevat rivit.

Kolme virhettä, jotka kannattaa tunnistaa
ViestiMitä se tarkoittaaMiten korjata
Colour is not a valid member of Part "Workspace.Part"Tällä objektilla ei ole mitään tällä täsmällisellä nimellä. Tässä ominaisuus kirjoitetaan Color.Vertaa kirjoitusasua ja isoja kirjaimia Properties-ikkunaan tai Exploreriin. Lisää tästä virheestä.
attempt to index nil with 'Name'Koodi luki jotain, tässä .Name, arvosta nil. Yllä olevassa esimerkissä player oli nil, koska alustaan koski irrallinen part.Selvitä, miksi arvo on nil, ja tarkista se if-lauseella ennen käyttöä. Lisää tästä virheestä.
Expected 'end' (to close 'then' at line 2), got <eof>Rivin 2 if-lauseelta puuttuu pari-end. Funktion kohdalla viesti sanoo to close 'function', ja <eof> tarkoittaa tiedoston loppua.Lisää puuttuva end suluissa mainitun rivin mukaan, ei viimeisen. Joskus viesti päättyy lauseeseen «did you forget to close ... at line N?». Se on Luaun arvaus sisennysten perusteella, ja se voi osoittaa väärään lohkoon, joten tarkista ensin suluissa oleva rivi. Lisää syntaksivirheistä.

Jos skripti ei tee mitään ja Outputkin on tyhjä, skripti on yleensä paikassa, jossa se ei koskaan käynnisty, tai odottaa tapahtumaa, joka ei laukea. Virheoppaassa on tarkistuslista hiljaisille skripteille ja lisää Outputin lukemisesta.

Mitä vanhat skriptaustutoriaalit tekevät toisin

Jos opettelet myös videoista ja foorumiviesteistä, kohtaat vanhoja malleja. Tässä tärkeimmät, ja syy, miksi kukin niistä on ongelma.

Vanhojen tutoriaalien mallit ja mitä tämä opas tekee niiden sijaan
TutoriaaliOngelmaTämä opas
Pitää tauon wait(1)-kutsullaRobloxin hakuteos merkitsee globaalin wait()-funktion vanhentuneeksi ja kertoo, että task.wait() korvasi sen.task.wait(1)
Löytää hahmon otherPart.Parent-viittauksella, kuten Robloxin laavaoppitunnissaKun partiin koskee hattu tai kädessä oleva työkalu, otherPart.Parent on Accessory tai Tool eikä hahmo, joten Humanoidia ei löydy ja kosketus menetetään.FindFirstAncestorOfClass("Model"), sitten GetPlayerFromCharacter
Käyttää Touched-tapahtumaa ilman debounceaTouched laukeaa useita kertoja peräkkäin yhdestä askeleesta, joten koodi suoritetaan yhä uudelleen.busy-lippu ja jäähdytys
Laittaa LocalScriptin Workspacen partin sisäänLocalScript ei koskaan käynnisty siellä. Se toimii vain paikoista, jotka kuuluvat yhdelle pelaajalle.LocalScript StarterPlayerScriptsissä (miksi)
Kirjoittaa part.Touched:connect(...) tai table.getn(list)Robloxin nimeämisopas sanoo, että camelCase-API:t ovat enimmäkseen vanhentuneita, ja hakuteos luettelee vain Connect-muodon. table.getn on vanhentunut, ja sen tilalla on #list.:Connect(...) ja #list
Muuttaa kolikoita tai tekee vahinkoa LocalScriptissäMuutos jää tämän pelaajan laitteelle, joten kukaan muu ei näe sitä, eikä palvelin ota sitä huomioon.Pelin säännöt palvelimen Scriptissä

Harjoitus: kolme muutosta, joita kannattaa kokeilla

Koodin muuttaminen opettaa enemmän kuin sen lukeminen. Kokeile näitä omassa placessasi yksi kerrallaan ja paina Playta jokaisen jälkeen.

  • Anna alustan antaa piste. Lisää Leaderstats-skripti tulostaulukko-oppaan vaiheesta 1. Etsi sitten TouchPadissa busy = true -rivin jälkeen pelaajan leaderstats-kansio ja lisää 1 Coins-arvoon. Vihje: player:FindFirstChild("leaderstats"), sitten leaderstats:FindFirstChild("Coins"), sitten coins.Value += 1. Tulostaulukko-oppaan kolikkoalusta on valmis versio, jossa jäähdytys on pelaajakohtainen.
  • Anna ColourChangerin muuttaa myös läpinäkyvyyttä. Tee ColourChangerista sellainen, että se muuttaa joka sekunti myös partin Transparency-arvoa. Vihje: lisää toinen taulukko lukuja väliltä 0-1, esimerkiksi { 0, 0.3, 0.6 }, ja aseta siitä part.Transparency part.Color-rivin jälkeisellä rivillä samalla index-arvolla.
  • Tulosta alustan väri. Anna MyFirstLocalScriptin tulostaa alustan Color, kun E:tä painetaan. Vihje: print(pad.Color) if pad and pad:IsA("BasePart") -lohkon sisällä. Paina E, kun alusta on keltainen: asiakas näkee palvelimen asettaman värin, koska palvelimen muutokset päätyvät kaikille asiakkaille.

Mitä opetella seuraavaksi

Olet nyt käyttänyt osia, joista useimmat peliskriptit on rakennettu. Hyvä järjestys tästä eteenpäin:

  1. LocalScript vs Script vs ModuleScript: missä kukin skriptityyppi toimii ja mitä se voi muuttaa, syvemmin kuin vaiheessa 4.
  2. RemoteEvents: miten LocalScript pyytää palvelinta tekemään jotain ja miten palvelin tarkistaa pyynnön.
  3. Tulostaulukko: ensimmäiset tilastosi, jotka luodaan ja joita muutetaan palvelimella.
  4. Ensimmäinen pelisi: lyhyt rata, jossa on laavaa, kolikoita ja maalialusta kahdella palvelinskriptillä, ja sitten julkaisu.
  5. Valitse sitten järjestelmä: kaupan GUI, kierrosjärjestelmä, tarkistuspisteet obbyssa, latausnäyttö tai animaatio näppäimen painalluksesta. Kun jokin hajoaa, skriptivirheiden opas auttaa lukemaan viestin. Tarkistuspisteopas on toistaiseksi englanniksi.

Robloxin omat tutoriaalit Coding fundamentals (englanniksi) täydentävät tätä opasta hyvin: kuusi osaa muuttujista ja funktioista ehtojen, silmukoiden, arrayden ja sanakirjojen kautta koodin järjestämiseen ModuleScripteihin, pienillä projekteilla Studiossa.

Yleiset virheet ja ratkaisut

Useimmat ongelmat ensimmäisten skriptien kanssa ovat nimi, joka ei täsmää, skripti väärässä paikassa tai silmukka ilman odotusta. Pidä Output auki testin aikana.

Studio jumiutuu tai lakkaa vastaamasta, kun painan Playta

while true do -silmukassa ei ole odotusta, joten mikään muu ei pääse suoritukseen. Robloxin dokumentaation mukaan loputon silmukka ilman viivettä, kuten task.wait(), jumiuttaa pelin ja kaataa Studion. Laita task.wait() jokaiseen loputtomaan silmukkaan, kuten ColourChangerissa.

Mitään ei tapahdu, kun astun alustalle

Tarkista, että TouchPad on Script eikä LocalScript, että se on suoraan Pad-partin sisällä, ettei se ole pois päältä ja että alustan CanTouch-ominaisuus on rastitettu. Tee sitten print("touched", otherPart.Name) ensimmäiseksi riviksi onTouched-funktion sisään. Jos se ei tulostu, tapahtuma ei laukea; jos tulostuu, ongelma on alempana.

E:n painaminen ei tee mitään

MyFirstLocalScriptin pitää olla LocalScript StarterPlayerScriptsin sisällä: LocalScript Workspacessa tai ServerScriptServicessä ei koskaan käynnisty. Partin nimen pitää olla täsmälleen Pad, ja sen pitää olla suoraan Workspacessa. Napsauta ensin peli-ikkunaa ja varmista, ettet kirjoita chattiin, koska skripti ohittaa näppäimet, jotka peli on jo käyttänyt.

Part muuttuu minun näytölläni mutta ei muilla pelaajilla

Muutoksen teki LocalScript, joten se jäi sinun laitteellesi. Tee se palvelimen Scriptissä tai anna LocalScriptin pyytää palvelinta RemoteEventin kautta.

ColourChanger toimii partin sisällä mutta hajoaa ServerScriptServicessä

Se käyttää script.Parent-viittausta partinaan. ServerScriptServicessä vanhempi on ServerScriptService, jolla ei ole Anchored- tai Color-ominaisuutta, joten Output näyttää virheen «not a valid member». Pidä se partin sisällä tai anna partille nimi ja etsi se nimellä, esimerkiksi local part = workspace:WaitForChild("ColourPart") :: BasePart.

Output ei näytä yhtään mitään

Tarkista, että Output-ikkuna on auki (Window-valikko tai Script-välilehti) eikä suodatin ole päällä: Outputia voi suodattaa viestityypin, Clientin tai Serverin ja tekstin mukaan. Jos se on auki ja silti tyhjä, skripti ei luultavasti käynnistynyt. Katso tarkistuslista skripteille, jotka eivät tee mitään.

Jos jäät jumiin: RoCode

Jos jäät jumiin placesi skriptin kanssa, RoCode voi käydä sen läpi kanssasi. RoCode on itsenäinen tekoälyagentti Roblox Studioon, ei Robloxin tekemä: kirjoitat verkkochattiin, ja sen Studio-lisäosa luo ja muokkaa skriptejä Explorerissasi.

Opetellessa Ask-tila on hyödyllinen: sinä kirjoitat skriptit, ja RoCode lukee sen, mitä jo on, ja vastaa kysymyksiin.

Sinä kirjoitat

Selitä rivi riviltä, mitä Pad-partin sisällä oleva TouchPad-skripti tekee ja miksi siinä käytetään debouncea.

RoCode tekee
  • Ask-tilassa käyttää vain lukutyökaluja, kuten Search Scripts ja Read Script, eikä muuta placessa mitään
  • Jos jotain pitää korjata, kertoo, mitä ja missä se muuttaisi, ja ehdottaa siirtymistä Build-tilaan
  • Build-tilassa muokkaa skriptejä paikan päällä ja tarkistaa sitten jokaisen Check Script -työkalulla. Se on käännöstarkistus, ei tyyppitarkistus eikä testipeli
  • Lukee Studion Outputin Check Output -työkalulla, mukaan lukien viimeisimmän testipelisi Server- ja Client-rivit, myös Stopin painamisen jälkeen

Build-tilassa lisäosan versiolla 3.9 tai uudemmalla RoCode voi ajaa lyhyen testipelin ja lukea virheet, ja versiolla 3.9.11 tai uudemmalla ohjata testihahmoa, mutta pelin aikana se ei ota kuvakaappauksia, joten alustalle astut silti itse. Miten RoCode yhdistyy Studioon.

Usein kysytyt kysymykset

Missä skriptejä kirjoitetaan Roblox Studiossa?

Vie Explorerissa osoitin säiliön, esimerkiksi ServerScriptServicen, päälle, paina + ja valitse Script. Studio avaa sen Script Editorissa, jossa kirjoitat Luauta. Palvelinskriptit ovat yleensä ServerScriptServicessä; LocalScriptit StarterPlayerScriptsissä tai StarterGuissa.

Miten skripti ajetaan Roblox Studiossa?

Paina Play (F5). Studio käynnistää testipelin, ja jokainen käytössä oleva Script ServerScriptServicessä tai Workspacessa suoritetaan heti pelin alkaessa; StarterPlayerScriptsin LocalScriptit suoritetaan, kun liityt testipeliin. Run (valitse Playn vieressä olevasta listasta tai paina F8) käynnistää pelin ilman avataria, joten käytä tässä oppaassa Playta. Stop (Shift+F5) lopettaa testin. Avataksesi olemassa olevan skriptin kaksoisnapsauta sitä Explorerissa.

Mitä ohjelmointikieltä Roblox käyttää?

Luauta. Roblox kuvaa sitä nopeaksi, pieneksi ja turvalliseksi skriptikieleksi, jossa on asteittainen tyypitys ja joka pohjautuu Lua 5.1:een, joten useimmat Lua-tutoriaalit ovat yhä hyödyllisiä. Luau lisää ominaisuuksia, kuten merkkijonointerpolaation takahipsuilla ja valinnaiset tyyppimerkinnät, ja Roblox lisää omia kirjastojaan ja objektejaan, esimerkiksi task.wait.

Miten Script eroaa LocalScriptistä?

Script toimii palvelimella, ja sen muutokset päätyvät kaikille pelaajille. LocalScript toimii yhden pelaajan laitteella syötettä, kameraa ja näytön valikoita varten, ja sen tekemät muutokset partteihin, arvoihin ja käyttöliittymään jäävät tälle laitteelle. Asiakas ja palvelin -opas (englanniksi) käy läpi molemmat, sekä ModuleScriptin.

Voiko Roblox Studiossa skriptata puhelimella tai iPadilla?

Robloxin asennussivu kuvaa Studion ilmaiseksi sovellukseksi Windowsille ja Macille eikä mainitse puhelin- tai tablettiversiota, joten skriptaukseen tarvitaan tietokone.

Miksi skriptini ei tee mitään eikä näytä virhettä?

Yleensä se on paikassa, jossa tällainen skripti ei käynnisty (LocalScript Workspacessa tai Script StarterPlayerScriptsissä), se on pois päältä tai tapahtuma, jota se odottaa, ei laukea. Virheoppaassa on tarkistuslista.

Kuinka kauan Roblox-skriptauksen oppiminen kestää?

Kukaan ei voi antaa rehellistä lukua: se riippuu siitä, kuinka paljon rakennat. Eniten auttaa pienten skriptien kirjoittaminen usein omassa placessa. Muokkaa tämän oppaan neljää skriptiä, kokeile harjoitustehtäviä, käy sitten läpi ensimmäisen pelin opas ja lisää yksi järjestelmä kerrallaan.

Lähteet ja lisälukemista

Miten koodi tarkistettiin: jokainen tämän sivun skripti läpäisee Luaun tiukan tyyppitarkistuksen Roblox API:n määrittelyillä (luau-lsp, 20. marraskuuta 2026). Tyyppitarkistus löytää virheet API-nimissä ja väärät tyypit, mutta ei pelilogiikan virheitä, joten testaa kaikki Studiossa ennen julkaisua.

Kokeile RoCodea omassa pelissäsi.

Ilmaisia krediittejä joka päivä, ei korttia. Asenna lisäosa, kuvaile ominaisuus ja katso, mitä Studioon ilmestyi.