Tutorial · Asas skrip

RemoteEvent Roblox: dari client ke pelayan dan kembali

LocalScript tidak boleh mengubah apa yang dilihat oleh pemain lain, dan Script pelayan tidak boleh mencapai skrin seorang pemain. Mesej antara kedua-duanya dihantar oleh RemoteEvent. Dalam panduan ini kita akan membina tiga corak yang paling kerap anda perlukan, RemoteFunction yang memulangkan jawapan, dan semakan pelayan yang menghalang client yang diubah suai daripada menyalahgunakannya.

Dikemas kini 20 November 202617 minit bacaanDitulis oleh

Ringkasnya

RemoteEvent ialah objek yang biasanya diletakkan dalam ReplicatedStorage dan menghantar mesej merentasi sempadan antara client dan pelayan. LocalScript memanggil FireServer, dan pelayan menerima mesej itu dalam OnServerEvent, dengan Player yang menghantarnya ditambah sebagai argumen pertama. Pelayan memanggil FireClient(player, ...) atau FireAllClients(...), dan LocalScript menerima mesej itu dalam OnClientEvent.

  • Gunakan RemoteFunction (InvokeServer dan OnServerInvoke) hanya apabila client memerlukan jawapan. Elakkan InvokeClient: client yang mengalami ralat, yang keluar atau yang tidak pernah memulangkan nilai akan merosakkan panggilan pada pelayan.
  • Jangan sekali-kali percaya apa yang dihantar oleh client. Pada pelayan, semak jenis, julat dan pemilikan setiap argumen, jarak ke pemain dan berapa kerap dia memanggil remote itu.
  • Fungsi, metatable dan objek yang tidak dapat dilihat oleh pihak sebelah lagi tidak akan sampai dengan selamat. UnreliableRemoteEvent boleh kehilangan mesej atau mengubah susunannya dan membuang apa-apa data yang melebihi 1000 bait.
Di halaman ini
  1. Kenapa perlu remote
  2. Sediakan remote
  3. 1. Client ke pelayan
  4. 2. Pelayan ke client
  5. 3. Pelayan ke semua
  6. RemoteFunction
  7. Senarai semakan
  8. Apa yang tidak boleh dihantar
  9. Memulangkan nil?
  10. UnreliableRemoteEvent
  11. Susunan dan had
  12. Apa yang perlu dipilih
  13. Common errors
  14. Dengan RoCode
  15. Soalan lazim
  16. Sumber dan bacaan lanjut

Kenapa RemoteEvent diperlukan

IlustrasiSetiap klik meminta pelayan mewarnakan part, jadi warna baharu kelihatan pada skrin kedua-dua pemain.

Setiap game Roblox berjalan sebagai satu pelayan dan satu client bagi setiap pemain. Pelayan yang berkuasa di sini: objek baharu atau perubahan sifat hanya sampai kepada semua pemain apabila pelayan yang melakukannya. Perubahan yang dibuat dalam LocalScript kekal pada satu peranti sahaja, kecuali beberapa pengecualian seperti watak pemain itu sendiri, yang pergerakannya dikawal oleh client dia. Oleh itu, apabila klik atau tekanan kekunci perlu mengubah dunia bersama, client perlu meminta pelayan, dan apabila pelayan mahu skrin seorang pemain bertindak balas, ia perlu memberitahu client itu. Jika pembahagian antara Script dan LocalScript masih baharu bagi anda, baca dahulu Script vs LocalScript vs ModuleScript (dalam bahasa Inggeris). Jika skrip itu sendiri masih baharu, mulakan dengan cara menulis skrip dalam Roblox Studio.

Untuk merentasi sempadan ini, Roblox menyediakan tiga objek:

  • RemoteEvent: mesej sehala. Penghantar terus menyambung kerjanya.
  • RemoteFunction: permintaan yang menunggu jawapan. Kod yang memanggil berhenti seketika sehingga pihak sebelah lagi memulangkan nilai.
  • UnreliableRemoteEvent: mesej sehala yang mungkin hilang atau tiba tidak mengikut susunan, tetapi kurang membebankan rangkaian. Sesuai untuk data yang sentiasa berubah.
Panggilan mana yang mencetuskan event mana
ArahPenghantar memanggilPenerima bersambung kepadaPenerima mendapat
Dari client ke pelayanremote:FireServer(...) dalam LocalScriptremote.OnServerEvent dalam ScriptPlayer yang menghantar mesej, kemudian argumen anda
Dari pelayan ke satu clientremote:FireClient(player, ...) dalam Scriptremote.OnClientEvent dalam LocalScriptHanya argumen anda
Dari pelayan ke semua clientremote:FireAllClients(...) dalam Scriptremote.OnClientEvent dalam LocalScriptHanya argumen anda
Client bertanya, pelayan menjawabremoteFunction:InvokeServer(...)remoteFunction.OnServerInvoke = function(player, ...)Player, kemudian argumen anda. Pemanggil mendapat apa yang dipulangkan oleh fungsi itu

