Коротко
RemoteEvent це об'єкт, який зазвичай лежить у ReplicatedStorage і передає повідомлення через межу між клієнтом і сервером. LocalScript викликає FireServer, і сервер отримує повідомлення в OnServerEvent, де першим аргументом додано Player, який його надіслав. Сервер викликає FireClient(player, ...) або FireAllClients(...), і LocalScript отримують повідомлення в OnClientEvent.
- Використовуйте RemoteFunction (
InvokeServerіOnServerInvoke), лише коли клієнту потрібна відповідь. УникайтеInvokeClient: клієнт, у якого сталася помилка, який вийшов або так і не повернув значення, ламає виклик на сервері. - Ніколи не довіряйте тому, що надсилає клієнт. На сервері перевіряйте тип, діапазон і належність кожного аргументу, відстань до гравця і те, як часто він викликає ремоут.
- Функції, метатаблиці та об'єкти, яких не бачить інша сторона, не переживають пересилання. UnreliableRemoteEvent може губити повідомлення або змінювати їхній порядок і відкидає будь-які дані, більші за 1000 байтів.
На цій сторінці
Навіщо потрібні RemoteEvent
Будь-яка гра Roblox працює як один сервер плюс по одному клієнту на кожного гравця. Сервер тут головний: новий об'єкт або зміна властивості доходить до всіх гравців, тільки коли її робить сервер. Зміна, зроблена в LocalScript, залишається на одному пристрої, за небагатьма винятками на кшталт власного персонажа гравця, рухом якого керує його клієнт. Тому, коли клік або натискання клавіші мають змінити спільний світ, клієнт повинен попросити сервер, а коли сервер хоче, щоб відреагував екран одного гравця, він повинен повідомити про це клієнту. Якщо поділ на Script і LocalScript для вас новий, спершу прочитайте Script vs LocalScript vs ModuleScript (англійською). Якщо новий сам скриптинг, почніть із того, як писати скрипти в Roblox Studio.
Для перетину цієї межі Roblox дає три об'єкти:
- RemoteEvent: повідомлення в один бік. Відправник одразу продовжує роботу.
- RemoteFunction: запит, який чекає на відповідь. Код, що викликав, стоїть на паузі, поки інша сторона не поверне значення.
- UnreliableRemoteEvent: повідомлення в один бік, яке може загубитися або прийти не по черзі, зате менше навантажує мережу. Підходить для даних, які змінюються постійно.
| Напрямок | Відправник викликає | Отримувач підключається до | Отримувач отримує |
|---|---|---|---|
| Від клієнта до сервера | remote:FireServer(...) у LocalScript | remote.OnServerEvent у Script | Player, який надіслав повідомлення, потім ваші аргументи |
| Від сервера одному клієнту | remote:FireClient(player, ...) у Script | remote.OnClientEvent у LocalScript | Лише ваші аргументи |
| Від сервера всім клієнтам | remote:FireAllClients(...) у Script | remote.OnClientEvent у LocalScript | Лише ваші аргументи |
| Клієнт питає, сервер відповідає | remoteFunction:InvokeServer(...) | remoteFunction.OnServerInvoke = function(player, ...) | Player, потім ваші аргументи. Код, що викликав, отримує те, що повернула функція |
Клієнти не можуть надсилати повідомлення одне одному напряму. Щоб передати щось від одного гравця решті, надішліть це на сервер, перевірте там, і нехай сервер перешле далі через FireClient або FireAllClients. За рекомендаціями Roblox щодо безпеки сервер тут працює як вартовий, а не як простий ретранслятор.
Де зберігати ремоути
Ремоут має лежати там, де його бачать і сервер, і клієнти. Звичайне місце це ReplicatedStorage; у документації Roblox зазначено, що в деяких випадках підійдуть також Workspace або Tool. ServerStorage і ServerScriptService доступні лише серверу, тому LocalScript, який чекає на ремоут звідти, чекатиме вічно.
- В Explorer наведіть курсор на ReplicatedStorage, натисніть кнопку + і вставте Folder. Назвіть папку
Remotes. - Наведіть курсор на
Remotes, натисніть + і вставте RemoteEvent. Перейменуйте його так, щоб ім'я описувало призначення, наприкладPaintRequest. - Повторіть для кожного ремоута. У цьому гайді використовуються два RemoteEvent (
PaintRequestіNotify) та одна 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
Скрипти в цьому гайді знаходять ремоути через WaitForChild. Він повертає результат одразу, якщо ремоут уже на місці, і чекає, якщо його ще немає, наприклад коли серверний скрипт створює ремоути під час гри. Заводьте окремий ремоут на кожен вид запиту: тоді кожен серверний обробник перевіряє одну форму аргументів, і зробити це правильно набагато простіше, ніж з одним ремоутом на всі випадки.
Схема 1: від клієнта до сервера, з перевіркою на сервері
Найчастіше завдання: гравець щось робить на своєму екрані, а сервер вирішує, що станеться. Тут гравець натискає Q, щоб вибрати один із чотирьох кольорів, і клікає або тапає по парту, щоб його пофарбувати. Новий колір бачать усі, бо фарбує сервер.
Клієнт надсилає дві речі: який парт і номер кольору. Сам колір він не надсилає ніколи, і в інших іграх він так само не повинен надсилати ціну, нагороду чи розмір шкоди. Модифікований клієнт може надіслати що завгодно, тому справжні дані (тут це палітра) зберігає сервер, а аргументи він сприймає як запит, який треба перевірити.
- У Workspace вставте Folder з іменем
Paintableі покладіть у нього кілька заанкерених Part. - Перевірте, що в
ReplicatedStorage.Remotesє RemoteEvent з іменемPaintRequest. - Вставте Script з іменем
PaintServerу ServerScriptService і LocalScript з іменемPaintClientу StarterPlayer, StarterPlayerScripts, з кодом нижче.
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")
-- Кольори належать серверу. Клієнт надсилає лише номер, який вибирає один із них.
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 -- стадів між персонажем і партом
local COOLDOWN_SECONDS = 0.25
local lastPaint: { [Player]: number } = {}
-- Перший параметр це завжди гравець, який викликав ремоут. Його підставляє Roblox,
-- тому йому можна довіряти. Усе, що після нього, прийшло від клієнта, і цьому довіряти не можна.
paintRequest.OnServerEvent:Connect(function(player: Player, part: unknown, colourIndex: unknown)
-- 1. Тип: справжній парт, а не таблиця, яка ним прикидається
if typeof(part) ~= "Instance" or not part:IsA("BasePart") then
return
end
-- 2. Діапазон: ціле число від 1 до 4. NaN і нескінченність теж відсіюються тут.
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. Дозволена ціль: лише парти в папці Paintable, нічого іншого в грі
if not part:IsDescendantOf(paintable) then
return
end
-- 4. Відстань: персонаж гравця має бути поруч із партом
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. Ліміт частоти: одне фарбування на гравця раз на чверть секунди
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)
Кожна непройдена перевірка просто робить return. Пояснювати чит-клієнту, чому йому відмовили, нема чого.
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 -- справжні кольори зберігає сервер
local selectedColour = 1
-- Промінь може влучати лише в парти всередині папки 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 -- клавіша або клік пішли в чат або на кнопку
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
-- Просимо, а не наказуємо: фарбувати чи ні, вирішує сервер
paintRequest:FireServer(result.Instance, selectedColour)
end
end
end)
gameProcessed дорівнює true, коли рушій уже обробив цей ввід, зазвичай в інтерфейсі: клік по кнопці або клавіші, набрані в текстовому полі на кшталт рядка чату. Завдяки цій перевірці літера Q, набрана в повідомленні, не змінює колір.
Схема 2: від сервера одному клієнту
Сервер надсилає повідомлення одному гравцю через FireClient. Перший аргумент це Player, якому воно адресоване, а обробник на клієнті отримує лише аргументи після нього. Використовуйте це для всього особистого: сповіщення, вікно з нагородою, звук, який має чути лише цей гравець. Гайд з катсцен це більший розібраний приклад: сервер вирішує, коли гравець побачить катсцену, і надсилає її кадри цьому одному гравцю через FireClient, а камеру рухає його пристрій.
Ця пара скриптів показує привітання, коли гравець заходить. LocalScript сам збирає невеликий банер, тому налаштовувати GUI не потрібно.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local function welcome(player: Player)
-- Перший аргумент вибирає, який клієнт отримає повідомлення. Більше його ніхто не побачить.
notify:FireClient(player, `Welcome, {player.DisplayName}! Press Q to change colour.`)
end
Players.PlayerAdded:Connect(welcome)
-- У Studio можна зайти раніше, ніж цей скрипт підключиться, тому вітаємо всіх, хто вже тут
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
-- Невеликий банер угорі екрана, зібраний у коді
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
-- Тут немає параметра player: сервер уже вибрав, хто отримає повідомлення
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 -- ховаємо, якщо його не замінило новіше повідомлення
label.Visible = false
end
end)
end)
Сервер надсилає повідомлення за PlayerAdded, а це може статися раніше, ніж цей LocalScript підключить свій обробник. Це нормально: Roblox ставить у чергу повідомлення RemoteEvent, що прийшли до появи обробника, і доставляє їх по черзі, щойно обробник підключиться.
Клієнту не потрібно захищатися від сервера: викликати OnClientEvent може лише серверний код. Анотація message: string потрібна для перевірки типів; це не перевірка під час виконання.
Схема 3: від сервера всім клієнтам
FireAllClients надсилає те саме повідомлення кожному підключеному гравцю. У нього немає аргументу Player, і кожен клієнт отримує повідомлення в тому ж OnClientEvent, що й раніше, тому скрипт NotifyClient зі схеми 2 вже його показує.
Цей Script оголошує всім, коли гравець уперше торкається фінішної лінії. Додайте у Workspace заанкерений Part з іменем FinishLine, потім додайте Script у 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 -- не гравець або вже оголошений
end
finished[player] = true
-- Кожен підключений клієнт запускає свій обробник OnClientEvent з цим текстом
notify:FireAllClients(`{player.DisplayName} reached the finish!`)
end)
Players.PlayerRemoving:Connect(function(player: Player)
finished[player] = nil
end)
Експлойтер може викликати Touched для свого персонажа з будь-якої відстані, але для оголошення, яке показується один раз на гравця, це нешкідливо. Якщо пізніше ви даватимете нагороду за фініш, додайте серверні перевірки перед видачею, наприклад мінімальний час від початку раунду.
FireAllClients доходить лише до гравців, підключених у цей момент. Той, хто зайде секундою пізніше, повідомлення вже не побачить. Це підходить для разових моментів, як-от оголошення, ефект вибуху чи звук, але не підходить для стану на кшталт таймера раунду або поточної фази гри. Для стану задайте на сервері атрибут, наприклад ReplicatedStorage:SetAttribute("TimeLeft", 30), і читайте його на клієнті через GetAttribute і GetAttributeChangedSignal("TimeLeft"). Атрибути реплікуються кожному клієнту, зокрема гравцям, які зайшли пізніше.
RemoteFunction: коли клієнту потрібна відповідь
RemoteEvent працює за принципом «надіслав і забув». RemoteFunction змушує код, що викликав, чекати: InvokeServer ставить на паузу код, який його викликав, поки серверна функція OnServerInvoke не поверне значення, і потім віддає те, що вона повернула. Використовуйте її, коли клієнт не може продовжувати без відповіді, наприклад «чи був цей код правильним?». Коли відповідь не потрібна, Roblox радить RemoteEvent, бо він не чекає.
Приклад: поле, куди гравці вводять промокод. Сервер зберігає коди, перевіряє текст і повертає два значення: чи спрацювало і повідомлення, яке треба показати.
- У
ReplicatedStorage.Remotesвставте RemoteFunction з іменемRedeemCode. - У StarterGui вставте ScreenGui з іменем
CodeGui, а всередину нього TextBox з іменемCodeBox. Розмір і місце виберіть на свій смак. - Додайте Script нижче в ServerScriptService, а LocalScript всередину
CodeBox.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local redeemCode = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("RedeemCode") :: RemoteFunction
-- Коди живуть на сервері, де жоден гравець не може їх прочитати
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 } = {}
-- Присвоюємо через =. OnServerInvoke це колбек, а не подія, до якої роблять 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)
Він додає до показника Coins з гайду з таблиці лідерів. Використані коди запам'ятовуються лише до виходу гравця, тому в такому вигляді гравець може перезайти й ввести той самий код знову. Якщо монети зберігаються, це безкоштовні монети при кожному перезаході: перш ніж використовувати це в живій грі, зберігайте використані коди кожного гравця разом із його збереженими даними в сховищі даних.
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 ставить цю функцію на паузу, поки колбек сервера не поверне значення.
-- pcall не дає LocalScript зупинитися, якщо виклик не вдався.
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 рівно один серверний колбек. Якщо два скрипти задають OnServerInvoke для однієї й тієї ж RemoteFunction, працює лише останній.
Чим небезпечний InvokeClient
RemoteFunction працює і в зворотний бік, з InvokeClient на сервері та OnClientInvoke на клієнті. Документація Roblox перелічує три серйозні ризики:
- Якщо колбек клієнта видає помилку, сервер теж видає помилку.
- Якщо гравець виходить під час виклику,
InvokeClientвидає помилку. - Якщо клієнт так і не поверне значення, серверний скрипт чекатиме вічно.
Модифікований клієнт керує своїм колбеком, тому читер може навмисно влаштувати третій випадок і тримати цей серверний потік скільки захоче. Щоб оновити екран гравця, використовуйте FireClient. Якщо серверу справді потрібна інформація від клієнта, надішліть RemoteEvent, нехай клієнт відповість через інший RemoteEvent, а відсутність відповіді вважайте на сервері звичайним випадком.
Перевіряйте кожен аргумент на сервері
Експлойтер може викликати будь-який RemoteEvent або будь-яку RemoteFunction скільки завгодно разів і з будь-якими аргументами. Єдине, чого він не може підробити, це перший параметр: Roblox сам підставляє Player, який надіслав повідомлення. Усе, що йде після, треба перевірити, перш ніж сервер почне діяти. Ховати ремоут або перевіряти в LocalScript марно, бо читер керує своїм клієнтом.
| Перевірка | Питання, яке ставить сервер | Приклад |
|---|---|---|
| Тип | Це той тип, на який я чекаю? Instance, а не таблиця, зібрана так, щоб бути на нього схожою? | typeof(part) == "Instance" and part:IsA("BasePart") |
| Діапазон | Число скінченне й лежить у допустимих межах? У тексту розумна довжина? | math.isfinite(n), n >= 1 and n <= 4, #text <= 20 |
| Належність | Цей гравець володіє предметом, у нього вистачає грошей, у нього є право діяти з цим об'єктом? | Предмет є в його інвентарі; парт лежить усередині Paintable |
| Відстань | Чи достатньо близько персонаж гравця в серверній копії світу? Залиште невеликий запас на лаги. | Не далі 30 стадів від парта |
| Частота | Чи не надто часто цей гравець надсилає? | Кулдаун на гравця або ліміт із накопиченням викликів |
NaN заслуговує на окреме попередження. Це число, тому type(x) == "number" проходить, але будь-яке порівняння з ним дає false, і перевірка на кшталт x < 0 or x > 100 пропускає його наскрізь. math.isfinite(x) відхиляє NaN і обидві нескінченності.
Пам'ятайте про межу перевірки відстані. Кожен клієнт керує фізикою свого персонажа, тому експлойтер може перед викликом перемістити персонажа до цілі. Перевірка все одно зупиняє найпростіше зловживання, коли з одного місця діють на всю карту. Тримайте парти-цілі заанкереними: у документації Roblox з безпеки зазначено, що експлойтер може отримати мережеве володіння незаанкереними партами поруч із собою і підтягнути їх ближче, а це обходить перевірку відстані.
Ось ті самі перевірки у вигляді ModuleScript, який можна використовувати в кожному обробнику ремоута.
local Players = game:GetService("Players")
local RemoteGuard = {}
-- Справжнє число між min і max. Відхиляє NaN і нескінченність, які проходять
-- звичайну перевірку 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
-- Ціле число між min і max, для кількостей, індексів і лічильників
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
-- Текст з обмеженням довжини. utf8.len повертає nil для невалідного UTF-8, який
-- сховища даних відхиляють.
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 очікуваного класу всередині контейнера, який ви дозволили.
-- Таблиця, зібрана так, щоб бути схожою на Instance, не проходить перевірку 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, коли персонаж гравця перебуває не далі maxDistance стадів від 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
-- Ліміт частоти на гравця. Кожен гравець може зробити `burst` викликів одразу і
-- отримує назад `perSecond` викликів щосекунди. Повертає функцію, яку викликають
-- перед роботою: вона відповідає true (можна) або false (надто часто).
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
Тримайте його в ServerScriptService. Код звідти ніколи не потрапляє на клієнти, тому ніхто не прочитає ваші перевірки.
А ось обробник зі схеми 1, переписаний з його допомогою. Замініть вміст PaintServer:
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerScriptService = game:GetService("ServerScriptService")
-- ":: any" важливо лише для строгої перевірки типів Luau; під час виконання це нічого не змінює
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) -- пачка з 4, потім 4 на секунду
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)
Лімітер видаляє запис гравця, коли той виходить, тому його таблиця не росте весь час життя сервера.
У зброї ці перевірки найважливіші: ніколи не дозволяйте клієнту повідомляти, в кого влучили. Ремоут з гайду з меча взагалі не несе аргументів, і сервер знаходить цілі сам. Гайд зі зброї надсилає лише точку прицілювання, яку сервер перевіряє на тип, NaN і відстань, перш ніж пустити власний промінь.
Меню підкоряються тому самому правилу: надсилайте вибір, а не результат. У гайді з діалогів з NPC клієнт надсилає лише номер натиснутої кнопки, а сервер сам дивиться, що дає ця відповідь. Меню з гайду з телепортів надсилає ім'я точки, а не позицію, і сервер знаходить точку у своїй папці й перевіряє, скільки Wins для неї потрібно.
Що можна і що не можна надсилати
Можна передавати числа, рядки, булеві значення, типи Roblox, як-от Vector3, CFrame, Color3 і елементи Enum, Instance, які бачать обидві сторони, і таблиці з усього цього. Деякі значення дорогою змінюються або зникають:
| Ви надсилаєте | Що відбувається |
|---|---|
| Функцію | Інша сторона отримує nil |
| Таблицю з метатаблицею | Метатаблиця губиться разом з усім, що таблиця мала лише через неї |
| Таблицю, де змішані числові й рядкові ключі | Roblox радить так не робити: надсилайте чистий масив або чистий словник |
Таблицю зі значеннями nil усередині | Уникайте: Roblox не радить nil за жодним індексом |
| Таблицю з ключами типу Instance, userdata або function | Такі ключі перетворюються на рядки |
| Instance, який отримувач не бачить, наприклад з ServerStorage або створений у LocalScript | Інша сторона отримує nil |
| Будь-яку таблицю | Отримувач отримує копію, а не ту саму таблицю |
Добра звичка: надсилати ідентифікатори, а не об'єкти чи значення. Ім'я предмета, номер варіанта, парт, який сервер може знайти й перевірити. Далі сервер працює зі своїми даними.
Чому RemoteFunction повертає nil
Якщо InvokeServer віддає вам nil, пройдіть ці пункти по черзі:
- Шлях без значення, що повертається. Кожен вихід з
OnServerInvokeмає щось повертати. Порожнійreturnу ранній перевірці надсилає назадnil. - return усередині вкладеної функції.
returnусерединіpcall(function() ... end), обробника:Connectабоtask.spawnвиходить лише з цієї внутрішньої функції. Збережіть результат, наприкладlocal ok, data = pcall(...), і потім повернітьdataіз самого колбека. - Значення, яке не може перетнути межу. Функція або Instance, якого клієнт не бачить (наприклад, будь-що в ServerStorage), приходить як
nil. З увімкненим instance streaming парт, який сервер щойно створив, міг ще не дійти до клієнта на момент повернення з функції. - Колбек задав інший скрипт. Працює лише останнє присвоєння
OnServerInvoke. Пошукайте ім'я ремоута у своїх скриптах.
Якщо виклик узагалі не повертається, значить, жоден скрипт ще не задав OnServerInvoke (Roblox тримає виклики в черзі, поки його не зададуть) або колбек завис, наприклад на WaitForChild для того, що ніколи не з'явиться.
UnreliableRemoteEvent: для постійних одноразових оновлень
UnreliableRemoteEvent має ті самі методи й події, що й RemoteEvent: FireServer, FireClient, FireAllClients, OnServerEvent і OnClientEvent. Різниця в тому, що Roblox не гарантує ні доставки, ні порядку. Повідомлення може бути відкинуте без повторного надсилання, коли:
- воно губиться дорогою або надто довго чекає в перевантаженій мережі
- його дані більші за 1000 байтів
- клієнт надсилає частіше за ліміт (зайве відкидається, а не відкладається)
- на момент приходу не підключено жодного обробника (воно викидається, а не ставиться в чергу)
Повідомлення можуть приходити й не по черзі, і їхній порядок ніяк не пов'язаний з вашими RemoteEvent чи RemoteFunction. Використовуйте його, коли важливе лише найсвіжіше значення, а наступне оновлення прийде за частку секунди: куди цілиться гравець, позиція косметичного ефекту, значення, яке змінюється щокадру. Якщо порядок важливий, кладіть у кожне повідомлення порядковий номер або мітку часу й ігноруйте все, що старіше за останнє оброблене.
Ніколи не використовуйте його для того, що має статися рівно один раз, наприклад для покупки, шкоди, нагороди чи старту раунду. І перевіряйте його аргументи на сервері так само, як у RemoteEvent.
Порядок доставки й ліміти частоти
Гарантії доставки Roblox стосуються одного з'єднання в одному напрямку: від сервера до одного клієнта або від одного клієнта до сервера.
- RemoteEvent надійні й упорядковані. Загублені повідомлення надсилаються повторно, поки отримувач залишається на зв'язку, і повідомлення приходять у тому порядку, в якому ви їх надіслали, навіть через різні RemoteEvent. Якщо сервер надсилає гравцю A, потім B, потім A, цей гравець отримує A, B, A.
- Порядок стосується моменту запуску обробників. Якщо обробник поступається керуванням, наприклад через
task.waitабоWaitForChild, наступне повідомлення може почати оброблятися раніше, ніж завершиться перше. - RemoteFunction і RemoteEvent не впорядковані одне відносно одного. Якщо ваш код залежить від суворого порядку, надсилайте пов'язані повідомлення через один тип ремоута або додайте свій порядковий номер.
- Зміни властивостей і атрибутів не впорядковані відносно ремоутів. Якщо сервер змінює властивість і потім викликає ремоут, клієнт може першим побачити будь-що з двох. Слухайте саму зміну, наприклад через
GetPropertyChangedSignal, а не розраховуйте, що вона вже прийшла. - Обробника ще немає. Повідомлення RemoteEvent стоять у черзі, поки не підключиться обробник. У черги є межі: коли вона заповнена, наступні повідомлення відкидаються, а в Output з'являється помилка
Remote event invocation discarded. - Гравець, який виходить, втрачає всі повідомлення, які ще не встигли до нього дійти.
Ліміт частоти. Повідомлення RemoteEvent і UnreliableRemoteEvent від клієнта до сервера обмежені приблизно 500 запитами на секунду на клієнта, за документацією на 30 вересня 2026. Ліміт спільний для всіх ремоутів одного типу, тому поділ одного завантаженого ремоута на десять його не піднімає. Понад ліміт повідомлення RemoteEvent обробляються пізніше й зберігають порядок, а повідомлення UnreliableRemoteEvent відкидаються. Ліміт рушія ніяк не заважає одному гравцю викликати ваш ремоут 50 разів на секунду, тому кожному обробнику, який щось змінює, все одно потрібен свій ліміт на гравця.
RemoteEvent, RemoteFunction, UnreliableRemoteEvent чи атрибут?
| Використовуйте | Для чого | Приклад | На що звернути увагу |
|---|---|---|---|
| RemoteEvent | Повідомлення в один бік, які мають дійти, і по черзі | Клієнт: «пофарбуй цей парт». Сервер: «покажи це сповіщення» | Перевіряйте кожен аргумент на сервері |
RemoteFunction з InvokeServer | Клієнту потрібна відповідь, перш ніж він зможе продовжити | Ввести промокод, підтвердити покупку | Код, що викликав, чекає; кожен шлях має повертати значення |
RemoteFunction з InvokeClient | Майже ніколи | Використовуйте натомість FireClient | Клієнт, у якого помилка, який вийшов або не відповів, ламає або підвішує виклик на сервері |
| UnreliableRemoteEvent | Часті оновлення, де важливе лише останнє | Напрямок прицілу, косметичні ефекти | Повідомлення губляться або змінюють порядок; ліміт даних 1000 байтів |
| Атрибут або value-об'єкт, заданий сервером | Спільний стан, який має бути видно завжди, зокрема гравцям, які зайшли пізніше | Таймер раунду, фаза гри, чи відчинені двері | До всіх доходять лише зміни сервера; клієнти слухають через GetAttributeChangedSignal або Changed |
| BindableEvent | Спілкування скриптів на одній стороні | Один серверний скрипт повідомляє іншому, що раунд закінчився | Не переходить між сервером і клієнтом |
Повний приклад того, як RemoteFunction і перевірки працюють разом там, де гравці платять, дивіться в гайді як зробити GUI магазину. Що стосується рядка про атрибути, серверний скрипт з гайду з дверей виставляє атрибут Open на кожних дверях при кожному їхньому русі, тож на нього може реагувати будь-який LocalScript.
Поширені помилки та рішення
Більшість проблем з ремоутами видно у вікні Output (відкрийте його з меню Window або з вкладки Script). Спершу загляньте туди, потім знайдіть свій симптом нижче. Гайд з помилок скриптів докладніше розбирає загальні повідомлення про помилки.
Infinite yield possible на WaitForChild для ремоута
Скрипт чекає на ремоут, який ніколи не з'явиться. Перевірте, що ім'я та регістр літер збігаються точно і що ремоут лежить у ReplicatedStorage, а не в ServerStorage чи ServerScriptService, яких клієнти не бачать.
Сервер отримує не ті значення, зі зсувом на одне
LocalScript передав самого гравця, як у remote:FireServer(player, 5). Roblox і так додає відправника першим параметром, тому сервер бачить (player, player, 5). Викликайте remote:FireServer(5).
Нічого не відбувається, коли я викликаю ремоут
Перевірте, що кожен виклик іде з правильного боку: FireServer і InvokeServer працюють лише з клієнтського коду, а FireClient, FireAllClients і InvokeClient лише із серверного Script. LocalScript ніколи не запускається в ServerScriptService, ServerStorage чи прямо у Workspace; кладіть його в StarterPlayerScripts, StarterGui, StarterCharacterScripts або StarterPack. Потім пошукайте в Output помилку всередині обробника.
Remote event invocation discarded
Повідомлення прийшли для RemoteEvent, у якого не було підключеного обробника, і черга заповнилася. Зазвичай скрипт з обробником падає з помилкою до рядка з :Connect, вимкнений або завис в очікуванні того, що ніколи не завантажиться. Підключайте обробники ближче до початку скрипта.
У мене працює, але інші гравці не бачать зміни
Зміну зроблено на клієнті, у LocalScript або в обробнику OnClientEvent. Робіть її в серверному обробнику OnServerEvent.
InvokeServer ніколи не повертається
Або жоден скрипт не задав OnServerInvoke (Roblox тримає виклики в черзі, поки його не зададуть), або колбек завис на чомусь, що поступається керуванням, наприклад на WaitForChild чи запиті до сховища даних. Додайте print на початок і в кінець колбека, щоб побачити, де він зупиняється.
Зробити з RoCode
Це може налаштувати й RoCode, просто у відкритому у вас плейсі. RoCode це ШІ-агент, який працює через плагін для Roblox Studio, тому він створює ремоути та скрипти у вашому Explorer, а не видає код, який треба вставляти.
Нехай гравці фарбують парти в папці Paintable кліком. Використай RemoteEvent і залиш перевірки на сервері: лише парти з цієї папки, не далі 30 стадів і не більше кількох фарбувань на секунду.
- Зазвичай спершу переглядає плейс через Search Game і Search Scripts у пошуках готової папки Remotes або обробника й використовує ваші папки, якщо вони є
- Створює RemoteEvent у ReplicatedStorage через Create Instance і пише серверний Script та LocalScript через Create Script
- Перед завершенням перевіряє компіляцію кожного скрипта через Check Script усередині Studio. Це ловить помилки компіляції, а не помилки логіки: він не перевіряє типи, не запускає лінтер і не виконує ваш код
- Надсилає зміни пачками, і кожна пачка це точка скасування в історії Studio
З плагіном 3.9 або новішим RoCode може запустити короткий плейтест і прочитати помилки, а з плагіном 3.9.11 або новішим може керувати тестовим персонажем, але по партах у 3D-вікні він не клікає. Натисніть Play самі й спробуйте зламати перевірки, наприклад пофарбувавши парт з іншого кінця карти. Якщо виникла помилка, Check Output може прочитати рядки Server і Client з вашого останнього плейтесту. Більшість ігрових систем спілкуються через такі ремоути, тому вони трапляться знову, коли ви збиратимете гру система за системою з RoCode. Як RoCode підключається до Studio.
Поширені запитання
Що означає securing the client-server boundary в Roblox?
Так називається сторінка документації Roblox про безпеку ремоутів, і ідея проста: усе, що клієнт надсилає через RemoteEvent або RemoteFunction, може йти від експлойтера, тому сервер перевіряє це, перш ніж діяти. Перевіряйте тип кожного аргументу, тримайте числа в розумних межах, перевіряйте, що гравцю зараз дозволено це робити, і обмежуйте, як часто кожен гравець може викликати ремоут. Чек-лист перевірок вище показує кожну з них у коді.
Чи безпечно використовувати RemoteFunction?
InvokeServer безпечний настільки, наскільки безпечний ваш серверний колбек: перевіряйте його аргументи й обмежуйте частоту, як у будь-якого RemoteEvent. Ризиковий напрямок це InvokeClient, бо клієнт, у якого помилка, який вийшов або ніколи не повернув значення, ламає або підвішує виклик на сервері.
Чи можуть експлойтери бачити й викликати мої ремоути?
Так. Усе, що лежить у ReplicatedStorage, доходить до кожного клієнта, а модифікований клієнт може викликати будь-який ремоут з будь-якими аргументами. Перейменування чи приховування ремоутів не робить їх безпечними; безпечними їх робить перевірка кожного аргументу на сервері.
Чи може один клієнт надіслати RemoteEvent іншому клієнту?
Напряму ні. Надішліть його на сервер, перевірте там, потім використайте FireClient або FireAllClients.
Як часто можна викликати RemoteEvent?
У документації Roblox вказано ліміт приблизно в 500 запитів на секунду на клієнта для повідомлень RemoteEvent і UnreliableRemoteEvent, надісланих на сервер, спільний для всіх ремоутів одного типу. Тримайтеся значно нижче за нього й дайте кожному обробнику свій ліміт на гравця.
Чи доходить FireAllClients до гравців, які зайшли пізніше?
Ні. Він доходить до гравців, підключених у цей момент. Для стану, потрібного тим, хто запізнився, задайте на сервері атрибут або value-об'єкт.
У чому різниця між RemoteEvent і BindableEvent?
RemoteEvent переходить між сервером і клієнтом. BindableEvent з'єднує скрипти на одній стороні, наприклад два серверні скрипти.
Джерела та що почитати
- Roblox Creator Docs: Remote events and callbacks (англійською). FireServer, FireClient, InvokeServer, ризики InvokeClient, обмеження аргументів і гарантії доставки
- Roblox Creator Docs: Securing the client-server boundary (англійською). Рівні перевірки, NaN, ліміти частоти, пересилання від клієнта до клієнта
- Roblox Creator Docs: Security and cheat mitigation tactics (англійською). Що може модифікований клієнт і авторитет сервера
- Roblox Creator Docs: Network ownership, movement validation, and physics (англійською). Чому клієнт керує своїм персонажем і межі перевірок відстані
- Roblox Engine API: RemoteEvent (англійською). Ліміт частоти й помилка invocation discarded
- Roblox Engine API: RemoteFunction (англійською). OnServerInvoke, попередження про InvokeClient і запобіжні заходи зі streaming
- Roblox Engine API: UnreliableRemoteEvent (англійською). Ліміт даних у 1000 байтів
- Roblox Creator Docs: Properties and attributes (англійською). Порядок реплікації між змінами властивостей і remote events
Як перевірявся код: кожен скрипт на цій сторінці проходить сувору перевірку типів Luau з визначеннями Roblox API (luau-lsp, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.