Rehber · Hata ayıklama

Roblox Studio'da script hataları nasıl düzeltilir

Roblox'ta bir script bozulduğunda Studio genellikle nerede ve neden olduğunu Output penceresine yazar. Bu rehberde bu mesajın nasıl okunacağını, sık hataların ne anlama geldiğini ve her birinin nasıl düzeltileceğini, script hiç hata vermeden çalışmıyorsa neyin kontrol edileceğini ve tahmin etmek yerine nedeni bulan adım sırasını ele alıyoruz.

Güncellendi: 20 Kasım 202616 dk okumaYazan:

Kısaca

Output penceresini Window menüsünden ya da Script sekmesinden aç, Play'e bas ve ilk kırmızı hataya tıkla. Studio scripti çöktüğü satırda açar. Mesaj neyin yanlış gittiğini söyler: attempt to index nil with 'Humanoid', .Humanoid'in hemen önündeki değerin nil olduğu anlamına gelir. Bu değerin neden olmadığını düzelt ve oyunu tekrar çalıştır.

  • Listedeki ilk hatadan başla. Alttaki hatalar çoğu zaman sadece onun sonuçlarıdır.
  • Oyun sırasındaki sık hatalar üç nedene iner: değer nil, bir ad yanlış yazılmış ya da henüz yüklenmemiş, ya da kod yanlış tarafta (sunucu ya da client) çalışıyor.
  • Hiç hata yoksa genellikle kod hiç çalışmamıştır. Scriptin tipini, Explorer'da nerede durduğunu, Enabled özelliğini ve beklediği event'in hiç tetiklenip tetiklenmediğini kontrol et.
  • Bir değerin ilgili satırda gerçekte ne olduğunu öğrenmek için onu etiketli bir print ile yazdır ya da o satıra bir breakpoint koy.
Bu sayfada
  1. Output'u okumak
  2. Hata ayıklama sırası
  3. Sık hatalar
  4. Hata yok, bir şey olmuyor
  5. Hata ayıklama araçları
  6. RoCode ile
  7. Sık sorulan sorular
  8. Kaynaklar ve ek okumalar

Output nasıl açılır ve hata nasıl okunur

ÇizimRehberdeki öldüren blok örneği, hızlandırılmış: bozuk satır hata veriyor, Stop, düzeltme ve yeni bir oyun testinden sonra part hatasız düşüyor.