Client tidak boleh menghantar mesej terus kepada satu sama lain. Untuk menghantar sesuatu daripada seorang pemain kepada yang lain, hantar ke pelayan, semak di sana, dan biar pelayan meneruskannya melalui FireClient atau FireAllClients. Menurut cadangan keselamatan Roblox, pelayan di sini bertindak sebagai penjaga pintu, bukan sekadar penyampai.

Di mana meletakkan remote

Remote perlu diletakkan di tempat yang boleh dilihat oleh pelayan dan client. Tempat biasa ialah ReplicatedStorage; dokumentasi Roblox menyatakan bahawa dalam sesetengah kes Workspace atau Tool juga sesuai. ServerStorage dan ServerScriptService hanya boleh dicapai oleh pelayan, jadi LocalScript yang menunggu remote dari situ akan menunggu selama-lamanya.

  1. Dalam Explorer, halakan kursor pada ReplicatedStorage, klik butang + dan masukkan Folder. Namakan folder itu Remotes.
  2. Halakan kursor pada Remotes, klik + dan masukkan RemoteEvent. Namakan semula supaya nama itu menerangkan tujuannya, contohnya PaintRequest.
  3. Ulang untuk setiap remote. Panduan ini menggunakan dua RemoteEvent (PaintRequest dan Notify) dan satu RemoteFunction (RedeemCode).
Explorer: semua yang ditambah oleh panduan ini, bahagian demi bahagian
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

Skrip dalam panduan ini mencari remote melalui WaitForChild. Ia memulangkan hasil serta-merta jika remote sudah ada, dan menunggu jika belum ada, contohnya apabila skrip pelayan mencipta remote semasa permainan berjalan. Buat remote berasingan untuk setiap jenis permintaan: dengan itu setiap pengendali pelayan menyemak satu bentuk argumen sahaja, dan melakukannya dengan betul jauh lebih mudah berbanding satu remote untuk semua keadaan.

Corak 1: dari client ke pelayan, dengan semakan pada pelayan

Tugas yang paling kerap: pemain melakukan sesuatu pada skrinnya, dan pelayan yang memutuskan apa yang berlaku. Di sini pemain menekan Q untuk memilih satu daripada empat warna, dan mengklik atau mengetik part untuk mewarnakannya. Semua orang nampak warna baharu itu kerana pelayan yang mewarnakannya.

Client menghantar dua perkara: part mana dan nombor warna. Ia tidak pernah menghantar warna itu sendiri, dan dalam game lain ia juga tidak sepatutnya menghantar harga, ganjaran atau jumlah damage. Client yang diubah suai boleh menghantar apa sahaja, jadi data sebenar (di sini, palet warna) disimpan oleh pelayan, dan argumen dianggap sebagai permintaan yang perlu disemak.

  1. Dalam Workspace, masukkan Folder bernama Paintable dan letakkan beberapa Part yang di-anchor di dalamnya.
  2. Pastikan ReplicatedStorage.Remotes mengandungi RemoteEvent bernama PaintRequest.
  3. Masukkan Script bernama PaintServer ke dalam ServerScriptService dan LocalScript bernama PaintClient ke dalam StarterPlayer, StarterPlayerScripts, dengan kod di bawah.
Script dalam ServerScriptService bernama 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")

-- Warna milik pelayan. Client hanya menghantar nombor yang memilih salah satu daripadanya.
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 -- stud antara watak dan part
local COOLDOWN_SECONDS = 0.25

local lastPaint: { [Player]: number } = {}

-- Parameter pertama sentiasa pemain yang memanggil remote. Roblox yang mengisinya,
-- jadi ia boleh dipercayai. Semua selepasnya datang daripada client dan tidak boleh dipercayai.
paintRequest.OnServerEvent:Connect(function(player: Player, part: unknown, colourIndex: unknown)
	-- 1. Jenis: part sebenar, bukan table yang menyamar sebagai part
	if typeof(part) ~= "Instance" or not part:IsA("BasePart") then
		return
	end

	-- 2. Julat: integer dari 1 hingga 4. NaN dan infiniti juga ditapis di sini.
	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. Sasaran yang dibenarkan: hanya part dalam folder Paintable, tiada yang lain dalam game
	if not part:IsDescendantOf(paintable) then
		return
	end

	-- 4. Jarak: watak pemain mesti berada berdekatan dengan 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. Had kekerapan: satu warna bagi setiap pemain setiap suku saat
	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)

Setiap semakan yang gagal hanya melakukan return. Tiada sebab untuk menerangkan kepada client yang menipu kenapa permintaannya ditolak.

LocalScript dalam StarterPlayerScripts bernama 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 -- warna sebenar disimpan oleh pelayan
local selectedColour = 1

