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
Output nasıl açılır ve hata nasıl okunur
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.
- Output'u Studio'daki Window menüsünden ya da Script sekmesindeki butonla aç.
- Sadece bu testi görmek için eski mesajları Ctrl+K (Mac'te ⌘K) ile temizle.
- Play'e (F5) bas ve oyunu bozan şeyi yap.
- İlk kırmızı satırı bul. Hatalar kırmızıdır.
Infinite yield possiblegibi 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.
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.CoinPadscriptin Explorer'daki yeridir: ServerScriptService içindeki CoinPad adlı script.:14hatanı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
awardfonksiyonunun 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.
- 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.
- İ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ç.
- 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. - Değeri tahmin etme, kontrol et. Satırın hemen üstüne bir
printekle 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. - İ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. - 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
pcalliçine sarma: böyle hata düzelmez, saklanır. - 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.
- 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 ne yazıyor | Ne demek | Genellikle 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 value | Fonksiyon 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 number | Sayı 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 loading | ModuleScript'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 nil | Bir 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 client | RemoteEvent yanlış taraftan çağrıldı. | Sunucu FireClient, LocalScript'ler FireServer kullanır. |
Data store hatası 403, StudioAccessToApisNotAllowed | Studio'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,FindFirstChildOfClassya daFindFirstAncestorhiçbir şey bulmadı, çünkü ad farklı ya da nesne henüz yok.Players.LocalPlayerbir sunucu Script'inde kullanıldı. O sadece LocalScript'lerde ve onların require ettiği ModuleScript'lerde var; sunucuda her zaman nil. Onun yerinePlayerAdded'ın ya da RemoteEvent işleyicisinin verdiğiplayer'ı kullan.player.Characterkarakter 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.
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")leaderstatsklasö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"):CharacterPlayer'ı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.
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,humanoiddaHumanoiddeğil. - Özellik adları Amerikan İngilizcesiyle yazılır.
part.ColourColour 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
WaitForChildkullan.
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.clocktanımlıyor, çağıran kod iseFormat.Clock(95)yazıyor. - Bir
local functiontanı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 + 10olmalı.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. Onutonumber(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.
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şlayanfunction,if,forya dawhile'ın kendiend'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 fazlaend.
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ülreturnile 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şı.
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.
| Neyi kontrol etmeli | Ne yanlış gidiyor | Nasıl düzeltilir |
|---|---|---|
| Scriptin tipi ve yeri | LocalScript 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. |
| Enabled | Enabled işareti kaldırılmış bir script çalışmaz. | Onu seç ve Properties penceresinde Enabled'ı işaretle. |
| RunContext | Bir 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 tetiklenmiyor | Touched 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 kod | while 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 kontrol | if not coins then return end gibi bir koruma, nesne yokken fonksiyonu sessizce durdurur. | return'den önce ayrıntılarla bir warn ekle. |
| Output filtreleri | Output 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üyorsun | Değ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:
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ı
Bağlamlı print ve warn
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.
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.
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.
- 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
- Roblox Creator Docs: Output (İngilizce). Output nerede, filtreleri ve görüntüleme ayarları
- Roblox Creator Docs: Debugging (İngilizce). breakpoint'ler, adım adım çalıştırma, Watch, Call Stack, command bar ve Developer Console
- Roblox Creator Docs: Script Editor (İngilizce). Script Analysis penceresi
- Roblox Creator Docs: Studio interface (İngilizce). Output ve command bar nereden açılır
- Roblox Creator Docs: Script types and locations (İngilizce). her script tipi nerede çalışır ve RunContext
- Roblox Creator Docs: Studio testing modes (İngilizce). Play, Client ve Server görünümleri ve Server & Clients testleri
- Roblox Engine API: Instance (İngilizce). WaitForChild, zaman aşımı ve 5 saniye sonraki uyarı
- Roblox Creator Docs: Reuse code (İngilizce). ModuleScript ve özyinelemeli require
- Roblox Creator Docs: Data store error codes and limits (İngilizce). hata 403, StudioAccessToApisNotAllowed
- Roblox Creator Docs: Data stores (İngilizce). Studio erişimini açmak ve ayrı bir test kopyası
- Roblox Engine API: BasePart (İngilizce). Touched ne zaman tetiklenir ve CanTouch
- Roblox Creator Docs: Type checking (İngilizce). strict mod
- Roblox Creator Docs: Developer Console (İngilizce). canlı oyunda sunucu çıktısını kim görür
- Roblox Creator Docs: Build your first game with Assistant (İngilizce). Assistant açıklasın diye Output'taki hatayı yapıştırmak
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.