Output penceresi Roblox'un script hatalarını, motor uyarılarını ve kodunun yazdırdığı her şeyi bildirdiği yerdir. Her zaman açık değildir, bu yüzden testten önce aç. Daha önce hiç script çalıştırmadıysan yeni başlayanlar için script rehberi Output'u açıp bir scriptten ilk satırı yazdırarak başlıyor.

  1. Output'u Studio'daki Window menüsünden ya da Script sekmesindeki butonla aç.
  2. Sadece bu testi görmek için eski mesajları Ctrl+K (Mac'te ⌘K) ile temizle.
  3. Play'e (F5) bas ve oyunu bozan şeyi yap.
  4. İlk kırmızı satırı bul. Hatalar kırmızıdır. Infinite yield possible gibi uyarılar turuncu gösterilir.

Oyun sırasındaki bir hata Output'ta böyle görünür. Output'un görüntüleme ayarlarına göre her satırda ayrıca saat, Client ya da Server etiketi ve scriptin adı olabilir.

Output (örnek)
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 scriptin Explorer'daki yeridir: ServerScriptService içindeki CoinPad adlı script.
  • :14 hatanın olduğu satırdır.
  • Satır numarasından sonraki mesaj neyin yanlış gittiğini söyler. Her biri aşağıdaki sık hatalar listesinde anlatılıyor.
  • Stack Begin ile Stack End arasındaki stack, en sonuncudan başlayarak buraya getiren çağrıları gösterir: 27. satırdan çağrılan award fonksiyonunun içindeki 14. satır.

Kırmızı hataya tıkla, Studio o scripti imleç ilgili satırdayken açar. Tek kişilik testte sunucunun ve senin client'ının mesajları aynı Output'a gider: sunucunun mesajları yeşil, client'ınkiler mavi işaretlenir. Üstteki filtreler listeyi mesaj tipine (Error, Warning), bağlama (Client, Server) ya da metne göre daraltır.

Her script için işe yarayan hata ayıklama sırası

Tahmin edip aynı anda birkaç şeyi değiştirmek bir scripti düzeltmenin yavaş yoludur. Bu sıra, hata mesajı olsun ya da olmasın, sorunu adım adım daraltır.

  1. Sorunu tekrarla. Output'u temizle, Play'e bas ve oyunu bozan şeyi tam olarak yap. Ne beklediğini ve onun yerine ne olduğunu not et.
  2. İlk hatayı al. İlk yeni kırmızı satırı oku: scriptin yolu, satır numarası ve mesaj. Hata yoksa hatasız çalışan scriptler bölümüne geç.
  3. Satıra git. Hataya tıkla. Satırın tamamını oku ve kendine içindeki hangi değerin nil, yanlış yazılmış ya da yanlış tipte olabileceğini sor.
  4. Değeri tahmin etme, kontrol et. Satırın hemen üstüne bir print ekle ya da oraya bir breakpoint koy ve değerlere Watch penceresinde bak. typeof(x) elinde ne olduğunu söyler: sayı, string, Instance ya da nil.
  5. İzi geriye doğru takip et. Değer yanlışsa nerede ayarlandığını bul: hiçbir şey bulamayan bir FindFirstChild, hiçbir şey döndürmeyen bir fonksiyon, çağıran kodun hiç vermediği bir argüman.
  6. Nedeni düzelt, her seferinde tek değişiklik. Adı düzelt, nesneyi bekle ya da kodu doğru tarafa taşı, sonra oyunu tekrar çalıştır. Satırı susturmak için pcall içine sarma: böyle hata düzelmez, saklanır.
  7. Emin ol. 1. adımı tekrarla. Hata kaybolmalı, özellik de beklediğin şeyi yapmalı. Konu diğer oyuncularsa iki client ile Server & Clients modunda da test et.
  8. Arkanı topla. Bir sonraki sorunu fark etmek kolay olsun diye hata ayıklama print'lerini sil ya da kapat.

Sık Roblox script hataları ve nasıl düzeltilir

Her mesaj senin adlarının yerleştirildiği tek bir kalıba göre kurulur, bu yüzden hatanın metni en iyi ipucudur. Aşağıdaki tırnak içindeki adlar, örneğin 'Health' ya da "Workspace", örnektir.

Output'taki sık hatalar. Tam açıklamayı açmak için bir mesaj seç.
Output ne yazıyorNe demekGenellikle nasıl düzeltilir
attempt to index nil with 'Health'.Health'in önündeki değer nil'di.Neden nil olduğunu bul ve kullanmadan önce if ile kontrol et.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild 5 saniyedir bekliyor ve nesne hâlâ çıkmadı.Adı ya da yolu düzelt, nesneyi birinin oluşturduğundan emin ol ya da bir zaman aşımı ekle.
Bridge is not a valid member of Workspace "Workspace"Orada şu an tam bu adda bir alt nesne ya da özellik yok.Yazımı ve büyük harfleri Explorer ile karşılaştır. Client'ta WaitForChild kullan.
attempt to call a nil valueFonksiyon olmayan bir şeyi çağırdın.Fonksiyonun adını ve çağrıdan önce tanımlandığını kontrol et.
attempt to perform arithmetic (add) on Instance and numberSayı olmayan bir şeyle matematik.Value nesnelerinde .Value, metin için tonumber kullan.
attempt to concatenate string with nil.. metni nil ya da bir nesneyle birleştirmeye çalıştı.tostring(), .Name ya da string interpolasyonu kullan.
Expected 'end' (to close 'function' at line 3), got <eof>Sözdizimi hatası. Script hiç çalışmaz.Script Editor'da kırmızıyla altı çizileni düzelt.
Requested module experienced an error while loadingModuleScript'in kendisi çalışırken hatayla çöktü.Modülün kendi hatasını düzelt, Output'ta biraz yukarıda gösteriliyor.
Argument 1 missing or nilBir Roblox fonksiyonu değere ihtiyaç duyduğu yerde nil aldı.Bu argümanın nereden gelmesi gerektiğini takip et.
FireServer can only be called from the clientRemoteEvent yanlış taraftan çağrıldı.Sunucu FireClient, LocalScript'ler FireServer kullanır.
Data store hatası 403, StudioAccessToApisNotAllowedStudio'nun bu oyunun data store'larını kullanmasına izin verilmiyor.Oyunu yayınla ve Studio Access to API Services'ı aç.

Buradaki ve daha fazla mesajın her nedeni, ona yol açan kodu ve düzeltmeyi içeren kendi sayfası var: Roblox Studio hata mesajlarına bak (İngilizce), örneğin attempt to index nil, Infinite yield possible ve is not a valid member of.

attempt to index nil with 'X'

Index etmek, bir şeyi nokta ya da köşeli parantezle okumaktır: part.Position, player.Character, list[1]. Bu hata soldaki şeyin nil olduğunu söyler, tırnak içindeki ad da ondan okumaya çalıştığın şeydir. Yani player.Character.Humanoid satırında attempt to index nil with 'Humanoid' hatası, player.Character'ın nil olduğu anlamına gelir. Anahtar bir sayıysa mesaj with number ile biter.

Değerin nil olmasının olağan nedenleri:

  • FindFirstChild, FindFirstChildOfClass ya da FindFirstAncestor hiçbir şey bulmadı, çünkü ad farklı ya da nesne henüz yok.
  • Players.LocalPlayer bir sunucu Script'inde kullanıldı. O sadece LocalScript'lerde ve onların require ettiği ModuleScript'lerde var; sunucuda her zaman nil. Onun yerine PlayerAdded'ın ya da RemoteEvent işleyicisinin verdiği player'ı kullan.
  • player.Character karakter spawn olmadan ya da yeniden doğarken okundu.
  • Tablodaki bir kayıt hiç ayarlanmadı, örneğin o oyuncunun verisi yüklenmeden playerData[player], ya da çağrılan fonksiyon hiçbir şey döndürmedi.

Klasik örnek öldüren blok. Bozuk sürüm part'a dokunan her şeyin bir karaktere ait olduğunu varsayar, oysa atılmış araçlar, anchor'sız part'lar ve aksesuarlar için bu doğru değil.

Script konum: Workspace'teki Part adı: KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- Bozuk sürüm:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- Dokunan part bir karakterin vücudunun parçası değilse FindFirstChild
	-- nil döndürür ve Output şunu gösterir:
	--   attempt to index nil with 'Health'

	-- Düzeltildi: kullanmadan önce her adımı kontrol ediyoruz
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

hit.Parent.Humanoid yazarsan farklı bir mesaj alırsın, Humanoid is not a valid member of ..., o aşağıda anlatılıyor. FindFirstAncestorOfClass("Model"), dokunan part karakterin elindeki bir aksesuarın ya da aracın içinde olduğunda da karakteri bulur, yani bloğa değen eldeki araç da sayılır.

Bu hatayı düzelten kalıp: değeri al, kontrol et ve ancak sonra kullan. Sunucuda, olmayabilecek şeyler için if kontrollü FindFirstChild uygundur. LocalScript'te sunucunun oluşturduğu şeyler için WaitForChild kullan, çünkü script başladıktan sonra çıkabilirler.

Infinite yield possible on ...

WaitForChild("Name") bu adda bir alt nesne çıkana kadar scripti duraklatır. 5 saniyeden fazla beklerse ve sen bir zaman aşımı vermediysen Roblox bu uyarıyı yazdırır. Bu bir hata değil uyarı: script hâlâ bekliyor ve nesne çıkana kadar bu satırdan sonraki hiçbir şey çalışmaz, bu da hiç olmayabilir. Olağan nedenler:

  • Yanlış ad ya da parent. WaitForChild("leaderStats") leaderstats klasörünü asla bulamaz.
  • Nesneyi kimse oluşturmuyor: onu yapan sunucu scripti kapalı, yanlış yerde ya da daha önce hatayla çöktü. Output'ta daha önceki bir hatayı ara.
  • Bir LocalScript ServerStorage'da ya da ServerScriptService'te bir şey bekliyor. Bunların içeriği oyunculara asla gönderilmez, bu yüzden bekleme bitmez.
  • Alt nesneyi değil bir özelliği bekliyorsun. Sık bir örnek player:WaitForChild("Character"): Character Player'ın bir özelliği, içindeki bir nesne değil.
  • Instance streaming açık (Workspace.StreamingEnabled) ve part oyuncudan çok uzakta, bu yüzden bu client'a henüz gönderilmedi.
LocalScript konum: StarterPlayerScripts adı: DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Bozuk sürüm:
--   local character = player:WaitForChild("Character")
-- Character, Player'ın bir özelliği, alt nesne değil, bu yüzden Output uyarır:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- Zaman aşımıyla WaitForChild sonsuza kadar beklemek yerine nil döndürür
	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

-- Zaten var olabilecek karakteri, sonra her yeniden doğmayı işliyoruz
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

WaitForChild'ın ikinci argümanı olan sayı saniye cinsinden zaman aşımıdır. O zaman script sessizce takılı kalmak yerine sorunu warn ile bildirip düzgünce durabilir.

X is not a valid member of Y

O anda var olmayan bir alt nesneye ya da özelliğe noktayla eriştin, örneğin Workspace'te Bridge adında bir part yokken workspace.Bridge. Mesajda önce istediğin şey, sonra içinde aradığın nesnenin sınıfı ve tam yolu gelir. Üç şeyi kontrol et:

  • Yazım ve büyük harfler Explorer ile tam olarak eşleşiyor. Klasörün adı tamamen küçük harfle leaderstats, humanoid da Humanoid değil.
  • Özellik adları Amerikan İngilizcesiyle yazılır. part.Colour Colour is not a valid member of Part "Workspace.Part" ile çöker; özelliğin adı Color.
  • Nesne yüklendi. Client'ta sunucunun oluşturduğu nesneler LocalScript başladıktan sonra gelebilir, bu yüzden orada WaitForChild kullan.
LocalScript konum: StarterPlayerScripts adı: CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Bozuk sürüm:
--   local coins = player.leaderstats.Coins
-- leaderstats'ı sunucu oluşturur ve bu client'a bu script başladıktan
-- sonra ulaşabilir. O zaman Output şunu gösterir:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- sunucu Coins'i IntValue olarak yapar

print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
	print(`[CoinsWatcher] coins changed to {newValue}`)
end)