-- Sinar hanya boleh mengenai part di dalam folder 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 -- kekunci atau klik pergi ke chat atau ke butang
	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
			-- Kita meminta, bukan mengarah: pelayan yang memutuskan sama ada untuk mewarnakan
			paintRequest:FireServer(result.Instance, selectedColour)
		end
	end
end)

gameProcessed bernilai true apabila enjin sudah mengendalikan input ini, biasanya dalam antara muka: klik pada butang atau kekunci yang ditaip dalam kotak teks seperti baris chat. Dengan semakan ini, huruf Q yang ditaip dalam mesej tidak menukar warna.

Corak 2: dari pelayan ke satu client

Pelayan menghantar mesej kepada seorang pemain melalui FireClient. Argumen pertama ialah Player yang dituju, dan pengendali pada client hanya menerima argumen selepasnya. Gunakan ini untuk semua perkara peribadi: notifikasi, tetingkap ganjaran, bunyi yang hanya patut didengar oleh pemain itu. Panduan cutscene ialah contoh yang lebih besar dan dihuraikan sepenuhnya: pelayan memutuskan bila pemain akan melihat cutscene dan menghantar syot-syotnya kepada pemain itu sahaja melalui FireClient, manakala peranti pemain itu yang menggerakkan kamera.

Pasangan skrip ini memaparkan ucapan selamat datang apabila pemain masuk. LocalScript membina sepanduk kecil sendiri, jadi anda tidak perlu menyediakan GUI.

Script dalam ServerScriptService bernama WelcomeServer
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent

local function welcome(player: Player)
	-- Argumen pertama memilih client mana yang menerima mesej. Tiada orang lain akan melihatnya.
	notify:FireClient(player, `Welcome, {player.DisplayName}! Press Q to change colour.`)
end

Players.PlayerAdded:Connect(welcome)

-- Dalam Studio anda boleh masuk sebelum skrip ini bersambung, jadi kita sambut semua yang sudah ada di sini
for _, player in Players:GetPlayers() do
	welcome(player)
end
LocalScript dalam StarterPlayerScripts bernama NotifyClient
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local player = Players.LocalPlayer

-- Sepanduk kecil di bahagian atas skrin, dibina dalam kod
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

-- Tiada parameter player di sini: pelayan sudah memilih siapa yang menerima mesej
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 -- sembunyikan jika tiada mesej lebih baharu yang menggantikannya
			label.Visible = false
		end
	end)
end)

Pelayan menghantar mesej pada PlayerAdded, dan ini boleh berlaku sebelum LocalScript ini menyambungkan pengendalinya. Itu tidak mengapa: Roblox meletakkan mesej RemoteEvent yang tiba sebelum pengendali wujud dalam baris gilir dan menghantarnya mengikut susunan sebaik sahaja pengendali bersambung.

Client tidak perlu melindungi dirinya daripada pelayan: hanya kod pelayan yang boleh mencetuskan OnClientEvent. Anotasi message: string hanya untuk semakan jenis; ia bukan semakan semasa program berjalan.

Corak 3: dari pelayan ke semua client

FireAllClients menghantar mesej yang sama kepada setiap pemain yang bersambung. Ia tiada argumen Player, dan setiap client menerima mesej itu dalam OnClientEvent yang sama seperti sebelum ini, jadi skrip NotifyClient daripada corak 2 sudah memaparkannya.

Script ini mengumumkan kepada semua orang apabila seorang pemain menyentuh garisan penamat buat kali pertama. Tambah Part yang di-anchor bernama FinishLine dalam Workspace, kemudian tambah Script dalam ServerScriptService.

Script dalam ServerScriptService bernama 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 -- bukan pemain atau sudah diumumkan
	end
	finished[player] = true

	-- Setiap client yang bersambung menjalankan pengendali OnClientEvent dengan teks ini
	notify:FireAllClients(`{player.DisplayName} reached the finish!`)
end)

Players.PlayerRemoving:Connect(function(player: Player)
	finished[player] = nil
end)

Exploiter boleh mencetuskan Touched untuk wataknya dari jarak mana pun, tetapi untuk pengumuman yang dipaparkan sekali bagi setiap pemain, ini tidak berbahaya. Jika kemudian anda memberi ganjaran kerana sampai ke garisan penamat, tambah semakan pelayan sebelum memberikannya, contohnya masa minimum sejak pusingan bermula.

FireAllClients hanya sampai kepada pemain yang bersambung pada saat itu. Pemain yang masuk sesaat kemudian tidak akan melihat mesej itu. Ini sesuai untuk detik sekali sahaja, seperti pengumuman, kesan letupan atau bunyi, tetapi tidak sesuai untuk keadaan seperti pemasa pusingan atau fasa permainan semasa. Untuk keadaan, tetapkan atribut pada pelayan, contohnya ReplicatedStorage:SetAttribute("TimeLeft", 30), dan bacanya pada client melalui GetAttribute dan GetAttributeChangedSignal("TimeLeft"). Atribut direplikasi kepada setiap client, termasuk pemain yang masuk kemudian.

