Туториал · Основы скриптинга

RemoteEvent в Roblox: от клиента к серверу и обратно

LocalScript не может изменить то, что видят другие игроки, а серверный Script не может дотянуться до экрана одного игрока. Сообщения между ними передают RemoteEvent. В этом гайде мы соберём три схемы, которые понадобятся вам чаще всего, RemoteFunction, которая возвращает ответ, и серверные проверки, которые не дают модифицированному клиенту ими злоупотреблять.

Обновлено 12 ноября 2026 г.16 мин чтенияАвтор:

Коротко

RemoteEvent это объект, который обычно лежит в ReplicatedStorage и передаёт сообщения через границу между клиентом и сервером. LocalScript вызывает FireServer, и сервер получает сообщение в OnServerEvent, где первым аргументом добавлен отправивший его Player. Сервер вызывает FireClient(player, ...) или FireAllClients(...), и LocalScript получают сообщение в OnClientEvent.

  • Используйте RemoteFunction (InvokeServer и OnServerInvoke), только когда клиенту нужен ответ. Избегайте InvokeClient: клиент, у которого случилась ошибка, который вышел или никогда не вернул значение, ломает вызов на сервере.
  • Никогда не доверяйте тому, что отправляет клиент. На сервере проверяйте тип, диапазон и принадлежность каждого аргумента, расстояние до игрока и то, как часто он вызывает ремоут.
  • Функции, метатаблицы и объекты, которых не видит другая сторона, не переживают пересылку. UnreliableRemoteEvent может терять сообщения или менять их порядок и отбрасывает любые данные больше 1000 байт.
На этой странице
  1. Зачем нужны ремоуты
  2. Настройка ремоутов
  3. 1. От клиента к серверу
  4. 2. От сервера клиенту
  5. 3. От сервера всем
  6. RemoteFunction
  7. Чек-лист проверок
  8. Что нельзя отправить
  9. Возвращает nil?
  10. UnreliableRemoteEvent
  11. Порядок и лимиты
  12. Что выбрать
  13. Common errors
  14. С RoCode
  15. Частые вопросы
  16. Источники и что почитать

Зачем нужны RemoteEvent

ИллюстрацияКаждый клик просит сервер покрасить парт, поэтому новый цвет виден на экранах обоих игроков.

Любая игра Roblox работает как один сервер плюс по одному клиенту на каждого игрока. Сервер здесь главный: новый объект или изменение свойства доходит до всех игроков, только когда его делает сервер. Изменение, сделанное в LocalScript, остаётся на одном устройстве, за немногими исключениями вроде собственного персонажа игрока, движением которого управляет его клиент. Поэтому, когда клик или нажатие клавиши должны изменить общий мир, клиент должен попросить сервер, а когда сервер хочет, чтобы отреагировал экран одного игрока, он должен сообщить об этом клиенту. Если разделение на Script и LocalScript для вас в новинку, сначала прочитайте Script vs LocalScript vs ModuleScript (на английском). Если в новинку сам скриптинг, начните с того, как писать скрипты в Roblox Studio.

Для пересечения этой границы Roblox даёт три объекта:

  • RemoteEvent: сообщение в одну сторону. Отправитель сразу продолжает работу.
  • RemoteFunction: запрос, который ждёт ответа. Вызвавший код стоит на паузе, пока другая сторона не вернёт значение.
  • UnreliableRemoteEvent: сообщение в одну сторону, которое может потеряться или прийти не по порядку, зато меньше нагружает сеть. Подходит для данных, которые меняются постоянно.
Какой вызов запускает какое событие
НаправлениеОтправитель вызываетПолучатель подключается кПолучатель получает
От клиента к серверуremote:FireServer(...) в LocalScriptremote.OnServerEvent в ScriptPlayer, который отправил сообщение, затем ваши аргументы
От сервера одному клиентуremote:FireClient(player, ...) в Scriptremote.OnClientEvent в LocalScriptТолько ваши аргументы
От сервера всем клиентамremote:FireAllClients(...) в Scriptremote.OnClientEvent в LocalScriptТолько ваши аргументы
Клиент спрашивает, сервер отвечаетremoteFunction:InvokeServer(...)remoteFunction.OnServerInvoke = function(player, ...)Player, затем ваши аргументы. Вызвавший получает то, что вернула функция

Клиенты не могут отправлять сообщения друг другу напрямую. Чтобы передать что-то от одного игрока остальным, отправьте это на сервер, проверьте там, и пусть сервер перешлёт дальше через FireClient или FireAllClients. По рекомендациям Roblox по безопасности сервер здесь работает как привратник, а не как простой ретранслятор.

Где хранить ремоуты

Ремоут должен лежать там, где его видят и сервер, и клиенты. Обычное место это ReplicatedStorage; в документации Roblox отмечено, что в некоторых случаях подойдут и Workspace или Tool. ServerStorage и ServerScriptService доступны только серверу, поэтому LocalScript, который ждёт ремоут оттуда, будет ждать вечно.

  1. В Explorer наведите курсор на ReplicatedStorage, нажмите кнопку + и вставьте Folder. Назовите папку Remotes.
  2. Наведите курсор на Remotes, нажмите + и вставьте RemoteEvent. Переименуйте его так, чтобы имя описывало назначение, например PaintRequest.
  3. Повторите для каждого ремоута. В этом гайде используются два RemoteEvent (PaintRequest и Notify) и одна RemoteFunction (RedeemCode).
