Opas · Virheenjäljitys

Miten korjata skriptivirheet Roblox Studiossa

Kun skripti Robloxissa hajoaa, Studio kertoo yleensä Output-ikkunassa, missä ja miksi. Tässä oppaassa käymme läpi, miten viesti luetaan, mitä yleiset virheet tarkoittavat ja miten kukin korjataan, mitä tarkistaa, jos skripti ei toimi lainkaan eikä virheitä näy, sekä työjärjestyksen, joka löytää syyn arvailun sijaan.

Päivitetty 20. marraskuuta 202616 min lukuaikaKirjoittaja:

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
  1. Outputin lukeminen
  2. Työjärjestys
  3. Yleiset virheet
  4. Ei virheitä, mitään ei tapahdu
  5. Virheenjäljityksen työkalut
  6. RoCodella
  7. Usein kysytyt kysymykset
  8. Lähteet ja lisälukemista

Miten avata Output ja lukea virhe

HavainnollistusOppaan tappavan palikan esimerkki, nopeutettu: rikkinäinen rivi antaa virheen, ja Stopin, korjauksen ja uuden testipelin jälkeen part putoaa ilman virhettä.

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ä.

  1. Avaa Output Studion Window-valikosta tai Script-välilehden painikkeesta.
  2. Tyhjennä vanhat viestit painamalla Ctrl+K (⌘K Macilla), jotta näet vain tämän testin.
  3. Paina Play (F5) ja tee se, mikä rikkoo pelin.
  4. 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.

Output (esimerkki)
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.CoinPad on skriptin paikka Explorerissa: CoinPad-niminen skripti ServerScriptServicen sisällä.
  • :14 on 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 award sisä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.

  1. 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.
  2. 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ä.
  3. Siirry riville. Napsauta virhettä. Lue koko rivi ja kysy itseltäsi, mikä sen arvoista voi olla nil, väärin kirjoitettu tai väärää tyyppiä.
  4. Tarkista arvo, älä arvaa. Lisää print juuri rivin yläpuolelle tai aseta riville keskeytyskohta ja katso arvoja Watch-ikkunassa. typeof(x) kertoo, mitä sinulla on: luku, merkkijono, Instance vai nil.
  5. 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.
  6. 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.
  7. 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.
  8. 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ä.

Yleiset virheet Outputissa. Valitse viesti avataksesi täyden selityksen.
Mitä Output kirjoittaaMitä se tarkoittaaTavallinen 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 valueKutsuit jotain, mikä ei ole funktio.Tarkista funktion nimi ja että se on määritelty ennen kutsua.
attempt to perform arithmetic (add) on Instance and numberLaskutoimitus 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 loadingModuleScript itse kaatui virheeseen suorituksen aikana.Korjaa moduulin oma virhe, joka näkyy hieman ylempänä Outputissa.
Argument 1 missing or nilRoblox-funktio sai nilin kohdassa, jossa se tarvitsee arvon.Selvitä, mistä tämän argumentin piti tulla.
FireServer can only be called from the clientRemoteEventiä kutsuttiin väärältä puolelta.Palvelin käyttää FireClient-metodia, LocalScriptit käyttävät FireServer-metodia.
Datastoren virhe 403, StudioAccessToApisNotAllowedStudio 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, FindFirstChildOfClass tai FindFirstAncestor ei löytänyt mitään, koska nimi on eri tai objektia ei vielä ole.
  • Players.LocalPlayer kä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 sijaan player-arvoa, jonka PlayerAdded tai RemoteEventin käsittelijä antaa.
  • player.Character luettiin 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.

Script kohteessa Part Workspacessa nimeltä KillBrick
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ä kansiota leaderstats.
  • 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"): Character on 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.
LocalScript kohteessa StarterPlayerScripts nimeltä DeathMessage
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, ja humanoid ei ole Humanoid.
  • Ominaisuuksien nimet kirjoitetaan amerikanenglanniksi. part.Colour kaatuu virheeseen Colour is not a valid member of Part "Workspace.Part"; ominaisuuden nimi on Color.
  • Objekti on latautunut. Asiakkaalla palvelimen luomat objektit voivat saapua vasta LocalScriptin käynnistymisen jälkeen, joten käytä siellä WaitForChild-kutsua.
LocalScript kohteessa StarterPlayerScripts nimeltä CoinsWatcher
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 kirjoittaa Format.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 + 10 pitää olla coins.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 se tonumber(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.

Script kohteessa ServerScriptService nimeltä CoinDrip
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 alkavalta function-, if-, for- tai while-lohkolta puuttuu oma end. 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äinen end.

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ääty return-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.
ModuleScript kohteessa ReplicatedStorage nimeltä Format
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.

Miksi skripti voi olla tekemättä mitään ilman virhettä
Mitä tarkistaaMikä menee vikaanMiten korjata
Skriptin tyyppi ja paikkaLocalScript 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ä.
EnabledSkripti, jonka Enabled-ruksi on poistettu, ei käynnisty.Valitse se ja rastita Enabled Properties-ikkunassa.
RunContextScriptin 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 laukeaTouched 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älkeenwhile 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 hiljaaSuojaus kuten if not coins then return end pysäyttää funktion hiljaa, kun objektia ei ole.Lisää warn yksityiskohtineen ennen return-lausetta.
Outputin suodattimetOutputia 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 senMuutoksen 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:

Script kohteessa ServerScriptService nimeltä Welcome
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 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.

Script kohteessa ServerScriptService nimeltä ShopDebug
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.

Sinä kirjoitat

Painoin Playta, ja kaupan painikkeen napsautus ei tee mitään. Output näyttää attempt to index nil with 'Coins'. Etsi syy ja korjaa se.

RoCode tekee
  • 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

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.