Hướng dẫn · Gỡ lỗi

Cách sửa lỗi script trong Roblox Studio

Khi một script Roblox bị hỏng, Studio thường cho bạn biết ở đâu và vì sao trong cửa sổ Output. Hướng dẫn này chỉ cách đọc thông báo đó, ý nghĩa của các lỗi hay gặp và cách sửa từng lỗi, cần kiểm tra gì khi script không chạy mà cũng không báo lỗi, và một trình tự giúp tìm ra nguyên nhân thay vì đoán mò.

Cập nhật ngày 20 tháng 11, 202622 phút đọcTác giả:

Tóm tắt

Mở cửa sổ Output qua menu Window hoặc tab Script, bấm Play và click vào lỗi màu đỏ đầu tiên. Studio sẽ mở script ở đúng dòng bị lỗi. Thông báo cho biết điều gì đã sai: attempt to index nil with 'Humanoid' nghĩa là giá trị ngay trước .Humanoid là nil. Hãy sửa lý do khiến giá trị đó không có, rồi chạy game lại.

  • Bắt đầu từ lỗi đầu tiên trong danh sách. Các lỗi bên dưới thường chỉ là hệ quả của nó.
  • Các lỗi hay gặp lúc chạy game quy về ba nguyên nhân: một giá trị là nil, một cái tên bị viết sai hoặc chưa tải xong, hoặc code chạy sai phía (server hay client).
  • Nếu hoàn toàn không có lỗi, thường là code chưa hề chạy. Kiểm tra loại script, vị trí của nó trong Explorer, thuộc tính Enabled của nó, và sự kiện mà nó chờ có thực sự xảy ra không.
  • Để biết thật sự một giá trị bằng gì ở dòng cần xem, hãy in nó ra bằng print kèm nhãn hoặc đặt breakpoint ở dòng đó.
Trong trang này
  1. Đọc Output
  2. Trình tự gỡ lỗi
  3. Lỗi hay gặp
  4. Không lỗi, không có gì xảy ra
  5. Công cụ gỡ lỗi
  6. Với RoCode
  7. Câu hỏi thường gặp
  8. Nguồn và tài liệu đọc thêm

Cách mở Output và đọc một lỗi

Minh họaVí dụ khối giết người trong hướng dẫn, tua nhanh: dòng bị hỏng báo lỗi, còn sau khi Stop, sửa và playtest lại, part rơi xuống mà không có lỗi.

Cửa sổ Output là nơi Roblox báo lỗi script, cảnh báo của engine và mọi thứ code của bạn in ra. Nó không phải lúc nào cũng mở sẵn, nên hãy mở nó trước khi test. Nếu bạn chưa từng chạy script nào, hướng dẫn học script cho người mới bắt đầu bằng việc mở Output và in dòng đầu tiên từ một script.

  1. Mở Output qua menu Window trong Studio hoặc bằng nút trên tab Script.
  2. Xóa các thông báo cũ bằng Ctrl+K (⌘K trên Mac), để chỉ thấy lần test này.
  3. Bấm Play (F5) và làm đúng việc khiến game bị hỏng.
  4. Tìm dòng màu đỏ đầu tiên. Lỗi có màu đỏ. Cảnh báo, ví dụ Infinite yield possible, hiện màu cam.

Một lỗi lúc chạy game trong Output trông như thế này. Tùy cài đặt hiển thị của Output, mỗi dòng còn có thể có thời gian, nhãn Client hoặc Server và tên script.

Output (ví dụ)
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 là vị trí của script trong Explorer: một script tên CoinPad bên trong ServerScriptService.
  • :14 là dòng xảy ra lỗi.
  • Thông báo sau số dòng cho biết điều gì đã sai. Mỗi thông báo được giải thích trong danh sách lỗi hay gặp bên dưới.
  • Stack giữa Stack Begin và Stack End cho thấy các lệnh gọi dẫn tới đây, bắt đầu từ lệnh gần nhất: dòng 14 bên trong hàm award, được gọi từ dòng 27.

Click vào lỗi màu đỏ, và Studio mở script đó với con trỏ ở đúng dòng. Khi test một mình, thông báo của server và client của bạn cùng vào một Output: thông báo server có nhãn màu xanh lá, thông báo client màu xanh dương. Các bộ lọc ở trên thu hẹp danh sách theo loại thông báo (Error, Warning), theo ngữ cảnh (Client, Server) hoặc theo chữ.

Trình tự gỡ lỗi dùng được cho mọi script

