Sa madaling salita
Ang RemoteEvent ay isang object na karaniwang nasa ReplicatedStorage at nagpapasa ng mga message sa hangganan ng client at server. Tinatawag ng LocalScript ang FireServer, at natatanggap ng server ang message sa OnServerEvent, kung saan idinadagdag bilang unang argument ang Player na nagpadala nito. Tinatawag ng server ang FireClient(player, ...) o FireAllClients(...), at natatanggap ng mga LocalScript ang message sa OnClientEvent.
- Gamitin ang RemoteFunction (
InvokeServeratOnServerInvoke) kapag kailangan lang ng client ng sagot. Iwasan angInvokeClient: ang client na nag-error, umalis o hindi kailanman nagbalik ng value ay sumisira sa tawag sa server. - Huwag kailanman pagkatiwalaan ang ipinapadala ng client. Sa server, suriin ang type, range at pagmamay-ari ng bawat argument, ang distansya ng player, at kung gaano kadalas niyang tinatawag ang remote.
- Hindi nakakaligtas sa pagpapasa ang mga function, metatable at object na hindi nakikita ng kabilang panig. Puwedeng mawala o magulo ang pagkakasunod ng mga message ng UnreliableRemoteEvent, at itinatapon nito ang kahit anong data na higit sa 1000 byte.
Sa page na ito
- Bakit kailangan ang remote
- Setup ng mga remote
- 1. Client papuntang server
- 2. Server papunta sa client
- 3. Server papunta sa lahat
- RemoteFunction
- Checklist ng mga check
- Ano ang hindi maipapadala
- Nagbabalik ng nil?
- UnreliableRemoteEvent
- Pagkakasunod at mga limit
- Alin ang pipiliin
- Common errors
- Gamit ang RoCode
- Mga madalas itanong
- Mga source at dagdag na babasahin
Bakit kailangan ang RemoteEvent
Bawat Roblox game ay gumagana bilang isang server dagdag ang isang client para sa bawat player. Ang server ang boss dito: nakakarating sa lahat ng player ang bagong object o pagbabago ng property kung server lang ang gumawa nito. Ang pagbabagong ginawa sa LocalScript ay nananatili sa iisang device, maliban sa ilang eksepsyon gaya ng sariling character ng player, na ang galaw ay kinokontrol ng client niya. Kaya kapag kailangang baguhin ng click o pindot ng key ang shared na mundo, kailangang humiling ang client sa server, at kapag gusto ng server na tumugon ang screen ng iisang player, kailangan nitong sabihin iyon sa client. Kung bago sa iyo ang paghihiwalay ng Script at LocalScript, basahin muna ang Script vs LocalScript vs ModuleScript (sa English). Kung bago sa iyo ang scripting mismo, magsimula sa paano sumulat ng script sa Roblox Studio.
Para tumawid sa hangganang ito, nagbibigay ang Roblox ng tatlong object:
- RemoteEvent: one-way na message. Agad na tumutuloy sa trabaho ang nagpadala.
- RemoteFunction: request na naghihintay ng sagot. Naka-pause ang code na tumawag hanggang magbalik ng value ang kabilang panig.
- UnreliableRemoteEvent: one-way na message na puwedeng mawala o dumating nang hindi sunod-sunod, pero mas magaan sa network. Bagay sa data na palaging nagbabago.
| Direksyon | Tinatawag ng nagpapadala | Kumokonekta ang tumatanggap sa | Natatanggap ng tumatanggap |
|---|---|---|---|
| Mula client papuntang server | remote:FireServer(...) sa LocalScript | remote.OnServerEvent sa Script | Ang Player na nagpadala ng message, tapos ang mga argument mo |
| Mula server papunta sa isang client | remote:FireClient(player, ...) sa Script | remote.OnClientEvent sa LocalScript | Ang mga argument mo lang |
| Mula server papunta sa lahat ng client | remote:FireAllClients(...) sa Script | remote.OnClientEvent sa LocalScript | Ang mga argument mo lang |
| Nagtatanong ang client, sumasagot ang server | remoteFunction:InvokeServer(...) | remoteFunction.OnServerInvoke = function(player, ...) | Ang Player, tapos ang mga argument mo. Natatanggap ng tumawag ang ibinalik ng function |
Hindi direktang makakapagpadala ng message ang mga client sa isa't isa. Para magpasa ng kahit ano mula sa isang player papunta sa iba, ipadala ito sa server, suriin doon, at hayaang ipasa ito ng server gamit ang FireClient o FireAllClients. Ayon sa mga rekomendasyon ng Roblox sa security, gumagana ang server dito bilang bantay sa pinto, hindi bilang simpleng tagapasa.
Saan itatago ang mga remote
Dapat nasa lugar ang remote kung saan nakikita ito ng server at ng mga client. Ang karaniwang lugar ay ReplicatedStorage; nakasaad sa documentation ng Roblox na sa ilang kaso, puwede rin ang Workspace o Tool. Server lang ang may access sa ServerStorage at ServerScriptService, kaya ang LocalScript na naghihintay ng remote mula roon ay maghihintay nang walang katapusan.
- Sa Explorer, i-hover ang ReplicatedStorage, pindutin ang + na button at maglagay ng Folder. Pangalanan ang folder na
Remotes. - I-hover ang
Remotes, pindutin ang + at maglagay ng RemoteEvent. Palitan ang pangalan nito para ilarawan ang gamit, halimbawaPaintRequest. - Ulitin para sa bawat remote. Sa guide na ito, dalawang RemoteEvent (
PaintRequestatNotify) at isang RemoteFunction (RedeemCode) ang ginagamit.
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
Hinahanap ng mga script sa guide na ito ang mga remote gamit ang WaitForChild. Agad itong nagbabalik ng resulta kung nandoon na ang remote, at naghihintay kung wala pa, halimbawa kapag gumagawa ng mga remote ang server script habang tumatakbo ang game. Gumawa ng hiwalay na remote para sa bawat uri ng request: sa ganoon, iisang hugis ng argument lang ang sinusuri ng bawat server handler, at mas madaling gawin ito nang tama kaysa sa iisang remote para sa lahat.
Pattern 1: mula client papuntang server, may check sa server
Ang pinakamadalas na gawain: may ginagawa ang player sa screen niya, at ang server ang nagpapasya kung ano ang mangyayari. Dito, pinipindot ng player ang Q para pumili ng isa sa apat na kulay, at kini-click o tina-tap ang part para kulayan ito. Nakikita ng lahat ang bagong kulay, dahil ang server ang nagkukulay.
Dalawang bagay ang ipinapadala ng client: aling part at ang numero ng kulay. Hindi nito kailanman ipinapadala ang kulay mismo, at sa ibang game, hindi rin nito dapat ipadala ang presyo, reward o laki ng damage. Kayang magpadala ng kahit ano ang binagong client, kaya ang server ang nagtatago ng totoong data (dito, ang palette), at itinuturing nito ang mga argument bilang request na kailangang suriin.
- Sa Workspace, maglagay ng Folder na pinangalanang
Paintableat ilagay dito ang ilang naka-anchor na Part. - Siguraduhing may RemoteEvent na pinangalanang
PaintRequestsaReplicatedStorage.Remotes. - Maglagay ng Script na pinangalanang
PaintServersa ServerScriptService at ng LocalScript na pinangalanangPaintClientsa StarterPlayer, StarterPlayerScripts, gamit ang code sa ibaba.
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")
-- Pag-aari ng server ang mga kulay. Numero lang ang ipinapadala ng client, na pumipili ng isa sa mga ito.
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 sa pagitan ng character at ng part
local COOLDOWN_SECONDS = 0.25
local lastPaint: { [Player]: number } = {}
-- Ang unang parameter ay palaging ang player na tumawag sa remote. Ang Roblox ang naglalagay nito,
-- kaya mapagkakatiwalaan ito. Lahat ng kasunod nito ay galing sa client, at hindi iyon mapagkakatiwalaan.
paintRequest.OnServerEvent:Connect(function(player: Player, part: unknown, colourIndex: unknown)
-- 1. Type: totoong part, hindi table na nagpapanggap na part
if typeof(part) ~= "Instance" or not part:IsA("BasePart") then
return
end
-- 2. Range: integer mula 1 hanggang 4. Dito rin sinasala ang NaN at infinity.
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. Pinapayagang target: mga part lang sa Paintable folder, wala nang iba sa game
if not part:IsDescendantOf(paintable) then
return
end
-- 4. Distansya: dapat malapit sa part ang character ng player
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. Limit sa dalas: isang pagkulay kada player bawat quarter ng segundo
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)
Bawat bigong check ay simpleng nagre-return. Walang dahilan para ipaliwanag sa nandadayang client kung bakit siya tinanggihan.
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 -- ang server ang nagtatago ng totoong mga kulay
local selectedColour = 1
-- Mga part lang sa loob ng Paintable folder ang puwedeng tamaan ng ray
local rayParams = RaycastParams.new()
rayParams.FilterType = Enum.RaycastFilterType.Include
rayParams.FilterDescendantsInstances = { paintable }
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed then
return -- napunta ang key o click sa chat o sa isang 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
-- Humihiling, hindi nag-uutos: ang server ang nagpapasya kung kukulayan o hindi
paintRequest:FireServer(result.Instance, selectedColour)
end
end
end)
Ang gameProcessed ay true kapag naproseso na ng engine ang input na ito, karaniwan sa interface: click sa button o mga key na tina-type sa text field gaya ng chat bar. Dahil sa check na ito, hindi nagbabago ang kulay kapag nag-type ka ng letrang Q sa isang message.
Pattern 2: mula server papunta sa isang client
Nagpapadala ang server ng message sa isang player gamit ang FireClient. Ang unang argument ay ang Player na pinadadalhan nito, at natatanggap lang ng handler sa client ang mga argument pagkatapos nito. Gamitin ito para sa lahat ng personal: notification, window ng reward, tunog na dapat ang player lang ang makarinig. Ang guide sa cutscene ay mas malaking halimbawa na hinimay: ang server ang nagpapasya kung kailan makikita ng player ang cutscene at ipinapadala ang mga frame nito sa iisang player na iyon gamit ang FireClient, at ang device niya ang gumagalaw sa camera.
Nagpapakita ang pares ng mga script na ito ng welcome kapag pumasok ang player. Ang LocalScript mismo ang bumubuo ng maliit na banner, kaya hindi mo kailangang mag-set up ng GUI.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local function welcome(player: Player)
-- Pinipili ng unang argument kung aling client ang tatanggap ng message. Wala nang ibang makakakita nito.
notify:FireClient(player, `Welcome, {player.DisplayName}! Press Q to change colour.`)
end
Players.PlayerAdded:Connect(welcome)
-- Sa Studio, puwede kang makapasok bago kumonekta ang script na ito, kaya binabati natin ang lahat ng nandito na
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
-- Maliit na banner sa itaas ng screen, binuo sa code
local gui = Instance.new("ScreenGui")
gui.Name = "Notifications"
gui.ResetOnSpawn = false
gui.Parent = player:WaitForChild("PlayerGui")
local label = Instance.new("TextLabel")
label.AnchorPoint = Vector2.new(0.5, 0)
label.Position = UDim2.new(0.5, 0, 0, 16)
label.Size = UDim2.fromOffset(420, 44)
label.BackgroundColor3 = Color3.fromRGB(18, 11, 31)
label.TextColor3 = Color3.new(1, 1, 1)
label.TextScaled = true
label.Visible = false
label.Parent = gui
local messageCount = 0
-- Walang player na parameter dito: napili na ng server kung sino ang tatanggap ng message
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 -- itago, kung hindi ito napalitan ng mas bagong message
label.Visible = false
end
end)
end)
Ipinapadala ng server ang message sa PlayerAdded, at puwedeng mangyari iyon bago ikonekta ng LocalScript na ito ang handler nito. Ayos lang iyon: inilalagay ng Roblox sa queue ang mga RemoteEvent message na dumating bago lumabas ang handler, at inihahatid ang mga ito nang sunod-sunod sa sandaling kumonekta ang handler.
Hindi kailangang protektahan ng client ang sarili laban sa server: server code lang ang kayang tumawag ng OnClientEvent. Ang annotation na message: string ay para sa type check; hindi ito check habang tumatakbo.
Pattern 3: mula server papunta sa lahat ng client
Ipinapadala ng FireAllClients ang iisang message sa bawat nakakonektang player. Wala itong Player na argument, at natatanggap ng bawat client ang message sa parehong OnClientEvent gaya ng dati, kaya ipinapakita na ito ng NotifyClient script mula sa pattern 2.
Ina-announce ng Script na ito sa lahat kapag unang beses na nahawakan ng player ang finish line. Magdagdag sa Workspace ng naka-anchor na Part na pinangalanang FinishLine, saka magdagdag ng Script sa 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 -- hindi player o na-announce na
end
finished[player] = true
-- Pinapatakbo ng bawat nakakonektang client ang sarili nitong OnClientEvent handler gamit ang text na ito
notify:FireAllClients(`{player.DisplayName} reached the finish!`)
end)
Players.PlayerRemoving:Connect(function(player: Player)
finished[player] = nil
end)
Kayang i-trigger ng exploiter ang Touched para sa character niya mula sa kahit anong distansya, pero hindi ito nakakapinsala para sa announcement na lumalabas nang isang beses kada player. Kung magbibigay ka mamaya ng reward sa pag-finish, magdagdag ng mga check sa server bago ito ibigay, halimbawa minimum na oras mula sa simula ng round.
Nakakarating lang ang FireAllClients sa mga player na nakakonekta sa sandaling iyon. Ang pumasok isang segundo pagkatapos ay hindi na makikita ang message. Bagay ito sa mga one-time na sandali gaya ng announcement, epekto ng pagsabog o tunog, pero hindi bagay sa state gaya ng round timer o kasalukuyang phase ng game. Para sa state, mag-set ng attribute sa server, halimbawa ReplicatedStorage:SetAttribute("TimeLeft", 30), at basahin ito sa client gamit ang GetAttribute at GetAttributeChangedSignal("TimeLeft"). Nare-replicate ang mga attribute sa bawat client, kasama ang mga player na pumasok nang huli.
RemoteFunction: kapag kailangan ng client ng sagot
Gumagana ang RemoteEvent sa prinsipyong "ipadala at kalimutan". Pinaghihintay naman ng RemoteFunction ang tumawag: pinapa-pause ng InvokeServer ang code na tumawag dito hanggang magbalik ng value ang server function na OnServerInvoke, saka ibinibigay ang ibinalik nito. Gamitin ito kapag hindi makakatuloy ang client nang walang sagot, halimbawa "tama ba ang code na ito?". Kapag hindi kailangan ng sagot, RemoteEvent ang inirerekomenda ng Roblox, dahil hindi ito naghihintay.
Halimbawa: field kung saan naglalagay ang mga player ng promo code. Ang server ang nagtatago ng mga code, sinusuri ang text at nagbabalik ng dalawang value: kung gumana ba, at ang message na ipapakita.
- Sa
ReplicatedStorage.Remotes, maglagay ng RemoteFunction na pinangalanangRedeemCode. - Sa StarterGui, maglagay ng ScreenGui na pinangalanang
CodeGui, at sa loob nito ng TextBox na pinangalanangCodeBox. Ikaw na ang bahala sa laki at puwesto. - Idagdag ang Script sa ibaba sa ServerScriptService, at ang LocalScript sa loob ng
CodeBox.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local redeemCode = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("RedeemCode") :: RemoteFunction
-- Nasa server ang mga code, kung saan walang player na makakabasa sa mga ito
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 } = {}
-- Ina-assign gamit ang =. Callback ang OnServerInvoke, hindi event na kinokonekta gamit ang 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)
Nagdadagdag ito sa stat na Coins mula sa guide sa leaderboard. Natatandaan lang ang mga nagamit na code hanggang umalis ang player, kaya sa ganitong anyo, puwedeng mag-rejoin ang player at ilagay ulit ang parehong code. Kung naka-save ang coins, libreng coins iyon sa bawat rejoin: bago gamitin ito sa live na game, itago ang mga nagamit na code ng bawat player kasama ng naka-save niyang data sa DataStore.
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..."
-- Pina-pause ng InvokeServer ang function na ito hanggang magbalik ng value ang callback ng server.
-- Pinipigilan ng pcall na huminto ang LocalScript kung nag-fail ang tawag.
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)
Eksaktong isang server callback lang ang mayroon ang RemoteFunction. Kung dalawang script ang nagse-set ng OnServerInvoke sa iisang RemoteFunction, ang huli lang ang gumagana.
Bakit delikado ang InvokeClient
Gumagana rin ang RemoteFunction sa kabilang direksyon, gamit ang InvokeClient sa server at OnClientInvoke sa client. Naglilista ang documentation ng Roblox ng tatlong seryosong panganib:
- Kung nag-error ang callback ng client, mag-e-error din ang server.
- Kung umalis ang player habang may tawag, mag-e-error ang
InvokeClient. - Kung hindi kailanman magbalik ng value ang client, maghihintay nang walang katapusan ang server script.
Kontrolado ng binagong client ang callback nito, kaya puwedeng sadyang gawin ng nandadaya ang pangatlong kaso at hawakan ang server thread na iyon hangga't gusto niya. Para i-update ang screen ng player, gamitin ang FireClient. Kung talagang kailangan ng server ng impormasyon mula sa client, magpadala ng RemoteEvent, hayaang sumagot ang client sa pamamagitan ng ibang RemoteEvent, at ituring sa server na karaniwang kaso ang walang sagot.
Suriin ang bawat argument sa server
Kayang tawagin ng exploiter ang kahit anong RemoteEvent o RemoteFunction nang kahit ilang beses at gamit ang kahit anong argument. Ang tanging hindi niya kayang pekein ay ang unang parameter: ang Roblox mismo ang naglalagay ng Player na nagpadala ng message. Lahat ng kasunod ay kailangang suriin bago kumilos ang server. Walang silbi ang pagtatago ng remote o pagsusuri sa LocalScript, dahil kontrolado ng nandadaya ang client niya.
| Check | Tanong ng server | Halimbawa |
|---|---|---|
| Type | Ito ba ang type na hinihintay ko? Instance, hindi table na binuo para magmukhang ganoon? | typeof(part) == "Instance" and part:IsA("BasePart") |
| Range | Finite ba ang numero at nasa pinapayagang hangganan? Makatwiran ba ang haba ng text? | math.isfinite(n), n >= 1 and n <= 4, #text <= 20 |
| Pagmamay-ari | Pag-aari ba ng player na ito ang item, sapat ba ang pera niya, may karapatan ba siyang kumilos sa object na ito? | Nasa inventory niya ang item; nasa loob ng Paintable ang part |
| Distansya | Sapat bang malapit ang character ng player sa kopya ng mundo sa server? Mag-iwan ng kaunting palugit para sa lag. | Hindi lalayo sa 30 stud mula sa part |
| Dalas | Hindi ba masyadong madalas magpadala ang player na ito? | Cooldown kada player o limit na may naiipong tawag |
Karapat-dapat ng hiwalay na babala ang NaN. Numero ito, kaya pumapasa ang type(x) == "number", pero false ang kahit anong paghahambing dito, at nakakalusot ito sa check gaya ng x < 0 or x > 100. Tinatanggihan ng math.isfinite(x) ang NaN at ang dalawang infinity.
Tandaan ang hangganan ng distance check. Kinokontrol ng bawat client ang physics ng sarili niyang character, kaya kayang ilipat ng exploiter ang character niya malapit sa target bago tumawag. Pinipigilan pa rin ng check ang pinakasimpleng pang-aabuso, kung saan mula sa iisang lugar ay kumikilos sa buong map. Panatilihing naka-anchor ang mga target na part: nakasaad sa security documentation ng Roblox na kayang makuha ng exploiter ang network ownership ng mga hindi naka-anchor na part malapit sa kanya at hilahin ang mga ito palapit, at nalalampasan nito ang distance check.
Narito ang parehong mga check bilang ModuleScript na magagamit mo sa bawat remote handler.
local Players = game:GetService("Players")
local RemoteGuard = {}
-- Totoong numero sa pagitan ng min at max. Tinatanggihan ang NaN at infinity, na pumapasa
-- sa karaniwang check na 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 sa pagitan ng min at max, para sa dami, index at counter
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
-- Text na may limit sa haba. Nagbabalik ang utf8.len ng nil para sa invalid na UTF-8, na
-- tinatanggihan ng mga DataStore.
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 ng inaasahang class sa loob ng container na pinayagan mo.
-- Hindi pumapasa sa typeof check ang table na binuo para magmukhang Instance.
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 kapag ang character ng player ay hindi lalayo sa maxDistance na stud mula sa 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
-- Limit sa dalas kada player. Bawat player ay puwedeng gumawa ng `burst` na tawag nang sabay at
-- nakakakuha pabalik ng `perSecond` na tawag bawat segundo. Nagbabalik ng function na tinatawag
-- bago magtrabaho: sumasagot ito ng true (puwede) o false (masyadong madalas).
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
Itago ito sa ServerScriptService. Hindi kailanman napupunta sa mga client ang code mula roon, kaya walang makakabasa ng mga check mo.
At narito ang handler mula sa pattern 1, isinulat ulit gamit ito. Palitan ang laman ng PaintServer:
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerScriptService = game:GetService("ServerScriptService")
-- Mahalaga lang ang ":: any" para sa strict type check ng Luau; walang binabago ito habang tumatakbo
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) -- batch na 4, tapos 4 kada segundo
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)
Dine-delete ng limiter ang entry ng player kapag umalis siya, kaya hindi lumalaki ang table nito sa buong buhay ng server.
Sa mga armas pinakamahalaga ang mga check na ito: huwag kailanman payagan ang client na sabihin kung sino ang tinamaan. Ang remote mula sa guide sa espada ay walang dalang argument, at ang server mismo ang naghahanap ng mga target. Ang guide sa baril ay nagpapadala lang ng aiming point, na sinusuri ng server para sa type, NaN at distansya bago magpatakbo ng sarili nitong ray.
Ganoon din ang patakaran sa mga menu: ipadala ang pinili, hindi ang resulta. Sa guide sa NPC dialogue, numero lang ng pinindot na button ang ipinapadala ng client, at ang server mismo ang tumitingin kung ano ang ibinibigay ng sagot na iyon. Ang menu mula sa guide sa teleport ay nagpapadala ng pangalan ng point, hindi ng posisyon, at hinahanap ng server ang point sa folder nito at sinusuri kung ilang Wins ang kailangan para dito.
Ano ang puwede at hindi puwedeng ipadala
Puwedeng ipasa ang mga numero, string, boolean, mga Roblox type gaya ng Vector3, CFrame, Color3 at mga item ng Enum, mga Instance na nakikita ng dalawang panig, at mga table na binubuo ng lahat ng ito. May ilang value na nagbabago o nawawala sa daan:
| Ipinapadala mo | Ano ang nangyayari |
|---|---|
| Function | Natatanggap ng kabilang panig ang nil |
| Table na may metatable | Nawawala ang metatable kasama ang lahat ng nasa table dahil lang dito |
| Table na halo ang numeric at string na key | Payo ng Roblox na huwag gawin ito: magpadala ng purong array o purong dictionary |
Table na may mga nil na value sa loob | Iwasan: hindi inirerekomenda ng Roblox ang nil sa kahit anong index |
| Table na may key na Instance, userdata o function | Nagiging string ang mga ganitong key |
| Instance na hindi nakikita ng tumatanggap, halimbawa mula sa ServerStorage o ginawa sa LocalScript | Natatanggap ng kabilang panig ang nil |
| Kahit anong table | Kopya ang natatanggap ng tumatanggap, hindi ang mismong table |
Magandang ugali: magpadala ng mga identifier, hindi ng mga object o value. Pangalan ng item, numero ng pagpipilian, part na kayang hanapin at suriin ng server. Pagkatapos, sariling data na ang gamit ng server.
Bakit nagbabalik ng nil ang RemoteFunction
Kung nil ang ibinibigay sa iyo ng InvokeServer, dumaan sa mga puntong ito nang sunod-sunod:
- Path na walang ibinabalik na value. Bawat labasan mula sa
OnServerInvokeay dapat may ibinabalik. Ang walang lamangreturnsa maagang check ay nagpapadala pabalik ngnil. - return sa loob ng nested na function. Ang
returnsa loob ngpcall(function() ... end), ng:Connecthandler o ngtask.spawnay lumalabas lang sa inner function na iyon. I-save ang resulta, halimbawalocal ok, data = pcall(...), saka ibalik angdatamula sa callback mismo. - Value na hindi makakatawid sa hangganan. Dumarating bilang
nilang function o Instance na hindi nakikita ng client (halimbawa, kahit ano sa ServerStorage). Kapag naka-on ang instance streaming, ang part na kagagawa lang ng server ay puwedeng hindi pa nakakarating sa client sa sandaling bumalik ang function. - Ibang script ang nag-set ng callback. Ang huling assignment lang ng
OnServerInvokeang gumagana. Hanapin ang pangalan ng remote sa mga script mo.
Kung hindi talaga bumabalik ang tawag, ibig sabihin ay wala pang script na nag-set ng OnServerInvoke (hinahawakan ng Roblox ang mga tawag sa queue hanggang ma-set ito), o nakabitin ang callback, halimbawa sa WaitForChild para sa bagay na hindi kailanman lalabas.
UnreliableRemoteEvent: para sa tuloy-tuloy na one-time na update
Pareho ang mga method at event ng UnreliableRemoteEvent at ng RemoteEvent: FireServer, FireClient, FireAllClients, OnServerEvent at OnClientEvent. Ang pagkakaiba ay hindi ginagarantiya ng Roblox ang delivery o ang pagkakasunod. Puwedeng itapon ang message nang walang muling pagpapadala kapag:
- nawala ito sa daan o masyadong matagal na naghintay sa siksik na network
- higit sa 1000 byte ang data nito
- nagpapadala ang client nang mas madalas sa limit (itinatapon ang sobra, hindi ipinagpapaliban)
- walang nakakonektang handler sa sandaling dumating ito (itinatapon ito, hindi inilalagay sa queue)
Puwede ring dumating ang mga message nang hindi sunod-sunod, at walang kaugnayan ang pagkakasunod nila sa mga RemoteEvent o RemoteFunction mo. Gamitin ito kapag ang pinakabagong value lang ang mahalaga at darating ang susunod na update sa loob ng isang bahagi ng segundo: kung saan nakatutok ang player, posisyon ng cosmetic na effect, value na nagbabago bawat frame. Kung mahalaga ang pagkakasunod, maglagay sa bawat message ng sequence number o timestamp at balewalain ang lahat ng mas luma kaysa sa huling naproseso.
Huwag kailanman gamitin ito para sa bagay na dapat mangyari nang eksaktong isang beses, halimbawa pagbili, damage, reward o pagsisimula ng round. At suriin ang mga argument nito sa server nang eksaktong gaya ng sa RemoteEvent.
Pagkakasunod ng delivery at mga limit sa dalas
Ang mga garantiya ng delivery ng Roblox ay para sa iisang koneksyon sa iisang direksyon: mula server papunta sa isang client, o mula sa isang client papuntang server.
- Maaasahan at sunod-sunod ang mga RemoteEvent. Muling ipinapadala ang mga nawalang message habang nakakonekta pa ang tumatanggap, at dumarating ang mga message sa pagkakasunod na ipinadala mo, kahit sa iba't ibang RemoteEvent. Kung nagpadala ang server sa isang player ng A, tapos B, tapos A, matatanggap ng player na iyon ang A, B, A.
- Ang pagkakasunod ay tungkol sa sandaling tumatakbo ang mga handler. Kung nagbibigay-daan ang handler, halimbawa gamit ang
task.waitoWaitForChild, puwedeng magsimulang maproseso ang susunod na message bago matapos ang una. - Hindi sunod-sunod ang RemoteFunction at RemoteEvent sa isa't isa. Kung nakadepende ang code mo sa mahigpit na pagkakasunod, ipadala ang magkakaugnay na message sa iisang uri ng remote o magdagdag ng sarili mong sequence number.
- Hindi sunod-sunod ang mga pagbabago ng property at attribute kumpara sa mga remote. Kung binago ng server ang property tapos tumawag ng remote, puwedeng alinman sa dalawa ang unang makita ng client. Pakinggan ang pagbabago mismo, halimbawa gamit ang
GetPropertyChangedSignal, sa halip na umasang dumating na ito. - Wala pang handler. Naghihintay sa queue ang mga RemoteEvent message hanggang kumonekta ang handler. May hangganan ang queue: kapag puno na ito, itinatapon ang mga susunod na message, at lumalabas sa Output ang error na
Remote event invocation discarded. - Ang player na umaalis ay nawawalan ng lahat ng message na hindi pa nakakarating sa kanya.
Limit sa dalas. Ang mga RemoteEvent at UnreliableRemoteEvent message mula client papuntang server ay limitado sa mga 500 request kada segundo kada client, ayon sa documentation noong 30 Setyembre 2026. Iisa ang limit para sa lahat ng remote na parehong uri, kaya hindi ito tumataas kapag hinati mo ang isang abalang remote sa sampu. Lampas sa limit, pinoproseso nang mas huli ang mga RemoteEvent message at napapanatili ang pagkakasunod, at itinatapon ang mga UnreliableRemoteEvent message. Hindi pinipigilan ng limit ng engine ang iisang player na tawagin ang remote mo nang 50 beses kada segundo, kaya kailangan pa rin ng bawat handler na may binabago ang sarili nitong limit kada player.
RemoteEvent, RemoteFunction, UnreliableRemoteEvent o attribute?
| Gamitin | Para saan | Halimbawa | Ano ang dapat bantayan |
|---|---|---|---|
| RemoteEvent | One-way na message na dapat makarating, at sunod-sunod | Client: "kulayan ang part na ito". Server: "ipakita ang notification na ito" | Suriin ang bawat argument sa server |
RemoteFunction na may InvokeServer | Kailangan ng client ng sagot bago ito makatuloy | Maglagay ng promo code, kumpirmahin ang pagbili | Naghihintay ang tumawag; dapat may ibinabalik na value ang bawat path |
RemoteFunction na may InvokeClient | Halos hindi kailanman | Gamitin na lang ang FireClient | Ang client na nag-error, umalis o hindi sumagot ay sumisira o nagpapabitin sa tawag sa server |
| UnreliableRemoteEvent | Madalas na update kung saan ang huli lang ang mahalaga | Direksyon ng aim, mga cosmetic na effect | Nawawala o nagugulo ang pagkakasunod ng mga message; 1000 byte ang limit ng data |
| Attribute o value object na sine-set ng server | Shared na state na dapat palaging nakikita, kasama ng mga player na pumasok nang huli | Round timer, phase ng game, kung bukas ang pinto | Ang mga pagbabago lang ng server ang nakakarating sa lahat; nakikinig ang mga client gamit ang GetAttributeChangedSignal o Changed |
| BindableEvent | Pag-uusap ng mga script sa iisang panig | Sinasabi ng isang server script sa iba na tapos na ang round | Hindi tumatawid sa pagitan ng server at client |
Para sa buong halimbawa kung paano nagtutulungan ang RemoteFunction at mga check kung saan nagbabayad ang mga player, tingnan ang guide na paano gumawa ng shop GUI. Tungkol sa row ng mga attribute, ang server script mula sa guide sa pinto ay nagse-set ng attribute na Open sa bawat pinto sa bawat galaw nito, kaya kayang tumugon dito ng kahit anong LocalScript.
Mga karaniwang error at solusyon
Karamihan sa mga problema sa remote ay nakikita sa Output window (buksan ito sa Window menu o sa Script tab). Tingnan muna roon, saka hanapin ang sintomas mo sa ibaba. Mas detalyadong hinihimay ng guide sa mga error ng script ang mga pangkalahatang error message.
Infinite yield possible sa WaitForChild para sa remote
Naghihintay ang script ng remote na hindi kailanman lalabas. Siguraduhing eksaktong tugma ang pangalan at ang malaki at maliit na titik, at na nasa ReplicatedStorage ang remote, hindi sa ServerStorage o ServerScriptService na hindi nakikita ng mga client.
Maling value ang natatanggap ng server, usog nang isa
Ipinasa ng LocalScript ang player mismo, gaya ng sa remote:FireServer(player, 5). Idinadagdag na ng Roblox ang nagpadala bilang unang parameter, kaya nakikita ng server ang (player, player, 5). Tawagin ang remote:FireServer(5).
Walang nangyayari kapag tinatawag ko ang remote
Siguraduhing mula sa tamang panig ang bawat tawag: gumagana lang ang FireServer at InvokeServer mula sa client code, at ang FireClient, FireAllClients at InvokeClient mula lang sa server Script. Hindi kailanman tumatakbo ang LocalScript sa ServerScriptService, ServerStorage o direkta sa Workspace; ilagay ito sa StarterPlayerScripts, StarterGui, StarterCharacterScripts o StarterPack. Pagkatapos, hanapin sa Output ang error sa loob ng handler.
Remote event invocation discarded
Dumating ang mga message para sa RemoteEvent na walang nakakonektang handler, at napuno ang queue. Karaniwan, nag-e-error ang script na may handler bago ang linyang may :Connect, naka-disable ito, o nakabitin sa paghihintay sa bagay na hindi kailanman maglo-load. Ikonekta ang mga handler malapit sa simula ng script.
Gumagana sa akin, pero hindi nakikita ng ibang player ang pagbabago
Sa client ginawa ang pagbabago, sa LocalScript o sa OnClientEvent handler. Gawin ito sa server handler na OnServerEvent.
Hindi kailanman bumabalik ang InvokeServer
Alinman sa walang script na nag-set ng OnServerInvoke (hinahawakan ng Roblox ang mga tawag sa queue hanggang ma-set ito), o nakabitin ang callback sa bagay na nagbibigay-daan, halimbawa sa WaitForChild o sa request sa DataStore. Magdagdag ng print sa simula at dulo ng callback para makita kung saan ito humihinto.
Gawin gamit ang RoCode
Kaya rin itong i-set up ng RoCode, mismo sa place na bukas mo. Ang RoCode ay isang AI agent na gumagana sa pamamagitan ng plugin para sa Roblox Studio, kaya gumagawa ito ng mga remote at script sa Explorer mo, hindi nagbibigay ng code na kailangan mo pang i-paste.
Hayaang kulayan ng mga player ang mga part sa Paintable folder sa pamamagitan ng click. Gumamit ng RemoteEvent at iwan ang mga check sa server: mga part lang mula sa folder na ito, hindi lalayo sa 30 stud at hindi hihigit sa ilang pagkulay kada segundo.
- Karaniwang tinitingnan muna ang place gamit ang Search Game at Search Scripts para maghanap ng existing na Remotes folder o handler, at ginagamit ang mga folder mo kung mayroon
- Gumagawa ng RemoteEvent sa ReplicatedStorage gamit ang Create Instance at sumusulat ng server Script at LocalScript gamit ang Create Script
- Bago matapos, sinusuri ang compile ng bawat script gamit ang Check Script sa loob ng Studio. Nahuhuli nito ang mga compile error, hindi ang mga mali sa logic: hindi ito nagte-type check, hindi nagpapatakbo ng linter at hindi pinapatakbo ang code mo
- Ipinapadala ang mga pagbabago nang pa-batch, at bawat batch ay undo point sa history ng Studio
Sa plugin 3.9 o mas bago, kayang magpatakbo ng RoCode ng maikling playtest at basahin ang mga error, at sa plugin 3.9.11 o mas bago ay kayang kontrolin ang isang test character, pero hindi ito nagki-click ng mga part sa 3D window. Ikaw mismo ang pumindot ng Play at subukang sirain ang mga check, halimbawa sa pagkulay ng part mula sa kabilang dulo ng map. Kung may error, kayang basahin ng Check Output ang mga linya ng Server at Client mula sa huling playtest mo. Karamihan sa mga game system ay nag-uusap sa pamamagitan ng ganitong mga remote, kaya makikita mo ulit ang mga ito kapag bumubuo ka ng game system kada system gamit ang RoCode. Paano kumokonekta ang RoCode sa Studio.
Mga madalas itanong
Ano ang ibig sabihin ng securing the client-server boundary sa Roblox?
Iyan ang pangalan ng page sa documentation ng Roblox tungkol sa security ng mga remote, at simple ang ideya: lahat ng ipinapadala ng client sa pamamagitan ng RemoteEvent o RemoteFunction ay puwedeng galing sa exploiter, kaya sinusuri ito ng server bago kumilos. Suriin ang type ng bawat argument, panatilihin ang mga numero sa makatwirang hangganan, suriin kung pinapayagan ang player na gawin ito ngayon, at limitahan kung gaano kadalas matatawag ng bawat player ang remote. Ipinapakita ng checklist ng mga check sa itaas ang bawat isa sa code.
Ligtas bang gamitin ang RemoteFunction?
Kasing-ligtas ng server callback mo ang InvokeServer: suriin ang mga argument nito at limitahan ang dalas, gaya ng sa kahit anong RemoteEvent. Ang mapanganib na direksyon ay ang InvokeClient, dahil ang client na nag-error, umalis o hindi kailanman nagbalik ng value ay sumisira o nagpapabitin sa tawag sa server.
Nakikita at natatawag ba ng mga exploiter ang mga remote ko?
Oo. Lahat ng nasa ReplicatedStorage ay nakakarating sa bawat client, at kayang tawagin ng binagong client ang kahit anong remote gamit ang kahit anong argument. Hindi nagiging ligtas ang mga remote sa pagpapalit ng pangalan o pagtatago; ang nagpapaligtas sa kanila ay ang pagsusuri sa bawat argument sa server.
Puwede bang magpadala ang isang client ng RemoteEvent sa ibang client?
Hindi nang direkta. Ipadala ito sa server, suriin doon, saka gamitin ang FireClient o FireAllClients.
Gaano kadalas puwedeng tawagin ang RemoteEvent?
Nakasaad sa documentation ng Roblox ang limit na mga 500 request kada segundo kada client para sa mga RemoteEvent at UnreliableRemoteEvent message na ipinapadala sa server, iisa para sa lahat ng remote na parehong uri. Manatiling malayo sa ilalim nito at bigyan ang bawat handler ng sariling limit kada player.
Nakakarating ba ang FireAllClients sa mga player na pumasok nang huli?
Hindi. Nakakarating ito sa mga player na nakakonekta sa sandaling iyon. Para sa state na kailangan ng mga nahuli, mag-set ng attribute o value object sa server.
Ano ang pagkakaiba ng RemoteEvent at BindableEvent?
Tumatawid ang RemoteEvent sa pagitan ng server at client. Pinagkokonekta ng BindableEvent ang mga script sa iisang panig, halimbawa dalawang server script.
Mga source at dagdag na babasahin
- Roblox Creator Docs: Remote events and callbacks (sa English). FireServer, FireClient, InvokeServer, mga panganib ng InvokeClient, mga limitasyon ng argument at mga garantiya ng delivery
- Roblox Creator Docs: Securing the client-server boundary (sa English). Mga antas ng check, NaN, mga limit sa dalas, pagpapasa mula client papunta sa client
- Roblox Creator Docs: Security and cheat mitigation tactics (sa English). Ano ang kaya ng binagong client at ang authority ng server
- Roblox Creator Docs: Network ownership, movement validation, and physics (sa English). Bakit kinokontrol ng client ang character niya at ang mga hangganan ng distance check
- Roblox Engine API: RemoteEvent (sa English). Limit sa dalas at ang error na invocation discarded
- Roblox Engine API: RemoteFunction (sa English). OnServerInvoke, mga babala tungkol sa InvokeClient at mga pag-iingat sa streaming
- Roblox Engine API: UnreliableRemoteEvent (sa English). Limit ng data na 1000 byte
- Roblox Creator Docs: Properties and attributes (sa English). Pagkakasunod ng replication sa pagitan ng mga pagbabago ng property at mga remote event
Paano sinuri ang code: bawat script sa page na ito ay dumaan sa strict Luau type check gamit ang mga definition ng Roblox API (luau-lsp, Nobyembre 20, 2026). Nahuhuli ng type check ang maling pangalan ng API at maling type, pero hindi ang mga mali sa game logic, kaya i-test muna ang lahat sa Studio bago mag-publish.