Explorer: всё, что добавляет этот гайд, раздел за разделом
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, чтобы выбрать один из четырёх цветов, и кликает или тапает по парту, чтобы его покрасить. Новый цвет видят все, потому что красит сервер.

Клиент отправляет две вещи: какой парт и номер цвета. Сам цвет он не отправляет никогда, и в других играх он точно так же не должен отправлять цену, награду или размер урона. Модифицированный клиент может отправить что угодно, поэтому настоящие данные (здесь это палитра) хранит сервер, а аргументы он воспринимает как запрос, который нужно проверить.

  1. В Workspace вставьте Folder с именем Paintable и положите в неё несколько анкерных Part.
  2. Проверьте, что в ReplicatedStorage.Remotes есть RemoteEvent с именем PaintRequest.
  3. Вставьте Script с именем PaintServer в ServerScriptService и LocalScript с именем PaintClient в StarterPlayer, StarterPlayerScripts, с кодом ниже.
Script в ServerScriptService с именем PaintServer
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local remotes = ReplicatedStorage:WaitForChild("Remotes")
local paintRequest = remotes:WaitForChild("PaintRequest") :: RemoteEvent
local paintable = workspace:WaitForChild("Paintable")

-- Цвета принадлежат серверу. Клиент отправляет только номер, который выбирает один из них.
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. Объяснять читерскому клиенту, почему ему отказали, незачем.

LocalScript в StarterPlayerScripts с именем PaintClient
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")

local remotes = ReplicatedStorage:WaitForChild("Remotes")
local paintRequest = remotes:WaitForChild("PaintRequest") :: RemoteEvent
local paintable = workspace:WaitForChild("Paintable")

local COLOUR_COUNT = 4 -- настоящие цвета хранит сервер
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 не нужно.

Script в ServerScriptService с именем WelcomeServer
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
LocalScript в StarterPlayerScripts с именем NotifyClient
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.

Script в ServerScriptService с именем FinishAnnouncer
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local finishLine = workspace:WaitForChild("FinishLine") :: BasePart

local finished: { [Player]: boolean } = {}

finishLine.Touched:Connect(function(hit: BasePart)
	local character = hit:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	if not player or finished[player] then
		return -- не игрок или уже объявлен
	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, потому что он не ждёт.

Пример: поле, куда игроки вводят промокод. Сервер хранит коды, проверяет текст и возвращает два значения: сработало ли и сообщение, которое нужно показать.

  1. В ReplicatedStorage.Remotes вставьте RemoteFunction с именем RedeemCode.
  2. В StarterGui вставьте ScreenGui с именем CodeGui, а внутрь него TextBox с именем CodeBox. Размер и место выберите на свой вкус.
  3. Добавьте Script ниже в ServerScriptService, а LocalScript внутрь CodeBox.
Script в ServerScriptService с именем RedeemServer
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 из гайда по таблице лидеров. Использованные коды запоминаются только до выхода игрока, поэтому в таком виде игрок может перезайти и ввести тот же код снова. Если монеты сохраняются, это бесплатные монеты при каждом перезаходе: прежде чем использовать это в живой игре, храните использованные коды каждого игрока вместе с его сохранёнными данными в хранилище данных.

LocalScript в TextBox CodeBox с именем RedeemClient
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local redeemCode = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("RedeemCode") :: RemoteFunction
local box = script.Parent :: TextBox

local GREEN = Color3.fromRGB(46, 204, 113)
local RED = Color3.fromRGB(231, 76, 60)

box.FocusLost:Connect(function(enterPressed: boolean)
	local code = box.Text
	if not enterPressed or code == "" then
		return
	end
	box.Text = ""
	box.PlaceholderText = "Checking..."

	-- InvokeServer ставит эту функцию на паузу, пока колбэк сервера не вернёт значение.
	-- 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, который можно использовать в каждом обработчике ремоута.

ModuleScript в ServerScriptService с именем RemoteGuard
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:

Script в ServerScriptService с именем 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, пройдите по этим пунктам по порядку:

  1. Путь без возвращаемого значения. Каждый выход из OnServerInvoke должен что-то возвращать. Пустой return в ранней проверке отправляет обратно nil.
  2. return внутри вложенной функции. return внутри pcall(function() ... end), обработчика :Connect или task.spawn выходит только из этой внутренней функции. Сохраните результат, например local ok, data = pcall(...), и затем верните data из самого колбэка.
  3. Значение, которое не может пересечь границу. Функция или Instance, которого клиент не видит (например, что угодно в ServerStorage), приходит как nil. При включённом instance streaming парт, который сервер только что создал, мог ещё не дойти до клиента к моменту возврата из функции.
  4. Колбэк задал другой скрипт. Работает только последнее присваивание 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 стадов и не больше нескольких покрасок в секунду.

RoCode делает
  • Обычно сначала просматривает плейс через 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 соединяет скрипты на одной стороне, например два серверных скрипта.

Источники и что почитать

Как проверялся код: каждый скрипт на этой странице проходит строгую проверку типов Luau с определениями Roblox API (luau-lsp, 12 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.

Попробуйте RoCode в своей игре.

Бесплатные кредиты каждый день, без карты. Установите плагин, опишите функцию и проверьте, что появилось в Studio.