Đoán mò và đổi nhiều thứ cùng lúc là cách sửa script chậm nhất. Trình tự này thu hẹp vấn đề từng bước một, dù có thông báo lỗi hay không.

  1. Tái hiện vấn đề. Xóa Output, bấm Play và làm đúng việc khiến game bị hỏng. Ghi lại bạn mong đợi điều gì và điều gì đã xảy ra thay vào đó.
  2. Lấy lỗi đầu tiên. Đọc dòng đỏ mới đầu tiên: đường dẫn script, số dòng và thông báo. Nếu không có lỗi, chuyển tới phần script chạy mà không báo lỗi.
  3. Tới đúng dòng. Click vào lỗi. Đọc cả dòng và tự hỏi giá trị nào trong đó có thể là nil, bị viết sai hoặc sai kiểu.
  4. Kiểm tra giá trị, đừng đoán. Thêm một print ngay phía trên dòng đó hoặc đặt breakpoint trên nó và xem giá trị trong cửa sổ Watch. typeof(x) cho biết bạn đang có gì: số, string, Instance hay nil.
  5. Lần ngược dấu vết. Nếu giá trị sai, tìm nơi nó được gán: một FindFirstChild không tìm thấy gì, một hàm không trả về gì, một đối số mà code gọi hàm chưa bao giờ truyền vào.
  6. Sửa nguyên nhân, mỗi lần một thay đổi. Sửa tên, chờ object hoặc chuyển code sang đúng phía, rồi chạy game lại. Đừng bọc dòng đó trong pcall để nó im lặng: làm vậy là giấu bug chứ không sửa bug.
  7. Xác nhận. Lặp lại bước 1. Lỗi phải biến mất, và tính năng phải làm đúng điều bạn mong đợi. Nếu liên quan tới người chơi khác, hãy test thêm ở chế độ Server & Clients với hai client.
  8. Dọn dẹp. Xóa hoặc tắt các print gỡ lỗi, để vấn đề tiếp theo dễ thấy.

Các lỗi script Roblox hay gặp và cách sửa

Mỗi thông báo theo một mẫu cố định có điền tên của bạn vào, nên bản thân nội dung lỗi là gợi ý tốt nhất. Các tên trong ngoặc kép bên dưới, ví dụ 'Health' hay "Workspace", chỉ là ví dụ.

Các lỗi hay gặp trong Output. Chọn một thông báo để mở phần giải thích đầy đủ.
Output viết gìNghĩa là gìCách sửa thường gặp
attempt to index nil with 'Health'Giá trị trước .Health là nil.Tìm hiểu vì sao nó là nil, và kiểm tra nó bằng if trước khi dùng.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild đã chờ 5 giây mà object vẫn chưa xuất hiện.Sửa tên hoặc đường dẫn, đảm bảo có thứ gì đó tạo ra object, hoặc thêm timeout.
Bridge is not a valid member of Workspace "Workspace"Hiện không có object con hay thuộc tính nào với đúng tên đó ở đó.Đối chiếu cách viết và chữ hoa với Explorer. Trên client hãy dùng WaitForChild.
attempt to call a nil valueBạn đã gọi một thứ không phải là hàm.Kiểm tra tên hàm và việc nó được khai báo phía trên lệnh gọi.
attempt to perform arithmetic (add) on Instance and numberLàm toán với một thứ không phải số.Dùng .Value với value object và tonumber với chữ.
attempt to concatenate string with nil.. cố nối chữ với nil hoặc một object.Dùng tostring(), .Name hoặc nội suy chuỗi.
Expected 'end' (to close 'function' at line 3), got <eof>Lỗi cú pháp. Script hoàn toàn không chạy.Sửa chỗ bị gạch đỏ trong Script Editor.
Requested module experienced an error while loadingChính ModuleScript bị lỗi trong lúc chạy.Sửa lỗi riêng của module, nó hiện ngay phía trên trong Output.
Argument 1 missing or nilMột hàm Roblox nhận nil ở chỗ nó cần một giá trị.Lần theo nơi mà đối số đó lẽ ra phải tới từ đó.
FireServer can only be called from the clientRemoteEvent bị gọi từ sai phía.Server dùng FireClient, LocalScript dùng FireServer.
Lỗi DataStore 403, StudioAccessToApisNotAllowedStudio không được phép dùng DataStore của game này.Publish game và bật Studio Access to API Services.