RemoteFunction: apabila client memerlukan jawapan

RemoteEvent berfungsi secara "hantar dan lupakan". RemoteFunction membuat pemanggil menunggu: InvokeServer menghentikan seketika kod yang memanggilnya sehingga fungsi pelayan OnServerInvoke memulangkan nilai, kemudian memberikan apa yang dipulangkannya. Gunakannya apabila client tidak boleh meneruskan tanpa jawapan, contohnya "adakah kod ini betul?". Apabila jawapan tidak diperlukan, Roblox mengesyorkan RemoteEvent, kerana ia tidak menunggu.

Contoh: kotak tempat pemain menaip kod promo. Pelayan menyimpan kod-kod itu, menyemak teks dan memulangkan dua nilai: sama ada ia berjaya, dan mesej yang perlu dipaparkan.

  1. Dalam ReplicatedStorage.Remotes, masukkan RemoteFunction bernama RedeemCode.
  2. Dalam StarterGui, masukkan ScreenGui bernama CodeGui, dan di dalamnya TextBox bernama CodeBox. Pilih saiz dan kedudukan mengikut citarasa anda.
  3. Tambah Script di bawah dalam ServerScriptService, dan LocalScript di dalam CodeBox.
Script dalam ServerScriptService bernama RedeemServer
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local redeemCode = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("RedeemCode") :: RemoteFunction

-- Kod-kod tinggal di pelayan, tempat tiada pemain boleh membacanya
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 } = {}

-- Diumpukkan dengan =. OnServerInvoke ialah callback, bukan event yang di-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)

Ia menambah kepada statistik Coins daripada panduan leaderboard. Kod yang sudah digunakan hanya diingati sehingga pemain keluar, jadi dalam bentuk ini pemain boleh masuk semula dan memasukkan kod yang sama sekali lagi. Jika syiling disimpan, ini bermakna syiling percuma setiap kali masuk semula: sebelum menggunakannya dalam game yang sudah dilancarkan, simpan kod yang telah digunakan oleh setiap pemain bersama data yang disimpannya dalam stor data.

LocalScript dalam TextBox CodeBox bernama 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 menghentikan seketika fungsi ini sehingga callback pelayan memulangkan nilai.
	-- pcall menghalang LocalScript daripada berhenti jika panggilan gagal.
	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 mempunyai tepat satu callback pelayan. Jika dua skrip menetapkan OnServerInvoke pada RemoteFunction yang sama, hanya yang terakhir berfungsi.

Bahaya InvokeClient

RemoteFunction juga berfungsi ke arah sebaliknya, dengan InvokeClient pada pelayan dan OnClientInvoke pada client. Dokumentasi Roblox menyenaraikan tiga risiko serius:

  • Jika callback client mengalami ralat, pelayan juga mengalami ralat.
  • Jika pemain keluar semasa panggilan, InvokeClient mengalami ralat.
  • Jika client tidak pernah memulangkan nilai, skrip pelayan akan menunggu selama-lamanya.

Client yang diubah suai mengawal callbacknya sendiri, jadi penipu boleh sengaja mencetuskan kes ketiga dan menahan thread pelayan itu selama yang dia mahu. Untuk mengemas kini skrin pemain, gunakan FireClient. Jika pelayan benar-benar memerlukan maklumat daripada client, hantar RemoteEvent, biar client menjawab melalui RemoteEvent lain, dan anggap ketiadaan jawapan sebagai keadaan biasa pada pelayan.

Semak setiap argumen pada pelayan

Exploiter boleh memanggil mana-mana RemoteEvent atau RemoteFunction berapa kali pun dengan apa-apa argumen. Satu-satunya perkara yang dia tidak boleh palsukan ialah parameter pertama: Roblox sendiri yang mengisi Player yang menghantar mesej. Semua yang datang selepasnya perlu disemak sebelum pelayan bertindak. Menyembunyikan remote atau menyemak dalam LocalScript tidak berguna, kerana penipu mengawal clientnya sendiri.

Senarai semakan untuk pelayan
SemakanSoalan yang ditanya oleh pelayanContoh
JenisAdakah ini jenis yang saya jangka? Instance, bukan table yang dibina supaya kelihatan seperti Instance?typeof(part) == "Instance" and part:IsA("BasePart")
JulatAdakah nombor itu terhingga dan dalam had yang dibenarkan? Adakah panjang teks munasabah?math.isfinite(n), n >= 1 and n <= 4, #text <= 20
PemilikanAdakah pemain ini memiliki item itu, adakah dia cukup wang, adakah dia berhak bertindak ke atas objek ini?Item ada dalam inventorinya; part berada di dalam Paintable
JarakAdakah watak pemain cukup dekat dalam salinan dunia pada pelayan? Beri sedikit ruang untuk lag.Tidak lebih daripada 30 stud dari part
KekerapanAdakah pemain ini menghantar terlalu kerap?Cooldown bagi setiap pemain atau had dengan panggilan yang terkumpul

