Tóm tắt
Để viết script trong Roblox Studio, rê chuột lên ServerScriptService trong Explorer, bấm + và chèn một Script. Studio mở nó trong Script Editor. Viết Luau, ví dụ print("Hello"), bấm Play (F5) và đọc kết quả trong cửa sổ Output (menu Window hoặc tab Script). Script chạy trên server và thay đổi mọi thứ cho mọi người; LocalScript trong StarterPlayerScripts chạy trên thiết bị của một người chơi.
- Hãy học bốn ý tưởng trước: biến (
local coins = 3), hàm (local function name() ... end), điều kiện if và sự kiện (part.Touched:Connect(...)). Bốn script trong hướng dẫn này được xây từ chúng, cộng thêm vòng lặp và bảng. - Dùng
task.wait(), không dùngwait(). Tài liệu tham khảo của Roblox đánh dấuwait()toàn cục là đã lỗi thời và được thay bằngtask.wait(). - Trong cài đặt hiển thị của cửa sổ Output, bật Show Context để mỗi dòng cho biết nó tới từ Server hay Client.
Trong trang này
Trước khi bắt đầu: Studio, Baseplate và cửa sổ Output
Bạn cần Roblox Studio và một tài khoản Roblox, ngoài ra không cần gì: không cần trình soạn code, không cần plugin. Mọi script trong hướng dẫn này đều được gõ trong Script Editor có sẵn của Studio.
- Cài Roblox Studio, ứng dụng miễn phí của Roblox cho Windows và Mac, và đăng nhập bằng tài khoản Roblox.
- Mở Studio. Trang khởi đầu có các template: chọn Baseplate. Bạn sẽ có một nền sàn với texture lưới 4x4 và một SpawnLocation, nơi avatar của bạn xuất hiện khi chơi.
- Nếu không thấy cửa sổ Explorer và Properties, hãy mở chúng từ menu Window hoặc tab Home. Explorer liệt kê mọi object trong place; Properties hiện các cài đặt của object đang chọn.
- Mở Output từ menu Window hoặc tab Script. Đây là nơi hiện thông báo và lỗi từ script của bạn.
- Trong cài đặt hiển thị của cửa sổ Output, bật Show Context, tùy chọn gắn nhãn Client hoặc Server cho mỗi thông báo, và Show Source, tùy chọn hiện script và số dòng mà thông báo tới từ đó.
| Script | Loại | Nằm ở đâu | Dạy điều gì |
|---|---|---|---|
FirstScript | Script | ServerScriptService | Biến, hàm, điều kiện if, vòng lặp và bảng |
ColourChanger | Script | Bên trong một Part trong Workspace | Thay đổi thuộc tính, script.Parent và vòng lặp có chờ |
TouchPad | Script | Bên trong Part tên Pad | Sự kiện, tìm người chơi đã chạm vào part, và debounce |
MyFirstLocalScript | LocalScript | StarterPlayerScripts, bên trong StarterPlayer | Code trên thiết bị của một người chơi, phím bấm và những gì chỉ ở lại trên thiết bị đó |
Workspace
Baseplate Part
SpawnLocation SpawnLocation
Part Part new
ColourChanger Script new
Pad Part new
TouchPad Script new
ServerScriptService
FirstScript Script new
StarterPlayer
StarterPlayerScripts
MyFirstLocalScript LocalScript new
Bước 1: viết script đầu tiên
- Trong Explorer, rê chuột lên ServerScriptService, bấm + và chọn Script (phím tắt Ctrl+I hoặc ⌘I trên Mac). Studio tạo script và mở nó trong Script Editor.
- Click chuột phải vào script mới, chọn Rename và đặt tên là
FirstScript. Tên không thay đổi việc script làm, nhưng cho biết script nào đã in ra cái gì. - Script mới bắt đầu với một dòng,
print("Hello world!"). Xóa nó và dán đoạn code bên dưới vào. - Bấm Play (F5), với Test được chọn trong danh sách bên trái nút này. Studio chạy playtest và đặt avatar lên SpawnLocation.
- Đọc các dòng trong Output, rồi bấm Stop (Shift+F5). Stop cũng đưa mọi object về trạng thái trước khi bấm Play, nên mọi thứ bạn đã dời hay đổi màu trong lúc chơi sẽ trở lại như cũ.
-- Script trong ServerScriptService tên FirstScript.
-- Luau đầu tiên của bạn: biến, hàm, điều kiện if, vòng lặp và bảng.
-- Bấm Play (F5) và đọc kết quả trong cửa sổ Output.
-- Biến là một cái tên giữ một giá trị
local gameName = "Coin Run"
local coinsToWin = 3
-- Hàm là một khối code có tên, có thể chạy bao nhiêu lần cũng được.
-- name và goal là tham số của nó; return trả một giá trị về cho nơi đã gọi nó.
local function describe(name: string, goal: number): string
return `{name}: collect {goal} coins to win`
end
print(describe(gameName, coinsToWin)) --> Coin Run: collect 3 coins to win
-- Điều kiện if chỉ chạy code khi điều kiện đúng
if coinsToWin > 5 then
print("That is a long game")
elseif coinsToWin > 1 then
print("That is a short game")
else
print("One coin and you win")
end
-- Vòng lặp for lặp lại code một số lần cho trước
for count = 1, coinsToWin do
print("Coin number", count)
end
-- Bảng giữ một danh sách giá trị; vòng lặp này đi qua chúng theo thứ tự
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
print(position, colour) --> 1 Red, rồi 2 Green, rồi 3 Blue
end
Mọi thứ sau -- trên một dòng là comment: Luau bỏ qua nó, nên bạn có thể để lại ghi chú cho mình. Comment --> cho biết dòng đó in ra gì.
Output sẽ hiện tám dòng này lẫn với các thông báo của chính Studio. Khi print nhận nhiều giá trị, nó đặt một dấu cách giữa chúng. Khi bật Show Context và Show Source, mỗi dòng còn được gắn nhãn Server và FirstScript kèm số dòng.
Coin Run: collect 3 coins to win
That is a short game
Coin number 1
Coin number 2
Coin number 3
1 Red
2 Green
3 Blue
Đối chiếu mỗi dòng với đoạn code đã in ra nó. Về sau bạn sẽ làm y như vậy với thông báo lỗi, nên thói quen này sẽ có ích.
FirstScript chỉ dùng Luau thuần, không có object Roblox nào, nên nó cũng chạy được trong Luau playground miễn phí trên trình duyệt. Hãy đổi một giá trị ở đó và chạy lại để xem điều gì thay đổi.
| Code | Ý tưởng | Ý nghĩa |
|---|---|---|
local gameName = "Coin Run" | Biến | Một cái tên giữ một giá trị. local nghĩa là chỉ script này, hoặc khối chứa nó, được dùng nó. Chữ trong ngoặc kép là một string; 3 là một số. Tên phân biệt chữ hoa chữ thường, nên coinsToWin và CoinsToWin là hai biến khác nhau. |
local function describe(name: string, goal: number): string | Hàm | Một khối code có tên, có thể chạy bao nhiêu lần cũng được. name và goal là các tham số của nó: những giá trị được truyền vào mỗi lần gọi. : string và : number là chú thích kiểu không bắt buộc. Luau dùng chúng để cảnh báo lỗi trong Script Editor; không có chúng code vẫn chạy y như vậy. |
return | Giá trị trả về | Trả một giá trị về cho code đã gọi hàm. print(describe(gameName, coinsToWin)) in ra thứ mà describe trả về. |
`{name}: collect {goal} coins to win` | Nội suy chuỗi | Chữ trong dấu backtick có thể chứa giá trị: Luau thay {name} và {goal} bằng giá trị hiện tại của chúng. |
if, elseif, else, end | Điều kiện if | Luau kiểm tra các điều kiện từ trên xuống và chỉ chạy điều kiện đúng đầu tiên. coinsToWin bằng 3, không lớn hơn 5 nhưng lớn hơn 1, nên chỉ "That is a short game" được in ra. |
for count = 1, coinsToWin do | Vòng lặp for theo số | Chạy code bên trong một lần cho mỗi số từ 1 tới coinsToWin, với count bằng 1, rồi 2, rồi 3. |
{ "Red", "Green", "Blue" } và for position, colour in colours do | Bảng và vòng lặp | Một bảng dạng danh sách, Luau gọi nó là mảng. Vị trí bắt đầu từ 1, không phải 0. Vòng lặp đi qua từng phần tử và cho vị trí cùng giá trị của nó. |
Mỗi khối mở bằng từ function, if, for hoặc while đều được đóng bằng từ end. Chỉ thiếu một end là cả script không chạy được; phần đọc lỗi cho thấy bạn sẽ nhận thông báo nào.
Bước 2: thay đổi một part bằng script
Script trở nên hữu ích khi chúng thay đổi thứ gì đó trong thế giới. Các cài đặt bạn thấy trong cửa sổ Properties, ví dụ Color, Transparency hay Anchored của một part, là các thuộc tính, và script cũng có thể đặt chúng.
- Trên tab Home, bấm Part. Studio thêm một khối vào Workspace. Tên của nó không quan trọng.
- Trong Explorer, rê chuột lên part mới, bấm + và chèn một Script. Đổi tên nó thành
ColourChangervà thay nội dung bằng đoạn code bên dưới. - Bấm Play. Part chuyển sang đỏ, rồi xanh dương, rồi xanh lá, mỗi giây đổi một lần, rồi bắt đầu lại.
-- Script bên trong một Part trong Workspace, tên ColourChanger.
-- Script thay đổi đúng những thuộc tính bạn thấy trong cửa sổ Properties.
-- Script này cho part của nó một màu mới mỗi giây, với mọi người chơi.
local part = script.Parent :: BasePart -- part chứa script này
local colours = {
Color3.fromRGB(255, 85, 85), -- đỏ
Color3.fromRGB(85, 170, 255), -- xanh dương
Color3.fromRGB(85, 255, 127), -- xanh lá
}
part.Anchored = true -- part đã Anchored đứng yên ở chỗ bạn đặt nó
local index = 1
while true do
part.Color = colours[index]
index = index % #colours + 1 -- 1, 2, 3, rồi lại 1
task.wait(1) -- dừng một giây (wait() cũ đã lỗi thời)
end
script.Parentlà object chứa script, ở đây là part. Kéo script sang một part khác, và nó sẽ đổi màu part đó.:: BasePartlà ép kiểu. Nó báo cho Script Editor biết parent là một part, để kiểm tra các thuộc tính được dùng. Luau chỉ dùng kiểu cho cảnh báo và gợi ý, nên ép kiểu không thay đổi việc dòng code làm.part.Colorvàpart.Anchoredlà chính những thuộc tính trong cửa sổ Properties, cùng tên. Roblox dùng cách viết tiếng Anh Mỹ, nên thuộc tính tên làColor, dù script tên là ColourChanger.Anchored = truegiữ part tại chỗ: tài liệu tham khảo của Roblox nói part đã Anchored không bao giờ di chuyển vì trọng lực, va chạm hay vật lý khác.colours[index]đọc một phần tử trong danh sách.#colourslà độ dài danh sách, 3, còn%cho số dư của phép chia, nênindex % #colours + 1đếm 1, 2, 3, 1, 2, 3.while true dolặp mãi mãi, vì vậytask.wait(1)bên trong rất quan trọng. Tài liệu Roblox bảo luôn đặt một khoảng chờ nhưtask.wait()trong vòng lặp vô hạn: không có nó game bị treo, còn Studio bị crash.
ColourChanger là một Script, nên nó chạy trên server, và mọi người chơi thấy cùng một màu cùng lúc. Bước 4 cho thấy một loại script khác.
Bước 3: phản ứng với người chơi bằng sự kiện
Phần lớn code game chờ một điều gì đó xảy ra: người chơi vào game, part bị chạm, nút được bấm. Roblox gọi đó là sự kiện. Để chạy code khi sự kiện xảy ra, bạn kết nối một hàm với nó.
- Chèn thêm một Part và đổi tên nó thành đúng
Pad, với chữ P viết hoa. Để nó nằm ngay trong Workspace, không trong folder hay model nào, vì LocalScript ở bước 4 tìm nó ở đó. - Biến nó thành một tấm pad phẳng có thể đứng lên, ví dụ đặt
Sizelà6, 1, 6trong cửa sổ Properties. Đặt nó trên sàn cạnh SpawnLocation và tích Anchored để nó không di chuyển. - Rê chuột lên Pad, bấm +, chèn một Script, đổi tên nó thành
TouchPadvà dán đoạn code bên dưới. - Bấm Play và đứng lên pad. Nó chuyển vàng trong 2 giây, còn Output ghi tên bạn.
-- Script bên trong một Part trong Workspace tên Pad, script tên TouchPad.
-- Sự kiện: khi người chơi bước lên pad, nó sáng màu vàng, còn Output ghi ra đó là ai.
-- Debounce ngăn code chạy nhiều lần mỗi giây trong lúc người chơi đứng trên nó.
local Players = game:GetService("Players")
local pad = script.Parent :: BasePart
local COOLDOWN_SECONDS = 2
local normalColour = pad.Color
local busy = false
local function onTouched(otherPart: BasePart)
if busy then
return -- vẫn đang hồi chiêu sau lần chạm trước
end
-- Nhân vật là Model chứa bộ phận cơ thể (hoặc cái mũ) đã chạm vào pad
local character = otherPart:FindFirstAncestorOfClass("Model")
local player = character and Players:GetPlayerFromCharacter(character)
if not player then
return -- một part rời hoặc NPC đã chạm, không phải người chơi
end
busy = true
print(`{player.Name} stepped on the pad`)
pad.Color = Color3.fromRGB(255, 220, 0)
task.wait(COOLDOWN_SECONDS)
pad.Color = normalColour
busy = false
end
pad.Touched:Connect(onTouched)
| Code | Làm gì |
|---|---|
pad.Touched:Connect(onTouched) | Kết nối hàm với sự kiện Touched của pad, nên Roblox chạy onTouched mỗi lần có thứ gì chạm vào pad, và truyền vào part đã chạm. |
otherPart | Part đã chạm vào pad: bàn chân, cẳng chân, quai mũ hoặc tool trong tay người chơi. Nó không bao giờ là chính người chơi, nên hai dòng tiếp theo tìm xem nó thuộc về ai. |
otherPart:FindFirstAncestorOfClass("Model") | Đi ngược lên từ part này tới tổ tiên đầu tiên có class đúng là Model, tức là nhân vật. Vì tên class phải khớp chính xác, nó bỏ qua cái mũ (class Accessory) và tool trong tay (class Tool). |
Players:GetPlayerFromCharacter(character) | Trả về Player sở hữu nhân vật này, hoặc nil nếu đó là nhân vật không thuộc về ai, ví dụ NPC. character and ở phía trước bỏ qua lệnh gọi nếu không tìm thấy model, và player vẫn là nil. |
if not player then return end | Dừng ở đây với mọi thứ không phải người chơi. return thoát khỏi hàm sớm. |
Vì sao pad cần debounce
Trang của Roblox về debounce cảnh báo rằng Touched kích hoạt nhiều lần liên tiếp khi các part chạm nhau, và nhân vật đang đi có nhiều bộ phận cơ thể. Không có bước kiểm tra, một bước chân lên pad có thể in ra rất nhiều dòng và khởi động lại ánh vàng hết lần này tới lần khác.
Biến busy chính là debounce. Lần chạm đầu tiên đặt nó thành true, và mọi lần chạm trong 2 giây tiếp theo đều gặp if busy then return end và dừng lại. Sau task.wait(COOLDOWN_SECONDS), pad trở về màu cũ, và busy lại thành false. COOLDOWN_SECONDS được viết hoa vì nó là một cài đặt không đổi trong lúc chơi: Roblox khuyên đặt tên hằng số như vậy.
Pad này có một debounce chung cho mọi người, nên người chơi thứ hai bước lên trong 2 giây đó sẽ bị bỏ qua. Với một pad phát sáng thì không sao. Một pad trao phần thưởng nên giữ thời gian hồi riêng cho từng người chơi, như pad coin trong hướng dẫn bảng xếp hạng.
Bước 4: LocalScript đầu tiên và nó khác gì
Một game đang chạy gồm một server cộng với một client cho mỗi người chơi. Mọi thứ cho tới giờ đều là Script, chạy trên server, nên thay đổi của nó tới được mọi người chơi. LocalScript chạy trên thiết bị của một người chơi. Phím bấm, camera và menu trên màn hình được xử lý ở đó, vì chỉ thiết bị đó biết về chúng.
- Trong Explorer, mở rộng StarterPlayer, rê chuột lên StarterPlayerScripts, bấm + và chèn một LocalScript. Đổi tên nó thành
MyFirstLocalScriptvà dán đoạn code bên dưới. - Bấm Play. Output hiện
Hello,và tên bạn với nhãn Client. - Click vào cửa sổ game và bấm E. Pad trở nên trong suốt hơn. Bấm E lần nữa để trả nó về như cũ.
- Trong lúc playtest đang chạy, bấm nút chuyển Client/Server trong các điều khiển test của Studio để chuyển sang bản sao của game trên server. Ở đó pad không trong suốt: server không hề biết về thay đổi này.
-- LocalScript trong StarterPlayer > StarterPlayerScripts tên MyFirstLocalScript.
-- LocalScript chạy trên thiết bị của một người chơi. Bấm E: Pad trong suốt hơn chỉ
-- trên màn hình của bạn, vì thay đổi part từ đây không tới server hay người khác.
local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")
local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- hiện trong Output với nhãn Client
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed then
return -- phím được dùng cho việc khác, ví dụ gõ chữ trong chat
end
if input.KeyCode == Enum.KeyCode.E then
local pad = workspace:FindFirstChild("Pad")
if pad and pad:IsA("BasePart") then
pad.Transparency = if pad.Transparency == 0 then 0.6 else 0
end
end
end)
Players.LocalPlayerlà người chơi mà script đang chạy trên thiết bị của họ. Roblox chỉ đặt nó cho LocalScript và ModuleScript mà chúng require, nên code server không dùng được nó.UserInputService.InputBegankích hoạt khi người chơi bắt đầu một lần bấm phím, click hoặc chạm.gameProcessedlàtruekhi engine đã dùng lần nhập đó, ví dụ click vào nút hoặc phím trong ô chat, nên script bỏ qua nó.workspace:FindFirstChild("Pad")trả về object con tên Pad, hoặcnilnếu không có.pad:IsA("BasePart")kiểm tra rằng nó thật sự là một part trước khi script đổiTransparencycủa nó.if pad.Transparency == 0 then 0.6 else 0là một biểu thức if: nó chọn một trong hai giá trị. Transparency 0 nghĩa là hoàn toàn nhìn thấy, 1 là vô hình.- Script chạy nhanh bằng Shift rất hợp làm LocalScript thứ hai: nó lắng nghe một phím và đổi WalkSpeed của nhân vật.
| Loại | Chạy ở đâu | Thay đổi tới đâu | Dùng để làm gì | Thường nằm ở |
|---|---|---|---|---|
| Script | Trên server | Tới mọi người chơi | Luật chơi: coin, sát thương, cửa, vòng chơi, lưu dữ liệu | ServerScriptService, hoặc bên trong part khi đang học |
| LocalScript | Trên thiết bị của một người chơi | Chỉ trên thiết bị đó, trừ chuyển động của nhân vật của chính họ | Nhập liệu, camera, menu trên màn hình, hiệu ứng cho một người chơi | StarterPlayerScripts hoặc StarterGui |
| ModuleScript | Ở phía gọi require() cho nó | Tới cùng nơi với script đã require nó | Code dùng chung cho nhiều script | ReplicatedStorage cho cả hai phía, ServerScriptService chỉ cho server |
Kẻ gian lận có thể thay đổi gì
Hãy coi như kẻ gian lận kiểm soát mọi thứ trên thiết bị của họ. Họ có thể chạy LocalScript của riêng mình và sửa LocalScript của bạn, nên có thể làm pad trong suốt, hay bất cứ thứ gì khác trên màn hình của họ. Ở đây việc đó vô hại: độ trong suốt chỉ để nhìn và ở lại trên thiết bị của họ. Chính vì thế mọi thứ quan trọng đều do Script trên server quyết định.
Script server cũng không tự động an toàn. TouchPad chạy trên server, nhưng thiết bị của mỗi người chơi điều khiển vật lý của nhân vật của họ, và tài liệu bảo mật của Roblox liệt kê, trong số những gì client có thể làm với các part nó điều khiển, việc kiểm soát thời điểm Touched kích hoạt hoặc chặn nó hoàn toàn. Với pad phát sáng thì điều này không quan trọng. Với pad trả thưởng, hãy kiểm tra thêm cả những gì server tự theo dõi, như quy tắc trong hướng dẫn obby rằng checkpoint chỉ được tính theo đúng thứ tự.
Bước 5: test cả bốn script cùng nhau
- Xóa Output bằng Ctrl+K (⌘K trên Mac) và bấm Play (F5). Output hiện tám dòng FirstScript với nhãn Server và dòng Hello của bạn với nhãn Client. Part ColourChanger đổi màu mỗi giây.
- Đứng lên pad. Nó chuyển vàng trong 2 giây, còn Output hiện một lần tên bạn và "stepped on the pad". Đi lại trên nó: dòng mới xuất hiện tối đa 2 giây một lần, chứ không phải mỗi lần Touched kích hoạt.
- Bấm E. Pad trở nên nửa trong suốt (Transparency 0.6). Bấm E lần nữa, và nó lại không trong suốt.
- Bấm Stop. Trong danh sách test, chọn Server & Clients, đặt 2 client và bấm Play (hoặc F7). Studio mở một cửa sổ server và hai cửa sổ client. Trong một client, bấm E: pad trong suốt hơn ở đó, còn client kia và server vẫn hiện nó không trong suốt. Bấm End Session khi xong.
- Cố tình làm hỏng một thứ. Đổi tên Pad thành
Pad2và chạy game. Bước lên pad vẫn làm nó chuyển vàng, vì TouchPad tìm part của nó quascript.Parent, chứ không qua tên. Bấm E giờ không có tác dụng gì, và cũng không có lỗi:FindFirstChild("Pad")trả vềnil, và bước kiểm traif pad and ...lặng lẽ bỏ qua phần còn lại. Thêmprint(pad)ở dòng sauFindFirstChild, chạy và bấm E: Output hiệnnil. Một print như vậy là cách nhanh nhất để hiểu vì sao script không làm gì. Dừng game, xóa dòng print và đổi tên part về lại Pad.
Đặt script ở đâu
Vị trí của script quyết định nó có chạy hay không, và Studio không cảnh báo nếu nó sẽ không bao giờ chạy. Cho các script tiếp theo của bạn:
| Container | Đặt gì vào | Vì sao |
|---|---|---|
| ServerScriptService | Script chứa phần lớn luật chơi: phần thưởng, vòng chơi, lưu dữ liệu | Chúng chạy trên server, và không có gì trong ServerScriptService được gửi tới người chơi. |
| Bên trong một part trong Workspace | Script gắn với một part, như ColourChanger và TouchPad | Ổn khi đang học: part là script.Parent. Với dự án thật, Roblox khuyên gắn tag cho part thay vì cách này (xem bên dưới). |
| StarterPlayerScripts, bên trong StarterPlayer | Phần lớn LocalScript: nhập liệu, camera, hiệu ứng cho một người chơi | Mỗi người chơi nhận một bản sao riêng khi vào game. |
| StarterGui | LocalScript bên trong ScreenGui điều khiển menu trên màn hình | Mỗi người chơi nhận một bản sao giao diện riêng. |
| ReplicatedStorage | ModuleScript mà cả code server lẫn code client cùng require | Cả hai phía đều thấy nó. LocalScript hoặc Script với cài đặt mặc định sẽ không bao giờ chạy ở đây. |
Trang của Roblox về vị trí đặt script khuyên hoàn toàn không đặt script trực tiếp trong part ở Workspace: hãy gắn tag cho part và xử lý chúng từ một ModuleScript bằng CollectionService. Dù vậy script bên trong part vẫn là cách bắt đầu đơn giản nhất, và với một hai object khi đang học thì không sao. Hướng dẫn làm cửa chỉ mẫu dùng tag, với một script cho mọi cánh cửa, còn hướng dẫn về client và server có bảng đầy đủ container nào chạy loại script nào.
Khi có gì đó sai: hãy đọc Output
Lỗi hiện trong Output màu đỏ. Mỗi lỗi bắt đầu bằng nơi nó xảy ra, tên đầy đủ của script và số dòng, rồi cho biết điều gì sai. Click vào lỗi, và Studio mở script ở đúng dòng đó. Ví dụ, nếu bạn xóa bước kiểm tra if not player khỏi TouchPad, và một part rời rơi xuống pad, Output sẽ hiện:
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'
Lỗi trong cách viết code, ví dụ thiếu end, hiện ra ngay cả trước khi bấm Play: Script Editor gạch đỏ chúng, còn cửa sổ Script Analysis (nút Analysis trên tab Script) liệt kê chúng. Script có lỗi kiểu này hoàn toàn không chạy, kể cả các dòng phía trên lỗi.
| Thông báo | Nghĩa là gì | Cách sửa |
|---|---|---|
Colour is not a valid member of Part "Workspace.Part" | Object này không có thứ gì với đúng tên đó. Ở đây thuộc tính được viết là Color. | Đối chiếu cách viết và chữ hoa với cửa sổ Properties hoặc Explorer. Xem thêm về lỗi này. |
attempt to index nil with 'Name' | Code đã đọc một thứ, ở đây là .Name, từ một giá trị nil. Trong ví dụ trên player là nil vì một part rời đã chạm vào pad. | Tìm hiểu vì sao giá trị là nil, và kiểm tra nó bằng if trước khi dùng. Xem thêm về lỗi này. |
Expected 'end' (to close 'then' at line 2), got <eof> | if ở dòng 2 không có end đi kèm. Với hàm, thông báo sẽ ghi to close 'function', còn <eof> nghĩa là cuối file. | Thêm end bị thiếu, dựa vào dòng trong ngoặc chứ không phải dòng cuối. Đôi khi thông báo kết thúc bằng câu "did you forget to close ... at line N?". Đó là phỏng đoán của Luau dựa trên thụt lề, và nó có thể chỉ sai khối, nên hãy kiểm tra dòng trong ngoặc trước. Xem thêm về lỗi cú pháp. |
Nếu script không làm gì và Output cũng trống, thường là script nằm ở nơi nó không bao giờ chạy, hoặc đang chờ một sự kiện không xảy ra. Hướng dẫn về lỗi có danh sách kiểm tra cho script im lặng và thêm về cách đọc Output.
Những gì các tutorial script cũ làm khác
Nếu bạn còn học qua video và bài viết trên diễn đàn, bạn sẽ gặp các mẫu cũ. Đây là những mẫu quan trọng, kèm lý do vì sao mỗi mẫu là vấn đề.
| Tutorial | Vấn đề | Hướng dẫn này |
|---|---|---|
Tạm dừng bằng wait(1) | Tài liệu tham khảo của Roblox đánh dấu wait() toàn cục là đã lỗi thời và nói rằng task.wait() đã thay thế nó. | task.wait(1) |
Tìm nhân vật qua otherPart.Parent, như trong bài học của Roblox về dung nham | Khi mũ hoặc tool trong tay chạm vào part, otherPart.Parent là Accessory hoặc Tool chứ không phải nhân vật, nên không tìm thấy Humanoid và cú chạm bị mất. | FindFirstAncestorOfClass("Model"), rồi GetPlayerFromCharacter |
Dùng Touched không có debounce | Touched kích hoạt nhiều lần liên tiếp chỉ trong một bước chân, nên code chạy đi chạy lại. | Cờ busy và thời gian hồi |
| Đặt LocalScript bên trong một part trong Workspace | LocalScript ở đó không bao giờ chạy. Nó chỉ chạy từ những nơi thuộc về một người chơi. | LocalScript trong StarterPlayerScripts (vì sao) |
Viết part.Touched:connect(...) hoặc table.getn(list) | Hướng dẫn đặt tên của Roblox nói rằng các API camelCase phần lớn đã lỗi thời, và tài liệu tham khảo chỉ liệt kê Connect. table.getn đã lỗi thời, thay bằng #list. | :Connect(...) và #list |
| Đổi coin hoặc gây sát thương trong LocalScript | Thay đổi chỉ ở lại trên thiết bị của người chơi đó, nên không ai khác thấy và server không tính nó. | Luật chơi nằm trong Script trên server |
Thực hành: ba thay đổi nên thử
Sửa code dạy bạn nhiều hơn là đọc nó. Hãy thử từng cái một trong place của bạn và bấm Play sau mỗi lần.
- Cho pad cộng một điểm. Thêm script Leaderstats từ bước 1 của hướng dẫn bảng xếp hạng. Sau đó trong TouchPad, sau
busy = true, tìm folderleaderstatscủa người chơi và cộng 1 vào giá trịCoins. Gợi ý:player:FindFirstChild("leaderstats"), rồileaderstats:FindFirstChild("Coins"), rồicoins.Value += 1. Pad coin trong hướng dẫn bảng xếp hạng là phiên bản hoàn chỉnh, có thời gian hồi cho từng người chơi. - Cho ColourChanger đổi cả độ trong suốt. Làm cho ColourChanger mỗi giây đổi cả
Transparencycủa part. Gợi ý: thêm một bảng thứ hai gồm các số từ 0 tới 1, ví dụ{ 0, 0.3, 0.6 }, và đặtpart.Transparencytừ bảng đó ở dòng saupart.Color, với cùngindex. - In màu của pad. Cho MyFirstLocalScript in
Colorcủa pad khi bấm E. Gợi ý:print(pad.Color)bên trong khốiif pad and pad:IsA("BasePart"). Bấm E khi pad đang vàng: client thấy màu do server đặt, vì thay đổi trên server tới được mọi client.
Học gì tiếp theo
Giờ bạn đã dùng các mảnh ghép tạo nên phần lớn script trong game. Một thứ tự tốt để học tiếp:
- LocalScript vs Script vs ModuleScript: mỗi loại script chạy ở đâu và có thể thay đổi gì, sâu hơn bước 4.
- RemoteEvent: cách LocalScript nhờ server làm gì đó và cách server kiểm tra yêu cầu.
- Bảng xếp hạng: các chỉ số đầu tiên của bạn, được tạo và thay đổi trên server.
- Game đầu tiên của bạn: một đường chạy ngắn có dung nham, coin và pad về đích với hai script server, rồi publish.
- Sau đó chọn một hệ thống: GUI shop, hệ thống vòng chơi, checkpoint trong obby, màn hình loading hoặc animation khi bấm phím. Khi có gì đó hỏng, hướng dẫn về lỗi script giúp bạn đọc thông báo. Hướng dẫn checkpoint hiện chỉ có bằng tiếng Anh.
Các tutorial của chính Roblox Coding fundamentals (bằng tiếng Anh) bổ sung tốt cho hướng dẫn này: sáu loạt bài từ biến và hàm, qua điều kiện, vòng lặp, mảng và dictionary, tới tổ chức code trong ModuleScript, kèm các dự án nhỏ trong Studio.
Lỗi thường gặp và cách sửa
Phần lớn vấn đề với những script đầu tiên là tên không khớp, script đặt sai chỗ, hoặc vòng lặp không có lệnh chờ. Hãy để Output mở trong lúc test.
Studio bị treo hoặc không phản hồi khi bấm Play
Vòng lặp while true do không có lệnh chờ, nên không có gì khác chạy được. Tài liệu Roblox nói vòng lặp vô hạn không có khoảng chờ như task.wait() sẽ làm treo game và crash Studio. Hãy đặt task.wait() trong mọi vòng lặp vô hạn, như trong ColourChanger.
Không có gì xảy ra khi mình đứng lên pad
Kiểm tra rằng TouchPad là một Script, không phải LocalScript, nằm ngay bên trong part Pad, không bị tắt, và thuộc tính CanTouch của pad được tích. Sau đó đặt print("touched", otherPart.Name) làm dòng đầu tiên bên trong onTouched. Nếu nó không in ra, sự kiện không kích hoạt; nếu có in ra, vấn đề nằm ở phía dưới.
Bấm E không có tác dụng gì
MyFirstLocalScript phải là một LocalScript bên trong StarterPlayerScripts: LocalScript trong Workspace hoặc ServerScriptService không bao giờ chạy. Part phải tên đúng là Pad và nằm ngay trong Workspace. Hãy click vào cửa sổ game trước và đảm bảo bạn không đang gõ trong chat, vì script bỏ qua những phím mà game đã dùng.
Part thay đổi trên màn hình của mình nhưng người chơi khác không thấy
Thay đổi do LocalScript tạo ra, nên nó chỉ ở lại trên thiết bị của bạn. Hãy làm nó trong một Script server, hoặc để LocalScript nhờ server qua RemoteEvent.
ColourChanger chạy được bên trong part nhưng hỏng trong ServerScriptService
Nó dùng script.Parent làm part của mình. Trong ServerScriptService, parent là ServerScriptService, vốn không có Anchored hay Color, nên Output hiện lỗi "not a valid member". Hãy giữ nó bên trong part, hoặc đặt tên cho part và tìm nó theo tên, ví dụ local part = workspace:WaitForChild("ColourPart") :: BasePart.
Output hoàn toàn không hiện gì
Kiểm tra rằng cửa sổ Output đang mở (menu Window hoặc tab Script) và không có bộ lọc: Output có thể lọc theo loại thông báo, theo Client hoặc Server và theo chữ. Nếu nó đang mở mà vẫn trống, có lẽ script chưa chạy. Xem danh sách kiểm tra cho script không làm gì.
Nếu bị kẹt: RoCode
Nếu bạn bị kẹt với một script trong place của mình, RoCode có thể cùng bạn xem xét nó. RoCode là một AI agent độc lập cho Roblox Studio, không phải của Roblox: bạn viết trong chat trên web, còn plugin Studio của nó tạo và sửa script trong Explorer của bạn.
Trong lúc đang học, chế độ Ask rất hữu ích: bạn tự viết script, còn RoCode đọc những gì đã có và trả lời câu hỏi.
Giải thích từng dòng script TouchPad bên trong part Pad làm gì, và vì sao nó dùng debounce.
- Ở chế độ Ask chỉ dùng các công cụ đọc, ví dụ Search Scripts và Read Script, và không thay đổi gì trong place
- Nếu có gì cần sửa, nó cho biết nó sẽ thay đổi gì và ở đâu, rồi đề nghị chuyển sang Build
- Ở chế độ Build, nó sửa script tại chỗ, rồi kiểm tra từng script bằng Check Script. Đây là bước kiểm tra compile, không phải kiểm tra kiểu và không phải playtest
- Đọc Output của Studio bằng công cụ Check Output, 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ấm Stop
Ở chế độ Build, 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 3.9.11 trở lên nó có thể điều khiển một nhân vật thử nghiệm, nhưng nó không chụp màn hình trong lúc chơi, nên bạn vẫn phải tự đứng lên pad. RoCode kết nối với Studio thế nào.
Câu hỏi thường gặp
Viết script trong Roblox Studio ở đâu?
Trong Explorer, rê chuột lên một container, ví dụ ServerScriptService, bấm + và chọn Script. Studio mở nó trong Script Editor, nơi bạn viết Luau. Script server thường nằm trong ServerScriptService; LocalScript nằm trong StarterPlayerScripts hoặc StarterGui.
Làm sao chạy script trong Roblox Studio?
Bấm Play (F5). Studio chạy playtest, và mọi Script đang bật trong ServerScriptService hoặc Workspace chạy ngay khi game khởi động; LocalScript trong StarterPlayerScripts chạy khi bạn vào playtest. Run (chọn trong danh sách cạnh Play hoặc bấm F8) chạy game không có avatar, nên với hướng dẫn này hãy dùng Play. Stop (Shift+F5) kết thúc lần test. Để mở một script có sẵn, double click vào nó trong Explorer.
Roblox dùng ngôn ngữ lập trình nào?
Luau. Roblox mô tả nó là một ngôn ngữ script nhanh, nhỏ, an toàn với kiểu dữ liệu từng phần (gradual typing), bắt nguồn từ Lua 5.1, nên phần lớn tutorial Lua vẫn hữu ích. Luau thêm các tính năng như nội suy chuỗi bằng dấu backtick và chú thích kiểu không bắt buộc, còn Roblox thêm các thư viện và object riêng, ví dụ task.wait.
Script khác LocalScript thế nào?
Script chạy trên server, và thay đổi của nó tới được mọi người chơi. LocalScript chạy trên thiết bị của một người chơi, dùng cho nhập liệu, camera và menu trên màn hình, và những thay đổi nó tạo ra với part, giá trị và giao diện chỉ ở lại trên thiết bị đó. Hướng dẫn về client và server (bằng tiếng Anh) giải thích cả hai, cùng với ModuleScript.
Có thể viết script Roblox Studio trên điện thoại hoặc iPad không?
Trang cài đặt của Roblox mô tả Studio là ứng dụng miễn phí cho Windows và Mac và không nhắc tới phiên bản cho điện thoại hay máy tính bảng, nên để viết script bạn cần máy tính.
Vì sao script của mình không làm gì và cũng không báo lỗi?
Thường là nó nằm ở nơi loại script đó không chạy (LocalScript trong Workspace hoặc Script trong StarterPlayerScripts), nó bị tắt, hoặc sự kiện mà nó chờ không kích hoạt. Hướng dẫn về lỗi có danh sách kiểm tra.
Học script Roblox mất bao lâu?
Không ai có thể đưa ra con số chính xác: nó phụ thuộc vào việc bạn làm nhiều tới đâu. Giúp nhiều nhất là thường xuyên viết các script nhỏ trong place của mình. Hãy sửa bốn script ở đây, thử các bài thực hành, rồi làm theo hướng dẫn game đầu tiên và thêm từng hệ thống một.
Nguồn và tài liệu đọc thêm
- Roblox Creator Docs: Luau (bằng tiếng Anh). Luau là gì và nó từ đâu ra
- Roblox Creator Docs: Roblox Studio setup (bằng tiếng Anh). Windows và Mac, yêu cầu hệ thống
- Roblox Creator Docs: Output (bằng tiếng Anh). mở Output, bộ lọc, Show Context và Show Source
- Roblox Creator Docs: Studio testing modes (bằng tiếng Anh). Play, Run, Stop, nút chuyển Client/Server và Server & Clients
- Roblox Creator Docs: Script Editor (bằng tiếng Anh). nơi mở script mới và Script Analysis
- Roblox Creator Docs: Script types and locations (bằng tiếng Anh). mỗi loại script chạy ở đâu, và dùng tag thay cho script trong part
- Roblox Creator Docs: Script (bằng tiếng Anh). khi nào Script bắt đầu chạy
- Roblox Creator Docs: Control structures (bằng tiếng Anh). điều kiện, vòng lặp và vì sao vòng lặp vô hạn cần lệnh chờ
- Roblox Creator Docs: Events (bằng tiếng Anh). Connect và những gì Touched truyền cho hàm
- Roblox Creator Docs: Debounce patterns (bằng tiếng Anh). vì sao Touched kích hoạt nhiều lần cho một lần chạm
- Roblox Creator Docs: wait (bằng tiếng Anh). wait() toàn cục và task.wait()
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (bằng tiếng Anh). client có thể làm gì với nhân vật của mình
- Roblox Creator Docs: Coding fundamentals (bằng tiếng Anh). loạt bài cho người mới của Roblox
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.