Mỗi thông báo ở đây, và cả những thông báo khác, đều có trang riêng với từng nguyên nhân, đoạn code gây ra nó và cách sửa: xem các thông báo lỗi của Roblox Studio, ví dụ attempt to index nil, Infinite yield possible và is not a valid member of.

attempt to index nil with 'X'

Index là việc đọc một thứ qua dấu chấm hoặc dấu ngoặc vuông: part.Position, player.Character, list[1]. Lỗi này cho biết thứ ở bên trái là nil, còn cái tên trong ngoặc kép là thứ bạn cố đọc từ nó. Vậy trên dòng player.Character.Humanoid, lỗi attempt to index nil with 'Humanoid' nghĩa là player.Character là nil. Nếu key là một số, thông báo kết thúc bằng with number.

Các lý do thường gặp khiến giá trị là nil:

  • FindFirstChild, FindFirstChildOfClass hoặc FindFirstAncestor không tìm thấy gì, vì tên khác hoặc object chưa có.
  • Players.LocalPlayer bị dùng trong một Script server. Nó chỉ có trong LocalScript và trong ModuleScript mà chúng require; trên server nó luôn là nil. Thay vào đó hãy dùng player mà PlayerAdded hoặc hàm xử lý RemoteEvent cung cấp.
  • player.Character bị đọc trước khi nhân vật spawn, hoặc trong lúc nó đang respawn.
  • Một mục trong bảng chưa bao giờ được gán, ví dụ playerData[player] trước khi dữ liệu của người chơi đó tải xong, hoặc hàm được gọi không trả về gì.

Trường hợp kinh điển là khối giết người. Bản bị hỏng cho rằng mọi thứ chạm vào part đều thuộc về một nhân vật, nhưng với tool bị vứt ra, part chưa Anchored và phụ kiện thì không phải vậy.

Script trong Part trong Workspace tên là KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- Bản bị hỏng:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- Nếu part chạm vào không phải một phần cơ thể nhân vật, FindFirstChild
	-- trả về nil, và Output hiện:
	--   attempt to index nil with 'Health'

	-- Đã sửa: kiểm tra từng bước trước khi dùng
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

Nếu viết hit.Parent.Humanoid, bạn sẽ nhận một thông báo khác, Humanoid is not a valid member of ..., được giải thích bên dưới. FindFirstAncestorOfClass("Model") tìm ra nhân vật cả khi part chạm vào nằm trong phụ kiện hoặc trong tool nhân vật đang cầm, nên tool đang cầm chạm vào khối cũng được tính.

Mẫu sửa lỗi này: lấy giá trị, kiểm tra nó, rồi mới dùng. Trên server, FindFirstChild kèm kiểm tra if phù hợp với những thứ có thể không tồn tại. Trong LocalScript, dùng WaitForChild cho những thứ server tạo ra, vì chúng có thể xuất hiện sau khi script đã chạy.

Infinite yield possible on ...

WaitForChild("Name") tạm dừng script cho tới khi xuất hiện một object con có tên đó. Nếu nó chờ quá 5 giây mà bạn không đặt timeout, Roblox in ra cảnh báo này. Đây là cảnh báo, không phải lỗi: script vẫn đang chờ, và không có gì sau dòng này chạy cho tới khi object xuất hiện, mà điều đó có thể không bao giờ xảy ra. Các nguyên nhân thường gặp:

  • Sai tên hoặc sai parent. WaitForChild("leaderStats") sẽ không bao giờ tìm thấy folder leaderstats.
  • Không có gì tạo ra object: script server tạo nó bị tắt, nằm sai chỗ hoặc đã lỗi trước đó. Hãy tìm lỗi sớm hơn trong Output.
  • LocalScript chờ thứ gì đó trong ServerStorage hoặc ServerScriptService. Nội dung của chúng không bao giờ được gửi tới người chơi, nên việc chờ sẽ không kết thúc.
  • Bạn đang chờ một thuộc tính, không phải object con. Ví dụ hay gặp là player:WaitForChild("Character"): Character là thuộc tính của Player, không phải object bên trong nó.
  • Instance streaming đang bật (Workspace.StreamingEnabled), và part ở quá xa người chơi nên chưa được gửi tới client này.
LocalScript trong StarterPlayerScripts tên là DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Bản bị hỏng:
--   local character = player:WaitForChild("Character")
-- Character là thuộc tính của Player, không phải object con, nên Output cảnh báo:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- Có timeout thì WaitForChild trả về nil thay vì chờ mãi mãi
	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