NaN layak diberi amaran khas. Ia ialah nombor, jadi type(x) == "number" lulus, tetapi setiap perbandingan dengannya memberi false, dan semakan seperti x < 0 or x > 100 membiarkannya lalu. math.isfinite(x) menolak NaN dan kedua-dua infiniti.

Ingat had semakan jarak. Setiap client mengawal fizik wataknya sendiri, jadi exploiter boleh menggerakkan wataknya ke sasaran sebelum membuat panggilan. Semakan itu tetap menghentikan penyalahgunaan paling mudah, iaitu bertindak ke atas seluruh peta dari satu tempat. Pastikan part sasaran di-anchor: dokumentasi keselamatan Roblox menyatakan bahawa exploiter boleh mendapat pemilikan rangkaian ke atas part yang tidak di-anchor berdekatan dengannya dan menariknya lebih dekat, dan ini memintas semakan jarak.

Berikut ialah semakan yang sama dalam bentuk ModuleScript yang boleh digunakan dalam setiap pengendali remote.

ModuleScript dalam ServerScriptService bernama RemoteGuard
local Players = game:GetService("Players")

local RemoteGuard = {}

-- Nombor sebenar antara min dan max. Menolak NaN dan infiniti, yang lulus
-- semakan biasa 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

-- Integer antara min dan max, untuk kuantiti, indeks dan pembilang
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

-- Teks dengan had panjang. utf8.len memulangkan nil untuk UTF-8 yang tidak sah, yang
-- ditolak oleh stor data.
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 daripada kelas yang dijangka di dalam bekas yang anda benarkan.
-- Table yang dibina supaya kelihatan seperti Instance tidak lulus semakan 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 apabila watak pemain berada tidak lebih daripada maxDistance stud dari 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

-- Had kekerapan bagi setiap pemain. Setiap pemain boleh membuat `burst` panggilan sekali gus dan
-- mendapat semula `perSecond` panggilan setiap saat. Memulangkan fungsi yang dipanggil
-- sebelum kerja: ia menjawab true (dibenarkan) atau false (terlalu kerap).
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

Simpan ia dalam ServerScriptService. Kod dari situ tidak pernah sampai ke client, jadi tiada siapa boleh membaca semakan anda.

Dan inilah pengendali daripada corak 1, ditulis semula menggunakannya. Gantikan kandungan PaintServer:

Script dalam ServerScriptService bernama PaintServer
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerScriptService = game:GetService("ServerScriptService")

-- ":: any" hanya penting untuk semakan jenis ketat Luau; semasa berjalan ia tidak mengubah apa-apa
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) -- serentak 4, kemudian 4 sesaat

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 memadam rekod pemain apabila dia keluar, jadi tablenya tidak terus membesar sepanjang hayat pelayan.

Dalam senjata, semakan ini paling penting: jangan sekali-kali biarkan client melaporkan siapa yang terkena. Remote daripada panduan pedang langsung tidak membawa argumen, dan pelayan mencari sasaran sendiri. Panduan senapang hanya menghantar titik bidikan, yang disemak oleh pelayan dari segi jenis, NaN dan jarak sebelum ia melepaskan sinarnya sendiri.

Menu mengikut peraturan yang sama: hantar pilihan, bukan hasil. Dalam panduan dialog NPC, client hanya menghantar nombor butang yang ditekan, dan pelayan sendiri yang melihat apa yang diberikan oleh jawapan itu. Menu daripada panduan teleport menghantar nama titik, bukan kedudukan, dan pelayan mencari titik itu dalam foldernya dan menyemak berapa banyak Wins yang diperlukan untuknya.

Apa yang boleh dan tidak boleh dihantar

Anda boleh menghantar nombor, string, nilai boolean, jenis Roblox seperti Vector3, CFrame, Color3 dan item Enum, Instance yang dapat dilihat oleh kedua-dua pihak, dan table yang terdiri daripada semua ini. Sesetengah nilai berubah atau hilang dalam perjalanan:

Argumen yang tiba tidak sama seperti semasa dihantar
Anda menghantarApa yang berlaku
FungsiPihak sebelah lagi menerima nil
Table dengan metatableMetatable hilang bersama semua yang dimiliki table itu melalui metatable sahaja
Table yang mencampurkan kunci nombor dan kunci stringRoblox menasihatkan supaya tidak berbuat begini: hantar array tulen atau dictionary tulen
Table dengan nilai nil di dalamnyaElakkan: Roblox tidak mengesyorkan nil pada mana-mana indeks
Table dengan kunci jenis Instance, userdata atau functionKunci sebegini bertukar menjadi string
Instance yang tidak dapat dilihat oleh penerima, contohnya dari ServerStorage atau yang dicipta dalam LocalScriptPihak sebelah lagi menerima nil
Apa-apa tablePenerima mendapat salinan, bukan table yang sama

