Tutorial · Dasar scripting

RemoteEvent di Roblox: dari client ke server dan sebaliknya

LocalScript tidak bisa mengubah apa yang dilihat pemain lain, dan Script server tidak bisa menyentuh layar satu pemain. RemoteEvent membawa pesan di antara keduanya. Panduan ini membuat tiga pola yang paling sering kamu pakai, sebuah RemoteFunction yang mengembalikan jawaban, dan pengecekan di sisi server yang mencegah client yang dimodifikasi menyalahgunakannya.

Diperbarui 12 November 202616 menit bacaDitulis oleh

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 (InvokeServer dan OnServerInvoke) hanya kalau client butuh jawaban balik. Hindari InvokeClient: 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
  1. Kenapa remote ada
  2. Siapkan remote
  3. 1. Client ke server
  4. 2. Server ke satu client
  5. 3. Server ke semua client
  6. RemoteFunction
  7. Checklist validasi
  8. Yang tidak bisa dikirim
  9. Mengembalikan nil?
  10. UnreliableRemoteEvent
  11. Urutan dan batas
  12. Mana yang dipakai
  13. Error umum
  14. Dengan RoCode
  15. Pertanyaan umum
  16. Sumber dan bacaan lanjutan

Kenapa RemoteEvent ada

IlustrasiSetiap klik meminta server mengecat part-nya, jadi layar kedua pemain menampilkan warna barunya.

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.
Panggilan mana memicu event mana
ArahPengirim memanggilPenerima tersambung kePenerima mendapat
Client ke serverremote:FireServer(...) di LocalScriptremote.OnServerEvent di ScriptPlayer yang mengirim, lalu argumenmu
Server ke satu clientremote:FireClient(player, ...) di Scriptremote.OnClientEvent di LocalScriptHanya argumenmu
Server ke semua clientremote:FireAllClients(...) di Scriptremote.OnClientEvent di LocalScriptHanya argumenmu
Client bertanya, server menjawabremoteFunction: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.

  1. Di Explorer, arahkan kursor ke ReplicatedStorage, klik tombol + dan sisipkan Folder. Beri nama Remotes.
  2. Arahkan kursor ke Remotes, klik + dan sisipkan RemoteEvent. Ganti namanya supaya menjelaskan tujuannya, misalnya PaintRequest.
  3. Ulangi untuk setiap remote. Panduan ini memakai dua RemoteEvent (PaintRequest dan Notify) dan satu RemoteFunction (RedeemCode).
Explorer: semua yang ditambahkan panduan ini, bagian demi bagian
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.

  1. Di Workspace, sisipkan Folder bernama Paintable dan taruh beberapa Part yang di-anchor di dalamnya.
  2. Cek bahwa ReplicatedStorage.Remotes punya RemoteEvent bernama PaintRequest.
  3. Sisipkan Script di ServerScriptService bernama PaintServer, dan LocalScript di StarterPlayer, StarterPlayerScripts bernama PaintClient, dengan kode di bawah.
Script di 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")

-- 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.

LocalScript di 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 -- 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.

Script di 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 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
LocalScript di 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

-- 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.

Script di 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 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.

  1. Di ReplicatedStorage.Remotes, sisipkan RemoteFunction bernama RedeemCode.
  2. Di StarterGui, sisipkan ScreenGui bernama CodeGui, dan di dalamnya sebuah TextBox bernama CodeBox. Atur ukuran dan letaknya sesukamu.
  3. Tambahkan Script di bawah ke ServerScriptService, dan LocalScript-nya ke dalam CodeBox.
Script di ServerScriptService bernama RedeemServer
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.

LocalScript di 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 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, InvokeClient melempar 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.

Checklist di sisi server
PengecekanPertanyaan yang diajukan serverContoh
TipeApakah tipenya sesuai harapanku? Sebuah Instance, bukan table yang dibuat mirip Instance?typeof(part) == "Instance" and part:IsA("BasePart")
RentangApakah angkanya terhingga dan di dalam rentang yang diizinkan? Apakah panjang teksnya wajar?math.isfinite(n), n >= 1 and n <= 4, #text <= 20
KepemilikanApakah pemain ini memiliki itemnya, punya uangnya, atau berhak bertindak pada objek ini?Itemnya ada di inventory mereka; part-nya ada di dalam Paintable
JarakApakah karakter pemain cukup dekat di salinan dunia milik server? Beri sedikit kelonggaran untuk lag.Dalam 30 stud dari part
LajuApakah 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.

ModuleScript di ServerScriptService bernama RemoteGuard
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:

Script di ServerScriptService bernama 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:

Argumen yang tidak tiba seperti saat dikirim
Kamu mengirimYang terjadi
Sebuah functionSisi lain menerima nil
Table dengan metatableMetatable-nya hilang, beserta apa pun yang dimiliki table hanya lewat metatable itu
Table yang mencampur key angka dan key stringRoblox bilang jangan: kirim array murni atau dictionary murni
Table dengan nilai nil di dalamnyaHindari: Roblox menyarankan tidak ada nil di indeks mana pun
Table dengan key berupa Instance, userdata atau functionKey itu diubah menjadi string
Instance yang tidak bisa dilihat penerima, misalnya yang ada di ServerStorage atau yang dibuat LocalScriptSisi lain menerima nil
Table apa punPenerima 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:

  1. Jalur tanpa nilai kembalian. Setiap jalan keluar dari OnServerInvoke harus mengembalikan sesuatu. return kosong di pengecekan awal mengirim balik nil.
  2. Return di dalam function bersarang. return di dalam pcall(function() ... end), handler :Connect atau task.spawn hanya keluar dari function dalam itu. Tangkap hasilnya, misalnya local ok, data = pcall(...), lalu kembalikan data dari callback-nya sendiri.
  3. 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.
  4. Script lain mengisi callback-nya. Hanya pengisian terakhir ke OnServerInvoke yang 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.wait atau WaitForChild, 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?

Memilih cara client dan server berkomunikasi
PakaiUntukContohYang perlu diwaspadai
RemoteEventPesan satu arah yang harus tiba, secara berurutanClient: "cat part ini". Server: "tampilkan pemberitahuan ini"Validasi setiap argumen di server
RemoteFunction dengan InvokeServerClient butuh jawaban sebelum bisa melanjutkanMenukarkan kode, mengonfirmasi pembelianPemanggil menunggu; setiap jalur harus mengembalikan nilai
RemoteFunction dengan InvokeClientHampir tidak pernahPakai FireClient sajaClient yang error, keluar atau tidak pernah menjawab merusak atau membekukan panggilan server
UnreliableRemoteEventUpdate yang sering dan hanya yang terbaru yang pentingArah bidikan, efek kosmetikPesan dijatuhkan atau diacak urutannya; batas payload 1.000 byte
Atribut atau value object yang diatur serverState bersama yang harus selalu terlihat, termasuk bagi pemain yang bergabung belakanganTimer ronde, fase game, status terbuka sebuah pintuHanya perubahan dari server yang sampai ke semua orang; client mendengarkan dengan GetAttributeChangedSignal atau Changed
BindableEventScript di sisi yang sama yang saling berkomunikasiSatu script server memberi tahu script lain bahwa ronde berakhirTidak 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.

Kamu ketik

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.

RoCode mengerjakan
  • 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

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.

Coba RoCode di game kamu sendiri.

Kredit gratis setiap hari, tanpa kartu. Pasang plugin-nya, jelaskan fiturnya, lalu cek hasilnya di Studio.