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 (
InvokeServerdanOnServerInvoke) hanya apabila client memerlukan jawapan. ElakkanInvokeClient: 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
Kenapa RemoteEvent diperlukan
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.
| Arah | Penghantar memanggil | Penerima bersambung kepada | Penerima mendapat |
|---|---|---|---|
| Dari client ke pelayan | remote:FireServer(...) dalam LocalScript | remote.OnServerEvent dalam Script | Player yang menghantar mesej, kemudian argumen anda |
| Dari pelayan ke satu client | remote:FireClient(player, ...) dalam Script | remote.OnClientEvent dalam LocalScript | Hanya argumen anda |
| Dari pelayan ke semua client | remote:FireAllClients(...) dalam Script | remote.OnClientEvent dalam LocalScript | Hanya argumen anda |
| Client bertanya, pelayan menjawab | remoteFunction: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.
- Dalam Explorer, halakan kursor pada ReplicatedStorage, klik butang + dan masukkan Folder. Namakan folder itu
Remotes. - Halakan kursor pada
Remotes, klik + dan masukkan RemoteEvent. Namakan semula supaya nama itu menerangkan tujuannya, contohnyaPaintRequest. - Ulang untuk setiap remote. Panduan ini menggunakan dua RemoteEvent (
PaintRequestdanNotify) dan satu 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
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.
- Dalam Workspace, masukkan Folder bernama
Paintabledan letakkan beberapa Part yang di-anchor di dalamnya. - Pastikan
ReplicatedStorage.Remotesmengandungi RemoteEvent bernamaPaintRequest. - Masukkan Script bernama
PaintServerke dalam ServerScriptService dan LocalScript bernamaPaintClientke dalam StarterPlayer, StarterPlayerScripts, dengan kod di bawah.
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.
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.
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
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.
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.
- Dalam
ReplicatedStorage.Remotes, masukkan RemoteFunction bernamaRedeemCode. - Dalam StarterGui, masukkan ScreenGui bernama
CodeGui, dan di dalamnya TextBox bernamaCodeBox. Pilih saiz dan kedudukan mengikut citarasa anda. - Tambah Script di bawah dalam ServerScriptService, dan LocalScript di dalam
CodeBox.
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.
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,
InvokeClientmengalami 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.
| Semakan | Soalan yang ditanya oleh pelayan | Contoh |
|---|---|---|
| Jenis | Adakah ini jenis yang saya jangka? Instance, bukan table yang dibina supaya kelihatan seperti Instance? | typeof(part) == "Instance" and part:IsA("BasePart") |
| Julat | Adakah nombor itu terhingga dan dalam had yang dibenarkan? Adakah panjang teks munasabah? | math.isfinite(n), n >= 1 and n <= 4, #text <= 20 |
| Pemilikan | Adakah 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 |
| Jarak | Adakah watak pemain cukup dekat dalam salinan dunia pada pelayan? Beri sedikit ruang untuk lag. | Tidak lebih daripada 30 stud dari part |
| Kekerapan | Adakah 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.
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:
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:
| Anda menghantar | Apa yang berlaku |
|---|---|
| Fungsi | Pihak sebelah lagi menerima nil |
| Table dengan metatable | Metatable hilang bersama semua yang dimiliki table itu melalui metatable sahaja |
| Table yang mencampurkan kunci nombor dan kunci string | Roblox menasihatkan supaya tidak berbuat begini: hantar array tulen atau dictionary tulen |
Table dengan nilai nil di dalamnya | Elakkan: Roblox tidak mengesyorkan nil pada mana-mana indeks |
| Table dengan kunci jenis Instance, userdata atau function | Kunci sebegini bertukar menjadi string |
| Instance yang tidak dapat dilihat oleh penerima, contohnya dari ServerStorage atau yang dicipta dalam LocalScript | Pihak sebelah lagi menerima nil |
| Apa-apa table | Penerima 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:
- Laluan tanpa nilai pulangan. Setiap jalan keluar dari
OnServerInvokemesti memulangkan sesuatu.returnkosong dalam semakan awal menghantarnilkembali. - return di dalam fungsi bersarang.
returndi dalampcall(function() ... end), pengendali:Connectatautask.spawnhanya keluar dari fungsi dalaman itu. Simpan hasilnya, contohnyalocal ok, data = pcall(...), kemudian pulangkandatadari callback itu sendiri. - 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. - Callback ditetapkan oleh skrip lain. Hanya umpukan
OnServerInvokeyang 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.waitatauWaitForChild, 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 discardedmuncul 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?
| Gunakan | Untuk apa | Contoh | Perkara yang perlu diberi perhatian |
|---|---|---|---|
| RemoteEvent | Mesej sehala yang mesti sampai, dan mengikut susunan | Client: "warnakan part ini". Pelayan: "paparkan notifikasi ini" | Semak setiap argumen pada pelayan |
RemoteFunction dengan InvokeServer | Client memerlukan jawapan sebelum boleh meneruskan | Masukkan kod promo, sahkan pembelian | Pemanggil menunggu; setiap laluan mesti memulangkan nilai |
RemoteFunction dengan InvokeClient | Hampir tidak pernah | Gunakan FireClient sebagai ganti | Client yang mengalami ralat, keluar atau tidak menjawab merosakkan atau menggantung panggilan pada pelayan |
| UnreliableRemoteEvent | Kemas kini kerap di mana hanya yang terakhir penting | Arah bidikan, kesan kosmetik | Mesej hilang atau bertukar susunan; had data 1000 bait |
| Atribut atau objek value yang ditetapkan oleh pelayan | Keadaan bersama yang mesti sentiasa kelihatan, termasuk kepada pemain yang masuk kemudian | Pemasa pusingan, fasa permainan, sama ada pintu terbuka | Hanya perubahan pelayan sampai kepada semua; client mendengar melalui GetAttributeChangedSignal atau Changed |
| BindableEvent | Komunikasi antara skrip pada pihak yang sama | Satu skrip pelayan memberitahu skrip lain bahawa pusingan telah tamat | Tidak 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.
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.
- 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
- Roblox Creator Docs: Remote events and callbacks (dalam bahasa Inggeris). FireServer, FireClient, InvokeServer, risiko InvokeClient, had argumen dan jaminan penghantaran
- Roblox Creator Docs: Securing the client-server boundary (dalam bahasa Inggeris). Lapisan semakan, NaN, had kekerapan, penghantaran dari client ke client
- Roblox Creator Docs: Security and cheat mitigation tactics (dalam bahasa Inggeris). Apa yang boleh dilakukan oleh client yang diubah suai dan kuasa pelayan
- Roblox Creator Docs: Network ownership, movement validation, and physics (dalam bahasa Inggeris). Kenapa client mengawal wataknya sendiri dan had semakan jarak
- Roblox Engine API: RemoteEvent (dalam bahasa Inggeris). Had kekerapan dan ralat invocation discarded
- Roblox Engine API: RemoteFunction (dalam bahasa Inggeris). OnServerInvoke, amaran tentang InvokeClient dan langkah berjaga-jaga dengan streaming
- Roblox Engine API: UnreliableRemoteEvent (dalam bahasa Inggeris). Had data 1000 bait
- Roblox Creator Docs: Properties and attributes (dalam bahasa Inggeris). Susunan replikasi antara perubahan sifat dan remote event
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.