Tabiat yang baik: hantar pengenal, bukan objek atau nilai. Nama item, nombor pilihan, part yang boleh dicari dan disemak oleh pelayan. Selepas itu pelayan bekerja dengan datanya sendiri.

Kenapa RemoteFunction memulangkan nil

Jika InvokeServer memberi anda nil, semak perkara ini mengikut susunan:

  1. Laluan tanpa nilai pulangan. Setiap jalan keluar dari OnServerInvoke mesti memulangkan sesuatu. return kosong dalam semakan awal menghantar nil kembali.
  2. return di dalam fungsi bersarang. return di dalam pcall(function() ... end), pengendali :Connect atau task.spawn hanya keluar dari fungsi dalaman itu. Simpan hasilnya, contohnya local ok, data = pcall(...), kemudian pulangkan data dari callback itu sendiri.
  3. Nilai yang tidak boleh merentasi sempadan. Fungsi atau Instance yang tidak dapat dilihat oleh client (contohnya apa sahaja dalam ServerStorage) tiba sebagai nil. Apabila instance streaming dihidupkan, part yang baru dicipta oleh pelayan mungkin belum sampai ke client semasa fungsi memulangkan nilai.
  4. Callback ditetapkan oleh skrip lain. Hanya umpukan OnServerInvoke yang terakhir berfungsi. Cari nama remote itu dalam skrip-skrip anda.

Jika panggilan langsung tidak kembali, ini bermakna belum ada skrip yang menetapkan OnServerInvoke (Roblox menahan panggilan dalam baris gilir sehingga ia ditetapkan) atau callback tergantung, contohnya pada WaitForChild untuk sesuatu yang tidak akan muncul.

UnreliableRemoteEvent: untuk kemas kini berterusan yang sekali guna

UnreliableRemoteEvent mempunyai kaedah dan event yang sama seperti RemoteEvent: FireServer, FireClient, FireAllClients, OnServerEvent dan OnClientEvent. Bezanya, Roblox tidak menjamin penghantaran mahupun susunan. Mesej boleh dibuang tanpa dihantar semula apabila:

  • ia hilang dalam perjalanan atau menunggu terlalu lama dalam rangkaian yang sesak
  • datanya melebihi 1000 bait
  • client menghantar lebih kerap daripada had (lebihannya dibuang, bukan ditangguhkan)
  • tiada pengendali yang bersambung semasa ia tiba (ia dibuang, bukan diletakkan dalam baris gilir)

Mesej juga boleh tiba tidak mengikut susunan, dan susunannya langsung tiada kaitan dengan RemoteEvent atau RemoteFunction anda. Gunakannya apabila hanya nilai terkini yang penting dan kemas kini seterusnya akan tiba dalam sebahagian kecil saat: ke mana pemain membidik, kedudukan kesan kosmetik, nilai yang berubah setiap bingkai. Jika susunan penting, letakkan nombor turutan atau cap masa dalam setiap mesej dan abaikan semua yang lebih lama daripada yang terakhir diproses.

Jangan sekali-kali gunakannya untuk sesuatu yang mesti berlaku tepat sekali, contohnya pembelian, damage, ganjaran atau permulaan pusingan. Dan semak argumennya pada pelayan sama seperti RemoteEvent.

Susunan penghantaran dan had kekerapan

Jaminan penghantaran Roblox merujuk kepada satu sambungan dalam satu arah: dari pelayan ke satu client atau dari satu client ke pelayan.

  • RemoteEvent boleh dipercayai dan tersusun. Mesej yang hilang dihantar semula selagi penerima masih bersambung, dan mesej tiba mengikut susunan anda menghantarnya, malah merentasi RemoteEvent yang berbeza. Jika pelayan menghantar kepada pemain A, kemudian B, kemudian A, pemain itu menerima A, B, A.
  • Susunan merujuk kepada saat pengendali bermula. Jika pengendali menyerahkan kawalan, contohnya melalui task.wait atau WaitForChild, mesej seterusnya boleh mula diproses sebelum yang pertama selesai.
  • RemoteFunction dan RemoteEvent tidak tersusun antara satu sama lain. Jika kod anda bergantung pada susunan yang ketat, hantar mesej yang berkaitan melalui satu jenis remote atau tambah nombor turutan anda sendiri.
  • Perubahan sifat dan atribut tidak tersusun berbanding remote. Jika pelayan menukar sifat kemudian memanggil remote, client mungkin melihat mana-mana satu dahulu. Dengar perubahan itu sendiri, contohnya melalui GetPropertyChangedSignal, dan jangan anggap ia sudah tiba.
  • Pengendali belum wujud. Mesej RemoteEvent menunggu dalam baris gilir sehingga pengendali bersambung. Baris gilir itu ada hadnya: apabila penuh, mesej seterusnya dibuang, dan ralat Remote event invocation discarded muncul dalam Output.
  • Pemain yang keluar kehilangan semua mesej yang belum sempat sampai kepadanya.

