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 globaalinwait()-funktion vanhentuneeksi ja korvatuksitask.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
Ennen aloitusta: Studio, Baseplate ja Output-ikkuna
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.
- Asenna Roblox Studio, Robloxin ilmainen sovellus Windowsille ja Macille, ja kirjaudu Roblox-tililläsi.
- Avaa Studio. Aloitussivulla on pohjia: valitse Baseplate. Saat lattian 4x4-ruudukkotekstuurilla ja SpawnLocationin, paikan, johon avatarisi ilmestyy pelatessa.
- 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.
- Avaa Output Window-valikosta tai Script-välilehdeltä. Tänne ilmestyvät skriptiesi viestit ja virheet.
- 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.
| Skripti | Tyyppi | Missä se on | Mitä se opettaa |
|---|---|---|---|
FirstScript | Script | ServerScriptService | Muuttujat, funktio, if-ehto, silmukat ja taulukko |
ColourChanger | Script | Partin sisällä Workspacessa | Ominaisuuksien muuttaminen, script.Parent ja silmukka odotuksella |
TouchPad | Script | Pad-nimisen Partin sisällä | Tapahtumat, partiin koskeneen pelaajan etsiminen ja debounce |
MyFirstLocalScript | LocalScript | StarterPlayerScripts, StarterPlayerin sisällä | Koodi yhden pelaajan laitteella, näppäinpainallukset ja se, mikä jää tälle laitteelle |
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
- 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.
- 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. - Uudet skriptit alkavat yhdellä rivillä,
print("Hello world!"). Poista se ja liitä alla oleva koodi. - Paina Play (F5), kun sen vasemmalla puolella olevasta listasta on valittu Test. Studio käynnistää testipelin ja asettaa avatarin SpawnLocationille.
- 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 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.
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.
| Koodi | Ajatus | Mitä se tarkoittaa |
|---|---|---|
local gameName = "Coin Run" | Muuttuja | Nimi, 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): string | Funktio | Nimetty 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. |
return | Paluuarvo | Antaa arvon koodille, joka kutsui funktiota. print(describe(gameName, coinsToWin)) tulostaa sen, minkä describe palauttaa. |
`{name}: collect {goal} coins to win` | Merkkijonointerpolaatio | Takahipsuissa oleva teksti voi sisältää arvoja: Luau korvaa {name}- ja {goal}-kohdat niiden nykyisillä arvoilla. |
if, elseif, else, end | If-ehto | Luau 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 do | Numeerinen for-silmukka | Suorittaa 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 do | Taulukko ja silmukka | Taulukko 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ä.
- Paina Home-välilehdellä Part. Studio lisää palikan Workspaceen. Sen nimellä ei ole väliä.
- Vie Explorerissa osoitin uuden partin päälle, paina + ja lisää Script. Nimeä se uudelleen
ColourChangerja korvaa sen sisältö alla olevalla koodilla. - Paina Play. Part muuttuu punaiseksi, sitten siniseksi, sitten vihreäksi, vaihtuen kerran sekunnissa, ja aloittaa alusta.
-- 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.Parenton objekti, jonka sisällä skripti on, tässä part. Vedä skripti toiseen partiin, niin se muuttaa sitä.:: BaseParton 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.Colorjapart.Anchoredovat samoja ominaisuuksia kuin Properties-ikkunassa, samoilla nimillä. Roblox käyttää amerikkalaista kirjoitusasua, joten ominaisuuden nimi onColor, vaikka skriptin nimi on ColourChanger.Anchored = truepitää partin paikallaan: Robloxin hakuteoksen mukaan ankkuroitu part ei koskaan liiku painovoiman, törmäysten tai muun fysiikan vuoksi.colours[index]lukee listasta yhden alkion.#colourson listan pituus, 3, ja%antaa jakojäännöksen, jotenindex % #colours + 1laskee 1, 2, 3, 1, 2, 3.while true dotoistuu loputtomasti, joten sen sisällä olevatask.wait(1)on niin tärkeä. Robloxin dokumentaatio käskee aina laittamaan loputtomaan silmukkaan viiveen, kutentask.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.
- 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ä. - Tee siitä tasainen alusta, jolle voi astua, esimerkiksi asettamalla
Size-arvoksi6, 1, 6Properties-ikkunassa. Sijoita se lattialle SpawnLocationin viereen ja rastita Anchored, jotta se ei liiku. - Vie osoitin Padin päälle, paina +, lisää Script, nimeä se uudelleen
TouchPadja liitä alla oleva koodi. - Paina Play ja astu alustalle. Se muuttuu keltaiseksi 2 sekunniksi, ja Output kertoo nimesi.
-- 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)
| Koodi | Mitä 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. |
otherPart | Part, 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 end | Pysä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ä.
- Avaa Explorerissa StarterPlayer, vie osoitin StarterPlayerScriptsin päälle, paina + ja lisää LocalScript. Nimeä se uudelleen
MyFirstLocalScriptja liitä alla oleva koodi. - Paina Play. Output näyttää
Hello,ja nimesi merkinnällä Client. - Napsauta peli-ikkunaa ja paina E. Alusta muuttuu läpikuultavammaksi. Paina E uudelleen palauttaaksesi sen.
- 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 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.LocalPlayeron 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.InputBeganlaukeaa, kun pelaaja aloittaa näppäimen painalluksen, napsautuksen tai kosketuksen.gameProcessedontrue, 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 tainil, jos sitä ei ole.pad:IsA("BasePart")tarkistaa, että se todella on part, ennen kuin skripti muuttaa senTransparency-arvoa.if pad.Transparency == 0 then 0.6 else 0on 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ä.
| Tyyppi | Missä toimii | Mihin muutokset päätyvät | Mihin | Yleensä sijaitsee |
|---|---|---|---|---|
| Script | Palvelimella | Kaikille pelaajille | Pelin säännöt: kolikot, vahinko, ovet, kierrokset, tallennus | ServerScriptService tai partin sisällä, kun opettelet |
| LocalScript | Yhden pelaajan laitteella | Vain tälle laitteelle, paitsi oman hahmon liike | Syöte, kamera, näytön valikot, tehosteet yhdelle pelaajalle | StarterPlayerScripts tai StarterGui |
| ModuleScript | Sillä puolella, joka kutsuu sille require() | Samaan paikkaan kuin käyttöön ottaneen skriptin muutokset | Koodi, joka on yhteinen useille skripteille | ReplicatedStorage 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ä
- 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.
- 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.
- Paina E. Alusta muuttuu puoliläpinäkyväksi (Transparency 0.6). Paina E uudelleen, niin se on läpinäkymätön.
- 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.
- Riko jotain tahallaan. Nimeä Pad uudelleen
Pad2ja käynnistä peli. Askel alustalle tekee siitä yhä keltaisen, koska TouchPad löytää partinsascript.Parent-viittauksella eikä nimen perusteella. E:n painaminen ei nyt tee mitään, eikä virhettä tule:FindFirstChild("Pad")palauttinil, ja tarkistusif 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:
| Säiliö | Mitä sinne laitetaan | Miksi |
|---|---|---|
| ServerScriptService | Skriptit, joissa on useimmat pelin säännöt: palkinnot, kierrokset, tallennus | Ne toimivat palvelimella, eikä mitään ServerScriptServicestä lähetetä pelaajille. |
| Partin sisällä Workspacessa | Script, joka liittyy yhteen partiin, kuten ColourChanger ja TouchPad | Kelpaa, 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 pelaajalle | Jokainen pelaaja saa oman kopionsa liittyessään. |
| StarterGui | LocalScriptit ScreenGuin sisällä, jotka ohjaavat näytön valikkoa | Jokainen pelaaja saa oman kopionsa käyttöliittymästä. |
| ReplicatedStorage | ModuleScriptit, jotka sekä palvelimen että asiakkaan koodi ottaa käyttöön | Molemmat 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ää:
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.
| Viesti | Mitä se tarkoittaa | Miten 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.
| Tutoriaali | Ongelma | Tämä opas |
|---|---|---|
Pitää tauon wait(1)-kutsulla | Robloxin hakuteos merkitsee globaalin wait()-funktion vanhentuneeksi ja kertoo, että task.wait() korvasi sen. | task.wait(1) |
Löytää hahmon otherPart.Parent-viittauksella, kuten Robloxin laavaoppitunnissa | Kun 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 debouncea | Touched laukeaa useita kertoja peräkkäin yhdestä askeleesta, joten koodi suoritetaan yhä uudelleen. | busy-lippu ja jäähdytys |
| Laittaa LocalScriptin Workspacen partin sisään | LocalScript 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 pelaajanleaderstats-kansio ja lisää 1Coins-arvoon. Vihje:player:FindFirstChild("leaderstats"), sittenleaderstats:FindFirstChild("Coins"), sittencoins.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.Transparencypart.Color-rivin jälkeisellä rivillä samallaindex-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:
- LocalScript vs Script vs ModuleScript: missä kukin skriptityyppi toimii ja mitä se voi muuttaa, syvemmin kuin vaiheessa 4.
- RemoteEvents: miten LocalScript pyytää palvelinta tekemään jotain ja miten palvelin tarkistaa pyynnön.
- Tulostaulukko: ensimmäiset tilastosi, jotka luodaan ja joita muutetaan palvelimella.
- Ensimmäinen pelisi: lyhyt rata, jossa on laavaa, kolikoita ja maalialusta kahdella palvelinskriptillä, ja sitten julkaisu.
- 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.
Selitä rivi riviltä, mitä Pad-partin sisällä oleva TouchPad-skripti tekee ja miksi siinä käytetään debouncea.
- 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
- Roblox Creator Docs: Luau (englanniksi). mikä Luau on ja mistä se tulee
- Roblox Creator Docs: Roblox Studio setup (englanniksi). Windows ja Mac, järjestelmävaatimukset
- Roblox Creator Docs: Output (englanniksi). Outputin avaaminen, suodattimet, Show Context ja Show Source
- Roblox Creator Docs: Studio testing modes (englanniksi). Play, Run, Stop, Client/Server-kytkin ja Server & Clients
- Roblox Creator Docs: Script Editor (englanniksi). missä uudet skriptit avautuvat, ja Script Analysis
- Roblox Creator Docs: Script types and locations (englanniksi). missä kukin skriptityyppi toimii, ja tagit parttien skriptien sijaan
- Roblox Creator Docs: Script (englanniksi). milloin Script alkaa toimia
- Roblox Creator Docs: Control structures (englanniksi). ehdot, silmukat ja miksi loputon silmukka tarvitsee odotuksen
- Roblox Creator Docs: Events (englanniksi). Connect ja mitä Touched välittää funktiolle
- Roblox Creator Docs: Debounce patterns (englanniksi). miksi Touched laukeaa useita kertoja yhdestä kosketuksesta
- Roblox Creator Docs: wait (englanniksi). globaali wait() ja task.wait()
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (englanniksi). mitä asiakas voi tehdä omalla hahmollaan
- Roblox Creator Docs: Coding fundamentals (englanniksi). Robloxin sarja aloittelijoille
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.