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

RemoteEvent у Roblox: від клієнта до сервера і назад

LocalScript не може змінити те, що бачать інші гравці, а серверний Script не може дістатися до екрана одного гравця. Повідомлення між ними передають RemoteEvent. У цьому гайді ми зберемо три схеми, які знадобляться вам найчастіше, RemoteFunction, що повертає відповідь, і серверні перевірки, які не дають модифікованому клієнту ними зловживати.

Оновлено 20 листопада 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, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.

Спробуйте RoCode у своїй грі.

Безкоштовні кредити щодня, без картки. Встановіть плагін, опишіть функцію та перевірте, що з'явилося в Studio.