Singkatnya
RemoteEvent adalah objek, biasanya disimpan di ReplicatedStorage, yang mengirim pesan melewati batas client dan server. LocalScript memanggil FireServer dan server mendengarnya di OnServerEvent, dengan Player pengirim ditambahkan sebagai argumen pertama. Server memanggil FireClient(player, ...) atau FireAllClients(...), dan LocalScript mendengarnya di OnClientEvent.
- Pakai RemoteFunction (
InvokeServerdanOnServerInvoke) hanya kalau client butuh jawaban balik. HindariInvokeClient: client yang error, keluar atau tidak pernah mengembalikan nilai merusak panggilan server. - Jangan pernah percaya pada apa yang dikirim client. Di server, cek tipe, rentang dan kepemilikan setiap argumen, jarak pemain, dan seberapa sering mereka mengirim.
- Function, metatable dan objek yang tidak bisa dilihat sisi lain tidak selamat di perjalanan. UnreliableRemoteEvent bisa menjatuhkan atau mengacak urutan pesan, dan menjatuhkan payload apa pun di atas 1.000 byte.
Di halaman ini
Kenapa RemoteEvent ada
Setiap game Roblox berjalan sebagai satu server ditambah satu client per pemain. Server adalah pemegang otoritas: objek baru atau perubahan properti hanya sampai ke setiap pemain kalau server yang membuatnya. Perubahan yang dibuat di LocalScript tetap di satu perangkat itu, dengan beberapa pengecualian seperti karakter pemain sendiri, yang gerakannya dikendalikan client mereka. Jadi saat sebuah klik atau penekanan tombol harus mengubah dunia bersama, client harus meminta ke server, dan saat server ingin layar satu pemain bereaksi, server harus memberi tahu client itu. Kalau pembagian antara Script dan LocalScript masih baru bagimu, baca dulu Script vs LocalScript vs ModuleScript (dalam bahasa Inggris). Kalau scripting sendiri masih baru, mulai dari cara scripting di Roblox Studio.
Roblox memberimu tiga objek untuk melewati batas itu:
- RemoteEvent: pesan satu arah. Pengirim langsung melanjutkan.
- RemoteFunction: permintaan yang menunggu balasan. Pemanggil berhenti sampai sisi lain mengembalikan nilai.
- UnreliableRemoteEvent: pesan satu arah yang bisa dijatuhkan atau tiba tidak berurutan, dengan imbalan beban jaringan yang lebih kecil. Cocok untuk data yang berubah terus-menerus.
| Arah | Pengirim memanggil | Penerima tersambung ke | Penerima mendapat |
|---|---|---|---|
| Client ke server | remote:FireServer(...) di LocalScript | remote.OnServerEvent di Script | Player yang mengirim, lalu argumenmu |
| Server ke satu client | remote:FireClient(player, ...) di Script | remote.OnClientEvent di LocalScript | Hanya argumenmu |
| Server ke semua client | remote:FireAllClients(...) di Script | remote.OnClientEvent di LocalScript | Hanya argumenmu |
| Client bertanya, server menjawab | remoteFunction:InvokeServer(...) | remoteFunction.OnServerInvoke = function(player, ...) | Player, lalu argumenmu. Pemanggil menerima apa pun yang dikembalikan function itu |
Client tidak bisa saling mengirim pesan secara langsung. Untuk meneruskan sesuatu dari satu pemain ke pemain lain, kirim ke server, cek di sana, dan biarkan server meneruskannya dengan FireClient atau FireAllClients. Panduan keamanan Roblox menyebut server di sini berperan sebagai penjaga gerbang, bukan sekadar perantara.
Di mana menaruh remote
Remote harus berada di tempat yang bisa dilihat server dan client. Tempat yang biasa adalah ReplicatedStorage; dokumentasi Roblox mencatat bahwa Workspace atau sebuah Tool juga bisa tepat dalam beberapa kasus. ServerStorage dan ServerScriptService hanya untuk server, jadi LocalScript yang menunggu remote di sana menunggu selamanya.
- Di Explorer, arahkan kursor ke ReplicatedStorage, klik tombol + dan sisipkan Folder. Beri nama
Remotes. - Arahkan kursor ke
Remotes, klik + dan sisipkan RemoteEvent. Ganti namanya supaya menjelaskan tujuannya, misalnyaPaintRequest. - Ulangi untuk setiap remote. Panduan ini memakai 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
Script di panduan ini mencari remote dengan WaitForChild. Function itu langsung kembali kalau remote sudah ada dan menunggu kalau belum, misalnya saat script server membuat remote selagi game berjalan. Pakai satu remote untuk satu jenis permintaan: setiap handler server lalu mengecek satu bentuk argumen, yang jauh lebih mudah dibuat benar daripada satu remote yang mengerjakan segalanya.
Pola 1: client ke server, dicek oleh server
Pekerjaan paling umum: pemain melakukan sesuatu di layarnya, dan server memutuskan apa yang terjadi. Di sini pemain menekan Q untuk memilih satu dari empat warna dan mengklik atau mengetuk sebuah part untuk mengecatnya. Semua orang melihat warna barunya, karena server yang mengecat.
Client mengirim dua hal: part yang mana, dan nomor warna. Client tidak pernah mengirim warnanya sendiri, dan di game lain client tidak boleh mengirim harga, hadiah atau jumlah damage. Client yang dimodifikasi bisa mengirim apa saja, jadi server menyimpan data aslinya (di sini, palet warna) dan memperlakukan argumen sebagai permintaan yang harus dicek.
- Di Workspace, sisipkan Folder bernama
Paintabledan taruh beberapa Part yang di-anchor di dalamnya. - Cek bahwa
ReplicatedStorage.Remotespunya RemoteEvent bernamaPaintRequest. - Sisipkan Script di ServerScriptService bernama
PaintServer, dan LocalScript di StarterPlayer, StarterPlayerScripts bernamaPaintClient, dengan kode 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")
-- Server yang memiliki warnanya. Client hanya mengirim angka yang memilih salah satunya.
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 karakter dan part
local COOLDOWN_SECONDS = 0.25
local lastPaint: { [Player]: number } = {}
-- Parameter pertama selalu pemain yang mengirim. Roblox yang mengisinya,
-- jadi bisa dipercaya. Semua setelahnya datang dari client dan tidak bisa dipercaya.
paintRequest.OnServerEvent:Connect(function(player: Player, part: unknown, colourIndex: unknown)
-- 1. Tipe: part sungguhan, bukan table yang berpura-pura jadi part
if typeof(part) ~= "Instance" or not part:IsA("BasePart") then
return
end
-- 2. Rentang: bilangan bulat dari 1 sampai 4. NaN dan tak hingga juga gagal 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. Target yang diizinkan: hanya part di folder Paintable, tidak ada yang lain di game
if not part:IsDescendantOf(paintable) then
return
end
-- 4. Jarak: karakter pemain harus dekat 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. Rate limit: satu kali cat per pemain setiap seperempat detik
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 pengecekan yang gagal cukup return. Tidak perlu memberi tahu client yang curang kenapa 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 -- server yang menyimpan warna aslinya
local selectedColour = 1
-- Biarkan ray hanya 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 -- tombol atau kliknya masuk ke chat atau sebuah button
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
-- Minta, jangan perintah: server yang memutuskan apakah pengecatan terjadi
paintRequest:FireServer(result.Instance, selectedColour)
end
end
end)
gameProcessed bernilai true kalau engine sudah menindaklanjuti input itu, biasanya di UI: klik pada button, atau tombol yang diketik ke text box seperti kolom chat. Mengeceknya berarti mengetik Q di sebuah pesan tidak mengganti warna.
Pola 2: server ke satu client
Server mengirim pesan ke satu pemain dengan FireClient. Argumen pertama adalah Player tujuan, dan handler di client hanya menerima argumen setelahnya. Pakai ini untuk apa pun yang bersifat pribadi: notifikasi, popup hadiah, suara yang hanya boleh didengar pemain itu. Panduan cutscene adalah contoh yang lebih besar: server memutuskan kapan pemain melihat cutscene dan mengirim shot-nya ke satu pemain itu dengan FireClient, dan perangkat mereka yang menggerakkan kamera.
Pasangan script ini menampilkan pesan selamat datang saat pemain bergabung. LocalScript membuat banner kecilnya sendiri, jadi tidak ada GUI yang perlu disiapkan.
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 menerimanya. Tidak ada orang lain yang melihat ini.
notify:FireClient(player, `Welcome, {player.DisplayName}! Press Q to change colour.`)
end
Players.PlayerAdded:Connect(welcome)
-- Di Studio kamu bisa bergabung sebelum script ini tersambung, jadi sapa siapa pun yang sudah ada
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
-- Banner kecil di bagian atas layar, dibuat dengan kode
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
-- Tidak ada parameter player di sini: server sudah memilih siapa yang menerimanya
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 kecuali pesan yang lebih baru sudah menggantikannya
label.Visible = false
end
end)
end)
Server mengirim saat PlayerAdded, yang bisa terjadi sebelum LocalScript ini menyambungkan handler-nya. Itu tidak masalah: Roblox mengantrekan pesan RemoteEvent yang tiba sebelum ada handler dan mengantarkannya, secara berurutan, begitu ada yang tersambung.
Client tidak perlu berjaga-jaga terhadap server: hanya kode server yang bisa memicu OnClientEvent. Anotasi message: string ditujukan untuk type checker; itu bukan pengecekan saat runtime.
Pola 3: server ke semua client
FireAllClients mengirim pesan yang sama ke setiap pemain yang tersambung. Function ini tidak menerima argumen Player, dan setiap client menerimanya di OnClientEvent yang sama seperti sebelumnya, jadi script NotifyClient dari Pola 2 sudah menampilkannya.
Script ini mengumumkan ke semua orang saat seorang pemain pertama kali menyentuh garis finis. Tambahkan Part yang di-anchor bernama FinishLine ke Workspace, lalu tambahkan Script-nya ke 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 tersambung menjalankan handler OnClientEvent-nya dengan teks ini
notify:FireAllClients(`{player.DisplayName} reached the finish!`)
end)
Players.PlayerRemoving:Connect(function(player: Player)
finished[player] = nil
end)
Exploiter bisa memicu Touched untuk karakternya sendiri dari jarak berapa pun, yang tidak berbahaya untuk pengumuman yang ditampilkan sekali per pemain. Kalau nanti kamu memberi hadiah untuk mencapai finis, tambahkan pengecekan server sebelum membayar, misalnya waktu minimum sejak ronde dimulai.
FireAllClients hanya sampai ke pemain yang tersambung pada saat itu. Orang yang bergabung sedetik kemudian tidak pernah melihat pesannya. Itu tepat untuk momen sekali saja, seperti pengumuman, efek ledakan atau suara, tapi salah untuk state seperti timer ronde atau fase game saat ini. Untuk state, atur atribut di server, misalnya ReplicatedStorage:SetAttribute("TimeLeft", 30), dan baca di client dengan GetAttribute dan GetAttributeChangedSignal("TimeLeft"). Atribut direplikasi ke setiap client, termasuk pemain yang bergabung belakangan.
RemoteFunction: saat client butuh jawaban
RemoteEvent itu kirim lalu lupakan. RemoteFunction membuat pemanggil menunggu: InvokeServer menghentikan kode yang memanggilnya sampai function OnServerInvoke di server return, lalu menyerahkan apa pun yang dikembalikannya. Pakai kalau client tidak bisa melanjutkan tanpa jawabannya, misalnya "apakah kode itu valid?". Kalau kamu tidak butuh balasan, Roblox merekomendasikan RemoteEvent, karena tidak menunggu.
Contoh: sebuah kotak tempat pemain mengetik kode hadiah. Server menyimpan kodenya, mengecek teksnya, dan mengembalikan dua nilai: apakah berhasil, dan pesan untuk ditampilkan.
- Di
ReplicatedStorage.Remotes, sisipkan RemoteFunction bernamaRedeemCode. - Di StarterGui, sisipkan ScreenGui bernama
CodeGui, dan di dalamnya sebuah TextBox bernamaCodeBox. Atur ukuran dan letaknya sesukamu. - Tambahkan Script di bawah ke ServerScriptService, dan LocalScript-nya ke dalam
CodeBox.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local redeemCode = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("RedeemCode") :: RemoteFunction
-- Kode disimpan di server, tempat tidak ada pemain yang bisa 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 } = {}
-- Isi dengan =. OnServerInvoke adalah callback, bukan event yang kamu 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)
Script ini menambah stat Coins dari panduan leaderboard. Kode yang sudah dipakai hanya diingat sampai pemain keluar, jadi seperti yang tertulis pemain bisa bergabung lagi dan menukarkan kode yang sama lagi. Kalau coin disimpan, itu berarti coin gratis setiap kali bergabung lagi: sebelum game live memakainya, simpan kode yang sudah dipakai setiap pemain bersama data tersimpannya di data store.
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 function ini sampai callback di server return.
-- pcall menjaga LocalScript tetap berjalan kalau panggilannya 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 punya tepat satu callback server. Kalau dua script mengisi OnServerInvoke pada RemoteFunction yang sama, hanya yang terakhir yang berjalan.
Kenapa InvokeClient berisiko
RemoteFunction juga bekerja ke arah sebaliknya, dengan InvokeClient di server dan OnClientInvoke di client. Dokumentasi Roblox mencantumkan tiga risiko serius:
- Kalau callback di client melempar error, server ikut melempar error itu.
- Kalau pemain keluar saat sedang di-invoke,
InvokeClientmelempar error. - Kalau client tidak pernah mengembalikan nilai, script server menunggu selamanya.
Client yang dimodifikasi mengendalikan callback-nya sendiri, jadi cheater bisa sengaja menyebabkan yang ketiga dan menahan thread server itu selama yang mereka mau. Untuk memperbarui layar pemain, pakai FireClient. Kalau server benar-benar butuh informasi dari client, kirim RemoteEvent, minta client membalas lewat RemoteEvent lain, dan perlakukan balasan yang tidak datang sebagai kasus biasa di server.
Validasi setiap argumen di server
Exploiter bisa memicu RemoteEvent mana pun atau meng-invoke RemoteFunction mana pun, sesering yang mereka mau, dengan argumen apa pun. Satu-satunya yang tidak bisa mereka palsukan adalah parameter pertama: Roblox yang mengisi Player pengirimnya. Semua setelah itu harus dicek sebelum server bertindak. Menyembunyikan remote atau mengecek di LocalScript tidak membantu, karena cheater mengendalikan client-nya sendiri.
| Pengecekan | Pertanyaan yang diajukan server | Contoh |
|---|---|---|
| Tipe | Apakah tipenya sesuai harapanku? Sebuah Instance, bukan table yang dibuat mirip Instance? | typeof(part) == "Instance" and part:IsA("BasePart") |
| Rentang | Apakah angkanya terhingga dan di dalam rentang yang diizinkan? Apakah panjang teksnya wajar? | math.isfinite(n), n >= 1 and n <= 4, #text <= 20 |
| Kepemilikan | Apakah pemain ini memiliki itemnya, punya uangnya, atau berhak bertindak pada objek ini? | Itemnya ada di inventory mereka; part-nya ada di dalam Paintable |
| Jarak | Apakah karakter pemain cukup dekat di salinan dunia milik server? Beri sedikit kelonggaran untuk lag. | Dalam 30 stud dari part |
| Laju | Apakah pemain ini mengirim terlalu cepat? | Cooldown per pemain atau pembatas laju dengan jatah yang terisi ulang |
NaN layak mendapat peringatan tersendiri. NaN adalah number, jadi type(x) == "number" lolos, tapi setiap perbandingan dengannya bernilai false, jadi pengecekan seperti x < 0 or x > 100 membiarkannya lewat begitu saja. math.isfinite(x) menolak NaN dan kedua tak hingga.
Ketahui batas pengecekan jarak. Setiap client mengendalikan fisika karakternya sendiri, jadi exploiter bisa memindahkan karakternya ke samping target sebelum mengirim. Pengecekan ini tetap menghentikan penyalahgunaan yang mudah, yaitu bertindak pada seluruh map dari satu tempat. Jaga juga part target tetap di-anchor: dokumentasi keamanan Roblox mencatat bahwa exploiter bisa mengambil network ownership part yang tidak di-anchor di dekatnya dan menarik part itu mendekat, yang mengakali pengecekan jarak.
Berikut pengecekan yang sama sebagai ModuleScript yang bisa kamu pakai ulang di setiap handler remote.
local Players = game:GetService("Players")
local RemoteGuard = {}
-- Angka nyata antara min dan max. Menolak NaN dan tak hingga, yang lolos
-- pengecekan type(x) == "number" biasa.
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
-- Bilangan bulat antara min dan max, untuk hitungan, indeks dan jumlah
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 batas panjang. utf8.len mengembalikan nil untuk UTF-8 yang tidak valid, yang
-- ditolak data store.
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 dari class yang diharapkan, di dalam container yang kamu izinkan.
-- Table yang dibuat mirip Instance gagal di pengecekan 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 kalau karakter pemain berada dalam 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
-- Rate limit per pemain. Setiap pemain boleh melakukan `burst` panggilan sekaligus, dan
-- mendapat kembali `perSecond` panggilan setiap detik. Mengembalikan function untuk dipanggil
-- sebelum mengerjakan tugasnya: jawabannya true (silakan) atau false (terlalu cepat).
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 di ServerScriptService. Kode di sana tidak pernah sampai ke client, jadi tidak ada yang bisa membaca pengecekanmu.
Dan inilah handler Pola 1 yang ditulis ulang memakainya. Ganti isi PaintServer:
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerScriptService = game:GetService("ServerScriptService")
-- ":: any" hanya penting bagi strict type checker Luau; tidak mengubah apa pun saat runtime
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) -- burst 4, lalu 4 per detik
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 menghapus entri setiap pemain saat mereka keluar, jadi table-nya tidak terus membesar selama server hidup.
Senjata adalah tempat pengecekan ini paling penting: jangan pernah biarkan client mengatakan siapa yang terkena. Remote di panduan pedang tidak membawa argumen sama sekali, dan server sendiri yang mencari targetnya. Panduan gun (dalam bahasa Inggris) hanya mengirim titik bidik, yang dicek server untuk tipe, NaN dan jarak sebelum server menembakkan ray-nya sendiri.
Menu mengikuti aturan yang sama: kirim pilihan, jangan pernah hasilnya. Di panduan dialog NPC client hanya mengirim nomor tombol yang ditekan, dan server mencari apa yang diberikan jawaban itu. Menu di panduan teleporter mengirim nama spot, bukan posisi, dan server mencari spot itu di folder miliknya sendiri dan mengecek Wins yang dibutuhkan.
Apa yang bisa dan tidak bisa dikirim
Kamu bisa mengirim number, string, boolean, tipe Roblox seperti Vector3, CFrame, Color3 dan item Enum, Instance yang bisa dilihat kedua sisi, dan table berisi semua itu. Beberapa nilai berubah atau hilang di perjalanan:
| Kamu mengirim | Yang terjadi |
|---|---|
| Sebuah function | Sisi lain menerima nil |
| Table dengan metatable | Metatable-nya hilang, beserta apa pun yang dimiliki table hanya lewat metatable itu |
| Table yang mencampur key angka dan key string | Roblox bilang jangan: kirim array murni atau dictionary murni |
Table dengan nilai nil di dalamnya | Hindari: Roblox menyarankan tidak ada nil di indeks mana pun |
| Table dengan key berupa Instance, userdata atau function | Key itu diubah menjadi string |
| Instance yang tidak bisa dilihat penerima, misalnya yang ada di ServerStorage atau yang dibuat LocalScript | Sisi lain menerima nil |
| Table apa pun | Penerima mendapat salinan, tidak pernah table yang sama |
Kebiasaan yang baik adalah mengirim pengenal, bukan objek atau nilai: nama item, indeks sebuah pilihan, part yang bisa dicari dan dicek server. Server lalu bekerja dari datanya sendiri.
Kenapa RemoteFunction mengembalikan nil
Kalau InvokeServer memberimu nil, periksa hal-hal ini secara berurutan:
- Jalur tanpa nilai kembalian. Setiap jalan keluar dari
OnServerInvokeharus mengembalikan sesuatu.returnkosong di pengecekan awal mengirim baliknil. - Return di dalam function bersarang.
returndi dalampcall(function() ... end), handler:Connectatautask.spawnhanya keluar dari function dalam itu. Tangkap hasilnya, misalnyalocal ok, data = pcall(...), lalu kembalikandatadari callback-nya sendiri. - Nilai yang tidak bisa menyeberang. Function, atau Instance yang tidak bisa dilihat client (apa pun di ServerStorage, misalnya), tiba sebagai
nil. Dengan instance streaming menyala, part yang baru saja dibuat server mungkin belum sampai ke client saat function return. - Script lain mengisi callback-nya. Hanya pengisian terakhir ke
OnServerInvokeyang berjalan. Cari nama remote itu di script-script kamu.
Kalau panggilannya tidak pernah kembali sama sekali, belum ada script yang mengisi OnServerInvoke (Roblox mengantrekan panggilan sampai ada yang mengisinya), atau callback-nya macet, misalnya di WaitForChild untuk sesuatu yang tidak pernah muncul.
UnreliableRemoteEvent: untuk update terus-menerus yang boleh hilang
UnreliableRemoteEvent punya method dan event yang sama dengan RemoteEvent: FireServer, FireClient, FireAllClients, OnServerEvent dan OnClientEvent. Bedanya, Roblox tidak menjamin pengiriman maupun urutannya. Sebuah pesan bisa dijatuhkan, tanpa dikirim ulang, kalau:
- hilang di perjalanan, atau menunggu terlalu lama di jaringan yang padat
- payload-nya lebih besar dari 1.000 byte
- client mengirim lebih cepat dari rate limit (kelebihannya dijatuhkan, bukan ditunda)
- tidak ada handler yang tersambung saat pesan tiba (pesan dibuang, bukan diantrekan)
Pesan juga bisa tiba tidak berurutan, dan tidak punya hubungan urutan dengan RemoteEvent atau RemoteFunction kamu. Pakai kalau hanya nilai terbaru yang penting dan update berikutnya tinggal sepersekian detik lagi: ke mana pemain membidik, posisi efek kosmetik, nilai yang berubah setiap frame. Kalau urutan penting, taruh nomor urut atau timestamp di setiap pesan dan abaikan apa pun yang lebih lama dari yang terakhir kamu tangani.
Jangan pernah memakainya untuk sesuatu yang harus terjadi tepat satu kali, seperti pembelian, damage, hadiah atau ronde yang dimulai. Dan validasi argumennya di server persis seperti untuk RemoteEvent.
Urutan pengiriman dan rate limit
Jaminan pengiriman Roblox berlaku untuk satu koneksi dalam satu arah: server ke satu client, atau satu client ke server.
- RemoteEvent itu andal dan berurutan. Pesan yang hilang dikirim ulang selama penerima tetap tersambung, dan pesan tiba dalam urutan kamu mengirimnya, bahkan lintas RemoteEvent yang berbeda. Kalau server mengirim A, lalu B, lalu A ke seorang pemain, pemain itu menerima A, B, A.
- Urutan adalah soal kapan handler mulai. Kalau sebuah handler yield, misalnya dengan
task.waitatauWaitForChild, pesan berikutnya bisa mulai ditangani sebelum yang pertama selesai. - RemoteFunction dan RemoteEvent tidak berurutan satu terhadap yang lain. Kalau kodemu bergantung pada urutan yang ketat, kirim pesan yang berkaitan lewat tipe remote yang sama, atau tambahkan nomor urutmu sendiri.
- Perubahan properti dan atribut tidak berurutan terhadap remote. Kalau server mengubah properti lalu memicu remote, client bisa melihat yang mana saja lebih dulu. Dengarkan perubahannya sendiri, misalnya dengan
GetPropertyChangedSignal, jangan menganggapnya sudah tiba. - Belum ada handler. Pesan RemoteEvent mengantre sampai sebuah handler tersambung. Antrean itu punya batas: begitu penuh, pesan berikutnya dibuang dan Output menampilkan error
Remote event invocation discarded. - Pemain yang keluar kehilangan pesan apa pun yang belum sampai kepadanya.
Rate limit. Pesan RemoteEvent dan UnreliableRemoteEvent dari client ke server dibatasi sekitar 500 request per detik per client, seperti didokumentasikan pada 30 September 2026. Batas itu dipakai bersama oleh setiap remote bertipe sama, jadi memecah satu remote yang sibuk menjadi sepuluh tidak menaikkannya. Melewati batas, pesan RemoteEvent diproses belakangan dan tetap berurutan, sedangkan pesan UnreliableRemoteEvent dijatuhkan. Batas engine tidak berbuat apa-apa untuk menghentikan satu pemain memicu remote kamu 50 kali per detik, jadi setiap handler yang mengubah sesuatu tetap butuh batas per pemainnya sendiri.
RemoteEvent, RemoteFunction, UnreliableRemoteEvent atau atribut?
| Pakai | Untuk | Contoh | Yang perlu diwaspadai |
|---|---|---|---|
| RemoteEvent | Pesan satu arah yang harus tiba, secara berurutan | Client: "cat part ini". Server: "tampilkan pemberitahuan ini" | Validasi setiap argumen di server |
RemoteFunction dengan InvokeServer | Client butuh jawaban sebelum bisa melanjutkan | Menukarkan kode, mengonfirmasi pembelian | Pemanggil menunggu; setiap jalur harus mengembalikan nilai |
RemoteFunction dengan InvokeClient | Hampir tidak pernah | Pakai FireClient saja | Client yang error, keluar atau tidak pernah menjawab merusak atau membekukan panggilan server |
| UnreliableRemoteEvent | Update yang sering dan hanya yang terbaru yang penting | Arah bidikan, efek kosmetik | Pesan dijatuhkan atau diacak urutannya; batas payload 1.000 byte |
| Atribut atau value object yang diatur server | State bersama yang harus selalu terlihat, termasuk bagi pemain yang bergabung belakangan | Timer ronde, fase game, status terbuka sebuah pintu | Hanya perubahan dari server yang sampai ke semua orang; client mendengarkan dengan GetAttributeChangedSignal atau Changed |
| BindableEvent | Script di sisi yang sama yang saling berkomunikasi | Satu script server memberi tahu script lain bahwa ronde berakhir | Tidak menyeberang antara server dan client |
Untuk contoh lengkap RemoteFunction dan validasi yang bekerja bersama pada sesuatu yang dibayar pemain, lihat cara membuat shop GUI. Untuk baris atribut, script server di panduan pintu mengatur atribut Open di setiap pintu setiap kali pintu bergerak, jadi LocalScript mana pun bisa bereaksi terhadapnya.
Error umum dan cara memperbaikinya
Sebagian besar masalah remote muncul di jendela Output (buka dari menu Window atau tab Script). Cek itu dulu, lalu cocokkan gejalanya di bawah. Panduan error script membahas pesan error umum lebih dalam.
Infinite yield possible pada WaitForChild untuk sebuah remote
Sebuah script menunggu remote yang tidak pernah tiba. Cek bahwa nama dan huruf kapitalnya cocok persis, dan bahwa remote ada di ReplicatedStorage, bukan ServerStorage atau ServerScriptService, yang tidak bisa dilihat client.
Server menerima nilai yang salah, bergeser satu
LocalScript mengirim player itu sendiri, seperti remote:FireServer(player, 5). Roblox sudah menambahkan pengirim sebagai parameter pertama, jadi server melihat (player, player, 5). Panggil remote:FireServer(5).
Tidak terjadi apa-apa saat aku memicu remote
Cek bahwa setiap panggilan berjalan di sisi yang benar: FireServer dan InvokeServer hanya berfungsi dari kode client, dan FireClient, FireAllClients serta InvokeClient hanya dari Script server. LocalScript tidak pernah berjalan di ServerScriptService, ServerStorage atau langsung di Workspace; taruh di StarterPlayerScripts, StarterGui, StarterCharacterScripts atau StarterPack. Lalu lihat Output untuk error di dalam handler.
Remote event invocation discarded
Pesan tiba untuk RemoteEvent yang tidak punya handler tersambung, dan antreannya penuh. Biasanya script handler-nya error sebelum baris :Connect, dinonaktifkan, atau macet menunggu sesuatu yang tidak pernah termuat. Sambungkan handler di dekat bagian atas script.
Berfungsi untukku, tapi pemain lain tidak melihat perubahannya
Perubahannya dibuat di client, di LocalScript atau handler OnClientEvent. Buatlah di handler OnServerEvent di server.
InvokeServer tidak pernah kembali
Entah belum ada script yang mengisi OnServerInvoke (Roblox mengantrekan panggilan sampai ada yang mengisinya), atau callback-nya macet di sesuatu yang yield, seperti WaitForChild atau request data store. Tambahkan print di awal dan akhir callback untuk melihat di mana berhentinya.
Buat dengan RoCode
Kamu juga bisa meminta RoCode menyiapkan ini di place yang sedang kamu buka. RoCode adalah agen AI yang bekerja lewat plugin Roblox Studio, jadi RoCode membuat remote dan script di Explorer kamu, bukan memberimu kode untuk ditempel.
Biarkan pemain mengklik part di folder Paintable untuk mengecatnya. Pakai RemoteEvent, dan simpan pengecekannya di server: hanya part di folder itu, dalam jarak 30 stud, dan tidak lebih dari beberapa kali cat per detik.
- Biasanya memeriksa place lebih dulu, dengan Search Game dan Search Scripts, untuk mencari folder Remotes atau handler yang sudah ada, dan memakai folder kamu yang sudah ada kalau memang ada
- Membuat RemoteEvent di ReplicatedStorage dengan Create Instance, dan menulis Script server serta LocalScript dengan Create Script
- Mengecek compile setiap script dengan Check Script di dalam Studio sebelum selesai. Itu menangkap error compile, bukan bug logika: tidak ada type check, lint atau menjalankan kodemu
- Mengirim perubahannya dalam batch, dan setiap batch adalah satu titik undo di history Studio
Dengan plugin 3.9 atau lebih baru RoCode bisa menjalankan playtest singkat dan membaca error-nya, dan dengan plugin 3.9.11 atau lebih baru RoCode bisa mengendalikan karakter tes, tapi tidak mengklik part di tampilan 3D. Tekan Play sendiri dan coba jebol pengecekannya, misalnya dengan mengecat dari seberang map. Kalau ada yang error, Check Output bisa membaca baris Server dan Client dari playtest terakhirmu. Sebagian besar sistem game berkomunikasi lewat remote seperti ini, jadi remote muncul lagi saat kamu membuat game sistem demi sistem dengan RoCode. Cara RoCode tersambung ke Studio.
Pertanyaan umum
Apa arti mengamankan batas client dan server di Roblox?
Itu nama halaman dokumentasi Roblox tentang keamanan remote (Securing the client-server boundary), dan idenya sederhana: apa pun yang dikirim client lewat RemoteEvent atau RemoteFunction bisa datang dari exploiter, jadi server mengeceknya sebelum bertindak. Cek tipe setiap argumen, jaga angka dalam rentang yang wajar, cek bahwa pemain memang boleh melakukannya saat ini, dan batasi seberapa sering setiap pemain bisa mengirim. Checklist validasi di atas menunjukkan masing-masing dalam kode.
Apakah RemoteFunction aman dipakai?
InvokeServer seaman callback server kamu: validasi argumennya dan beri rate limit seperti RemoteEvent mana pun. InvokeClient adalah arah yang berisiko, karena client yang error, keluar atau tidak pernah return merusak atau membekukan panggilan server.
Bisakah exploiter melihat dan memicu remote milikku?
Bisa. Semua yang ada di ReplicatedStorage sampai ke setiap client, dan client yang dimodifikasi bisa memicu remote mana pun dengan argumen apa pun. Mengganti nama atau menyembunyikan remote tidak membuatnya aman; mengecek setiap argumen di server yang membuatnya aman.
Bisakah satu client mengirim RemoteEvent ke client lain?
Tidak secara langsung. Kirim ke server, cek di sana, lalu pakai FireClient atau FireAllClients.
Seberapa sering aku bisa memicu RemoteEvent?
Roblox mendokumentasikan batas sekitar 500 request per detik per client untuk pesan RemoteEvent dan UnreliableRemoteEvent yang dikirim ke server, dipakai bersama oleh semua remote bertipe sama. Tetaplah jauh di bawahnya, dan beri setiap handler batas per pemainnya sendiri.
Apakah FireAllClients sampai ke pemain yang bergabung belakangan?
Tidak. Pesannya sampai ke pemain yang tersambung pada saat itu. Untuk state yang dibutuhkan pemain yang datang belakangan, atur atribut atau value object di server.
Apa beda RemoteEvent dan BindableEvent?
RemoteEvent menyeberang antara server dan client. BindableEvent menghubungkan script di sisi yang sama, misalnya dua script server.
Sumber dan bacaan lanjutan
- Roblox Creator Docs: Remote events and callbacks (dalam bahasa Inggris). FireServer, FireClient, InvokeServer, risiko InvokeClient, batasan argumen dan jaminan pengiriman
- Roblox Creator Docs: Securing the client-server boundary (dalam bahasa Inggris). Lapisan validasi, NaN, rate limit, perantara dari client ke client
- Roblox Creator Docs: Security and cheat mitigation tactics (dalam bahasa Inggris). Apa yang bisa dilakukan client yang dimodifikasi, dan otoritas server
- Roblox Creator Docs: Network ownership, movement validation, and physics (dalam bahasa Inggris). Kenapa client mengendalikan karakternya sendiri, dan batas pengecekan jarak
- Roblox Engine API: RemoteEvent (dalam bahasa Inggris). Batas throttling dan error invocation discarded
- Roblox Engine API: RemoteFunction (dalam bahasa Inggris). OnServerInvoke, peringatan InvokeClient dan kehati-hatian soal streaming
- Roblox Engine API: UnreliableRemoteEvent (dalam bahasa Inggris). Batas payload 1.000 byte
- Roblox Creator Docs: Properties and attributes (dalam bahasa Inggris). Urutan replikasi antara perubahan properti dan remote event
Cara kode ini dicek: setiap skrip di halaman ini lolos pemeriksa tipe strict Luau dengan definisi API Roblox (luau-lsp, 12 November 2026). Pemeriksaan tipe menangkap nama API yang salah ketik dan tipe yang keliru, bukan logika game, jadi uji dulu di Studio sebelum dipublikasikan.