-- Xử lý nhân vật có thể đã tồn tại, rồi đến mỗi lần respawn
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

Con số làm đối số thứ hai của WaitForChild là timeout tính bằng giây. Khi đó script có thể báo vấn đề bằng warn và dừng gọn gàng, thay vì treo im lặng.

X is not a valid member of Y

Bạn đã dùng dấu chấm để truy cập một object con hoặc thuộc tính không tồn tại lúc đó, ví dụ workspace.Bridge khi trong Workspace không có part nào tên Bridge. Trong thông báo, đầu tiên là thứ bạn yêu cầu, sau đó là class và đường dẫn đầy đủ của object nơi nó được tìm. Kiểm tra ba điều:

  • Cách viết và chữ hoa khớp chính xác với Explorer. Folder tên là leaderstats, toàn chữ thường, và humanoid không phải là Humanoid.
  • Tên thuộc tính viết theo tiếng Anh Mỹ. part.Colour lỗi với Colour is not a valid member of Part "Workspace.Part"; thuộc tính tên là Color.
  • Object đã tải xong. Trên client, object do server tạo có thể tới sau khi LocalScript đã chạy, nên ở đó hãy dùng WaitForChild.
LocalScript trong StarterPlayerScripts tên là CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Bản bị hỏng:
--   local coins = player.leaderstats.Coins
-- leaderstats do server tạo, và nó có thể tới client này sau khi
-- script này đã chạy. Khi đó Output hiện:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- server tạo Coins dạng IntValue

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

Ở đây cần một script server tạo leaderstats với một IntValue tên Coins, như trong hướng dẫn bảng xếp hạng.

attempt to call a nil value

Code đặt dấu ngoặc sau một thứ bằng nil, nên không có gì để chạy. Các nguyên nhân thường gặp:

  • Tên hàm bị viết sai hoặc khác chữ hoa. Module khai báo Format.clock, còn code gọi lại viết Format.Clock(95).
  • local function bị gọi ở một dòng phía trên chỗ khai báo nó. Lúc đó tên chưa tồn tại, nên hãy dời phần khai báo lên trên.
  • ModuleScript không bao giờ thêm hàm vào bảng mà nó trả về.

Hai thông báo tương tự chỉ cùng một lỗi. Gọi một method không tồn tại của bảng bằng dấu hai chấm cho ra attempt to call missing method 'Kill' of table. Gõ sai method của object Roblox, ví dụ part:Destory(), cho ra Destory is not a valid member of Part "Workspace.Part".

attempt to perform arithmetic (add) on ...

Luau cố làm phép tính (add, sub, mul, div và các phép khác), nhưng một vế không phải là số. Tên kiểu ở cuối thông báo cho biết bạn đang gặp trường hợp nào:

  • on Instance and number: bạn đã tính với value object, chứ không phải với con số của nó. coins + 10 phải là coins.Value + 10.
  • on nil and number: biến hoặc mục trong bảng chưa bao giờ được gán. Hãy cho nó giá trị ban đầu, hoặc viết (x or 0) ở chỗ mà không có giá trị thật sự nghĩa là số không.
  • on string and number: chữ không phải là số, thường lấy từ TextBox. Chuyển nó bằng tonumber(text) và kiểm tra kết quả không phải nil. Chữ chứa một con số, ví dụ "5", được chuyển tự động.

Phép so sánh cũng hỏng theo cách tương tự, với attempt to compare nil < number. Luau viết lại a > b thành b < a, nên thứ tự trong thông báo có thể ngược với code của bạn.

Script trong ServerScriptService tên là 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
		-- Ghi ra lý do không có gì xảy ra, thay vì im lặng
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- Bản bị hỏng:
	--   coins = coins + amount
	-- coins là object IntValue, không phải con số của nó, nên Output hiện:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- Mỗi phút cho mỗi người chơi trên server một ít coin
while true do
	task.wait(INTERVAL_SECONDS)
	for _, player in Players:GetPlayers() do
		addCoins(player, REWARD)
	end
end

attempt to concatenate string with nil

Toán tử .. chỉ nối string và số. Không nối được với nil, với object cũng không: "Hi " .. player cho ra attempt to concatenate string with Instance. Hãy dùng player.Name, bọc giá trị trong tostring() hoặc dùng nội suy chuỗi với dấu backtick, print(`Coins: {coins}`), cách này sẽ in ra nil chứ không làm dừng script.

Expected 'end' và các lỗi cú pháp khác