Burada leaderboard rehberindeki (İngilizce) gibi Coins adlı bir IntValue ile leaderstats oluşturan bir sunucu scripti gerekiyor.

attempt to call a nil value

Kod nil olan bir şeyin arkasına parantez koydu, bu yüzden çalıştırılacak bir şey yoktu. Olağan nedenler:

  • Fonksiyonun adı yanlış yazılmış ya da büyük harfleri farklı. Modül Format.clock tanımlıyor, çağıran kod ise Format.Clock(95) yazıyor.
  • Bir local function tanımlandığı satırın üstünde çağrılıyor. O anda ad henüz yok, bu yüzden tanımı yukarı taşı.
  • ModuleScript fonksiyonu döndürdüğü tabloya hiç eklemiyor.

İki benzer mesaj aynı hataya işaret eder. Bir tablonun var olmayan bir metodunu iki noktayla çağırmak attempt to call missing method 'Kill' of table verir. Bir Roblox nesnesinin metodunda yazım hatası, örneğin part:Destory(), Destory is not a valid member of Part "Workspace.Part" verir.

attempt to perform arithmetic (add) on ...

Luau hesap yapmaya çalıştı (add, sub, mul, div ve benzerleri), ama taraflardan biri sayı değildi. Mesajın sonundaki tip adları hangi durumda olduğunu söyler:

  • on Instance and number: sayısıyla değil bir value nesnesiyle hesap yaptın. coins + 10, coins.Value + 10 olmalı.
  • on nil and number: değişken ya da tablodaki kayıt hiç ayarlanmadı. Ona bir başlangıç değeri ver ya da değerin olmamasının gerçekten sıfır demek olduğu yerde (x or 0) yaz.
  • on string and number: sayı olmayan bir metin, çoğu zaman bir TextBox'tan. Onu tonumber(text) ile çevir ve sonucun nil olmadığını kontrol et. İçinde sayı yazan bir metin, örneğin "5", otomatik çevrilir.