Had kekerapan. Mesej RemoteEvent dan UnreliableRemoteEvent dari client ke pelayan dihadkan kepada kira-kira 500 permintaan sesaat bagi setiap client, menurut dokumentasi pada 30 September 2026. Had ini dikongsi oleh semua remote daripada jenis yang sama, jadi memecahkan satu remote yang sibuk kepada sepuluh tidak menaikkannya. Melebihi had, mesej RemoteEvent diproses kemudian dan mengekalkan susunan, manakala mesej UnreliableRemoteEvent dibuang. Had enjin langsung tidak menghalang seorang pemain daripada memanggil remote anda 50 kali sesaat, jadi setiap pengendali yang mengubah sesuatu tetap memerlukan had sendiri bagi setiap pemain.

RemoteEvent, RemoteFunction, UnreliableRemoteEvent atau atribut?

Cara memilih kaedah komunikasi antara client dan pelayan
GunakanUntuk apaContohPerkara yang perlu diberi perhatian
RemoteEventMesej sehala yang mesti sampai, dan mengikut susunanClient: "warnakan part ini". Pelayan: "paparkan notifikasi ini"Semak setiap argumen pada pelayan
RemoteFunction dengan InvokeServerClient memerlukan jawapan sebelum boleh meneruskanMasukkan kod promo, sahkan pembelianPemanggil menunggu; setiap laluan mesti memulangkan nilai
RemoteFunction dengan InvokeClientHampir tidak pernahGunakan FireClient sebagai gantiClient yang mengalami ralat, keluar atau tidak menjawab merosakkan atau menggantung panggilan pada pelayan
UnreliableRemoteEventKemas kini kerap di mana hanya yang terakhir pentingArah bidikan, kesan kosmetikMesej hilang atau bertukar susunan; had data 1000 bait
Atribut atau objek value yang ditetapkan oleh pelayanKeadaan bersama yang mesti sentiasa kelihatan, termasuk kepada pemain yang masuk kemudianPemasa pusingan, fasa permainan, sama ada pintu terbukaHanya perubahan pelayan sampai kepada semua; client mendengar melalui GetAttributeChangedSignal atau Changed
BindableEventKomunikasi antara skrip pada pihak yang samaSatu skrip pelayan memberitahu skrip lain bahawa pusingan telah tamatTidak merentasi antara pelayan dan client

Untuk contoh lengkap bagaimana RemoteFunction dan semakan bekerja bersama di tempat pemain membayar, lihat panduan cara buat GUI kedai. Bagi baris tentang atribut, skrip pelayan daripada panduan pintu menetapkan atribut Open pada setiap pintu setiap kali ia bergerak, jadi mana-mana LocalScript boleh bertindak balas kepadanya.

Ralat biasa dan cara membaikinya

Kebanyakan masalah remote kelihatan dalam tetingkap Output (buka dari menu Window atau dari tab Script). Lihat di situ dahulu, kemudian cari simptom anda di bawah. Panduan ralat skrip menghuraikan mesej ralat umum dengan lebih terperinci.

Infinite yield possible pada WaitForChild untuk remote

Skrip menunggu remote yang tidak akan muncul. Pastikan nama dan huruf besar kecil sepadan dengan tepat dan remote itu berada dalam ReplicatedStorage, bukan dalam ServerStorage atau ServerScriptService yang tidak dapat dilihat oleh client.

Pelayan menerima nilai yang salah, teranjak satu kedudukan

LocalScript menghantar pemain itu sendiri, seperti dalam remote:FireServer(player, 5). Roblox sudah menambah penghantar sebagai parameter pertama, jadi pelayan melihat (player, player, 5). Panggil remote:FireServer(5).

Tiada apa berlaku apabila saya memanggil remote

Pastikan setiap panggilan datang dari pihak yang betul: FireServer dan InvokeServer hanya berfungsi dari kod client, dan FireClient, FireAllClients dan InvokeClient hanya dari Script pelayan. LocalScript tidak pernah berjalan dalam ServerScriptService, ServerStorage atau terus dalam Workspace; letakkannya dalam StarterPlayerScripts, StarterGui, StarterCharacterScripts atau StarterPack. Kemudian cari ralat di dalam pengendali dalam Output.

Remote event invocation discarded

Mesej tiba untuk RemoteEvent yang tiada pengendali bersambung, dan baris gilir menjadi penuh. Biasanya skrip yang mengandungi pengendali gagal dengan ralat sebelum baris :Connect, dimatikan atau tergantung menunggu sesuatu yang tidak akan dimuatkan. Sambungkan pengendali lebih awal dalam skrip.

Ia berfungsi untuk saya, tetapi pemain lain tidak nampak perubahan itu

Perubahan itu dibuat pada client, dalam LocalScript atau dalam pengendali OnClientEvent. Buatnya dalam pengendali pelayan OnServerEvent.

InvokeServer tidak pernah kembali