Các thông báo bắt đầu bằng Expected là lỗi cú pháp: code không phải Luau hợp lệ, Roblox không compile được nó, và không dòng nào của script này chạy, kể cả các dòng nằm trên lỗi. Script Editor gạch đỏ chúng ngay khi bạn gõ, nên bạn có thể sửa trước khi bấm Play.

  • Expected 'end' (to close 'function' at line 3), got <eof>: một function, if, for hoặc while bắt đầu ở dòng 3 thiếu end của nó. Số dòng trước thông báo thường chỉ vào cuối file, nên hãy xem dòng được nêu trong ngoặc.
  • Expected 'then' when parsing if statement, got '=': một dấu = đơn trong điều kiện. So sánh thì cần ==.
  • Expected ')' (to close '(' at line 1), got 'local': dấu ngoặc chưa bao giờ được đóng.
  • Expected <eof>, got 'end': thừa một end.

Khi thụt lề đều đặn, một end bị thiếu hay bị thừa rất dễ nhận ra, vì mỗi khối thẳng hàng với end đóng nó.

Requested module experienced an error while loading

require() đầu tiên của một ModuleScript sẽ chạy code của nó. Nếu module bị lỗi trong lúc chạy, script đã require nó nhận được thông báo này. Vấn đề thật sự là lỗi riêng của module, nằm cao hơn một hai dòng trong Output: hãy sửa lỗi đó. Hai thông báo tương tự:

  • Module code did not return exactly one value: module không kết thúc bằng return. ModuleScript phải trả về đúng một giá trị, không phải nil, thường là bảng của nó.
  • Requested module was required recursively: hai module require lẫn nhau. Hãy tách phần dùng chung ra một module thứ ba mà cả hai cùng require.
ModuleScript trong ReplicatedStorage tên là Format
local Format = {}

-- Đổi số giây thành phút và giây: 95 thành "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

-- Module phải trả về bảng của nó ở cuối. Thiếu dòng này thì mỗi lần
-- require module này đều lỗi với: Module code did not return exactly one value
return Format

Một script require nó bằng local Format = require(ReplicatedStorage:WaitForChild("Format")), rồi gọi Format.clock(95). Nếu viết Format.Clock(95), bạn sẽ nhận lỗi attempt to call a nil value.

Argument 1 missing or nil

Một hàm Roblox nhận nil ở một đối số mà nó cần, còn con số cho biết là đối số nào. workspace:FindFirstChild(itemName) lỗi kiểu này khi itemName là nil. Bug hiếm khi nằm ở dòng này. Nó nằm ở nơi mà giá trị lẽ ra phải tới: một biến bị gõ sai, một attribute chưa bao giờ được đặt, hoặc một đối số RemoteEvent mà client không gửi. Đối số RemoteEvent tới từ thiết bị của người chơi, nên server phải kiểm tra chúng trước khi dùng. Hướng dẫn RemoteEvent chỉ cách làm việc đó.

FireServer can only be called from the client

RemoteEvent có chiều. LocalScript gọi FireServer, còn Script server lắng nghe bằng OnServerEvent. Script server gọi FireClient hoặc FireAllClients, còn LocalScript lắng nghe bằng OnClientEvent. Gọi method từ sai phía sẽ cho ra lỗi này hoặc lỗi ngược lại, FireClient can only be called from the server. Cách sửa thường là chuyển code sang đúng loại script: xem Script, LocalScript và ModuleScript.

Lỗi DataStore 403 trong Studio

Các lệnh gọi DataStore trong Studio lỗi với mã 403 (StudioAccessToApisNotAllowed) cho tới khi bạn cho phép chúng. Publish place, mở File, Experience Settings, Security, bật Enable Studio Access to API Services và lưu. Sau đó Studio dùng cùng các DataStore với game đang chạy thật, nên Roblox khuyên làm việc này trên một bản sao riêng để test, chứ không phải trên game đang có người chơi. Hãy bọc mọi lệnh gọi DataStore trong pcall, vì các lệnh gọi này có thể lỗi vì những lý do nằm ngoài code của bạn. Cách lưu an toàn được giải thích trong hướng dẫn DataStore.

Script chạy không lỗi nhưng không làm gì cả

Một script im lặng thường là chưa hề chạy, vẫn đang chờ thứ gì đó, hoặc đã chạy sai phía. Trước khi đổi code, hãy cho nó dòng đầu tiên là print(script:GetFullName(), "started") và chạy game. Nếu dòng này không bao giờ hiện trong Output, vấn đề nằm ở chỗ đặt script hoặc cách nó được cài đặt, chứ không phải ở nội dung bên trong.