Karşılaştırmalar da aynı şekilde, attempt to compare nil < number ile bozulur. Luau a > b'yi b < a olarak yeniden yazar, bu yüzden mesajdaki sıra kodundakinin tersi olabilir.

Script konum: ServerScriptService adı: 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
		-- Susmak yerine neden hiçbir şey olmadığını yazıyoruz
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- Bozuk sürüm:
	--   coins = coins + amount
	-- coins bir IntValue nesnesi, sayısı değil, bu yüzden Output şunu gösterir:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- Her dakika sunucudaki her oyuncuya biraz coin veriyoruz
while true do
	task.wait(INTERVAL_SECONDS)
	for _, player in Players:GetPlayers() do
		addCoins(player, REWARD)
	end
end

attempt to concatenate string with nil

.. operatörü sadece string'leri ve sayıları birleştirir. nil ile birleştirilemez, bir nesneyle de: "Hi " .. player attempt to concatenate string with Instance verir. player.Name kullan, değeri tostring() içine sar ya da scripti durdurmak yerine nil yazdıran ters tırnaklı string interpolasyonunu kullan, print(`Coins: {coins}`).

Expected 'end' ve diğer sözdizimi hataları

Expected ile başlayan mesajlar sözdizimi hatalarıdır: kod geçerli Luau değil, Roblox onu derleyemez ve hatanın üstündekiler dahil bu scriptin tek bir satırı bile çalışmaz. Script Editor onları daha yazarken kırmızıyla altını çizer, yani Play'e basmadan düzeltebilirsin.

  • Expected 'end' (to close 'function' at line 3), got <eof>: 3. satırda başlayan function, if, for ya da while'ın kendi end'i yok. Mesajın önündeki satır numarası çoğu zaman dosyanın sonunu gösterir, bu yüzden parantez içinde adı geçen satıra bak.
  • Expected 'then' when parsing if statement, got '=': koşulda tek bir =. Karşılaştırma için == gerekir.
  • Expected ')' (to close '(' at line 1), got 'local': parantez hiç kapatılmadı.
  • Expected <eof>, got 'end': bir fazla end.

