Коротко
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, 12 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.