Vì sao một script có thể không làm gì mà không báo lỗi
Cần kiểm tra gìĐiều gì bị saiCách sửa
Loại và vị trí của scriptLocalScript chỉ chạy khi đặt trong StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack hoặc ReplicatedFirst (từ các container Starter nó chạy dưới dạng bản sao của người chơi). Nếu đặt trong Workspace, ServerScriptService hoặc ReplicatedStorage, nó sẽ không bao giờ chạy. Script với RunContext mặc định chỉ chạy trong Workspace hoặc ServerScriptService.Dời nó đi hoặc dùng loại script khác. Code giao diện và điều khiển dùng LocalScript, luật chơi dùng Script trong ServerScriptService.
EnabledScript bị bỏ tích Enabled sẽ không chạy.Chọn nó và tích Enabled trong cửa sổ Properties.
RunContextRunContext của Script quyết định nó chạy ở đâu. Legacy, giá trị mặc định, chạy trên server từ Workspace hoặc ServerScriptService. Server chạy trên server, Client chạy trên thiết bị của mỗi người chơi, ví dụ từ ReplicatedStorage.Đặt nó có chủ đích. Tài liệu Roblox khuyên để Client Script trong ReplicatedStorage hoặc ReplicatedFirst, còn LocalScript trong các container Starter.
Sự kiện không kích hoạtTouched chỉ kích hoạt khi có chuyển động vật lý, cần ít nhất một trong hai part không Anchored, và cần CanTouch ở cả hai. PlayerAdded không kích hoạt cho những người chơi đã có trên server lúc bạn kết nối sự kiện. Hàm xử lý RemoteEvent sẽ không chạy nếu phía bên kia không bao giờ gọi sự kiện.Đặt một print bên trong hàm xử lý để biết chắc nó có chạy không, rồi sửa thứ lẽ ra phải kích hoạt nó.
Code sau vòng lặp hoặc lệnh chờCác dòng dưới vòng lặp while true do không bao giờ chạy, vì vòng lặp không kết thúc. Các dòng dưới một WaitForChild không bao giờ tìm thấy object cũng không chạy.Kết nối sự kiện trước vòng lặp hoặc chạy vòng lặp bằng task.spawn. Cho các lệnh chờ một timeout.
Bước kiểm tra lặng lẽ thoát raMột lệnh bảo vệ như if not coins then return end lặng lẽ dừng hàm khi object không có.Thêm một warn kèm chi tiết trước return.
Bộ lọc OutputOutput có thể lọc theo loại thông báo, theo Client hoặc Server và theo chữ. Một bộ lọc bị quên có thể giấu đúng lỗi bạn đang tìm.Bỏ các bộ lọc và xóa ô tìm kiếm.
Chỉ mình bạn thấyThay đổi do LocalScript tạo ra, nên chỉ người chơi đó thấy. Server và những người chơi khác không thấy.Thực hiện thay đổi trên server. Xem script chạy ở đâu.

Nhiều người vấp phải trường hợp PlayerAdded, vì khi test trong Studio bạn vào game gần như ngay sau khi server khởi động. Nếu có gì đó phía trên dòng Connect phải chờ, ví dụ WaitForChild, task.wait hoặc require một module có chờ, bạn có thể vào trước khi kết nối được tạo. Hãy xử lý cả người chơi mới lẫn người chơi đã có mặt:

Script trong ServerScriptService tên là Welcome
local Players = game:GetService("Players")

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

Players.PlayerAdded:Connect(onPlayerAdded)

-- Với những người chơi đã ở đây khi dòng trên chạy,
-- PlayerAdded trong script này sẽ không kích hoạt, nên xử lý họ ngay bây giờ
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Công cụ gỡ lỗi trong Roblox Studio

print ghi một dòng vào Output, còn warn ghi một cảnh báo. Đây là cách nhanh nhất để trả lời câu hỏi "cái này có chạy không?" và "giá trị này bằng bao nhiêu?". Một print(x) trơn trọi về sau rất khó tìm, nên hãy thêm nhãn và các chi tiết quan trọng. typeof(x) cho biết đó là loại giá trị gì: số, string, Instance hay nil, còn GetFullName() cho biết chính xác bạn đang có object nào.

Script trong ServerScriptService tên là ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- đặt false khi bạn xong việc
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 và ClassName cho biết giá trị thật sự là gì
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

