Hướng dẫn · Cơ bản về scripting

RemoteEvent trong Roblox: từ client tới server và ngược lại

LocalScript không thể thay đổi những gì người chơi khác nhìn thấy, còn Script server không thể chạm tới màn hình của một người chơi. Tin nhắn giữa hai bên được truyền bằng RemoteEvent. Trong hướng dẫn này chúng ta dựng ba mô hình bạn sẽ cần thường xuyên nhất, một RemoteFunction trả về câu trả lời, và các bước kiểm tra trên server để client bị chỉnh sửa không thể lạm dụng chúng.

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

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 (InvokeServer và OnServerInvoke) khi client cần câu trả lời. Tránh InvokeClient: 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
  1. Vì sao cần remote
  2. Thiết lập remote
  3. 1. Từ client tới server
  4. 2. Từ server tới client
  5. 3. Từ server tới mọi người
  6. RemoteFunction
  7. Danh sách kiểm tra
  8. Thứ không gửi được
  9. Trả về nil?
  10. UnreliableRemoteEvent
  11. Thứ tự và giới hạn
  12. Nên chọn gì
  13. Common errors
  14. Với RoCode
  15. Câu hỏi thường gặp
  16. Nguồn và tài liệu đọc thêm

Vì sao cần RemoteEvent

Minh họaMỗi cú click yêu cầu server sơn một part, nên màu mới hiện trên màn hình của cả hai người chơi.

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.
Lời gọi nào kích hoạt sự kiện nào
HướngBên gửi gọiBên nhận kết nối vớiBên nhận nhận được
Từ client tới serverremote:FireServer(...) trong LocalScriptremote.OnServerEvent trong ScriptPlayer đã gửi tin nhắn, rồi tới các tham số của bạn
Từ server tới một clientremote:FireClient(player, ...) trong Scriptremote.OnClientEvent trong LocalScriptChỉ các tham số của bạn
Từ server tới mọi clientremote:FireAllClients(...) trong Scriptremote.OnClientEvent trong LocalScriptChỉ các tham số của bạn
Client hỏi, server trả lờiremoteFunction: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.

  1. 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.
  2. 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.
  3. Lặp lại cho từng remote. Hướng dẫn này dùng hai RemoteEvent (PaintRequest và Notify) và một RemoteFunction (RedeemCode).
Explorer: mọi thứ mà hướng dẫn này thêm vào, theo từng phần
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.

  1. Trong Workspace, chèn một Folder tên Paintable và đặt vào đó vài Part đã anchor.
  2. Kiểm tra rằng trong ReplicatedStorage.Remotes có RemoteEvent tên PaintRequest.
  3. Chèn một Script tên PaintServer vào ServerScriptService và một LocalScript tên PaintClient vào StarterPlayer, StarterPlayerScripts, với code bên dưới.
Script trong ServerScriptService tên là PaintServer
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.

LocalScript trong StarterPlayerScripts tên là PaintClient
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.

Script trong ServerScriptService tên là WelcomeServer
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
LocalScript trong StarterPlayerScripts tên là NotifyClient
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.

Script trong ServerScriptService tên là FinishAnnouncer
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ị.

  1. Trong ReplicatedStorage.Remotes, chèn một RemoteFunction tên RedeemCode.
  2. Trong StarterGui, chèn một ScreenGui tên CodeGui, và bên trong nó một TextBox tên CodeBox. Kích thước và vị trí tùy bạn chọn.
  3. Thêm Script bên dưới vào ServerScriptService, và LocalScript vào bên trong CodeBox.
Script trong ServerScriptService tên là RedeemServer
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.

LocalScript trong TextBox CodeBox tên là RedeemClient
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, InvokeClient bá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ọ.

Danh sách kiểm tra cho server
Kiểm traCâu hỏi server đặt raVí 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 viSố 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ữuNgườ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áchNhâ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ấtNgườ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.

ModuleScript trong ServerScriptService tên là RemoteGuard
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:

Script trong ServerScriptService tên là 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:

Các tham số tới nơi không giống lúc gửi
Bạn gửiChuyện gì xảy ra
Một functionPhía bên kia nhận được nil
Table có metatableMetatable 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ỗiRoblox 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 trongNê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 functionCá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 LocalScriptPhía bên kia nhận được nil
Bất kỳ table nàoBê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ự:

  1. 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ột return rỗng ở bước kiểm tra sớm sẽ gửi lại nil.
  2. return bên trong function lồng nhau. return bên trong pcall(function() ... end), handler của :Connect hoặc task.spawn chỉ 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ề data từ chính callback.
  3. 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ề.
  4. Callback do script khác đặt. Chỉ lần gán OnServerInvoke cuố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.wait hoặc WaitForChild, 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?

Cách chọn kiểu giao tiếp giữa client và server
DùngĐể làm gìVí dụCần chú ý
RemoteEventTin 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 InvokeServerClient cần câu trả lời trước khi có thể tiếp tụcNhập mã quà tặng, xác nhận mua hàngBên gọi phải chờ; mọi nhánh đều phải trả về giá trị
RemoteFunction với InvokeClientGần như không bao giờThay vào đó hãy dùng FireClientClient 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
UnreliableRemoteEventCập nhật thường xuyên, chỉ cái mới nhất là quan trọngHướ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 đặtTrạ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ôngChỉ thay đổi của server mới tới được mọi người; client lắng nghe qua GetAttributeChangedSignal hoặc Changed
BindableEventGiao tiếp giữa các script ở cùng một phíaMột script server báo cho script khác rằng round đã kết thúcKhô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.

Bạn gõ

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.

RoCode làm
  • 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

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.