Lyhyesti
Avaa Output-ikkuna Window-valikosta tai Script-välilehdeltä, paina Play ja napsauta ensimmäistä punaista virhettä. Studio avaa skriptin riviltä, jolla se kaatui. Viesti kertoo, mikä meni vikaan: attempt to index nil with 'Humanoid' tarkoittaa, että arvo juuri ennen .Humanoid-kohtaa oli nil. Korjaa syy, miksi arvoa ei ole, ja käynnistä peli uudelleen.
- Aloita listan ensimmäisestä virheestä. Alempana olevat virheet ovat usein vain sen seurauksia.
- Yleiset pelinaikaiset virheet palautuvat kolmeen syyhyn: arvo on
nil, nimi on kirjoitettu väärin tai ei ole vielä latautunut, tai koodi suoritetaan väärällä puolella (palvelin tai asiakas). - Jos virhettä ei ole lainkaan, koodi ei yleensä edes käynnistynyt. Tarkista skriptin tyyppi, missä se on Explorerissa, sen
Enabled-ominaisuus ja laukeaako tapahtuma, jota se odottaa, ylipäätään. - Selvittääksesi, mikä arvo oikeasti on halutulla rivillä, tulosta se printillä ja nimilapulla tai aseta riville keskeytyskohta.
Tällä sivulla
Miten avata Output ja lukea virhe
Output-ikkuna on paikka, jossa Roblox ilmoittaa skriptivirheistä, moottorin varoituksista ja kaikesta, mitä koodisi tulostaa. Se ei ole aina auki, joten avaa se ennen testiä. Jos et ole vielä kertaakaan ajanut skriptiä, skriptausopas aloittelijoille alkaa avaamalla Outputin ja tulostamalla ensimmäisen rivin skriptistä.
- Avaa Output Studion Window-valikosta tai Script-välilehden painikkeesta.
- Tyhjennä vanhat viestit painamalla Ctrl+K (⌘K Macilla), jotta näet vain tämän testin.
- Paina Play (F5) ja tee se, mikä rikkoo pelin.
- Etsi ensimmäinen punainen rivi. Virheet ovat punaisia. Varoitukset, esimerkiksi
Infinite yield possible, näytetään oranssina.
Pelinaikainen virhe näyttää Outputissa tältä. Outputin näyttöasetuksista riippuen jokaisella rivillä voi olla lisäksi aika, Client- tai Server-merkintä ja skriptin nimi.
ServerScriptService.CoinPad:14: attempt to index nil with 'Coins'
Stack Begin
Script 'ServerScriptService.CoinPad', Line 14 - function award
Script 'ServerScriptService.CoinPad', Line 27
Stack End
ServerScriptService.CoinPadon skriptin paikka Explorerissa: CoinPad-niminen skripti ServerScriptServicen sisällä.:14on rivi, jolla virhe tapahtui.- Rivinumeron jälkeinen viesti kertoo, mikä meni vikaan. Jokainen niistä käydään läpi alla olevassa yleisten virheiden listassa.
- Pino Stack Beginin ja Stack Endin välissä näyttää kutsut, jotka johtivat tänne, viimeisimmästä alkaen: rivi 14 funktion
awardsisällä, jota kutsuttiin riviltä 27.
Napsauta punaista virhettä, niin Studio avaa skriptin kursori oikealla rivillä. Yksin testatessa palvelimen ja oman asiakkaasi viestit tulevat samaan Outputiin: palvelimen viestit on merkitty vihreällä, asiakkaan sinisellä. Yläreunan suodattimet rajaavat listaa viestin tyypin (Error, Warning), kontekstin (Client, Server) tai tekstin mukaan.
Virheenjäljityksen työjärjestys, joka sopii mihin tahansa skriptiin
Arvailu ja monen asian muuttaminen kerralla on hidas tapa korjata skripti. Tämä työjärjestys kaventaa ongelmaa askel kerrallaan, oli virheilmoitusta tai ei.
- Toista ongelma. Tyhjennä Output, paina Play ja tee täsmälleen se, mikä rikkoo pelin. Kirjoita ylös, mitä odotit ja mitä tapahtui sen sijaan.
- Ota ensimmäinen virhe. Lue ensimmäinen uusi punainen rivi: skriptin polku, rivinumero ja viesti. Jos virhettä ei ole, siirry osioon skriptit, jotka toimivat ilman virheitä.
- Siirry riville. Napsauta virhettä. Lue koko rivi ja kysy itseltäsi, mikä sen arvoista voi olla
nil, väärin kirjoitettu tai väärää tyyppiä. - Tarkista arvo, älä arvaa. Lisää
printjuuri rivin yläpuolelle tai aseta riville keskeytyskohta ja katso arvoja Watch-ikkunassa.typeof(x)kertoo, mitä sinulla on: luku, merkkijono, Instance vai nil. - Seuraa jälkiä taaksepäin. Jos arvo on väärä, etsi kohta, jossa se asetettiin:
FindFirstChild, joka ei löytänyt mitään, funktio, joka ei palauttanut mitään, argumentti, jota kutsuva koodi ei koskaan välittänyt. - Korjaa syy, yksi muutos kerrallaan. Korjaa nimi, odota objektia tai siirrä koodi oikealle puolelle ja käynnistä peli uudelleen. Älä kääri riviä
pcall-kutsuun hiljentääksesi sen: näin bugi piiloutuu eikä korjaannu. - Varmista. Toista vaihe 1. Virheen pitää kadota, ja toiminnon pitää tehdä se, mitä odotit. Jos kyse on muista pelaajista, testaa lisäksi Server & Clients -tilassa kahdella asiakkaalla.
- Siivoa jälkesi. Poista tai kytke pois virheenjäljityksen printit, jotta seuraava ongelma on helppo huomata.
Yleiset Roblox-skriptivirheet ja niiden korjaus
Jokainen viesti rakentuu samasta pohjasta, johon sijoitetaan omat nimesi, joten virheen teksti itse on paras vihje. Alla lainausmerkeissä olevat nimet, esimerkiksi 'Health' tai "Workspace", ovat esimerkkejä.
| Mitä Output kirjoittaa | Mitä se tarkoittaa | Tavallinen korjaus |
|---|---|---|
attempt to index nil with 'Health' | Arvo ennen .Health-kohtaa oli nil. | Selvitä, miksi se on nil, ja tarkista se if-lauseella ennen käyttöä. |
Infinite yield possible on 'Players.YourName:WaitForChild("Character")' | WaitForChild on odottanut jo 5 sekuntia, eikä objektia ole ilmestynyt. | Korjaa nimi tai polku, varmista, että jokin luo objektin, tai lisää aikakatkaisu. |
Bridge is not a valid member of Workspace "Workspace" | Lapsiobjektia tai ominaisuutta tällä täsmällisellä nimellä ei siellä juuri nyt ole. | Vertaa kirjoitusasua ja isoja kirjaimia Exploreriin. Käytä asiakkaalla WaitForChild-kutsua. |
attempt to call a nil value | Kutsuit jotain, mikä ei ole funktio. | Tarkista funktion nimi ja että se on määritelty ennen kutsua. |
attempt to perform arithmetic (add) on Instance and number | Laskutoimitus jollakin, mikä ei ole luku. | Käytä value-objekteilla .Value-ominaisuutta ja tekstillä tonumber-funktiota. |
attempt to concatenate string with nil | .. yritti yhdistää tekstiä nilin tai objektin kanssa. | Käytä tostring()-funktiota, .Name-ominaisuutta tai merkkijonointerpolaatiota. |
Expected 'end' (to close 'function' at line 3), got <eof> | Syntaksivirhe. Skriptiä ei suoriteta lainkaan. | Korjaa se, mikä on alleviivattu punaisella Script Editorissa. |
Requested module experienced an error while loading | ModuleScript itse kaatui virheeseen suorituksen aikana. | Korjaa moduulin oma virhe, joka näkyy hieman ylempänä Outputissa. |
Argument 1 missing or nil | Roblox-funktio sai nilin kohdassa, jossa se tarvitsee arvon. | Selvitä, mistä tämän argumentin piti tulla. |
FireServer can only be called from the client | RemoteEventiä kutsuttiin väärältä puolelta. | Palvelin käyttää FireClient-metodia, LocalScriptit käyttävät FireServer-metodia. |
Datastoren virhe 403, StudioAccessToApisNotAllowed | Studio ei saa käyttää tämän pelin datastoreja. | Julkaise peli ja ota käyttöön Studio Access to API Services. |
Jokaisella tämän listan viestillä, ja muillakin, on oma sivunsa, jossa on jokainen syy, sen aiheuttava koodi ja korjaus: katso Roblox Studion virheilmoitukset, esimerkiksi attempt to index nil, Infinite yield possible ja is not a valid member of.
attempt to index nil with 'X'
Indeksointi tarkoittaa jonkin lukemista pisteen tai hakasulkeiden kautta: part.Position, player.Character, list[1]. Tämä virhe kertoo, että vasemmalla puolella oleva oli nil, ja lainausmerkeissä oleva nimi on se, mitä yritit siitä lukea. Siis rivillä player.Character.Humanoid virhe attempt to index nil with 'Humanoid' tarkoittaa, että player.Character oli nil. Jos avain on luku, viesti päättyy sanoihin with number.
Tavalliset syyt, miksi arvo oli nil:
FindFirstChild,FindFirstChildOfClasstaiFindFirstAncestorei löytänyt mitään, koska nimi on eri tai objektia ei vielä ole.Players.LocalPlayerkäytettiin palvelimen Scriptissä. Se on olemassa vain LocalScripteissä ja ModuleScripteissä, jotka ne ottavat käyttöön requirella; palvelimella se on aina nil. Käytä sen sijaanplayer-arvoa, jonkaPlayerAddedtai RemoteEventin käsittelijä antaa.player.Characterluettiin ennen kuin hahmo oli syntynyt, tai sen syntyessä uudelleen.- Taulukon merkintää ei koskaan asetettu, esimerkiksi
playerData[player]ennen kuin tämän pelaajan tiedot latautuivat, tai kutsuttu funktio ei palauttanut mitään.
Klassinen tapaus on tappava palikka. Rikkinäinen versio olettaa, että kaikki partiin koskeva kuuluu hahmolle, mutta pudotetuille työkaluille, ankkuroimattomille parteille ja asusteille tämä ei pidä paikkaansa.
local part = script.Parent :: BasePart
part.Touched:Connect(function(hit: BasePart)
-- Rikkinäinen versio:
-- hit.Parent:FindFirstChild("Humanoid").Health = 0
-- Jos koskettava part ei ole osa hahmon kehoa, FindFirstChild
-- palauttaa nil, ja Output näyttää:
-- attempt to index nil with 'Health'
-- Korjattu: tarkistetaan jokainen vaihe ennen käyttöä
local model = hit:FindFirstAncestorOfClass("Model")
local humanoid = model and model:FindFirstChildOfClass("Humanoid")
if humanoid then
humanoid.Health = 0
end
end)
Jos kirjoitat hit.Parent.Humanoid, saat toisen viestin, Humanoid is not a valid member of ..., joka käsitellään alempana. FindFirstAncestorOfClass("Model") löytää hahmon myös silloin, kun koskettava part on asusteen tai hahmon kädessä olevan työkalun sisällä, joten kädessä oleva työkalu, joka osuu palikkaan, lasketaan myös.
Malli, joka korjaa tämän virheen: hae arvo, tarkista se ja käytä sitä vasta sitten. Palvelimella FindFirstChild ja if-tarkistus sopii asioille, joita ei hyvin voi olla olemassa. LocalScriptissä käytä WaitForChild-kutsua asioille, jotka palvelin luo, koska ne voivat ilmestyä vasta skriptin käynnistymisen jälkeen.
Infinite yield possible on ...
WaitForChild("Name") pysäyttää skriptin, kunnes tämänniminen lapsiobjekti ilmestyy. Jos se odottaa yli 5 sekuntia etkä ole antanut aikakatkaisua, Roblox tulostaa tämän varoituksen. Se on varoitus eikä virhe: skripti odottaa yhä, eikä mitään tämän rivin jälkeen suoriteta ennen kuin objekti ilmestyy, eikä se välttämättä ilmesty koskaan. Tavalliset syyt:
- Väärä nimi tai vanhempi.
WaitForChild("leaderStats")ei koskaan löydä kansiotaleaderstats. - Kukaan ei luo objektia: sen tekevä palvelinskripti on pois päältä, väärässä paikassa tai kaatui aiemmin virheeseen. Etsi aiempi virhe Outputista.
- LocalScript odottaa jotain ServerStoragessa tai ServerScriptServicessä. Niiden sisältöä ei koskaan lähetetä pelaajille, joten odotus ei pääty.
- Odotat ominaisuutta etkä lapsiobjektia. Yleinen esimerkki on
player:WaitForChild("Character"):Characteron Playerin ominaisuus, ei sen sisällä oleva objekti. - Objektien striimaus on päällä (
Workspace.StreamingEnabled), ja part on liian kaukana pelaajasta, joten sitä ei ole vielä lähetetty tälle asiakkaalle.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Rikkinäinen versio:
-- local character = player:WaitForChild("Character")
-- Character on Playerin ominaisuus eikä lapsiobjekti, joten Output varoittaa:
-- Infinite yield possible on 'Players.YourName:WaitForChild("Character")'
local function onCharacterAdded(character: Model)
-- Aikakatkaisun kanssa WaitForChild palauttaa nil eikä odota ikuisesti
local humanoid = character:WaitForChild("Humanoid", 10)
if not (humanoid and humanoid:IsA("Humanoid")) then
warn(`[DeathMessage] no Humanoid in {character:GetFullName()} after 10 seconds`)
return
end
humanoid.Died:Connect(function()
print(`[DeathMessage] {player.Name} died`)
end)
end
-- Käsitellään hahmo, joka voi jo olla olemassa, ja sitten jokainen uudelleensyntyminen
local current = player.Character
if current then
onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)
WaitForChild-kutsun toisena argumenttina oleva luku on aikakatkaisu sekunteina. Silloin skripti voi ilmoittaa ongelmasta warn-kutsulla ja pysähtyä hallitusti sen sijaan, että jäisi hiljaa jumiin.
X is not a valid member of Y
Viittasit pisteellä lapsiobjektiin tai ominaisuuteen, jota sillä hetkellä ei ole, esimerkiksi workspace.Bridge, kun Workspacessa ei ole Bridge-nimistä partia. Viestissä on ensin se, mitä pyysit, ja sitten sen objektin luokka ja täysi polku, josta etsit. Tarkista kolme asiaa:
- Kirjoitusasu ja isot kirjaimet vastaavat täsmälleen Exploreria. Kansion nimi on
leaderstats, kokonaan pienillä kirjaimilla, jahumanoidei oleHumanoid. - Ominaisuuksien nimet kirjoitetaan amerikanenglanniksi.
part.Colourkaatuu virheeseenColour is not a valid member of Part "Workspace.Part"; ominaisuuden nimi onColor. - Objekti on latautunut. Asiakkaalla palvelimen luomat objektit voivat saapua vasta LocalScriptin käynnistymisen jälkeen, joten käytä siellä
WaitForChild-kutsua.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Rikkinäinen versio:
-- local coins = player.leaderstats.Coins
-- leaderstatsin luo palvelin, ja se voi saapua tälle asiakkaalle vasta
-- tämän skriptin käynnistymisen jälkeen. Silloin Output näyttää:
-- leaderstats is not a valid member of Player "Players.YourName"
local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- palvelin tekee Coinsista IntValuen
print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
print(`[CoinsWatcher] coins changed to {newValue}`)
end)
Tähän tarvitaan palvelinskripti, joka luo leaderstats-kansion ja sinne Coins-nimisen IntValuen, kuten tulostaulukko-oppaassa.
attempt to call a nil value
Koodi laittoi sulut jonkin nil-arvon perään, joten suoritettavaa ei ollut. Tavalliset syyt:
- Funktion nimi on kirjoitettu väärin tai isot kirjaimet eroavat. Moduuli määrittelee
Format.clock, mutta kutsuva koodi kirjoittaaFormat.Clock(95). local function-funktiota kutsutaan rivillä, joka on sen määrittelyn yläpuolella. Silloin nimeä ei vielä ole, joten siirrä määrittely ylemmäs.- ModuleScript ei koskaan lisää funktiota palauttamaansa taulukkoon.
Kaksi samankaltaista viestiä viittaa samaan virheeseen. Taulukon olemattoman metodin kutsuminen kaksoispisteellä antaa attempt to call missing method 'Kill' of table. Kirjoitusvirhe Roblox-objektin metodissa, esimerkiksi part:Destory(), antaa Destory is not a valid member of Part "Workspace.Part".
attempt to perform arithmetic (add) on ...
Luau yritti laskea (add, sub, mul, div ja niin edelleen), mutta toinen puolista ei ollut luku. Viestin lopussa olevat tyyppien nimet vihjaavat, mikä tapaus on kyseessä:
on Instance and number: laskit value-objektilla etkä sen luvulla.coins + 10pitää ollacoins.Value + 10.on nil and number: muuttujaa tai taulukon merkintää ei koskaan asetettu. Anna sille alkuarvo tai kirjoita(x or 0)kohtiin, joissa puuttuva arvo todella tarkoittaa nollaa.on string and number: teksti, joka ei ole luku, usein TextBoxista. Muunna setonumber(text)-kutsulla ja tarkista, ettei tulos ole nil. Teksti, jossa on luku, esimerkiksi"5", muunnetaan automaattisesti.
Vertailut hajoavat samalla tavalla, viestillä attempt to compare nil < number. Luau kirjoittaa a > b muotoon b < a, joten viestin järjestys voi olla päinvastainen kuin koodissasi.
local Players = game:GetService("Players")
local REWARD = 5
local INTERVAL_SECONDS = 60
local function addCoins(player: Player, amount: number)
local leaderstats = player:FindFirstChild("leaderstats")
local coins = leaderstats and leaderstats:FindFirstChild("Coins")
if not (coins and coins:IsA("IntValue")) then
-- Kerrotaan, miksi mitään ei tapahtunut, eikä vaieta
warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
return
end
-- Rikkinäinen versio:
-- coins = coins + amount
-- coins on IntValue-objekti eikä sen luku, joten Output näyttää:
-- attempt to perform arithmetic (add) on Instance and number
coins.Value += amount
end
-- Joka minuutti annetaan jokaiselle palvelimen pelaajalle vähän kolikoita
while true do
task.wait(INTERVAL_SECONDS)
for _, player in Players:GetPlayers() do
addCoins(player, REWARD)
end
end
attempt to concatenate string with nil
Operaattori .. yhdistää vain merkkijonoja ja lukuja. Nilin kanssa yhdistäminen ei onnistu, eikä objektinkaan: "Hi " .. player antaa attempt to concatenate string with Instance. Käytä player.Name-ominaisuutta, kääri arvo tostring()-kutsuun tai käytä merkkijonointerpolaatiota takahipsuilla, print(`Coins: {coins}`), joka tulostaa nil sen sijaan, että pysäyttäisi skriptin.
Expected 'end' ja muut syntaksivirheet
Viestit, jotka alkavat sanalla Expected, ovat syntaksivirheitä: koodi ei ole kelvollista Luauta, Roblox ei pysty kääntämään sitä, eikä yhtäkään tämän skriptin riviä suoriteta, ei edes virheen yläpuolella olevia. Script Editor alleviivaa ne punaisella jo kirjoittaessa, joten ne voi korjata ennen Playn painamista.
Expected 'end' (to close 'function' at line 3), got <eof>: riviltä 3 alkavaltafunction-,if-,for- taiwhile-lohkolta puuttuu omaend. Viestin edessä oleva rivinumero osoittaa usein tiedoston loppuun, joten katso suluissa mainittua riviä.Expected 'then' when parsing if statement, got '=': yksittäinen=ehdossa. Vertailuun tarvitaan==.Expected ')' (to close '(' at line 1), got 'local': sulkua ei koskaan suljettu.Expected <eof>, got 'end': yksi ylimääräinenend.
Tasaisilla sisennyksillä puuttuva tai ylimääräinen end on helppo huomata, koska jokainen lohko on samalla tasolla kuin sen sulkeva end.
Requested module experienced an error while loading
ModuleScriptin ensimmäinen require() suorittaa sen koodin. Jos moduuli kaatuu suorituksen aikana virheeseen, sen käyttöön ottanut skripti saa tämän viestin. Todellinen ongelma on moduulin oma virhe rivin tai kaksi ylempänä Outputissa: korjaa se. Kaksi samankaltaista viestiä:
Module code did not return exactly one value: moduuli ei päätyreturn-lauseeseen. ModuleScriptin pitää palauttaa yksi arvo, joka ei ole nil, yleensä oma taulukkonsa.Requested module was required recursively: kaksi moduulia ottaa toisensa käyttöön. Siirrä yhteinen osa kolmanteen moduuliin, jonka molemmat ottavat käyttöön.
local Format = {}
-- Muuntaa sekuntimäärän minuuteiksi ja sekunneiksi: 95:stä tulee "1:35"
function Format.clock(seconds: number): string
local whole = math.max(0, math.floor(seconds))
return string.format("%d:%02d", whole // 60, whole % 60)
end
-- Moduulin pitää lopuksi palauttaa taulukkonsa. Ilman tätä riviä jokainen
-- tämän moduulin require kaatuu virheeseen: Module code did not return exactly one value
return Format
Skripti ottaa sen käyttöön kutsulla local Format = require(ReplicatedStorage:WaitForChild("Format")) ja kutsuu sitten Format.clock(95). Jos kirjoitat Format.Clock(95), saat virheen attempt to call a nil value.
Argument 1 missing or nil
Roblox-funktio sai nilin argumentissa, jota se tarvitsee, ja luku kertoo, missä niistä. workspace:FindFirstChild(itemName) kaatuu näin, kun itemName on nil. Bugi on harvoin tällä rivillä. Se on siellä, mistä arvon piti tulla: kirjoitusvirhe muuttujassa, attribuutti, jota ei koskaan asetettu, tai RemoteEventin argumentti, jota asiakas ei lähettänyt. RemoteEventin argumentit tulevat pelaajan laitteelta, joten palvelimen täytyy tarkistaa ne ennen käyttöä. Miten se tehdään, näyttää RemoteEvent-opas.
FireServer can only be called from the client
RemoteEventillä on suunta. LocalScript kutsuu FireServer-metodia, ja palvelimen Script kuuntelee OnServerEvent-tapahtumaa. Palvelimen Script kutsuu FireClient- tai FireAllClients-metodia, ja LocalScriptit kuuntelevat OnClientEvent-tapahtumaa. Metodin kutsuminen väärältä puolelta antaa tämän virheen tai sen peilikuvan, FireClient can only be called from the server. Yleensä korjaus on siirtää koodi oikeantyyppiseen skriptiin: katso Script, LocalScript ja ModuleScript.
Datastoren virhe 403 Studiossa
Datastore-kutsut Studiossa kaatuvat virhekoodiin 403 (StudioAccessToApisNotAllowed), kunnes sallit ne. Julkaise place, avaa File, Experience Settings, Security, ota käyttöön Enable Studio Access to API Services ja tallenna. Sen jälkeen Studio käyttää samoja datastoreja kuin julkaistu peli, joten Roblox neuvoo tekemään tämän erillisessä testikopiossa eikä pelissä, jota jo pelataan. Kääri jokainen datastore-kutsu pcall-kutsuun, koska tällaiset kutsut voivat kaatua koodistasi riippumattomista syistä. Turvallinen tallennus käydään läpi DataStore-tutoriaalissa.
Skripti toimii ilman virheitä mutta ei tee mitään
Hiljainen skripti ei yleensä käynnistynyt lainkaan, odottaa yhä jotain tai käynnistyi väärällä puolella. Ennen kuin muutat koodia, tee sen ensimmäiseksi riviksi print(script:GetFullName(), "started") ja käynnistä peli. Jos tämä rivi ei koskaan ilmesty Outputiin, ongelma on siinä, missä skripti on tai miten se on asetettu, eikä siinä, mitä siihen on kirjoitettu.
| Mitä tarkistaa | Mikä menee vikaan | Miten korjata |
|---|---|---|
| Skriptin tyyppi ja paikka | LocalScript käynnistyy vain, jos se on StarterPlayerScriptsissä, StarterCharacterScriptsissä, StarterGuissa, StarterPackissa tai ReplicatedFirstissä (Starter-säiliöistä se käynnistyy pelaajan kopiona). Jos se on Workspacessa, ServerScriptServicessä tai ReplicatedStoragessa, se ei käynnisty koskaan. Script oletusarvoisella RunContextilla käynnistyy vain Workspacessa tai ServerScriptServicessä. | Siirrä se tai käytä toista skriptityyppiä. Käyttöliittymän ja ohjauksen koodi kuuluu LocalScriptiin, pelin säännöt Scriptiin ServerScriptServicessä. |
| Enabled | Skripti, jonka Enabled-ruksi on poistettu, ei käynnisty. | Valitse se ja rastita Enabled Properties-ikkunassa. |
| RunContext | Scriptin RunContext päättää, missä se käynnistyy. Legacy, oletusarvo, käynnistyy palvelimella Workspacesta tai ServerScriptServicestä. Server käynnistyy palvelimella, Client käynnistyy jokaisen pelaajan laitteella, esimerkiksi ReplicatedStoragesta. | Aseta se tietoisesti. Robloxin dokumentaatio neuvoo laittamaan Client Scriptit ReplicatedStorageen tai ReplicatedFirstiin ja LocalScriptit Starter-säiliöihin. |
| Tapahtuma ei laukea | Touched laukeaa vain fyysisestä liikkeestä, vähintään toisen kahdesta partista pitää olla ankkuroimaton, ja molemmissa pitää olla CanTouch. PlayerAdded ei laukea pelaajille, jotka olivat jo palvelimella, kun yhdistit tapahtumaan. RemoteEventin käsittelijä ei käynnisty, jos toinen puoli ei koskaan kutsu tapahtumaa. | Laita print käsittelijän sisään, jotta tiedät varmasti, käynnistyykö se, ja korjaa sitten se, minkä pitäisi kutsua sitä. |
| Koodi silmukan tai odotuksen jälkeen | while true do -silmukan alla olevia rivejä ei suoriteta koskaan, koska silmukka ei pääty. Myöskään sellaisen WaitForChild-kutsun alla olevia rivejä, joka ei koskaan löydä objektia, ei suoriteta. | Yhdistä tapahtumat ennen silmukkaa tai käynnistä silmukka task.spawn-kutsulla. Anna odotuksille aikakatkaisu. |
| Tarkistus, joka poistuu hiljaa | Suojaus kuten if not coins then return end pysäyttää funktion hiljaa, kun objektia ei ole. | Lisää warn yksityiskohtineen ennen return-lausetta. |
| Outputin suodattimet | Outputia voi suodattaa viestin tyypin, Clientin tai Serverin ja tekstin mukaan. Unohtunut suodatin voi piilottaa virheen, jota etsit. | Nollaa suodattimet ja tyhjennä hakukenttä. |
| Vain sinä näet sen | Muutoksen teki LocalScript, joten vain tämä pelaaja näkee sen. Palvelin ja muut pelaajat eivät näe sitä. | Tee muutos palvelimella. Katso, missä skriptit suoritetaan. |
PlayerAdded-tapaukseen kompastuvat monet, koska Studion testissä liityt melkein heti palvelimen käynnistyttyä. Jos jokin Connect-rivin yläpuolella odottaa, esimerkiksi WaitForChild, task.wait tai sellaisen moduulin require, joka odottaa, saatat liittyä ennen kuin yhteys on olemassa. Käsittele sekä uudet että jo liittyneet pelaajat:
local Players = game:GetService("Players")
local function onPlayerAdded(player: Player)
print(`[Welcome] {player.Name} joined`)
end
Players.PlayerAdded:Connect(onPlayerAdded)
-- Pelaajille, jotka olivat jo täällä, kun yllä oleva rivi suoritettiin,
-- PlayerAdded ei laukea tässä skriptissä, joten käsitellään heidät nyt
for _, player in Players:GetPlayers() do
task.spawn(onPlayerAdded, player)
end
Virheenjäljityksen työkalut Roblox Studiossa
print ja warn kontekstin kanssa
print kirjoittaa rivin Outputiin, ja warn kirjoittaa varoituksen. Se on nopein tapa vastata kysymyksiin "käynnistyikö tämä ylipäätään?" ja "mikä tämä arvo on?". Pelkkää print(x)-riviä on myöhemmin vaikea löytää, joten lisää nimilappu ja tärkeät yksityiskohdat. typeof(x) näyttää, millainen arvo on kyseessä: luku, merkkijono, Instance vai nil, ja GetFullName() näyttää, mikä objekti sinulla tarkalleen on.
local Players = game:GetService("Players")
local DEBUG = true -- aseta false, kun olet valmis
local TAG = "[ShopServer]"
local function debugPrint(...: any)
if DEBUG then
print(TAG, ...)
end
end
Players.PlayerAdded:Connect(function(player: Player)
debugPrint("joined:", player.Name, player.UserId)
local leaderstats = player:WaitForChild("leaderstats", 10)
if not leaderstats then
warn(TAG, "no leaderstats for", player.Name, "after 10 seconds")
return
end
local coins = leaderstats:FindFirstChild("Coins")
-- typeof ja ClassName näyttävät, mikä arvo oikeasti on
debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)
Outputin hakukenttä suodattaa tekstin mukaan, joten pysyvä nimilappu kuten [ShopServer] antaa näyttää vain tämän järjestelmän rivit. Jos haluat tietää, miten koodi päätyi riville, debug.traceback() palauttaa nykyisen kutsupinon merkkijonona.
Keskeytyskohdat ja askeltava suoritus
Keskeytyskohta pysäyttää pelin rivillä, jotta voit katsoa kaikkea juuri sillä hetkellä. Napsauta Script Editorissa rivinumeron oikealla puolella olevaa reunusta (punainen ympyrä ilmestyy) ja käynnistä testipeli. Kun suoritus saavuttaa tämän rivin, peli pysähtyy, ja keltainen nuoli näyttää seuraavan rivin. Koodissa eteenpäin liikutaan askelluspainikkeilla:
- Step Over (F10) suorittaa nykyisen rivin ja pysähtyy seuraavalle.
- Step Into (F11) menee sen funktion sisään, jota tällä rivillä kutsutaan.
- Step Out (Shift+F11) suorittaa nykyisen funktion loppuun ja pysähtyy koodiin, joka kutsui sitä.
- Resume Scripts jatkaa seuraavaan keskeytyskohtaan asti.
Reunuksen oikea napsautus antaa kaksi muuta hyödyllistä tyyppiä. Ehdollinen keskeytyskohta pysäyttää vain, kun lauseke kuten amount < 0 on tosi. Logpoint tulostaa viestin Outputiin pysäyttämättä, joten voit kirjata arvon muuttamatta skriptiä.
Watch ja Call Stack
Kun peli on pysäytetty, vie osoitin Script Editorissa muuttujan päälle nähdäksesi sen arvon. Watch-ikkunan Variables-välilehti näyttää kaikki näkyvyysalueen muuttujat, ja My Watches -välilehdelle voi kirjoittaa minkä tahansa lausekkeen, esimerkiksi coins.Value + amount, ja nähdä sen nykyisen arvon. Call Stack -ikkuna näyttää, mikä funktio kutsui mitäkin päätyäkseen pysäytetylle riville. Molemmat avataan Script-välilehdeltä tai Window-valikosta.
Script Analysis ja tiukka tila
Script Editor alleviivaa ongelmat jo kirjoittaessa, ja Script Analysis -ikkuna, joka avataan Script-välilehden Analysis-painikkeesta, näyttää kaikkien skriptien virheet ja varoitukset. Se löytää syntaksivirheet ja tuntemattomat nimet ennen Playn painamista. Jos skriptin ensimmäiseksi riviksi laitetaan --!strict, Luaun tiukka tyyppitarkistus kytkeytyy päälle, ja se ilmoittaa lisäksi kirjoitusvirheistä ominaisuuksissa, vääränlaisista argumenttityypeistä ja arvoista, jotka voivat olla nil. Käynnissä olevaa peliä se ei kuitenkaan näe: partin, jota Workspacessa ei ole, näyttää vain Output.
Command bar
Command bar (Script-välilehdellä tai Ctrl+9, ⌘9 Macilla) suorittaa Luauta heti. Kun peli on käynnissä, se on nopea tapa kysyä: print(workspace:FindFirstChild("Bridge")) kertoo, onko tällainen part olemassa, ja print(#game:GetService("Players"):GetPlayers()) laskee pelaajat. Muokkaustilassa command barin koodi muuttaa placeasi oikeasti, joten ole varovainen kaiken kanssa, mikä siirtää tai poistaa objekteja.
Developer Console julkaistussa pelissä
Studion Output toimii vain Studiossa. Julkaistussa pelissä paina F9 tai kirjoita chattiin /console avataksesi Developer Consolen. Sen Log näyttää tulosteen omalta laitteeltasi, ja palvelimen tulosteen, jos olet pelin omistaja tai sellaisen ryhmän jäsen, jolla on oikeus muokata sitä.
Robloxin sisäänrakennettu Assistant voi myös auttaa yksittäisen viestin kanssa: Robloxin oma opas neuvoo liittämään virheen Outputista ja pyytämään Assistantia selittämään sen. Jos Assistant lakkasi vastaamasta tai kertoo, että olet osunut rajaan, katso Assistantin rajat ja virheet.
Virheiden korjaus RoCodella
RoCode on itsenäinen tekoälyagentti Roblox Studioon: kuvaat ongelman verkkochatissa, ja Studio-lisäosa lukee ja muokkaa auki olevaa placeasi. Virheiden kanssa se voi hoitaa yllä olevan työjärjestyksen lukuvaiheet nojaten testipeliin, jonka olet jo ajanut.
Painoin Playta, ja kaupan painikkeen napsautus ei tee mitään. Output näyttää attempt to index nil with 'Coins'. Etsi syy ja korjaa se.
- Lukee Studion Outputin Check Output -työkalullaan, mukaan lukien Server- ja Client-rivit viimeisimmästä testipelistäsi, myös sen jälkeen, kun painoit Stop
- Avaa virheen skriptin Read Script -työkalulla ja lukee rivin ympärillä olevan koodin, ja Search Scripts -työkalulla se voi etsiä, missä puuttuva arvo olisi pitänyt luoda
- Tekee kohdennetun muokkauksen Edit Script -työkalulla, tarkalla haulla ja korvauksella tässä skriptissä, ja ajaa sitten Check Script -työkalun, joka kääntää skriptin Studiossa (se ei tarkista tyyppejä, ei aja linteriä eikä suorita koodiasi)
- Lähettää muutokset Studioon erinä, ja jokainen erä on kumouskohta Studion historiassa
Paina Playta uudelleen ja napsauta kaupan painiketta varmistaaksesi korjauksen itse: lisäosan versiolla 3.9 tai uudemmalla RoCode voi ajaa lyhyen testipelin ja lukea virheet, ja lisäosan versiolla 3.9.15 tai uudemmalla sen testihahmo voi painaa näytön painikkeita, mutta se tarkistaa vain sen, mitä se itse päätti testata, eikä käännöstarkistus kerro, onko pelin logiikka oikein. Virheiden lukeminen kuuluu jokaiseen rakennukseen: rakennus-, tarkistus- ja testikierros kokonaiselle pelille toistaa tämän tarkistuksen jokaisen järjestelmän jälkeen. Miten RoCode yhdistyy Studioon.
Usein kysytyt kysymykset
Miksi skripti Robloxissa ei toimi, vaikka virheitä ei ole?
Yleensä skripti ei käynnistynyt lainkaan (väärä skriptityyppi tai säiliö, tai Enabled on pois päältä), se odottaa yhä jotain, tai tapahtuma, jota se kuuntelee, ei koskaan laukea. Print ensimmäisellä rivillä näyttää, mistä vaihtoehdosta on kyse. Katso tarkistuslista yllä.
Mitä "attempt to index nil" tarkoittaa Robloxissa?
Arvo ennen pistettä tai kaksoispistettä oli nil, joten Roblox ei voinut katsoa sen sisään. Rivillä player.Character.Humanoid virhe attempt to index nil with 'Humanoid' tarkoittaa, että player.Character oli nil: sitä ei ole tai se ei ole vielä latautunut. Tarkista arvo if-lauseella ennen käyttöä, ja odota LocalScriptissä palvelimen luomia objekteja WaitForChild-kutsulla. Lisää syistä.
Mitä "infinite yield possible" tarkoittaa Robloxissa?
WaitForChild on odottanut yli 5 sekuntia lapsiobjektia, joka ei ole ilmestynyt, ja odottaa yhä. Usein nimi tai vanhempi on väärä, tai kukaan ei luo objektia. Lisää syistä.
Miksi Output-ikkuna on tyhjä tai ei näy?
Avaa se Window-valikosta tai Script-välilehdeltä. Jos se on auki, mutta pysyy testin aikana tyhjänä, nollaa suodattimet ja hakukenttä ja tarkista sitten, että skriptit, joiden pitäisi tulostaa jotain, käynnistyvät.
Onko Robloxissa skriptien virhetarkistusta?
Kyllä, se on rakennettu Studioon: Script Editor alleviivaa ongelmat kirjoittaessa, ja Script Analysis -ikkuna näyttää ne listana. Ne löytävät syntaksi- ja tyyppivirheet, mutta eivät puuttuvia objekteja eivätkä väärää pelilogiikkaa: ne näkyvät vasta, kun koodi on käynnissä.
Pitääkö koodi kääriä pcalliin, jotta virheitä ei tulisi?
Vain kutsut, jotka voivat kaatua koodistasi riippumattomista syistä, esimerkiksi datastore-, HTTP- tai MarketplaceService-pyynnöt. Jos käärit nil-virheen pcalliin, viesti katoaa, mutta funktio ei silti toimi.
Miten näen skriptivirheet julkaistussa pelissä?
Paina pelissä F9 tai kirjoita chattiin /console avataksesi Developer Consolen. Se näyttää virheet omalta laitteeltasi, ja palvelimelta, jos olet pelin omistaja tai ryhmän jäsen, joka voi muokata sitä.
Lähteet ja lisälukemista
- Roblox Creator Docs: Output (englanniksi). missä Output on, sen suodattimet ja näyttöasetukset
- Roblox Creator Docs: Debugging (englanniksi). keskeytyskohdat, askeltava suoritus, Watch, Call Stack, command bar ja Developer Console
- Roblox Creator Docs: Script Editor (englanniksi). Script Analysis -ikkuna
- Roblox Creator Docs: Studio interface (englanniksi). mistä Output ja command bar avataan
- Roblox Creator Docs: Script types and locations (englanniksi). missä kukin skriptityyppi käynnistyy, ja RunContext
- Roblox Creator Docs: Studio testing modes (englanniksi). Play, Client- ja Server-näkymät sekä Server & Clients -testit
- Roblox Engine API: Instance (englanniksi). WaitForChild, sen aikakatkaisu ja varoitus 5 sekunnin jälkeen
- Roblox Creator Docs: Reuse code (englanniksi). ModuleScript ja rekursiiviset requiret
- Roblox Creator Docs: Data store error codes and limits (englanniksi). virhe 403, StudioAccessToApisNotAllowed
- Roblox Creator Docs: Data stores (englanniksi). Studion käyttöoikeuden kytkeminen päälle ja erillinen testikopio
- Roblox Engine API: BasePart (englanniksi). milloin Touched laukeaa, ja CanTouch
- Roblox Creator Docs: Type checking (englanniksi). tiukka tila
- Roblox Creator Docs: Developer Console (englanniksi). kuka näkee palvelimen tulosteen julkaistussa pelissä
- Roblox Creator Docs: Build your first game with Assistant (englanniksi). virheen liittäminen Outputista, jotta Assistant selittää sen
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.