Ô tìm kiếm trong Output lọc theo chữ, nên một nhãn cố định như [ShopServer] cho phép chỉ hiện các dòng của hệ thống đó. Nếu cần biết code đã tới dòng này bằng cách nào, debug.traceback() trả về call stack hiện tại dưới dạng string.

Breakpoint và chạy từng bước

Breakpoint tạm dừng game ở một dòng, để bạn có thể xem mọi thứ ngay lúc đó. Trong Script Editor, click vào lề bên phải số dòng (sẽ hiện một chấm đỏ), rồi chạy playtest. Khi chạy tới dòng đó, game tạm dừng, và một mũi tên vàng chỉ dòng tiếp theo. Sau đó các nút chạy từng bước đưa bạn đi tiếp trong code:

  • Step Over (F10) chạy dòng hiện tại và dừng ở dòng tiếp theo.
  • Step Into (F11) đi vào bên trong hàm được gọi ở dòng này.
  • Step Out (Shift+F11) chạy hết hàm hiện tại và dừng ở code đã gọi nó.
  • Resume Scripts chạy tiếp tới breakpoint tiếp theo.

Click chuột phải vào lề cho thêm hai loại hữu ích. Breakpoint có điều kiện chỉ tạm dừng khi một biểu thức như amount < 0 đúng. Logpoint in một thông báo ra Output mà không tạm dừng, nên bạn có thể ghi log một giá trị mà không phải sửa script.

Watch và Call Stack

Khi game đang tạm dừng, rê chuột lên một biến trong Script Editor để xem giá trị của nó. Cửa sổ Watch ở tab Variables hiện mọi biến trong phạm vi, còn ở tab My Watches bạn có thể nhập bất kỳ biểu thức nào, ví dụ coins.Value + amount, và xem giá trị hiện tại của nó. Cửa sổ Call Stack cho thấy hàm nào đã gọi hàm nào để tới được dòng đang tạm dừng. Cả hai mở qua tab Script hoặc menu Window.

Script Analysis và strict mode

Script Editor gạch chân vấn đề ngay khi bạn gõ, còn cửa sổ Script Analysis, mở bằng nút Analysis trên tab Script, liệt kê lỗi và cảnh báo trong mọi script. Nó bắt lỗi cú pháp và tên lạ trước khi bạn bấm Play. Nếu đặt --!strict làm dòng đầu tiên của script, chế độ kiểm tra kiểu nghiêm ngặt của Luau sẽ bật, và nó báo thêm cả lỗi gõ sai thuộc tính, sai kiểu đối số và các giá trị có thể là nil. Nhưng nó không nhìn thấy game đang chạy: một part không có trong Workspace thì chỉ Output mới cho bạn biết.

Command bar