Sama ada belum ada skrip yang menetapkan OnServerInvoke (Roblox menahan panggilan dalam baris gilir sehingga ia ditetapkan), atau callback tergantung pada sesuatu yang menyerahkan kawalan, contohnya WaitForChild atau permintaan ke stor data. Tambah print di awal dan di akhir callback untuk melihat di mana ia berhenti.

Buat dengan RoCode

RoCode juga boleh menyediakan ini, terus dalam place yang anda buka. RoCode ialah ejen AI yang bekerja melalui plugin untuk Roblox Studio, jadi ia mencipta remote dan skrip dalam Explorer anda, bukan memberikan kod yang perlu ditampal.

Anda tulis

Biar pemain mewarnakan part dalam folder Paintable dengan klik. Gunakan RemoteEvent dan kekalkan semakan pada pelayan: hanya part dari folder ini, tidak lebih daripada 30 stud dan tidak lebih daripada beberapa kali mewarna sesaat.

RoCode buat
  • Biasanya meninjau place dahulu melalui Search Game dan Search Scripts untuk mencari folder Remotes atau pengendali yang sudah ada, dan menggunakan folder anda jika ada
  • Mencipta RemoteEvent dalam ReplicatedStorage melalui Create Instance dan menulis Script pelayan dan LocalScript melalui Create Script
  • Sebelum selesai, menyemak kompilasi setiap skrip melalui Check Script di dalam Studio. Ini menangkap ralat kompilasi, bukan ralat logik: ia tidak menyemak jenis, tidak menjalankan linter dan tidak melaksanakan kod anda
  • Menghantar perubahan secara berkumpulan, dan setiap kumpulan ialah titik undo dalam sejarah Studio

Dengan plugin 3.9 atau lebih baharu, RoCode boleh menjalankan playtest pendek dan membaca ralat, dan dengan plugin 3.9.11 atau lebih baharu ia boleh mengawal watak ujian, tetapi ia tidak mengklik part dalam tetingkap 3D. Tekan Play sendiri dan cuba patahkan semakan itu, contohnya dengan mewarnakan part dari hujung peta yang lain. Jika ada ralat, Check Output boleh membaca baris Server dan Client daripada playtest terakhir anda. Kebanyakan sistem game berkomunikasi melalui remote seperti ini, jadi anda akan bertemu dengannya lagi apabila anda membina game sistem demi sistem dengan RoCode. Cara RoCode bersambung ke Studio.

Soalan lazim

Apa maksud securing the client-server boundary dalam Roblox?

Itulah nama halaman dokumentasi Roblox tentang keselamatan remote, dan ideanya mudah: semua yang dihantar oleh client melalui RemoteEvent atau RemoteFunction mungkin datang daripada exploiter, jadi pelayan menyemaknya sebelum bertindak. Semak jenis setiap argumen, kekalkan nombor dalam had yang munasabah, semak bahawa pemain dibenarkan melakukannya sekarang, dan hadkan berapa kerap setiap pemain boleh memanggil remote. Senarai semakan di atas menunjukkan setiap satu dalam kod.

Adakah RemoteFunction selamat digunakan?

InvokeServer selamat setakat mana callback pelayan anda selamat: semak argumennya dan hadkan kekerapannya, seperti mana-mana RemoteEvent. Arah yang berisiko ialah InvokeClient, kerana client yang mengalami ralat, keluar atau tidak pernah memulangkan nilai akan merosakkan atau menggantung panggilan pada pelayan.

Bolehkah exploiter melihat dan memanggil remote saya?

Ya. Semua yang berada dalam ReplicatedStorage sampai kepada setiap client, dan client yang diubah suai boleh memanggil mana-mana remote dengan apa-apa argumen. Menamakan semula atau menyembunyikan remote tidak menjadikannya selamat; yang menjadikannya selamat ialah semakan setiap argumen pada pelayan.

Bolehkah satu client menghantar RemoteEvent kepada client lain?

Tidak secara terus. Hantar ke pelayan, semak di sana, kemudian gunakan FireClient atau FireAllClients.

Berapa kerap RemoteEvent boleh dipanggil?

Dokumentasi Roblox menyatakan had kira-kira 500 permintaan sesaat bagi setiap client untuk mesej RemoteEvent dan UnreliableRemoteEvent yang dihantar ke pelayan, dikongsi oleh semua remote daripada jenis yang sama. Kekal jauh di bawahnya dan beri setiap pengendali had sendiri bagi setiap pemain.

Adakah FireAllClients sampai kepada pemain yang masuk kemudian?

Tidak. Ia sampai kepada pemain yang bersambung pada saat itu. Untuk keadaan yang diperlukan oleh pemain yang lewat, tetapkan atribut atau objek value pada pelayan.

Apakah beza antara RemoteEvent dan BindableEvent?

RemoteEvent merentasi antara pelayan dan client. BindableEvent menghubungkan skrip pada pihak yang sama, contohnya dua skrip pelayan.

Sumber dan bacaan lanjut

Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.