Tóm tắt
RemoteEvent là một object thường nằm trong ReplicatedStorage và truyền tin nhắn qua ranh giới giữa client và server. LocalScript gọi FireServer, và server nhận tin nhắn trong OnServerEvent, với Player đã gửi nó được thêm vào làm tham số đầu tiên. Server gọi FireClient(player, ...) hoặc FireAllClients(...), và các LocalScript nhận tin nhắn trong OnClientEvent.
- Chỉ dùng RemoteFunction (
InvokeServervàOnServerInvoke) khi client cần câu trả lời. TránhInvokeClient: một client bị lỗi, đã thoát hoặc không bao giờ trả về giá trị sẽ làm hỏng lời gọi trên server. - Đừng bao giờ tin những gì client gửi lên. Trên server, hãy kiểm tra kiểu, phạm vi và quyền sở hữu của từng tham số, khoảng cách tới người chơi và tần suất người đó gọi remote.
- Function, metatable và object mà phía bên kia không nhìn thấy sẽ không còn nguyên sau khi gửi đi. UnreliableRemoteEvent có thể làm mất tin nhắn hoặc đảo thứ tự của chúng, và bỏ đi mọi dữ liệu lớn hơn 1000 byte.
Trong trang này
Vì sao cần RemoteEvent
Mọi game Roblox đều chạy dưới dạng một server cộng với một client cho mỗi người chơi. Server là bên chính ở đây: một object mới hay một thay đổi thuộc tính chỉ tới được mọi người chơi khi server thực hiện nó. Thay đổi làm trong LocalScript chỉ nằm trên một thiết bị, trừ vài ngoại lệ như nhân vật của chính người chơi, thứ mà client của họ điều khiển chuyển động. Vì vậy, khi một cú click hay một phím bấm cần thay đổi thế giới chung, client phải xin server, còn khi server muốn màn hình của một người chơi phản ứng, nó phải báo cho client đó. Nếu việc chia Script và LocalScript còn mới với bạn, hãy đọc Script vs LocalScript vs ModuleScript (tiếng Anh) trước. Nếu bản thân việc viết script còn mới, hãy bắt đầu với cách viết script trong Roblox Studio.
Để vượt qua ranh giới này, Roblox cung cấp ba object:
- RemoteEvent: tin nhắn một chiều. Bên gửi tiếp tục chạy ngay.
- RemoteFunction: yêu cầu có chờ câu trả lời. Code gọi nó tạm dừng cho tới khi phía bên kia trả về giá trị.
- UnreliableRemoteEvent: tin nhắn một chiều có thể bị mất hoặc tới không đúng thứ tự, nhưng đổi lại tốn ít băng thông mạng hơn. Phù hợp với dữ liệu thay đổi liên tục.
| Hướng | Bên gửi gọi | Bên nhận kết nối với | Bên nhận nhận được |
|---|---|---|---|
| Từ client tới server | remote:FireServer(...) trong LocalScript | remote.OnServerEvent trong Script | Player đã gửi tin nhắn, rồi tới các tham số của bạn |
| Từ server tới một client | remote:FireClient(player, ...) trong Script | remote.OnClientEvent trong LocalScript | Chỉ các tham số của bạn |
| Từ server tới mọi client | remote:FireAllClients(...) trong Script | remote.OnClientEvent trong LocalScript | Chỉ các tham số của bạn |
| Client hỏi, server trả lời | remoteFunction:InvokeServer(...) | remoteFunction.OnServerInvoke = function(player, ...) | Player, rồi tới các tham số của bạn. Bên gọi nhận được giá trị mà function trả về |
Các client không thể gửi tin nhắn trực tiếp cho nhau. Để chuyển thứ gì đó từ một người chơi tới những người còn lại, hãy gửi nó lên server, kiểm tra ở đó, rồi để server chuyển tiếp qua FireClient hoặc FireAllClients. Theo khuyến nghị bảo mật của Roblox, server ở đây đóng vai người gác cổng, chứ không phải một trạm chuyển tiếp đơn thuần.
Đặt remote ở đâu
Remote phải nằm ở nơi cả server lẫn client đều thấy. Chỗ thông thường là ReplicatedStorage; tài liệu Roblox ghi rằng trong một số trường hợp Workspace hoặc Tool cũng dùng được. ServerStorage và ServerScriptService chỉ server truy cập được, nên LocalScript chờ remote ở đó sẽ chờ mãi mãi.
- Trong Explorer, rê chuột lên ReplicatedStorage, bấm nút + và chèn một Folder. Đặt tên thư mục là
Remotes. - Rê chuột lên
Remotes, bấm + và chèn một RemoteEvent. Đổi tên nó sao cho tên mô tả đúng mục đích, ví dụPaintRequest. - Lặp lại cho từng remote. Hướng dẫn này dùng hai RemoteEvent (
PaintRequestvàNotify) và một RemoteFunction (RedeemCode).
ReplicatedStorage
Remotes Folder new
PaintRequest RemoteEvent new
Notify RemoteEvent new
RedeemCode RemoteFunction new
ServerScriptService
PaintServer Script new
WelcomeServer Script new
FinishAnnouncer Script new
RedeemServer Script new
RemoteGuard ModuleScript new
StarterPlayer
StarterPlayerScripts
PaintClient LocalScript new
NotifyClient LocalScript new
StarterGui
CodeGui ScreenGui new
CodeBox TextBox new
RedeemClient LocalScript new
Workspace
Paintable Folder new
FinishLine Part new
Các script trong hướng dẫn này tìm remote bằng WaitForChild. Nó trả kết quả ngay nếu remote đã có sẵn, và chờ nếu chưa có, ví dụ khi một script server tạo remote trong lúc chơi. Hãy tạo một remote riêng cho mỗi loại yêu cầu: khi đó mỗi handler trên server chỉ kiểm tra một dạng tham số, và làm đúng việc này dễ hơn nhiều so với một remote dùng cho mọi trường hợp.
Mô hình 1: từ client tới server, có kiểm tra trên server
Tình huống phổ biến nhất: người chơi làm gì đó trên màn hình của họ, còn server quyết định chuyện gì xảy ra. Ở đây người chơi bấm Q để chọn một trong bốn màu, rồi click hoặc chạm vào một part để sơn nó. Mọi người đều thấy màu mới, vì server là bên sơn.
Client gửi hai thứ: part nào và số thứ tự của màu. Nó không bao giờ gửi chính màu đó, và trong các game khác nó cũng không được gửi giá tiền, phần thưởng hay lượng sát thương theo cách y hệt. Client bị chỉnh sửa có thể gửi bất cứ thứ gì, nên dữ liệu thật (ở đây là bảng màu) do server giữ, còn các tham số được server coi là một yêu cầu cần kiểm tra.
- Trong Workspace, chèn một Folder tên
Paintablevà đặt vào đó vài Part đã anchor. - Kiểm tra rằng trong
ReplicatedStorage.Remotescó RemoteEvent tênPaintRequest. - Chèn một Script tên
PaintServervào ServerScriptService và một LocalScript tênPaintClientvào StarterPlayer, StarterPlayerScripts, với code bên dưới.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local remotes = ReplicatedStorage:WaitForChild("Remotes")
local paintRequest = remotes:WaitForChild("PaintRequest") :: RemoteEvent
local paintable = workspace:WaitForChild("Paintable")
-- Màu thuộc về server. Client chỉ gửi một số thứ tự để chọn một trong số đó.
local PALETTE = {
Color3.fromRGB(231, 76, 60),
Color3.fromRGB(46, 204, 113),
Color3.fromRGB(52, 152, 219),
Color3.fromRGB(241, 196, 15),
}
local MAX_DISTANCE = 30 -- số stud giữa nhân vật và part
local COOLDOWN_SECONDS = 0.25
local lastPaint: { [Player]: number } = {}
-- Tham số đầu tiên luôn là người chơi đã gọi remote. Roblox tự điền nó,
-- nên có thể tin được. Mọi thứ sau nó đến từ client, và không được tin.
paintRequest.OnServerEvent:Connect(function(player: Player, part: unknown, colourIndex: unknown)
-- 1. Kiểu: một part thật, không phải table giả làm part
if typeof(part) ~= "Instance" or not part:IsA("BasePart") then
return
end
-- 2. Phạm vi: số nguyên từ 1 đến 4. NaN và vô cực cũng bị loại ở đây.
if type(colourIndex) ~= "number" or not math.isfinite(colourIndex) then
return
end
if colourIndex % 1 ~= 0 or colourIndex < 1 or colourIndex > #PALETTE then
return
end
-- 3. Mục tiêu được phép: chỉ các part trong thư mục Paintable, không gì khác trong game
if not part:IsDescendantOf(paintable) then
return
end
-- 4. Khoảng cách: nhân vật của người chơi phải ở gần part
local character = player.Character
local root = character and character:FindFirstChild("HumanoidRootPart")
if not (root and root:IsA("BasePart")) then
return
end
if (root.Position - part.Position).Magnitude > MAX_DISTANCE then
return
end
-- 5. Giới hạn tần suất: mỗi người chơi được sơn một lần mỗi phần tư giây
local now = os.clock()
local last = lastPaint[player]
if last and now - last < COOLDOWN_SECONDS then
return
end
lastPaint[player] = now
part.Color = PALETTE[colourIndex]
end)
Players.PlayerRemoving:Connect(function(player: Player)
lastPaint[player] = nil
end)
Mỗi bước kiểm tra không qua chỉ đơn giản là return. Không cần giải thích cho client gian lận vì sao nó bị từ chối.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")
local remotes = ReplicatedStorage:WaitForChild("Remotes")
local paintRequest = remotes:WaitForChild("PaintRequest") :: RemoteEvent
local paintable = workspace:WaitForChild("Paintable")
local COLOUR_COUNT = 4 -- màu thật do server giữ
local selectedColour = 1
-- Tia chỉ được trúng các part bên trong thư mục Paintable
local rayParams = RaycastParams.new()
rayParams.FilterType = Enum.RaycastFilterType.Include
rayParams.FilterDescendantsInstances = { paintable }
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed then
return -- phím hoặc cú click đã đi vào chat hoặc vào một nút
end
if input.KeyCode == Enum.KeyCode.Q then
selectedColour = selectedColour % COLOUR_COUNT + 1
return
end
local isClick = input.UserInputType == Enum.UserInputType.MouseButton1
local isTap = input.UserInputType == Enum.UserInputType.Touch
if isClick or isTap then
local camera = workspace.CurrentCamera
local ray = camera:ScreenPointToRay(input.Position.X, input.Position.Y)
local result = workspace:Raycast(ray.Origin, ray.Direction * 500, rayParams)
if result then
-- Xin chứ không ra lệnh: sơn hay không là do server quyết định
paintRequest:FireServer(result.Instance, selectedColour)
end
end
end)
gameProcessed là true khi engine đã xử lý input này, thường là trong giao diện: một cú click vào nút hoặc các phím gõ vào ô văn bản như thanh chat. Nhờ bước kiểm tra này, chữ Q gõ trong tin nhắn không làm đổi màu.
Mô hình 2: từ server tới một client
Server gửi tin nhắn cho một người chơi qua FireClient. Tham số đầu tiên là Player nhận tin, còn handler trên client chỉ nhận các tham số sau nó. Dùng cách này cho mọi thứ mang tính cá nhân: một thông báo, một cửa sổ phần thưởng, một âm thanh chỉ người chơi đó được nghe. Hướng dẫn cutscene là ví dụ lớn hơn được phân tích kỹ: server quyết định khi nào người chơi xem cutscene và gửi các khung hình của nó cho đúng người chơi đó qua FireClient, còn camera do thiết bị của họ di chuyển.
Cặp script này hiện lời chào khi người chơi vào game. LocalScript tự dựng một banner nhỏ, nên không cần thiết lập GUI.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local function welcome(player: Player)
-- Tham số đầu tiên chọn client nào nhận tin nhắn. Không ai khác thấy nó.
notify:FireClient(player, `Welcome, {player.DisplayName}! Press Q to change colour.`)
end
Players.PlayerAdded:Connect(welcome)
-- Trong Studio bạn có thể vào game trước khi script này kịp kết nối, nên ta chào cả những ai đã ở đây
for _, player in Players:GetPlayers() do
welcome(player)
end
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local player = Players.LocalPlayer
-- Một banner nhỏ ở đầu màn hình, dựng bằng code
local gui = Instance.new("ScreenGui")
gui.Name = "Notifications"
gui.ResetOnSpawn = false
gui.Parent = player:WaitForChild("PlayerGui")
local label = Instance.new("TextLabel")
label.AnchorPoint = Vector2.new(0.5, 0)
label.Position = UDim2.new(0.5, 0, 0, 16)
label.Size = UDim2.fromOffset(420, 44)
label.BackgroundColor3 = Color3.fromRGB(18, 11, 31)
label.TextColor3 = Color3.new(1, 1, 1)
label.TextScaled = true
label.Visible = false
label.Parent = gui
local messageCount = 0
-- Ở đây không có tham số player: server đã chọn ai nhận tin nhắn
notify.OnClientEvent:Connect(function(message: string)
messageCount += 1
local thisMessage = messageCount
label.Text = message
label.Visible = true
task.delay(4, function()
if messageCount == thisMessage then -- ẩn đi nếu chưa bị tin nhắn mới hơn thay thế
label.Visible = false
end
end)
end)
Server gửi tin nhắn trong PlayerAdded, và việc đó có thể xảy ra trước khi LocalScript này kết nối handler của nó. Không sao cả: Roblox xếp hàng các tin nhắn RemoteEvent tới trước khi có handler và giao chúng theo thứ tự ngay khi handler được kết nối.
Client không cần tự bảo vệ trước server: chỉ code server mới gọi được OnClientEvent. Chú thích kiểu message: string dùng cho việc kiểm tra kiểu; nó không phải là kiểm tra lúc chạy.
Mô hình 3: từ server tới mọi client
FireAllClients gửi cùng một tin nhắn cho mọi người chơi đang kết nối. Nó không có tham số Player, và mỗi client nhận tin nhắn trong cùng OnClientEvent như trước, nên script NotifyClient từ mô hình 2 đã hiển thị được nó.
Script này thông báo cho mọi người khi một người chơi lần đầu chạm vạch đích. Thêm vào Workspace một Part đã anchor tên FinishLine, sau đó thêm Script vào ServerScriptService.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local finishLine = workspace:WaitForChild("FinishLine") :: BasePart
local finished: { [Player]: boolean } = {}
finishLine.Touched:Connect(function(hit: BasePart)
local character = hit:FindFirstAncestorOfClass("Model")
local player = character and Players:GetPlayerFromCharacter(character)
if not player or finished[player] then
return -- không phải người chơi hoặc đã được thông báo rồi
end
finished[player] = true
-- Mỗi client đang kết nối chạy handler OnClientEvent của mình với đoạn văn bản này
notify:FireAllClients(`{player.DisplayName} reached the finish!`)
end)
Players.PlayerRemoving:Connect(function(player: Player)
finished[player] = nil
end)
Kẻ exploit có thể kích hoạt Touched cho nhân vật của mình từ bất kỳ khoảng cách nào, nhưng với một thông báo chỉ hiện một lần cho mỗi người chơi thì điều này vô hại. Nếu sau này bạn trao phần thưởng khi về đích, hãy thêm các bước kiểm tra trên server trước khi trao, ví dụ thời gian tối thiểu kể từ khi round bắt đầu.
FireAllClients chỉ tới được những người chơi đang kết nối vào lúc đó. Ai vào muộn một giây sẽ không thấy tin nhắn nữa. Cách này hợp với những khoảnh khắc một lần, như thông báo, hiệu ứng nổ hay âm thanh, nhưng không hợp với trạng thái như đồng hồ đếm round hay giai đoạn hiện tại của game. Với trạng thái, hãy đặt một attribute trên server, ví dụ ReplicatedStorage:SetAttribute("TimeLeft", 30), và đọc nó trên client qua GetAttribute và GetAttributeChangedSignal("TimeLeft"). Attribute được replicate tới mọi client, kể cả người chơi vào sau.
RemoteFunction: khi client cần câu trả lời
RemoteEvent hoạt động theo kiểu "gửi rồi quên". RemoteFunction bắt bên gọi phải chờ: InvokeServer tạm dừng code đã gọi nó cho tới khi function OnServerInvoke trên server trả về giá trị, rồi trao lại giá trị đó. Dùng nó khi client không thể tiếp tục nếu thiếu câu trả lời, ví dụ "mã này có đúng không?". Khi không cần câu trả lời, Roblox khuyên dùng RemoteEvent vì nó không phải chờ.
Ví dụ: một ô để người chơi nhập mã quà tặng. Server giữ các mã, kiểm tra văn bản và trả về hai giá trị: có thành công không và thông báo cần hiển thị.
- Trong
ReplicatedStorage.Remotes, chèn một RemoteFunction tênRedeemCode. - Trong StarterGui, chèn một ScreenGui tên
CodeGui, và bên trong nó một TextBox tênCodeBox. Kích thước và vị trí tùy bạn chọn. - Thêm Script bên dưới vào ServerScriptService, và LocalScript vào bên trong
CodeBox.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local redeemCode = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("RedeemCode") :: RemoteFunction
-- Các mã nằm trên server, nơi không người chơi nào đọc được
local CODES: { [string]: number } = {
LAUNCH = 100,
THANKYOU = 50,
}
local MAX_LENGTH = 20
local COOLDOWN_SECONDS = 2
local usedCodes: { [Player]: { [string]: boolean } } = {}
local lastTry: { [Player]: number } = {}
-- Gán bằng dấu =. OnServerInvoke là callback, không phải sự kiện để Connect.
redeemCode.OnServerInvoke = function(player: Player, code: unknown): (boolean, string)
local now = os.clock()
local last = lastTry[player]
if last and now - last < COOLDOWN_SECONDS then
return false, "Wait a moment before trying again"
end
lastTry[player] = now
if type(code) ~= "string" or #code == 0 or #code > MAX_LENGTH then
return false, "Type a code first"
end
local key = string.upper(code)
local reward = CODES[key]
if not reward then
return false, "That code doesn't exist"
end
local used = usedCodes[player]
if not used then
used = {}
usedCodes[player] = used
end
if used[key] then
return false, "You already used that code"
end
local leaderstats = player:FindFirstChild("leaderstats")
local coins = leaderstats and leaderstats:FindFirstChild("Coins")
if not (coins and coins:IsA("IntValue")) then
return false, "Coins aren't set up in this game yet"
end
used[key] = true
coins.Value += reward
return true, `Code accepted: +{reward} coins`
end
Players.PlayerRemoving:Connect(function(player: Player)
usedCodes[player] = nil
lastTry[player] = nil
end)
Nó cộng vào chỉ số Coins từ hướng dẫn bảng xếp hạng. Các mã đã dùng chỉ được nhớ tới khi người chơi thoát, nên ở dạng này người chơi có thể vào lại và nhập cùng mã đó lần nữa. Nếu coin được lưu lại, đây là coin miễn phí mỗi lần vào lại: trước khi dùng cách này trong game thật, hãy lưu các mã đã dùng của từng người chơi cùng với dữ liệu đã lưu của họ trong DataStore.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local redeemCode = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("RedeemCode") :: RemoteFunction
local box = script.Parent :: TextBox
local GREEN = Color3.fromRGB(46, 204, 113)
local RED = Color3.fromRGB(231, 76, 60)
box.FocusLost:Connect(function(enterPressed: boolean)
local code = box.Text
if not enterPressed or code == "" then
return
end
box.Text = ""
box.PlaceholderText = "Checking..."
-- InvokeServer tạm dừng function này cho tới khi callback trên server trả về giá trị.
-- pcall giữ cho LocalScript không bị dừng nếu lời gọi thất bại.
local ok, accepted, message = pcall(function()
return redeemCode:InvokeServer(code)
end)
if ok and type(message) == "string" then
box.PlaceholderText = message
box.PlaceholderColor3 = if accepted == true then GREEN else RED
else
box.PlaceholderText = "Something went wrong, try again"
box.PlaceholderColor3 = RED
end
end)
RemoteFunction có đúng một callback phía server. Nếu hai script cùng đặt OnServerInvoke cho cùng một RemoteFunction, chỉ cái cuối cùng có tác dụng.
InvokeClient nguy hiểm ở chỗ nào
RemoteFunction cũng hoạt động theo chiều ngược lại, với InvokeClient trên server và OnClientInvoke trên client. Tài liệu Roblox liệt kê ba rủi ro nghiêm trọng:
- Nếu callback của client báo lỗi, server cũng báo lỗi.
- Nếu người chơi thoát trong lúc gọi,
InvokeClientbáo lỗi. - Nếu client không bao giờ trả về giá trị, script server sẽ chờ mãi mãi.
Client bị chỉnh sửa điều khiển callback của chính nó, nên kẻ gian lận có thể cố tình gây ra trường hợp thứ ba và giữ thread server đó bao lâu tùy thích. Để cập nhật màn hình người chơi, hãy dùng FireClient. Nếu server thực sự cần thông tin từ client, hãy gửi một RemoteEvent, để client trả lời qua một RemoteEvent khác, và trên server coi việc không có câu trả lời là trường hợp bình thường.
Kiểm tra mọi tham số trên server
Kẻ exploit có thể gọi bất kỳ RemoteEvent hay RemoteFunction nào, bao nhiêu lần tùy thích và với bất kỳ tham số nào. Thứ duy nhất họ không làm giả được là tham số đầu tiên: Roblox tự điền Player đã gửi tin nhắn. Mọi thứ phía sau đều cần kiểm tra trước khi server hành động. Giấu remote hay kiểm tra trong LocalScript đều vô ích, vì kẻ gian lận điều khiển client của chính họ.
| Kiểm tra | Câu hỏi server đặt ra | Ví dụ |
|---|---|---|
| Kiểu | Đây có đúng kiểu tôi chờ không? Là Instance, chứ không phải table được dựng để trông giống nó? | typeof(part) == "Instance" and part:IsA("BasePart") |
| Phạm vi | Số có hữu hạn và nằm trong giới hạn cho phép không? Văn bản có độ dài hợp lý không? | math.isfinite(n), n >= 1 and n <= 4, #text <= 20 |
| Quyền sở hữu | Người chơi này có sở hữu vật phẩm không, có đủ tiền không, có quyền tác động lên object này không? | Vật phẩm có trong inventory của họ; part nằm bên trong Paintable |
| Khoảng cách | Nhân vật của người chơi có đủ gần trong bản sao thế giới của server không? Chừa một chút dư cho lag. | Không xa quá 30 stud tính từ part |
| Tần suất | Người chơi này có gửi quá thường xuyên không? | Cooldown cho từng người chơi hoặc giới hạn có tích lũy lượt gọi |
NaN đáng được cảnh báo riêng. Nó là một số, nên type(x) == "number" vẫn qua, nhưng mọi phép so sánh với nó đều cho false, và một bước kiểm tra như x < 0 or x > 100 để nó lọt qua hoàn toàn. math.isfinite(x) loại bỏ NaN và cả hai giá trị vô cực.
Hãy nhớ giới hạn của việc kiểm tra khoảng cách. Mỗi client điều khiển physics của nhân vật mình, nên kẻ exploit có thể di chuyển nhân vật tới mục tiêu trước khi gọi. Bước kiểm tra vẫn chặn được kiểu lạm dụng đơn giản nhất, khi đứng một chỗ mà tác động lên cả bản đồ. Hãy giữ các part mục tiêu ở trạng thái anchor: tài liệu bảo mật của Roblox ghi rằng kẻ exploit có thể giành network ownership của các part không bị anchor ở gần mình và kéo chúng lại gần, và việc này lách qua bước kiểm tra khoảng cách.
Đây là các bước kiểm tra đó dưới dạng một ModuleScript bạn có thể dùng trong mọi handler của remote.
local Players = game:GetService("Players")
local RemoteGuard = {}
-- Một số thật nằm giữa min và max. Loại bỏ NaN và vô cực, những thứ vẫn qua được
-- bước kiểm tra thông thường type(x) == "number".
function RemoteGuard.number(value: unknown, min: number, max: number): number?
if type(value) ~= "number" or not math.isfinite(value) then
return nil
end
if value < min or value > max then
return nil
end
return value
end
-- Số nguyên nằm giữa min và max, cho số lượng, chỉ số và bộ đếm
function RemoteGuard.integer(value: unknown, min: number, max: number): number?
local n = RemoteGuard.number(value, min, max)
if n and n % 1 == 0 then
return n
end
return nil
end
-- Văn bản có giới hạn độ dài. utf8.len trả về nil với UTF-8 không hợp lệ, thứ mà
-- DataStore sẽ từ chối.
function RemoteGuard.text(value: unknown, maxLength: number): string?
if type(value) ~= "string" or #value > maxLength or utf8.len(value) == nil then
return nil
end
return value
end
-- Instance thuộc class mong đợi bên trong container mà bạn cho phép.
-- Table được dựng để trông giống Instance sẽ không qua bước kiểm tra typeof.
function RemoteGuard.instanceIn(value: unknown, className: string, container: Instance): Instance?
if typeof(value) ~= "Instance" then
return nil
end
if not value:IsA(className) or not value:IsDescendantOf(container) then
return nil
end
return value
end
-- True khi nhân vật của người chơi ở không xa quá maxDistance stud tính từ position
function RemoteGuard.isNear(player: Player, position: Vector3, maxDistance: number): boolean
local character = player.Character
local root = character and character:FindFirstChild("HumanoidRootPart")
if not (root and root:IsA("BasePart")) then
return false
end
return (root.Position - position).Magnitude <= maxDistance
end
-- Giới hạn tần suất cho từng người chơi. Mỗi người chơi có thể gọi `burst` lần ngay lập tức và
-- được trả lại `perSecond` lượt gọi mỗi giây. Trả về một function để gọi
-- trước khi làm việc: nó trả lời true (được phép) hoặc false (quá thường xuyên).
function RemoteGuard.limiter(burst: number, perSecond: number): (Player) -> boolean
local buckets: { [Player]: { tokens: number, updated: number } } = {}
Players.PlayerRemoving:Connect(function(player: Player)
buckets[player] = nil
end)
return function(player: Player): boolean
local now = os.clock()
local bucket = buckets[player]
if not bucket then
bucket = { tokens = burst, updated = now }
buckets[player] = bucket
end
bucket.tokens = math.min(burst, bucket.tokens + (now - bucket.updated) * perSecond)
bucket.updated = now
if bucket.tokens < 1 then
return false
end
bucket.tokens -= 1
return true
end
end
return RemoteGuard
Hãy đặt nó trong ServerScriptService. Code ở đó không bao giờ tới được client, nên không ai đọc được các bước kiểm tra của bạn.
Và đây là handler từ mô hình 1, được viết lại bằng module này. Thay nội dung của PaintServer:
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerScriptService = game:GetService("ServerScriptService")
-- ":: any" chỉ quan trọng với kiểm tra kiểu strict của Luau; lúc chạy nó không thay đổi gì
local RemoteGuard = require(ServerScriptService:WaitForChild("RemoteGuard")) :: any
local paintRequest = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("PaintRequest") :: RemoteEvent
local paintable = workspace:WaitForChild("Paintable")
local PALETTE = {
Color3.fromRGB(231, 76, 60),
Color3.fromRGB(46, 204, 113),
Color3.fromRGB(52, 152, 219),
Color3.fromRGB(241, 196, 15),
}
local canPaint = RemoteGuard.limiter(4, 4) -- một đợt 4 lần, sau đó 4 lần mỗi giây
paintRequest.OnServerEvent:Connect(function(player: Player, partArg: unknown, colourArg: unknown)
local part = RemoteGuard.instanceIn(partArg, "BasePart", paintable) :: BasePart?
local colourIndex = RemoteGuard.integer(colourArg, 1, #PALETTE) :: number?
if not part or not colourIndex then
return
end
if not RemoteGuard.isNear(player, part.Position, 30) or not canPaint(player) then
return
end
part.Color = PALETTE[colourIndex]
end)
Limiter xóa mục ghi của người chơi khi họ thoát, nên bảng của nó không phình ra suốt thời gian server chạy.
Với vũ khí, các bước kiểm tra này quan trọng nhất: đừng bao giờ để client báo đã bắn trúng ai. Remote trong hướng dẫn làm kiếm không mang tham số nào cả, và server tự tìm mục tiêu. Hướng dẫn làm súng chỉ gửi điểm ngắm, và server kiểm tra kiểu, NaN và khoảng cách của nó trước khi tự bắn tia riêng.
Menu cũng theo cùng quy tắc: gửi lựa chọn, đừng gửi kết quả. Trong hướng dẫn hội thoại NPC, client chỉ gửi số thứ tự của nút được bấm, còn server tự xem câu trả lời đó mang lại gì. Menu trong hướng dẫn teleport gửi tên điểm đến chứ không gửi vị trí, và server tìm điểm đó trong thư mục của mình rồi kiểm tra cần bao nhiêu Wins để tới đó.
Những gì gửi được và không gửi được
Bạn có thể truyền số, chuỗi, giá trị boolean, các kiểu của Roblox như Vector3, CFrame, Color3 và các phần tử Enum, các Instance mà cả hai bên đều thấy, và table chứa những thứ đó. Một số giá trị bị thay đổi hoặc mất đi trên đường truyền:
| Bạn gửi | Chuyện gì xảy ra |
|---|---|
| Một function | Phía bên kia nhận được nil |
| Table có metatable | Metatable bị mất, cùng với mọi thứ mà table chỉ có được thông qua nó |
| Table trộn lẫn khóa số và khóa chuỗi | Roblox khuyên đừng làm vậy: hãy gửi một mảng thuần hoặc một dictionary thuần |
Table có giá trị nil bên trong | Nên tránh: Roblox khuyên không đặt nil ở bất kỳ chỉ số nào |
| Table có khóa kiểu Instance, userdata hoặc function | Các khóa đó bị chuyển thành chuỗi |
| Instance mà bên nhận không thấy, ví dụ từ ServerStorage hoặc được tạo trong LocalScript | Phía bên kia nhận được nil |
| Bất kỳ table nào | Bên nhận nhận được một bản sao, không phải chính table đó |
Một thói quen tốt: gửi định danh, đừng gửi object hay giá trị. Tên vật phẩm, số thứ tự lựa chọn, một part mà server có thể tìm và kiểm tra. Phần còn lại server làm việc với dữ liệu của chính nó.
Vì sao RemoteFunction trả về nil
Nếu InvokeServer trả cho bạn nil, hãy đi qua các mục sau theo thứ tự:
- Nhánh không có giá trị trả về. Mọi lối thoát khỏi
OnServerInvokeđều phải trả về thứ gì đó. Mộtreturnrỗng ở bước kiểm tra sớm sẽ gửi lạinil. - return bên trong function lồng nhau.
returnbên trongpcall(function() ... end), handler của:Connecthoặctask.spawnchỉ thoát khỏi function bên trong đó. Hãy lưu kết quả, ví dụlocal ok, data = pcall(...), rồi trả vềdatatừ chính callback. - Giá trị không thể vượt qua ranh giới. Một function hoặc Instance mà client không thấy (ví dụ bất cứ thứ gì trong ServerStorage) tới nơi dưới dạng
nil. Khi bật instance streaming, một part mà server vừa tạo có thể chưa tới được client vào lúc function trả về. - Callback do script khác đặt. Chỉ lần gán
OnServerInvokecuối cùng có tác dụng. Hãy tìm tên remote trong các script của bạn.
Nếu lời gọi hoàn toàn không trả về, nghĩa là chưa có script nào đặt OnServerInvoke (Roblox giữ các lời gọi trong hàng đợi cho tới khi nó được đặt) hoặc callback bị treo, ví dụ ở WaitForChild chờ một thứ sẽ không bao giờ xuất hiện.
UnreliableRemoteEvent: cho các cập nhật liên tục dùng một lần
UnreliableRemoteEvent có cùng các method và sự kiện như RemoteEvent: FireServer, FireClient, FireAllClients, OnServerEvent và OnClientEvent. Điểm khác là Roblox không đảm bảo việc giao tới lẫn thứ tự. Tin nhắn có thể bị bỏ mà không gửi lại khi:
- nó bị mất trên đường hoặc phải chờ quá lâu trong mạng bị quá tải
- dữ liệu của nó lớn hơn 1000 byte
- client gửi nhiều hơn giới hạn (phần dư bị bỏ đi, không bị hoãn lại)
- vào lúc tới nơi không có handler nào được kết nối (nó bị bỏ đi, không được xếp hàng)
Tin nhắn cũng có thể tới không đúng thứ tự, và thứ tự của chúng không liên quan gì tới RemoteEvent hay RemoteFunction của bạn. Hãy dùng nó khi chỉ giá trị mới nhất là quan trọng và bản cập nhật tiếp theo sẽ tới sau một phần giây: hướng ngắm của người chơi, vị trí của hiệu ứng trang trí, một giá trị thay đổi mỗi frame. Nếu thứ tự quan trọng, hãy đặt số thứ tự hoặc mốc thời gian vào mỗi tin nhắn và bỏ qua mọi thứ cũ hơn tin cuối cùng đã xử lý.
Đừng bao giờ dùng nó cho thứ phải xảy ra đúng một lần, ví dụ mua hàng, sát thương, phần thưởng hay bắt đầu round. Và hãy kiểm tra tham số của nó trên server y như với RemoteEvent.
Thứ tự giao tin và giới hạn tần suất
Các đảm bảo giao tin của Roblox áp dụng cho một kết nối theo một chiều: từ server tới một client hoặc từ một client tới server.
- RemoteEvent đáng tin cậy và có thứ tự. Tin nhắn bị mất được gửi lại chừng nào bên nhận còn kết nối, và tin nhắn tới theo đúng thứ tự bạn gửi, kể cả qua các RemoteEvent khác nhau. Nếu server gửi cho một người chơi A, rồi B, rồi A, người chơi đó nhận được A, B, A.
- Thứ tự áp dụng cho thời điểm handler bắt đầu chạy. Nếu handler yield, ví dụ qua
task.waithoặcWaitForChild, tin nhắn tiếp theo có thể bắt đầu được xử lý trước khi tin đầu tiên xong. - RemoteFunction và RemoteEvent không có thứ tự với nhau. Nếu code của bạn phụ thuộc vào thứ tự chặt chẽ, hãy gửi các tin nhắn liên quan qua cùng một loại remote hoặc tự thêm số thứ tự.
- Thay đổi thuộc tính và attribute không có thứ tự so với remote. Nếu server đổi một thuộc tính rồi gọi remote, client có thể thấy bất kỳ cái nào trước. Hãy lắng nghe chính thay đổi đó, ví dụ qua
GetPropertyChangedSignal, thay vì cho rằng nó đã tới. - Chưa có handler. Tin nhắn RemoteEvent nằm trong hàng đợi cho tới khi có handler kết nối. Hàng đợi có giới hạn: khi đầy, các tin nhắn tiếp theo bị bỏ, và trong Output xuất hiện lỗi
Remote event invocation discarded. - Người chơi đang thoát mất mọi tin nhắn chưa kịp tới chỗ họ.
Giới hạn tần suất. Tin nhắn RemoteEvent và UnreliableRemoteEvent từ client tới server bị giới hạn ở khoảng 500 yêu cầu mỗi giây cho mỗi client, theo tài liệu tính đến ngày 30 tháng 9 năm 2026. Giới hạn này dùng chung cho mọi remote cùng loại, nên chia một remote bận rộn thành mười cái cũng không nâng được nó. Vượt quá giới hạn, tin nhắn RemoteEvent được xử lý sau và giữ nguyên thứ tự, còn tin nhắn UnreliableRemoteEvent bị bỏ. Giới hạn của engine hoàn toàn không ngăn một người chơi gọi remote của bạn 50 lần mỗi giây, nên mọi handler có thay đổi thứ gì đó vẫn cần giới hạn riêng cho từng người chơi.
RemoteEvent, RemoteFunction, UnreliableRemoteEvent hay attribute?
| Dùng | Để làm gì | Ví dụ | Cần chú ý |
|---|---|---|---|
| RemoteEvent | Tin nhắn một chiều phải tới nơi, và theo đúng thứ tự | Client: "sơn part này". Server: "hiện thông báo này" | Kiểm tra mọi tham số trên server |
RemoteFunction với InvokeServer | Client cần câu trả lời trước khi có thể tiếp tục | Nhập mã quà tặng, xác nhận mua hàng | Bên gọi phải chờ; mọi nhánh đều phải trả về giá trị |
RemoteFunction với InvokeClient | Gần như không bao giờ | Thay vào đó hãy dùng FireClient | Client bị lỗi, đã thoát hoặc không trả lời sẽ làm hỏng hoặc treo lời gọi trên server |
| UnreliableRemoteEvent | Cập nhật thường xuyên, chỉ cái mới nhất là quan trọng | Hướng ngắm, hiệu ứng trang trí | Tin nhắn bị mất hoặc đổi thứ tự; giới hạn dữ liệu 1000 byte |
| Attribute hoặc value object do server đặt | Trạng thái chung phải luôn nhìn thấy được, kể cả với người chơi vào sau | Đồng hồ round, giai đoạn game, cửa có đang mở không | Chỉ thay đổi của server mới tới được mọi người; client lắng nghe qua GetAttributeChangedSignal hoặc Changed |
| BindableEvent | Giao tiếp giữa các script ở cùng một phía | Một script server báo cho script khác rằng round đã kết thúc | Không đi qua giữa server và client |
Để xem ví dụ đầy đủ về cách RemoteFunction và các bước kiểm tra phối hợp với nhau ở nơi người chơi trả tiền, hãy xem hướng dẫn cách làm GUI cửa hàng. Về dòng attribute, script server trong hướng dẫn làm cửa đặt attribute Open trên mỗi cánh cửa mỗi khi nó chuyển động, để bất kỳ LocalScript nào cũng có thể phản ứng theo.
Lỗi thường gặp và cách sửa
Phần lớn vấn đề với remote đều hiện trong cửa sổ Output (mở từ menu Window hoặc tab Script). Hãy xem ở đó trước, rồi tìm triệu chứng của bạn bên dưới. Hướng dẫn lỗi script phân tích kỹ hơn các thông báo lỗi thường gặp.
Infinite yield possible ở WaitForChild cho remote
Script đang chờ một remote sẽ không bao giờ xuất hiện. Kiểm tra tên và chữ hoa chữ thường khớp chính xác, và remote nằm trong ReplicatedStorage chứ không phải ServerStorage hay ServerScriptService, những nơi client không thấy.
Server nhận sai giá trị, bị lệch một vị trí
LocalScript đã truyền chính người chơi, như trong remote:FireServer(player, 5). Roblox vốn đã thêm bên gửi làm tham số đầu tiên, nên server thấy (player, player, 5). Hãy gọi remote:FireServer(5).
Không có gì xảy ra khi tôi gọi remote
Kiểm tra mỗi lời gọi được thực hiện từ đúng phía: FireServer và InvokeServer chỉ chạy từ code client, còn FireClient, FireAllClients và InvokeClient chỉ chạy từ Script server. LocalScript không bao giờ chạy trong ServerScriptService, ServerStorage hoặc trực tiếp trong Workspace; hãy đặt nó vào StarterPlayerScripts, StarterGui, StarterCharacterScripts hoặc StarterPack. Sau đó tìm trong Output lỗi bên trong handler.
Remote event invocation discarded
Tin nhắn đã tới một RemoteEvent chưa có handler nào được kết nối, và hàng đợi bị đầy. Thường thì script chứa handler bị lỗi trước dòng :Connect, bị tắt, hoặc bị treo khi chờ thứ không bao giờ tải xong. Hãy kết nối handler ở gần đầu script.
Với tôi thì chạy, nhưng người chơi khác không thấy thay đổi
Thay đổi được thực hiện trên client, trong LocalScript hoặc trong handler OnClientEvent. Hãy thực hiện nó trong handler OnServerEvent trên server.
InvokeServer không bao giờ trả về
Hoặc chưa có script nào đặt OnServerInvoke (Roblox giữ các lời gọi trong hàng đợi cho tới khi nó được đặt), hoặc callback bị treo ở một thứ có yield, ví dụ WaitForChild hoặc một yêu cầu tới DataStore. Thêm print ở đầu và cuối callback để xem nó dừng ở đâu.
Làm với RoCode
RoCode cũng có thể thiết lập việc này, ngay trong place bạn đang mở. RoCode là một AI agent hoạt động qua plugin cho Roblox Studio, nên nó tạo remote và script trong Explorer của bạn, chứ không đưa ra code để bạn phải tự dán vào.
Cho người chơi sơn các part trong thư mục Paintable bằng cách click. Dùng RemoteEvent và giữ các bước kiểm tra trên server: chỉ các part trong thư mục này, không xa quá 30 stud và không quá vài lần sơn mỗi giây.
- Thường sẽ xem qua place trước bằng Search Game và Search Scripts để tìm thư mục Remotes hoặc handler có sẵn, và dùng các thư mục của bạn nếu chúng đã có
- Tạo RemoteEvent trong ReplicatedStorage qua Create Instance và viết Script server cùng LocalScript qua Create Script
- Trước khi xong, kiểm tra từng script biên dịch được qua Check Script bên trong Studio. Việc này bắt lỗi biên dịch chứ không bắt lỗi logic: nó không kiểm tra kiểu, không chạy linter và không thực thi code của bạn
- Gửi thay đổi theo từng đợt, và mỗi đợt là một điểm undo trong lịch sử Studio
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.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 click vào part trong cửa sổ 3D. Hãy tự bấm Play và thử phá các bước kiểm tra, ví dụ sơn một part từ đầu bên kia bản đồ. Nếu có lỗi, Check Output có thể đọc các dòng Server và Client từ lần playtest gần nhất của bạn. Phần lớn hệ thống game giao tiếp qua những remote như thế này, nên bạn sẽ gặp lại chúng khi dựng game từng hệ thống một với RoCode. RoCode kết nối với Studio như thế nào.
Câu hỏi thường gặp
Securing the client-server boundary trong Roblox nghĩa là gì?
Đó là tên trang tài liệu của Roblox về bảo mật remote, và ý tưởng rất đơn giản: mọi thứ client gửi qua RemoteEvent hoặc RemoteFunction đều có thể đến từ kẻ exploit, nên server kiểm tra nó trước khi hành động. Kiểm tra kiểu của từng tham số, giữ các con số trong giới hạn hợp lý, kiểm tra người chơi lúc này có được phép làm việc đó không, và giới hạn tần suất mỗi người chơi được gọi remote. Danh sách kiểm tra ở trên cho thấy từng bước bằng code.
Dùng RemoteFunction có an toàn không?
InvokeServer an toàn đúng bằng mức callback server của bạn an toàn: hãy kiểm tra tham số của nó và giới hạn tần suất, như với bất kỳ RemoteEvent nào. Chiều có rủi ro là InvokeClient, vì client bị lỗi, đã thoát hoặc không bao giờ trả về giá trị sẽ làm hỏng hoặc treo lời gọi trên server.
Kẻ exploit có thấy và gọi được remote của tôi không?
Có. Mọi thứ nằm trong ReplicatedStorage đều tới được mọi client, và client bị chỉnh sửa có thể gọi bất kỳ remote nào với bất kỳ tham số nào. Đổi tên hay giấu remote không làm chúng an toàn; thứ làm chúng an toàn là kiểm tra từng tham số trên server.
Một client có thể gửi RemoteEvent cho client khác không?
Trực tiếp thì không. Gửi nó lên server, kiểm tra ở đó, rồi dùng FireClient hoặc FireAllClients.
Có thể gọi RemoteEvent thường xuyên tới mức nào?
Tài liệu Roblox ghi giới hạn khoảng 500 yêu cầu mỗi giây cho mỗi client đối với tin nhắn RemoteEvent và UnreliableRemoteEvent gửi lên server, dùng chung cho mọi remote cùng loại. Hãy giữ ở mức thấp hơn nhiều và cho mỗi handler một giới hạn riêng cho từng người chơi.
FireAllClients có tới được người chơi vào sau không?
Không. Nó tới những người chơi đang kết nối vào lúc đó. Với trạng thái mà người vào muộn cần biết, hãy đặt một attribute hoặc value object trên server.
RemoteEvent và BindableEvent khác nhau thế nào?
RemoteEvent đi qua giữa server và client. BindableEvent kết nối các script ở cùng một phía, ví dụ hai script server.
Nguồn và tài liệu đọc thêm
- Roblox Creator Docs: Remote events and callbacks (tiếng Anh). FireServer, FireClient, InvokeServer, rủi ro của InvokeClient, giới hạn tham số và đảm bảo giao tin
- Roblox Creator Docs: Securing the client-server boundary (tiếng Anh). Các mức kiểm tra, NaN, giới hạn tần suất, chuyển tiếp từ client tới client
- Roblox Creator Docs: Security and cheat mitigation tactics (tiếng Anh). Client bị chỉnh sửa làm được gì và quyền quyết định của server
- Roblox Creator Docs: Network ownership, movement validation, and physics (tiếng Anh). Vì sao client điều khiển nhân vật của mình và giới hạn của kiểm tra khoảng cách
- Roblox Engine API: RemoteEvent (tiếng Anh). Giới hạn tần suất và lỗi invocation discarded
- Roblox Engine API: RemoteFunction (tiếng Anh). OnServerInvoke, cảnh báo về InvokeClient và các lưu ý khi dùng streaming
- Roblox Engine API: UnreliableRemoteEvent (tiếng Anh). Giới hạn dữ liệu 1000 byte
- Roblox Creator Docs: Properties and attributes (tiếng Anh). Thứ tự replication giữa thay đổi thuộc tính và remote event
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.