Düzgün girintiyle eksik ya da fazla bir end'i fark etmek kolaydır, çünkü her blok onu kapatan end ile aynı seviyede durur.

Requested module experienced an error while loading

Bir ModuleScript'in ilk require()'ı onun kodunu çalıştırır. Modül çalışırken hatayla çökerse onu require eden script bu mesajı alır. Asıl sorun modülün Output'ta bir iki satır yukarıdaki kendi hatası: onu düzelt. İki benzer mesaj:

  • Module code did not return exactly one value: modül return ile bitmiyor. Bir ModuleScript nil olmayan tek bir değer döndürmeli, genellikle kendi tablosunu.
  • Requested module was required recursively: iki modül birbirini require ediyor. Ortak kısmı ikisinin de require ettiği üçüncü bir modüle taşı.
ModuleScript konum: ReplicatedStorage adı: Format
local Format = {}

-- Saniye sayısını dakika ve saniyeye çevirir: 95, "1:35" olur
function Format.clock(seconds: number): string
	local whole = math.max(0, math.floor(seconds))
	return string.format("%d:%02d", whole // 60, whole % 60)
end

-- Modül sonunda kendi tablosunu döndürmeli. Bu satır olmadan bu modülün her
-- require'ı şununla çöker: Module code did not return exactly one value
return Format

Bir script onu local Format = require(ReplicatedStorage:WaitForChild("Format")) ile require eder, sonra Format.clock(95) çağırır. Format.Clock(95) yazarsan attempt to call a nil value hatasını alırsın.

Argument 1 missing or nil

Bir Roblox fonksiyonu ihtiyaç duyduğu bir argümanda nil aldı, sayı da tam olarak hangisinde olduğunu söyler. workspace:FindFirstChild(itemName), itemName nil olduğunda böyle çöker. Hata nadiren bu satırdadır. Değerin gelmesi gereken yerdedir: yazım hatalı bir değişken, hiç ayarlanmamış bir attribute ya da client'ın göndermediği bir RemoteEvent argümanı. RemoteEvent argümanları oyuncunun cihazından gelir, bu yüzden sunucu onları kullanmadan önce kontrol etmeli. Bunun nasıl yapılacağını RemoteEvent rehberi (İngilizce) gösteriyor.

FireServer can only be called from the client

Bir RemoteEvent'in yönü vardır. LocalScript FireServer çağırır, sunucu Script'i de OnServerEvent ile dinler. Sunucu Script'i FireClient ya da FireAllClients çağırır, LocalScript'ler de OnClientEvent ile dinler. Metodu yanlış taraftan çağırmak bu hatayı ya da aynasını verir, FireClient can only be called from the server. Düzeltme genellikle kodu doğru tipteki scripte taşımaktır: Script, LocalScript ve ModuleScript'e bak (İngilizce).

Studio'da data store hatası 403

Studio'daki data store çağrıları, sen izin verene kadar 403 hata koduyla (StudioAccessToApisNotAllowed) çöker. Place'i yayınla, File, Experience Settings, Security'yi aç, Enable Studio Access to API Services'ı aç ve kaydet. Bundan sonra Studio canlı oyunla aynı data store'ları kullanır, bu yüzden Roblox bunu zaten oynanan oyunda değil ayrı bir test kopyasında yapmayı öneriyor. Her data store çağrısını pcall içine sar, çünkü bu çağrılar kodunun dışındaki nedenlerle çökebilir. Güvenli kaydetme DataStore eğitiminde anlatılıyor.

Script hatasız çalışıyor ama hiçbir şey yapmıyor

Sessiz bir script genellikle hiç çalışmamıştır, hâlâ bir şey bekliyordur ya da yanlış tarafta çalışmıştır. Kodu değiştirmeden önce ilk satırını print(script:GetFullName(), "started") yap ve oyunu çalıştır. Bu satır Output'ta hiç çıkmadıysa sorun içinde yazanda değil, scriptin nerede durduğunda ya da nasıl ayarlandığındadır.

Bir script neden hata vermeden hiçbir şey yapmayabilir
Neyi kontrol etmeliNe yanlış gidiyorNasıl düzeltilir
Scriptin tipi ve yeriLocalScript sadece StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack ya da ReplicatedFirst'e konursa çalışır (Starter kapsayıcılarından oyuncunun kopyası olarak çalışır). Workspace'e, ServerScriptService'e ya da ReplicatedStorage'a konursa asla çalışmaz. Varsayılan RunContext'li bir Script sadece Workspace'te ya da ServerScriptService'te çalışır.Onu taşı ya da başka bir script tipi kullan. Arayüz ve kontrol kodu LocalScript'e, oyun kuralları ServerScriptService'teki bir Script'e gider.
EnabledEnabled işareti kaldırılmış bir script çalışmaz.Onu seç ve Properties penceresinde Enabled'ı işaretle.
RunContextBir Script'in RunContext'i nerede çalışacağına karar verir. Varsayılan değer Legacy, Workspace'ten ya da ServerScriptService'ten sunucuda çalışır. Server sunucuda çalışır, Client her oyuncunun cihazında çalışır, örneğin ReplicatedStorage'tan.Bilinçli olarak ayarla. Roblox dokümantasyonu Client Script'leri ReplicatedStorage'a ya da ReplicatedFirst'e, LocalScript'leri Starter kapsayıcılarına koymayı öneriyor.
Event tetiklenmiyorTouched sadece fiziksel hareketle tetiklenir, iki part'tan en az birinin anchor'sız olması ve ikisinde de CanTouch gerekir. PlayerAdded, event'e bağlandığında zaten sunucuda olan oyuncular için tetiklenmez. Diğer taraf event'i hiç tetiklemiyorsa RemoteEvent işleyicisi çalışmaz.Çalışıp çalışmadığını kesin öğrenmek için işleyicinin içine bir print koy, sonra onu tetiklemesi gereken şeyi düzelt.
Döngüden ya da beklemeden sonraki kodwhile true do döngüsünün altındaki satırlar asla çalışmaz, çünkü döngü bitmez. Nesneyi hiç bulamayan bir WaitForChild'ın altındaki satırlar da çalışmaz.Event'leri döngüden önce bağla ya da döngüyü task.spawn ile başlat. Beklemelere zaman aşımı ver.
Sessizce çıkan bir kontrolif not coins then return end gibi bir koruma, nesne yokken fonksiyonu sessizce durdurur.return'den önce ayrıntılarla bir warn ekle.
Output filtreleriOutput mesaj tipine, Client ya da Server'a ve metne göre filtrelenebilir. Unutulmuş bir filtre aradığın hatayı saklayabilir.Filtreleri sıfırla ve arama kutusunu temizle.
Sadece sen görüyorsunDeğişikliği bir LocalScript yaptı, bu yüzden onu sadece o oyuncu görür. Sunucu ve diğer oyuncular görmez.Değişikliği sunucuda yap. Scriptlerin nerede çalıştığına bak (İngilizce).

PlayerAdded durumuna çok kişi takılır, çünkü Studio testinde sunucu başladıktan neredeyse hemen sonra girersin. Connect satırının üstünde bir şey bekliyorsa, örneğin WaitForChild, task.wait ya da bekleyen bir modülün require'ı, bağlantı kurulmadan girmiş olabilirsin. Hem yeni hem de zaten girmiş oyuncuları işle:

Script konum: ServerScriptService adı: Welcome
local Players = game:GetService("Players")

local function onPlayerAdded(player: Player)
	print(`[Welcome] {player.Name} joined`)
end

Players.PlayerAdded:Connect(onPlayerAdded)

-- Yukarıdaki satır çalıştığında zaten burada olan oyuncular için
-- bu scriptte PlayerAdded tetiklenmez, bu yüzden onları şimdi işliyoruz
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Roblox Studio'daki hata ayıklama araçları

print Output'a bir satır yazar, warn da bir uyarı yazar. "Bu hiç çalıştı mı?" ve "bu değer ne?" sorularını cevaplamanın en hızlı yolu bu. Çıplak bir print(x)'i sonra bulmak zor, bu yüzden bir etiket ve önemli ayrıntılar ekle. typeof(x) değerin ne olduğunu gösterir: sayı, string, Instance ya da nil, GetFullName() da elindeki nesnenin tam olarak hangisi olduğunu gösterir.

Script konum: ServerScriptService adı: ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- bitirince false yap
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 ve ClassName değerin gerçekte ne olduğunu gösterir
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

Output'taki arama kutusu metne göre filtreler, bu yüzden [ShopServer] gibi sabit bir etiket sadece bu sistemin satırlarını göstermeni sağlar. Kodun bir satıra nasıl ulaştığını öğrenmen gerekiyorsa debug.traceback() mevcut çağrı stack'ini string olarak döndürür.

Breakpoint'ler ve adım adım çalıştırma

Bir breakpoint oyunu bir satırda duraklatır, böylece o andaki her şeye bakabilirsin. Script Editor'da satır numarasının sağındaki boşluğa tıkla (kırmızı bir daire çıkar), sonra bir oyun testi başlat. Çalışma o satıra gelince oyun duraklar, sarı bir ok da sonraki satırı gösterir. Kodda ilerlemeyi adım adım çalıştırma butonları sağlar:

  • Step Over (F10) mevcut satırı çalıştırır ve sonrakinde durur.
  • Step Into (F11) o satırda çağrılan fonksiyonun içine girer.
  • Step Out (Shift+F11) mevcut fonksiyonu sonuna kadar çalıştırır ve onu çağıran kodda durur.
  • Resume Scripts bir sonraki breakpoint'e kadar devam eder.

Boşluğa sağ tıklamak iki işe yarar tür daha verir. Koşullu breakpoint sadece amount < 0 gibi bir ifade doğru olduğunda duraklatır. Logpoint duraklatmadan Output'a bir mesaj yazar, yani scripti değiştirmeden bir değeri loglayabilirsin.

Watch ve Call Stack

Oyun duraklamışken değerini görmek için Script Editor'da fareyle bir değişkenin üstüne gel. Watch penceresi Variables sekmesinde kapsamdaki tüm değişkenleri gösterir, My Watches sekmesinde de coins.Value + amount gibi herhangi bir ifade girip şu anki değerini görebilirsin. Call Stack penceresi duraklatılmış satıra ulaşmak için hangi fonksiyonun hangisini çağırdığını gösterir. İkisi de Script sekmesinden ya da Window menüsünden açılır.

Script Analysis ve strict mod

Script Editor sorunların altını daha yazarken çizer, Script sekmesindeki Analysis butonuyla açılan Script Analysis penceresi de tüm scriptlerdeki hataları ve uyarıları gösterir. Sözdizimi hatalarını ve bilinmeyen adları Play'e basmadan yakalar. Scriptin ilk satırına --!strict koyarsan Luau'nun strict tip kontrolü açılır, bu da özelliklerdeki yazım hatalarını, yanlış argüman tiplerini ve nil olabilecek değerleri de bildirir. Ama çalışan oyunu göremez: Workspace'te olmayan bir part'ı sadece Output gösterir.

Command bar

Command bar (Script sekmesinde ya da Ctrl+9, Mac'te ⌘9) Luau'yu hemen çalıştırır. Oyun çalışırken bu soru sormanın hızlı bir yolu: print(workspace:FindFirstChild("Bridge")) böyle bir part olup olmadığını söyler, print(#game:GetService("Players"):GetPlayers()) da oyuncuları sayar. Düzenleme modunda command bar'daki kod place'ini gerçekten değiştirir, bu yüzden nesneleri taşıyan ya da silen her şeye dikkat et.

Canlı oyunda Developer Console

Studio'daki Output sadece Studio'da çalışır. Canlı oyunda Developer Console'u açmak için F9'a bas ya da sohbete /console yaz. Log'u kendi cihazından gelen çıktıyı, oyunun sahibiysen ya da onu düzenleme izni olan bir grubun üyesiysen sunucunun çıktısını da gösterir.

Roblox'un yerleşik Assistant'ı da tek bir mesajda yardımcı olabilir: Roblox'un kendi rehberi Output'taki hatayı yapıştırıp Assistant'tan onu açıklamasını istemeyi öneriyor. Assistant yanıt vermeyi bıraktıysa ya da limite takıldığını yazıyorsa Assistant limitleri ve hataları sayfasına bak (İngilizce).

RoCode ile hata düzeltme

RoCode, Roblox Studio için bağımsız bir yapay zeka ajanı: sorunu bir web sohbetinde anlatırsın, Studio plugin'i de açık olan place'ini okur ve düzenler. Hatalarda, zaten çalıştırdığın oyun testine dayanarak yukarıdaki sıranın okuma adımlarını üstlenebilir.

Sen yazarsın

Play'e bastım ve mağaza butonuna tıklamak hiçbir şey yapmıyor. Output attempt to index nil with 'Coins' gösteriyor. Nedenini bul ve düzelt.

RoCode yapar
  • Studio'daki Output'u Check Output aracıyla okur, sen Stop'a bastıktan sonra bile son oyun testindeki Server ve Client satırları dahil
  • Hatadaki scripti Read Script ile açar ve o satırın etrafındaki kodu okur, Search Scripts ile de eksik değerin nerede oluşturulması gerektiğini bulabilir
  • Edit Script ile, o scriptte tam bir bul ve değiştir ile, hedefli bir düzenleme yapar, sonra scripti Studio içinde derleyen Check Script'i çalıştırır (tip kontrolü yapmaz, linter çalıştırmaz ve kodunu çalıştırmaz)
  • Değişiklikleri Studio'ya gruplar hâlinde gönderir ve her grup Studio geçmişinde bir geri alma noktasıdır

Düzeltmeden kendin emin olmak için tekrar Play'e bas ve mağaza butonuna tıkla: plugin 3.9 veya sonrasıyla RoCode kısa bir oyun testi çalıştırıp hataları okuyabilir, plugin 3.9.15 veya sonrasıyla da test karakteri ekrandaki butonlara basabilir, ama sadece kendi test etmeye karar verdiği şeyi kontrol eder, derleme kontrolü de oyun mantığının doğru olup olmadığını söylemez. Hataları okumak her inşanın parçası: bütün bir oyun için inşa, kontrol ve test döngüsü bu kontrolü her sistemden sonra tekrarlar. RoCode Studio'ya nasıl bağlanır.

Sık sorulan sorular

Roblox'ta script hata olmamasına rağmen neden çalışmıyor?

Genellikle script hiç çalışmamıştır (yanlış script tipi ya da kapsayıcı, ya da Enabled kapalı), hâlâ bir şey bekliyordur ya da dinlediği event hiç tetiklenmiyordur. İlk satırdaki bir print hangisi olduğunu gösterir. Yukarıdaki kontrol listesine bak.

Roblox'ta "attempt to index nil" ne demek?

Nokta ya da iki noktanın önündeki değer nil'di, bu yüzden Roblox içine bakamadı. player.Character.Humanoid satırında attempt to index nil with 'Humanoid' hatası, player.Character'ın nil olduğu anlamına gelir: yok ya da henüz yüklenmedi. Değeri kullanmadan önce if ile kontrol et, LocalScript'te de sunucunun oluşturduğu nesneleri WaitForChild ile bekle. Nedenleri hakkında daha fazlası.

Roblox'ta "infinite yield possible" ne demek?

WaitForChild hiç çıkmayan bir alt nesneyi 5 saniyeden fazla bekliyor ve beklemeye devam ediyor. Çoğu zaman ad ya da parent yanlıştır, ya da nesneyi kimse oluşturmuyordur. Nedenleri hakkında daha fazlası.

Output penceresi neden boş ya da görünmüyor?

Onu Window menüsünden ya da Script sekmesinden aç. Açıksa ama test sırasında boş kalıyorsa filtreleri ve arama kutusunu sıfırla, sonra bir şey yazdırması gereken scriptlerin çalıştığını kontrol et.

Roblox'ta scriptleri hatalara karşı kontrol eden bir şey var mı?

Evet, Studio'da yerleşik: Script Editor sorunların altını yazarken çizer, Script Analysis penceresi de onları liste hâlinde gösterir. Sözdizimi ve tip hatalarını bulurlar, ama eksik nesneleri ve yanlış oyun mantığını bulamazlar: bunlar sadece kod çalışırken görünür.

Hata olmasın diye kodu pcall içine sarmalı mıyım?

Sadece kodunun dışındaki nedenlerle çökebilecek çağrıları, örneğin data store, HTTP ya da MarketplaceService istekleri. nil hatasını pcall içine sararsan mesaj kaybolur, ama fonksiyon yine de çalışmaz.

Canlı oyunda script hataları nasıl görülür?

Developer Console'u açmak için oyunda F9'a bas ya da sohbete /console yaz. Kendi cihazından gelen hataları, oyunun sahibiysen ya da onu düzenleyebilen bir grubun üyesiysen sunucudan gelenleri de gösterir.

Kaynaklar ve ek okumalar

Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.