Command bar (trên tab Script hoặc Ctrl+9, ⌘9 trên Mac) chạy Luau ngay lập tức. Khi game đang chạy, đây là cách nhanh để hỏi: print(workspace:FindFirstChild("Bridge")) cho biết part đó có tồn tại không, còn print(#game:GetService("Players"):GetPlayers()) đếm số người chơi. Ở chế độ chỉnh sửa, code trong command bar thay đổi place của bạn thật sự, nên hãy cẩn thận với mọi thứ di chuyển hoặc xóa object.

Developer Console trong game thật

Output của Studio chỉ hoạt động trong Studio. Trong game thật, bấm F9 hoặc gõ /console trong chat để mở Developer Console. Phần Log của nó hiện output từ thiết bị của bạn, và cả output của server nếu bạn là chủ game hoặc thành viên của group có quyền chỉnh sửa game.

Assistant có sẵn của Roblox cũng có thể giúp với một thông báo riêng lẻ: hướng dẫn của chính Roblox khuyên dán lỗi từ Output vào và nhờ Assistant giải thích. Nếu Assistant ngừng trả lời hoặc báo bạn đã chạm giới hạn, xem giới hạn và lỗi của Assistant.

Sửa lỗi với RoCode

RoCode là một AI agent độc lập cho Roblox Studio: bạn mô tả vấn đề trong chat trên web, còn plugin Studio đọc và sửa place bạn đang mở. Với lỗi, nó có thể đảm nhận các bước đọc trong trình tự ở trên, dựa vào lần playtest bạn đã chạy.

Bạn gõ

Mình bấm Play, và click vào nút shop không có tác dụng gì. Output hiện attempt to index nil with 'Coins'. Tìm nguyên nhân và sửa giúp mình.

RoCode làm
  • Đọc Output trong Studio bằng công cụ Check Output của nó, kể cả các dòng Server và Client từ lần playtest gần nhất của bạn, ngay cả sau khi bạn đã bấm Stop
  • Mở script trong lỗi bằng Read Script và đọc code quanh dòng đó, còn bằng Search Scripts nó có thể tìm nơi lẽ ra phải tạo giá trị bị thiếu
  • Sửa đúng chỗ bằng Edit Script, tìm và thay chính xác trong script đó, rồi chạy Check Script, công cụ compile script ngay trong Studio (nó không kiểm tra kiểu, không chạy linter và không chạy code của bạn)
  • Gửi thay đổi vào Studio theo từng đợt, và mỗi đợt là một điểm undo trong lịch sử Studio

Bấm Play lần nữa và click vào nút shop để tự xác nhận bản sửa: với plugin 3.9 trở lên, RoCode có thể chạy một playtest ngắn và đọc lỗi, còn với plugin 3.9.15 trở lên nhân vật thử nghiệm của nó có thể bấm các nút trên màn hình, nhưng nó chỉ kiểm tra những gì nó tự chọn để test, và bước kiểm tra compile không cho biết logic game có đúng hay không. Đọc lỗi là một phần của mỗi lần build: chu trình build, kiểm tra và test cho cả một game lặp lại bước kiểm tra này sau mỗi hệ thống. RoCode kết nối với Studio thế nào.

Câu hỏi thường gặp

Vì sao script trong Roblox không chạy dù không có lỗi?

Thường là script chưa hề chạy (sai loại script hoặc sai container, hoặc Enabled bị tắt), nó vẫn đang chờ thứ gì đó, hoặc sự kiện mà nó lắng nghe không bao giờ kích hoạt. Một print ở dòng đầu tiên sẽ cho biết là trường hợp nào. Xem danh sách kiểm tra ở trên.

"attempt to index nil" trong Roblox nghĩa là gì?

Giá trị trước dấu chấm hoặc dấu hai chấm là nil, nên Roblox không thể nhìn vào bên trong. Trên dòng player.Character.Humanoid, lỗi attempt to index nil with 'Humanoid' nghĩa là player.Character là nil: nó không có hoặc chưa tải xong. Hãy kiểm tra giá trị bằng if trước khi dùng, và trong LocalScript hãy chờ các object do server tạo bằng WaitForChild. Xem thêm về các nguyên nhân.

"infinite yield possible" trong Roblox nghĩa là gì?

WaitForChild đã chờ hơn 5 giây một object con chưa bao giờ xuất hiện, và vẫn đang chờ tiếp. Thường là sai tên hoặc sai parent, hoặc không có gì tạo ra object đó. Xem thêm về các nguyên nhân.

Vì sao cửa sổ Output trống hoặc không hiện?

Mở nó qua menu Window hoặc tab Script. Nếu nó đã mở mà vẫn trống trong lúc test, hãy bỏ các bộ lọc và ô tìm kiếm, rồi kiểm tra rằng các script lẽ ra phải in ra gì đó thật sự có chạy.

Roblox có công cụ kiểm tra lỗi script không?

Có, nó có sẵn trong Studio: Script Editor gạch chân vấn đề khi bạn gõ, còn cửa sổ Script Analysis liệt kê chúng. Chúng tìm ra lỗi cú pháp và lỗi kiểu, nhưng không tìm ra object bị thiếu hay logic game sai: những thứ đó chỉ thấy được khi code đang chạy.

Có nên bọc code trong pcall để không bị lỗi không?

Chỉ những lệnh gọi có thể lỗi vì lý do nằm ngoài code của bạn, ví dụ yêu cầu tới DataStore, HTTP hoặc MarketplaceService. Nếu bọc một lỗi nil trong pcall, thông báo sẽ biến mất nhưng tính năng vẫn không chạy.

Làm sao xem lỗi script trong game thật?

Bấm F9 trong game hoặc gõ /console trong chat để mở Developer Console. Nó hiện lỗi từ thiết bị của bạn, và cả từ server nếu bạn là chủ game hoặc thành viên group có quyền chỉnh sửa game.

Nguồn và tài liệu đọc thêm

Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.

Thử RoCode trong chính game của bạn.

Mỗi ngày có credit miễn phí, không cần thẻ. Cài plugin, mô tả tính năng và xem kết quả xuất hiện trong Studio.