Коротко
Положите в StarterPack Tool с именем Sword и партом с именем Handle. LocalScript в Tool слушает Tool.Activated, проигрывает анимацию взмаха и вызывает RemoteEvent без аргументов. Script в ServerScriptService проверяет кулдаун и то, что игрок жив и держит меч, находит Humanoid в боксе перед ним через workspace:GetPartBoundsInBox и вызывает Humanoid:TakeDamage один раз на цель.
- Не наносите урон из события
Touchedклинка: устройство игрока управляет своим персонажем и может вызвать Touched откуда угодно, и именно меч приведён как пример на странице Roblox про network ownership. - Клиент не отправляет ни цель, ни урон. Кулдауном, хитбоксом и размером урона владеет сервер.
TakeDamageничего не делает, пока у цели есть ForceField, например первые 10 секунд после спавна на SpawnLocation.- Удары проходят сквозь стены или приходятся раньше, чем взмах визуально достаёт до цели? Возьмите версию серверного скрипта с замахом и проверкой стен.
На этой странице
Как устроен рабочий меч
Меч, который работает в настоящей игре, разделён между устройством игрока и сервером. На странице Roblox про инструменты сказано, что ввод для инструментов должен жить в LocalScript, потому что только устройство игрока знает, когда происходит ввод, и что большинству инструментов нужны LocalScript, серверный Script и RemoteEvent между ними. В этом гайде используется именно такое разделение. Один взмах выглядит так:
- Игрок кликает, тапает или нажимает триггер геймпада с экипированным Sword. В LocalScript срабатывает
Tool.Activated. - LocalScript проигрывает анимацию взмаха, если она есть, и вызывает RemoteEvent
SwordSwing. Больше он ничего не отправляет. - Серверный Script проверяет кулдаун, то, что игрок жив, и то, что Sword у него в руке.
- Сервер строит собственный хитбокс перед персонажем игрока и находит каждый Humanoid внутри него.
- Каждый из этих Humanoid один раз теряет здоровье через
TakeDamage.
| Элемент | Где находится | Что делает |
|---|---|---|
Tool Sword | StarterPack | То, что держит игрок. Roblox копирует всё из StarterPack в Backpack игрока при каждом спавне его персонажа. |
Part Handle | Внутри Tool | Парт, за который держится персонаж. Клинок приварен к нему. |
LocalScript SwordClient | Внутри Tool | Слышит клик, проигрывает анимацию взмаха и вызывает ремоут. |
RemoteEvent SwordSwing | ReplicatedStorage (его создаёт SwordService) | Несёт «я взмахнул» с устройства игрока на сервер, без аргументов. |
Script SwordService | ServerScriptService | Проверяет каждый взмах, находит, кто стоит перед игроком, и наносит урон. Единственное место, где может произойти удар. |
ServerScriptService
SwordService Script new
StarterPack
Sword Tool new
Handle Part new
Blade Part new
WeldConstraint WeldConstraint new
SwordClient LocalScript new
Шаг 1: соберите Tool меча
- В Explorer наведите курсор на Workspace, нажмите кнопку + и вставьте Tool. Переименуйте его в
Sword. Серверный скрипт ищет именно это имя. Меч вы собираете в Workspace, как советует страница Roblox про инструменты, потому что там видны его парты и их можно двигать и менять в размере. Последний шаг переносит его в StarterPack. - Вставьте в Tool Part и назовите его
Handle. Это рукоять, за которую персонаж держит меч. Он должен быть прямым потомком Tool и единственным партом с таким именем: при двух Handle Roblox выбирает один случайно, и персонаж может держать меч за клинок. - Вставьте в Tool второй Part, назовите его
Blade, придайте ему форму и поставьте так, чтобы он торчал из верха Handle. - Вставьте в Blade WeldConstraint. В окне Properties задайте его
Part0равным Handle, аPart1равным Blade, чтобы меч оставался целым, пока игрок его носит. - Выделите оба парта и убедитесь, что Anchored выключен. Анкерный парт в инструменте приковывает персонажа к месту, когда тот его экипирует. Выключите у обоих и CanCollide, чтобы клинок при взмахе не натыкался на игроков и стены.
- Выделите Tool и снимите галочку CanBeDropped. Когда она стоит, нажатие Backspace выбрасывает меч в Workspace.
- Перетащите готовый Sword из Workspace в StarterPack. Tool, оставленный в Workspace, это подбираемый предмет, который забирает один игрок, а не меч, который с самого начала лежит в Backpack у каждого.
Меч из одного MeshPart тоже подойдёт: назовите этот MeshPart Handle и пропустите Weld. Если при тесте персонаж держит меч под странным углом, выделите Tool и подправьте его свойства хвата (GripPos, GripForward, GripRight и GripUp) в окне Properties.
Шаг 2: добавьте серверный скрипт
Наведите курсор на ServerScriptService, вставьте Script с именем SwordService и вставьте в него код ниже. Это единственное место, где может произойти удар мечом. Настройки в начале это строки, которые вам и положено менять.
-- Script в ServerScriptService с именем SwordService.
-- Единственное место, где может произойти удар мечом: проверяет взмах, находит цели перед
-- атакующим собственным хитбоксом и наносит урон.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Настройки
local SWORD_NAME = "Sword" -- имя Tool в StarterPack
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- держите то же значение в SwordClient
local HIT_RANGE = 6 -- стады перед атакующим
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false -- false: игроки одной команды не могут ранить друг друга
-- Взмахи, отправленные ровно через COOLDOWN_SECONDS, после сетевой задержки могут прийти
-- чуть ближе друг к другу, поэтому сервер даёт такой запас и не отбрасывает настоящий взмах
local NETWORK_SLACK = 0.1
-- Ремоут, который вызывает LocalScript меча. Он не несёт аргументов: кто получит удар,
-- решает сервер, поэтому клиенту нечего подделывать.
local swingEvent = Instance.new("RemoteEvent")
swingEvent.Name = "SwordSwing"
swingEvent.Parent = ReplicatedStorage
local lastSwing: { [Player]: number } = {}
local function isTeammate(attacker: Player, target: Player?): boolean
if FRIENDLY_FIRE or not target then
return false
end
-- Нейтральные игроки (без команды) всегда могут бить друг друга
return not attacker.Neutral and not target.Neutral and attacker.Team == target.Team
end
local function onSwing(player: Player)
-- 1. Один взмах за кулдаун, как бы часто ни вызывали ремоут
local now = os.clock()
local last = lastSwing[player]
if last and now - last < COOLDOWN_SECONDS - NETWORK_SLACK then
return
end
-- 2. Атакующий должен быть жив и держать меч
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
local rootPart = humanoid and humanoid.RootPart
if not (character and humanoid and rootPart) or humanoid.Health <= 0 then
return
end
local sword = character:FindFirstChild(SWORD_NAME)
if not (sword and sword:IsA("Tool")) then
return
end
lastSwing[player] = now
-- 3. Собственный хитбокс сервера: бокс перед корневым партом атакующего
local params = OverlapParams.new()
params.FilterType = Enum.RaycastFilterType.Exclude
params.FilterDescendantsInstances = { character }
local boxCFrame = rootPart.CFrame * CFrame.new(0, 0, -HIT_RANGE / 2)
local parts = workspace:GetPartBoundsInBox(boxCFrame, Vector3.new(HIT_WIDTH, HIT_HEIGHT, HIT_RANGE), params)
-- 4. Каждый Humanoid в боксе получает урон один раз, даже если внутри несколько его партов
local alreadyHit: { [Humanoid]: boolean } = {}
for _, part in parts do
local model = part:FindFirstAncestorOfClass("Model")
local target = model and model:FindFirstChildOfClass("Humanoid")
if model and target and not alreadyHit[target] and target.Health > 0 then
alreadyHit[target] = true
if not isTeammate(player, Players:GetPlayerFromCharacter(model)) then
target:TakeDamage(DAMAGE) -- ничего не делает, пока у цели есть ForceField
end
end
end
end
swingEvent.OnServerEvent:Connect(onSwing)
Players.PlayerRemoving:Connect(function(player: Player)
lastSwing[player] = nil
end)
SwordService сам создаёт RemoteEvent SwordSwing при запуске игры, поэтому вручную вставлять в ReplicatedStorage ничего не нужно. Если вы уже создали RemoteEvent с таким именем, удалите его: LocalScript мог бы найти ваш, а его на сервере никто не слушает.
| Настройка | Значение здесь | Что меняет |
|---|---|---|
SWORD_NAME | "Sword" | Имя Tool, который сервер ожидает в руке игрока. Измените его, если ваш Tool называется иначе. |
DAMAGE | 20 | Сколько здоровья снимает каждый удар. Humanoid начинает со 100 здоровья, поэтому пять ударов выбивают тестовый риг. Персонажи игроков по умолчанию восстанавливают 1% от MaxHealth каждую секунду, поэтому игрок, которого бьют с максимальной скоростью, переживает пятый удар, и нужен шестой. |
COOLDOWN_SECONDS | 0.6 | Время между взмахами. Задайте то же значение в SwordClient. |
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT | 6, 5, 6 | Хитбокс в стадах: как далеко он достаёт перед игроком, какой он ширины и высоты. |
FRIENDLY_FIRE | false | При false игроки одной команды не могут ранить друг друга. Игроки без команды всегда могут бить друг друга, а NPC всегда можно ударить. |
NETWORK_SLACK | 0.1 | На сколько раньше кулдауна сервер всё ещё принимает взмах. Два клика с промежутком 0.6 секунды после сетевой задержки могут прийти чуть ближе друг к другу, и без этого запаса сервер отбросил бы настоящий взмах, который игрок уже увидел. |
Шаг 3: добавьте LocalScript в Tool
Вставьте в Tool Sword LocalScript, назовите его SwordClient и вставьте в него этот код:
-- LocalScript внутри Tool Sword с именем SwordClient.
-- Tool.Activated срабатывает на устройстве игрока, поэтому этот скрипт слушает клик,
-- тап или триггер, проигрывает анимацию взмаха и просит сервер сделать взмах.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local tool = script.Parent :: Tool
local swingEvent = ReplicatedStorage:WaitForChild("SwordSwing") :: RemoteEvent
local COOLDOWN_SECONDS = 0.6 -- то же значение, что в SwordService
local SWING_ANIMATION_ID = "" -- необязательно: "rbxassetid://" и за ним id вашей анимации
local player = Players.LocalPlayer
local lastSwing = 0
local swingTrack: AnimationTrack? = nil
local trackCharacter: Model? = nil
-- Загружаем анимацию один раз на персонажа. Анимации, запущенные на вашем собственном
-- персонаже с вашего устройства, показываются всем игрокам.
local function loadSwing()
local character = player.Character
if SWING_ANIMATION_ID == "" or not character or character == trackCharacter then
return
end
local humanoid = character:FindFirstChildOfClass("Humanoid")
local animator = humanoid and humanoid:FindFirstChildOfClass("Animator")
if animator then
local animation = Instance.new("Animation")
animation.AnimationId = SWING_ANIMATION_ID
swingTrack = animator:LoadAnimation(animation)
trackCharacter = character
end
end
tool.Equipped:Connect(loadSwing)
tool.Activated:Connect(function()
local now = os.clock()
if now - lastSwing < COOLDOWN_SECONDS then
return -- сервер тоже это проверяет; проверка здесь избавляет от лишних запросов
end
lastSwing = now
if swingTrack then
swingTrack:Play()
end
swingEvent:FireServer()
end)
Пока оставьте SWING_ANIMATION_ID пустым. Меч работает и без анимации, потому что попадание в любом случае решает сервер. Как его заполнить, показано в разделе Добавьте анимацию взмаха.
Activated срабатывает на клик мышью, тап на телефоне и триггер на геймпаде, поэтому один и тот же скрипт работает на любом устройстве. Roblox копирует Tool и LocalScript внутри него в Backpack каждого игрока при спавне его персонажа, поэтому у каждого игрока работает своя копия.
LocalScript держит собственный кулдаун только для того, чтобы не отправлять запросы, которые сервер всё равно проигнорирует. Это не проверка безопасности: читер может удалить его, изменить или вызвать SwordSwing из своего кода. Гайд по RemoteEvent объясняет, почему каждый ремоут нужно проверять на сервере, а Script vs LocalScript vs ModuleScript (на английском) показывает, что LocalScript может и чего не может менять.
Как сервер решает, кто получил удар
Когда приходит SwordSwing, SwordService ничего не спрашивает у клиента. Он строит бокс перед персонажем атакующего там, где его видит сервер, и спрашивает у движка, какие парты находятся внутри, через workspace:GetPartBoundsInBox. Этот метод заменяет более старый FindPartsInRegion3, который Roblox помечает как устаревший.
Центр бокса находится в 3 стадах перед корневым партом атакующего. Это смещение CFrame.new(0, 0, -HIT_RANGE / 2): CFrame смотрит вдоль своей отрицательной оси Z, это его LookVector. Поэтому бокс тянется от середины персонажа на 6 стадов вперёд, а в ширину он 5 стадов и в высоту 6. Запрос сравнивает ограничивающий бокс (bounding box) каждого парта, быстрое приближение его объёма в форме коробки, поэтому круглые парты и меши считаются чуть больше, чем выглядят. Для меча этот небольшой запас полезен.
| Шаг | Код | Зачем |
|---|---|---|
| Пропустить атакующего | OverlapParams с Exclude и персонажем атакующего | Собственные руки, ноги и меч атакующего тоже находятся в боксе. |
| Найти персонажа | part:FindFirstAncestorOfClass("Model") | Парт в боксе может быть конечностью, шляпой или инструментом в руке. FindFirstAncestorOfClass сравнивает точное имя класса, поэтому проходит мимо шляпы (класс Accessory) и инструмента в руке (класс Tool, хотя Tool это разновидность Model) и останавливается на модели персонажа. |
| Найти Humanoid | model:FindFirstChildOfClass("Humanoid") | Ударить можно всё, у чего есть Humanoid: игроков, NPC и тестовые манекены. Стены и полы пропускаются. |
| Один раз на Humanoid | таблица alreadyHit | В боксе обычно оказывается несколько партов одного персонажа. Без таблицы каждый из них наносил бы урон заново. |
| Только живые цели | target.Health > 0 | Уже выбитого персонажа повторно не бьют. |
| Команды | isTeammate | При FRIENDLY_FIRE равном false игроки одной команды пропускаются. У игрока, чьё свойство Neutral равно true, команды нет. |
| Урон | target:TakeDamage(DAMAGE) | Снижает Health, если цель не защищает ForceField. |
Таблица alreadyHit создаётся заново при каждом взмахе, поэтому того же игрока можно ударить снова следующим взмахом, когда пройдёт кулдаун. Это и есть правило «один раз на цель за взмах», с которым у мечей на Touched постоянные трудности.
Скрипт использует TakeDamage, а не присваивание Health. В справке Roblox сказано, что TakeDamage не трогает Humanoid, пока его защищает ForceField, а прямое присваивание Health игнорирует ForceField. Игрок, который спавнится на SpawnLocation, по умолчанию получает ForceField на 10 секунд (Duration у SpawnLocation), поэтому новоприбывших нельзя ударить в момент появления.
Четыре способа сделать хитбокс меча: сравнение
Туториалы по мечам расходятся в основном в одном: как узнать, во что попал клинок. Есть четыре распространённых ответа. Они отличаются тем, насколько точно следуют за клинком, сколько работы стоят серверу и может ли читер подделать результат.
| Способ | Как работает | Кто решает | Точность | Для чего лучше всего |
|---|---|---|---|---|
Touched на клинке | Урон всякий раз, когда парт клинка касается персонажа | Устройство атакующего, которое владеет своим персонажем и мечом | Следует за клинком, но срабатывает несколько раз за касание | Ни для чего в игре с другими игроками: устройство атакующего может вызвать его откуда угодно |
| Бокс перед игроком (этот гайд) | Один запрос GetPartBoundsInBox на сервере за взмах | Сервер | Фиксированный бокс, а не путь клинка. Меши считаются по ограничивающим боксам, поэтому чуть щедро | Большинство игр: просто, дёшево и нечего подделывать |
GetPartsInPart на парте-хитбоксе | Серверный запрос с партом в форме дуги клинка, во время взмаха | Сервер | Точные формы: в документации Roblox сказано, что он делает полную геометрическую проверку, и предлагаются запросы по боксу или сфере, когда хватит меньшей точности, потому что они дешевле | Большое оружие необычной формы, например дуга косы |
| Рейкасты вдоль клинка | Каждый кадр взмаха короткие лучи пускаются из точек на клинке туда, где они были в прошлом кадре | Та сторона, которая их пускает. На сервере нужно серверное представление о том, где клинок | Близко следует за анимацией | Игры, где важен точный путь взмаха. Так работают хитбокс-модули сообщества |
Бокс это правильный первый выбор. Это один запрос на взмах, он никогда не зависит от анимации, которую читер мог бы изменить, и его легко настроить тремя числами. Переходите на парт нужной формы или лучи вдоль клинка, когда игроки жалуются, что попадания ощущаются неправильно у оружия, чей радиус далёк от бокса, и сохраняйте то же правило: запрос выполняет и урон наносит сервер.
Пресеты мечей: от кинжала до двуручника
Один и тот же SwordService делает очень разное оружие пятью настройками. Таблица это отправная точка, рассчитанная для манекена из Rig Generator со 100 Health. «Время до нокаута» считается от первого удара, когда каждый взмах попадает сразу, как только позволяет кулдаун.
| Оружие | DAMAGE | COOLDOWN_SECONDS | HIT_RANGE | HIT_WIDTH | Удары (время) | Урон в секунду |
|---|---|---|---|---|---|---|
| Кинжал | 12 | 0.35 | 4 | 4 | 9 (2.8 с) | около 34 |
| Меч (этот гайд) | 20 | 0.6 | 6 | 5 | 5 (2.4 с) | около 33 |
| Двуручный меч | 35 | 1.1 | 7 | 7 | 3 (2.2 с) | около 32 |
| Копьё | 18 | 0.8 | 9 | 3 | 6 (4 с) | около 23 |
- Игроки лечатся, манекены нет. Персонажи игроков по умолчанию восстанавливают 1% от MaxHealth каждую секунду. При ровно 100 урона за 5 ударов игрок, которого бьют с максимальной скоростью, переживает пятый удар, и нужен шестой. Оставьте запас, например 21 урон вместо 20, если важно точное число ударов.
- Масштабируйте NETWORK_SLACK вместе с кулдауном. 0.1 секунды из гайда это шестая часть от 0.6. Если оставить 0.1 у кинжала с кулдауном 0.35 секунды, читер мог бы бить каждые 0.25 секунды, на 40% быстрее. Берите примерно шестую часть от
COOLDOWN_SECONDS: 0.06 для кинжала. - Держите SwordClient в соответствии. Задайте там тот же
COOLDOWN_SECONDS, иначе клиент отправляет взмахи, которые сервер игнорирует.
Версия 2: замах и никаких ударов сквозь стены
Когда базовый меч заработал, появляются две жалобы. Удар приходится в тот же миг, когда игрок кликнул, раньше, чем анимация взмаха дойдёт до цели, и взмах может достать того, кто стоит по другую сторону тонкой стены, потому что бокс стены не учитывает. Эта версия SwordService исправляет и то и другое. Она заменяет скрипт из шага 2: то же имя, тот же ремоут, те же настройки, поэтому SwordClient менять не нужно.
-- Script в ServerScriptService с именем SwordService (версия с замахом и проверкой стен).
-- Заменяет скрипт из шага 2: те же настройки и ремоут плюс два правила. Удар приходится
-- через WINDUP_SECONDS после клика, когда взмах доходит до цели, и никого не задевает
-- сквозь стену.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Настройки
local SWORD_NAME = "Sword"
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- держите то же значение в SwordClient
local WINDUP_SECONDS = 0.15 -- время от клика до удара; подгоните под свою анимацию взмаха
local HIT_RANGE = 6
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false
local NETWORK_SLACK = 0.1
local swingEvent = Instance.new("RemoteEvent")
swingEvent.Name = "SwordSwing"
swingEvent.Parent = ReplicatedStorage
local lastSwing: { [Player]: number } = {}
local function isTeammate(attacker: Player, target: Player?): boolean
if FRIENDLY_FIRE or not target then
return false
end
return not attacker.Neutral and not target.Neutral and attacker.Team == target.Team
end
-- Возвращает персонажа и корневой парт атакующего, пока он жив и держит меч
local function getArmedCharacter(player: Player): (Model?, BasePart?)
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
local rootPart = humanoid and humanoid.RootPart
if not (character and humanoid and rootPart) or humanoid.Health <= 0 then
return nil, nil
end
local sword = character:FindFirstChild(SWORD_NAME)
if not (sword and sword:IsA("Tool")) then
return nil, nil
end
return character, rootPart
end
-- True, когда между атакующим и целью нет ничего, кроме самой цели
local function hasClearLine(attacker: Model, from: BasePart, target: Model, to: BasePart): boolean
local params = RaycastParams.new()
params.ExcludeInstances = { attacker }
local result = workspace:Raycast(from.Position, to.Position - from.Position, params)
return result == nil or result.Instance:IsDescendantOf(target)
end
local function strike(player: Player)
-- Проверяем снова после замаха: атакующий мог умереть или убрать меч
local character, rootPart = getArmedCharacter(player)
if not (character and rootPart) then
return
end
local params = OverlapParams.new()
params.FilterType = Enum.RaycastFilterType.Exclude
params.FilterDescendantsInstances = { character }
local boxCFrame = rootPart.CFrame * CFrame.new(0, 0, -HIT_RANGE / 2)
local parts = workspace:GetPartBoundsInBox(boxCFrame, Vector3.new(HIT_WIDTH, HIT_HEIGHT, HIT_RANGE), params)
local alreadyHit: { [Humanoid]: boolean } = {}
for _, part in parts do
local model = part:FindFirstAncestorOfClass("Model")
local target = model and model:FindFirstChildOfClass("Humanoid")
local targetRoot = target and target.RootPart
if model and target and targetRoot and not alreadyHit[target] and target.Health > 0 then
alreadyHit[target] = true
if not isTeammate(player, Players:GetPlayerFromCharacter(model)) and hasClearLine(character, rootPart, model, targetRoot) then
target:TakeDamage(DAMAGE)
end
end
end
end
swingEvent.OnServerEvent:Connect(function(player: Player)
local now = os.clock()
local last = lastSwing[player]
if last and now - last < COOLDOWN_SECONDS - NETWORK_SLACK then
return
end
local character = getArmedCharacter(player)
if not character then
return
end
lastSwing[player] = now
task.delay(WINDUP_SECONDS, strike, player)
end)
Players.PlayerRemoving:Connect(function(player: Player)
lastSwing[player] = nil
end)
Сначала удалите SwordService из шага 2, иначе оба скрипта создадут по ремоуту SwordSwing. Задайте WINDUP_SECONDS равным моменту в вашей анимации взмаха, когда клинок проходит перед персонажем; для быстрого взмаха подходит 0.15.
- Замах. Кулдаун и проверки «жив и держит меч» выполняются, когда приходит клик, затем
task.delayзапускаетstrikeчерезWINDUP_SECONDS.strikeпроверяет атакующего ещё раз, потому что за это время он мог умереть или убрать меч, и только потом строит бокс. Цель, которая за время замаха вышла из зоны досягаемости, не получает удар, и именно этого игроки ждут, когда видят взмах. - Проверка стен. Для каждой цели в боксе
hasClearLineпускает луч от корневого парта атакующего к корневому парту цели, пропуская собственного персонажа атакующего. Если первое, что он встречает, принадлежит цели или он не встречает ничего, удар засчитывается. Стена, дверь или другой игрок между ними его блокируют. - Сколько это стоит. Один дополнительный луч на цель за взмах, что немного по сравнению с самим запросом бокса.
Замах также делает меч честнее против читеров, которые бьют в тот же миг, когда телепортируются к кому-то: сервер ищет цели мгновением позже, там, где он видит персонажей в этот момент. Сам телепорт это не останавливает; для этого нужна проверка движения, описанная в разделе Что может и чего не может эксплойтер.
Добавьте анимацию взмаха (необязательно)
SwordClient уже проигрывает анимацию, как только вы дадите ему ID. Анимацию вы делаете один раз, в Animation Editor в Studio:
- Вставьте риг для анимации. На вкладке Avatar или Home нажмите Character, чтобы открыть Rig Generator, и выберите риг, который соответствует аватарам вашей игры, например R15 и затем Block Avatar.
- На вкладке Avatar нажмите Clip Editor, чтобы открыть Animation Editor, выделите риг и поставьте позы для короткого взмаха правой рукой.
- Задайте приоритет Action: нажмите кнопку … в элементах управления воспроизведением редактора, наведите курсор на Set Animation Priority и выберите Action. Action стоит выше Movement, Idle и Core, поэтому взмах проигрывается поверх анимаций ходьбы и стояния, а не проигрывает им.
- В том же меню … выберите Publish to Roblox. Если ваша игра принадлежит группе, выберите эту группу в поле Creator перед отправкой.
- Скопируйте asset ID анимации из Toolbox и в SwordClient задайте
SWING_ANIMATION_IDравным"rbxassetid://"и за ним это число.
SwordClient загружает взмах через Animator персонажа, а не через более старый Humanoid:LoadAnimation, который Roblox помечает как устаревший. В справке Roblox по Animator сказано, что анимации, которые устройство игрока запускает на собственном персонаже этого игрока, реплицируются на сервер и всем остальным игрокам, поэтому LocalScript может проиграть взмах, и его увидят все. Там же сказано, что Animator должен создаваться на сервере, поэтому никогда не создавайте его в LocalScript. У персонажей игроков он обычно лежит внутри Humanoid, и именно там его ищет собственный пример анимации от Roblox.
Анимация нужна только для вида. Попадания от неё не зависят, поэтому медленная, отсутствующая или изменённая анимация никогда не меняет того, кто получит удар.
Как проиграть анимацию по нажатию клавиши, в цикле или на NPC, читайте в гайде по скрипту анимации.
В чём ошибаются старые туториалы по мечам
Если вы сравниваете этот гайд с видео или постом на форуме, вот важные отличия и причина, по которой каждый приём создаёт проблему.
| Туториал | Проблема | Этот гайд |
|---|---|---|
Наносит урон в событии Touched клинка | Устройство атакующего может вызвать Touched на своём мече откуда угодно (страница Roblox про network ownership), а Touched срабатывает несколько раз подряд за одно касание (страница Roblox про debounce). | Сервер находит цели собственным боксом, один раз на Humanoid за взмах. |
| Снижает Health в LocalScript | Изменение, которое LocalScript вносит в чужого персонажа, остаётся на этом одном устройстве. | Весь урон наносится в SwordService. |
Использует wait(0.5) для кулдауна | Roblox помечает глобальный wait() как устаревший, вместо него используется task.wait(), а кулдаун, который существует только на клиенте, никого не останавливает. | Сравнивает время os.clock() на сервере. Ничто не ждёт. |
Проигрывает взмах через Humanoid:LoadAnimation | Устарел, вместо него используется Animator:LoadAnimation. | Загружает взмах через Animator. |
Ищет цели через Region3 и FindPartsInRegion3 | Устарело. Roblox советует в новых проектах использовать GetPartBoundsInBox с OverlapParams. | Использует GetPartBoundsInBox. |
Кладёт серверный Script внутрь Tool, и он слушает Activated | Меч каждого игрока запускает свою копию серверного кода, и такие скрипты часто наносят урон в Touched (первая строка). С настройками по умолчанию Script работает только в Workspace или ServerScriptService, поэтому Script в Tool не запускается, пока меч не экипируют в первый раз. Страница Roblox про инструменты описывает большинство инструментов как LocalScript для ввода, серверный Script для эффекта и RemoteEvent между ними. | Один SwordService в ServerScriptService обслуживает все мечи в игре. |
Что может и чего не может эксплойтер
Считайте, что читер управляет всем на своём устройстве. Он может читать и менять ваши LocalScript, а в гайде Roblox по безопасности сказано, что он может вызывать RemoteEvent с любой частотой и произвольными аргументами. Вот что это значит для этого меча.
| Читер пытается | Результат | Почему |
|---|---|---|
Вызывать SwordSwing так быстро, как может его код, или использовать автокликер | Засчитывается не больше одного взмаха раз в 0.5 секунды | Серверный кулдаун это 0.6 секунды минус 0.1 секунды сетевого запаса. Этот запас и есть максимум, что выигрывает читер. |
| Отправить с ремоутом цель, число урона или позицию | Игнорируется | onSwing читает только игрока, которого Roblox подставляет сам. Всё остальное, отправленное с ремоутом, никогда не читается. |
| Изменить SwordClient, например убрать его кулдаун | На сервер не влияет | SwordService держит свои настройки в ServerScriptService, который никогда не отправляется игрокам. |
| Бить, будучи мёртвым или без меча в руке | Игнорируется | SwordService проверяет, что его Humanoid жив и что Tool с именем Sword лежит внутри его персонажа, куда Roblox переносит инструмент при экипировке. |
| Ударить кого-то с другого конца карты | Ничего не происходит | Бокс строится вокруг персонажа атакующего там, где его видит сервер, и достаёт только на 6 стадов вперёд. |
| Телепортироваться к игроку и затем ударить | Возможно | Каждое устройство управляет движением своего персонажа, и Roblox перечисляет телепортацию в любую точку среди того, что клиент может делать со своим персонажем. Серверная проверка движения может это засечь. |
| Ударить сквозь тонкую стену | Возможно в пределах бокса в 6 стадов | Запрос бокса из шага 2 не ищет стены. Версия 2 добавляет проверку стен. |
| Проиграть любую анимацию или никакой | На попадания не влияет | Попадания никогда не зависят от анимации. Roblox отмечает, что читеры могут проигрывать произвольные анимации на своём персонаже. |
В двух строках стоит «Возможно», и это честно. Этот меч не даёт читеру выбирать, кого он бьёт, как сильно и как часто. Он не может помешать ему двигать собственного персонажа. В документации Roblox по безопасности сказано, что клиенты управляют движением и физикой своего персонажа и что проверки движения нужно настраивать под каждую игру. Для соревновательной игры следующий слой это серверная проверка движения (гайд по спринту собирает такую, она предупреждает о грубых спидхаках и дальних телепортах) или server authority от Roblox, которую документация описывала как бету, когда мы проверяли 13 октября 2026.
Шаг 4: проверьте
- Добавьте то, по чему бить. На вкладке Avatar или Home нажмите Character, чтобы открыть Rig Generator, выберите риг (например, R15, затем Block Avatar), и он вставится в Workspace. Отодвиньте его на несколько стадов от вашего SpawnLocation.
- Нажмите Play, экипируйте Sword из хотбара, подойдите к ригу и кликните. После первого удара над ним появляется полоска здоровья, потому что по умолчанию Humanoid показывает полоску, только когда его Health ниже MaxHealth. Humanoid начинает со 100 здоровья, поэтому пятый удар его выбивает.
- Кликайте так быстро, как можете. Что-то делает только один взмах раз в 0.6 секунды.
- Отойдите от рига примерно на 8 стадов или повернитесь к нему спиной и взмахните. Ничего не происходит, потому что ни один его парт не находится в боксе.
- Проверьте на настоящем игроке. Выберите Server & Clients в выпадающем списке режимов теста, задайте 2 клиента и нажмите Play. Ударьте другого игрока в течение 10 секунд после его спавна: ничего не происходит из-за ForceField при спавне. После этого каждый удар снимает 20. По умолчанию персонажи игроков ещё и восстанавливают 1% от MaxHealth каждую секунду, поэтому между драками их здоровье понемногу возвращается.
- Если в вашей игре есть Teams, поместите обоих тестовых игроков в одну команду. При
FRIENDLY_FIREравном false их взмахи ничего не делают друг другу.
Всё это время держите окно Output открытым (меню Window, затем Output). Когда эти скрипты работают, они ничего не печатают, поэтому любая красная ошибка от SwordService или SwordClient это настоящая проблема. Смотрите Частые ошибки.
Как расширить меч до боевой системы
Комбо
Держите на сервере счётчик взмахов на игрока, рядом с lastSwing. Если предыдущий взмах был недавно, прибавляйте 1; иначе начинайте снова с 1. Затем выбирайте урон по счётчику, например больше урона на каждом третьем ударе, и очищайте счётчик по PlayerRemoving тем же способом. Клиент может вести свой счёт, чтобы выбирать, какую анимацию проиграть, потому что анимация никогда не решает попадание. Бокс и проверки остаются точно такими же.
Отбрасывание
После TakeDamage SwordService может оттолкнуть цель через ApplyImpulse на RootPart цели, в направлении rootPart.CFrame.LookVector атакующего. В справке Roblox сказано, что толчок зависит от массы цели и что серверный Script может вызывать его на парте, которым владеет сервер, или на парте, которым автоматически владеет клиент. Устройство каждого игрока симулирует его собственного персонажа, поэтому проверяйте отбрасывание на игроках через Server & Clients, а не только на риге.
Зачёт убийств для таблицы лидеров
Прямо перед target:TakeDamage(DAMAGE) запишите, кто ударил последним, через target:SetAttribute("LastHitBy", player.UserId). В серверном Script подключите событие Died у Humanoid каждого персонажа, прочитайте этот атрибут, найдите атакующего через Players:GetPlayerByUserId и прибавьте 1 к IntValue Kills в его leaderstats. Создайте его рядом с Coins и Wins, как в шаге 1 гайда по таблице лидеров, и меняйте на сервере, как в шаге 2.
Блок
Добавьте второй RemoteEvent, который клиент вызывает, когда кнопка блока нажата и отпущена, и пусть сервер выставляет атрибут Blocking на персонаже этого игрока, со своим лимитом частоты. В SwordService снижайте или пропускайте урон, когда у персонажа цели выставлен Blocking. Читер всё равно сам выбирает, когда блокировать, поэтому делайте блок коротким или дайте ему кулдаун.
Продажа меча или выдача на каждый раунд
StarterPack выдаёт меч каждому игроку при каждом спавне. Чтобы вместо этого продавать его, положите его в папку ShopItems из гайда по GUI магазина. Каталог того гайда уже продаёт Tool с именем ClassicSword, поэтому либо назовите этот Tool ClassicSword и задайте такой же SWORD_NAME, либо измените запись в каталоге. Чтобы выдавать его только на время раунда, возьмите скрипт GiveRoundTool из гайда по системе раундов: храните Sword в ServerStorage, а не в StarterPack, и замените "RoundTool" в том скрипте на "Sword".
Враги для боя и оружие дальнего боя
Для NPC, который преследует игроков, следуйте гайду по поиску пути для NPC. Меч наносит ему урон, как любому другому Humanoid. Про оружие, которое бьёт на расстоянии по тем же серверным правилам, читайте в гайде по оружию.
Частые ошибки и решения
Откройте окно Output (меню Window, затем Output) до нажатия Play. Большинство проблем с мечом либо печатают там ошибку, либо возникают из-за имени, которое не совпадает.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("SwordSwing")'
SwordClient ждёт ремоут, который создаёт SwordService, значит, SwordService не работает. Проверьте, что это Script, а не LocalScript, что он лежит прямо в ServerScriptService, не отключён и что в Output нет ошибки от него.
Я взмахиваю, но никто не получает урон
Проверьте по порядку: SwordClient это LocalScript, а не Script, и лежит прямо в Tool Sword; Tool называется точно Sword или так, как указано в SWORD_NAME; цель находится не дальше 6 стадов перед вами; цель заспавнилась больше 10 секунд назад, так что её ForceField уже исчез; и, если вы используете Teams, вы не в одной команде при FRIENDLY_FIRE равном false.
Меч бьёт игроков, но никогда не бьёт моего NPC
Пространственные запросы вроде GetPartBoundsInBox никогда не возвращают парт, у которого выключен CanQuery (CanQuery действует, только когда выключен и CanCollide). Включите CanQuery обратно у частей тела NPC и проверьте, что его Humanoid это прямой потомок модели NPC.
Мой персонаж застревает, когда я экипирую меч
Какой-то парт меча заанкерен. Выделите все парты внутри Tool и снимите Anchored.
Одни взмахи попадают, а другие промахиваются на том же расстоянии
В версии с замахом цель, которая вышла из бокса за WINDUP_SECONDS, не получает удар, а проверка стен пропускает всех, кто стоит за стеной или за другим игроком. Уменьшите замах или увеличьте HIT_WIDTH, если в плейтестах промахи кажутся нечестными.
Персонаж держит меч за клинок
Партов с именем Handle больше одного, и Roblox выбрал не тот. Оставьте ровно один Handle, рукоять, и переименуйте остальные. Затем подправьте свойства хвата у Tool, если угол всё ещё неправильный.
Клинок остаётся на месте или падает, когда я экипирую меч
Клинок не приварен к Handle. Добавьте WeldConstraint, у которого Part0 равен Handle, а Part1 равен клинку.
Урон виден на моём экране, но здоровье другого игрока не меняется
Урон наносится из LocalScript, который меняет только вашу копию игры. Наносите урон только в SwordService, как в шаге 2.
Сделать с RoCode
Если не хочется собирать всё это вручную, RoCode может сделать это в открытом у вас плейсе. Это независимый ИИ-агент для написания кода, не от Roblox: вы описываете функцию в его веб-чате, а его плагин для Roblox Studio создаёт Tool, парты и скрипты в вашем Explorer, так что вам не приходится копировать код из окна чата.
Сделай меч: Tool с именем Sword в StarterPack с Handle и приваренным к нему клинком, LocalScript, который вызывает RemoteEvent по Activated, и серверный Script, который проверяет кулдаун 0.6 секунды и наносит 20 урона всем Humanoid в боксе перед игроком.
- Создаёт Tool и его парты через Create Instance и задаёт их свойства через Set Property
- Пишет SwordService и SwordClient через Create Script и может сначала поискать уже имеющиеся боевые скрипты через Search Scripts
- Ему велено проверять компиляцию каждого написанного скрипта через Check Script, который компилирует код в Studio без запуска (типы он не проверяет)
- Ставит точку отмены до и после каждой пачки изменений, поэтому Ctrl+Z откатывает по одной пачке
RoCode не может сделать анимацию взмаха или загрузить её: сделайте её в Animation Editor и вставьте её ID. С плагином 3.9 или новее RoCode может запустить короткий плейтест и прочитать ошибки, а с плагином 3.9.11 или новее может управлять тестовым персонажем, но он не кликает в 3D-окне, чтобы взмахнуть, поэтому взмахи вы проверяете сами. Страница как создать целую игру Roblox с RoCode, система за системой показывает, куда встаёт оружие. Как RoCode подключается к Studio.
Частые вопросы
Почему мой меч бьёт одного игрока несколько раз за один взмах?
Потому что он наносит урон из Touched. На странице Roblox про debounce отмечено, что Touched срабатывает несколько раз подряд за одно касание, и каждый парт цели может коснуться клинка. Этот гайд находит цели одним запросом бокса на взмах и ведёт список, поэтому каждый Humanoid теряет здоровье один раз за взмах.
Урон меча должен быть в LocalScript или в Script?
В Script на сервере. Урон, нанесённый из LocalScript, меняет только копию игры этого игрока, а всё, что находится на устройстве игрока, читер может изменить. LocalScript должен только слышать клик, проигрывать анимацию и вызывать RemoteEvent.
Как добавить мечу анимацию взмаха?
Сделайте её в Animation Editor, задайте приоритет Action, опубликуйте в Roblox и впишите её asset ID в SWING_ANIMATION_ID как rbxassetid:// и за ним число. SwordClient проигрывает её через Animator персонажа. Анимации, которые устройство игрока запускает на собственном персонаже этого игрока, показываются всем.
Почему анимация меча не проигрывается?
Проверьте три вещи. Приоритет: Action стоит выше Movement, Idle и Core, поэтому взмах с Action проигрывается поверх ходьбы и стояния, а более низкий приоритет может им проиграть. Владелец: если игра принадлежит группе, публикуйте анимацию, выбрав эту группу как Creator. ID: SWING_ANIMATION_ID должен быть полным текстом rbxassetid:// с числом вашей анимации, а не пустой строкой.
Какой хитбокс лучше всего для меча в Roblox?
Для большинства игр это запрос бокса на сервере один раз за взмах, как в этом гайде: один вызов GetPartBoundsInBox, клиенту нечего подделывать, и три числа для настройки. Используйте GetPartsInPart с партом нужной формы или рейкасты вдоль клинка, только когда радиус оружия далёк от бокса. Сравнение четырёх способов.
Как сделать, чтобы меч не бил сквозь стены?
Перед нанесением урона пустите луч от корневого парта атакующего к корневому парту цели, пропуская персонажа атакующего, и засчитывайте удар, только если первое, что встречает луч, принадлежит цели. Версия 2 SwordService делает это для каждой цели.
Почему удар приходится раньше, чем анимация взмаха дойдёт до цели?
Сервер проверяет хитбокс в тот же миг, когда приходит клик. Сначала выждите короткий замах, например 0.15 секунды через task.delay, затем проверьте, что атакующий всё ещё жив и держит меч, и постройте бокс, как делает версия 2.
Могут ли эксплойтеры всё равно читерить с этим мечом?
Они не могут выбирать, кто получит удар, сколько урона наносит удар и как часто они бьют, потому что все три вещи решает сервер; максимум, что они выигрывают, это 0.1 секунды сетевого запаса на кулдауне. Они по-прежнему могут двигать своего персонажа, например вплотную к кому-то, потому что каждое устройство управляет движением своего персонажа. Следующий слой это серверная проверка движения.
Как сделать боевую систему с комбо?
Держите на сервере счётчик взмахов на игрока, сбрасывайте его после короткой паузы и выбирайте урон и анимацию по счётчику. Проверка попадания остаётся той же. Раздел Как расширить разбирает ещё отбрасывание, зачёт убийств и блок.
Источники и что почитать
- Roblox Creator Docs: In-game tools (на английском). сборка инструмента в Workspace, Handle, Weld, Grip, анкер и почему большинство инструментов используют LocalScript, Script и RemoteEvent
- Roblox Creator Docs: WorldRoot:GetPartBoundsInBox (на английском). запрос бокса, OverlapParams и устаревший FindPartsInRegion3
- Roblox Creator Docs: Humanoid:TakeDamage (на английском). защита ForceField, полоска здоровья и регенерация здоровья
- Roblox Creator Docs: Network ownership (на английском). эксплойт с мечом на Touched
- Roblox Creator Docs: Security tactics and cheat mitigation (на английском). никогда не доверяйте клиенту
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (на английском). что клиент может делать со своим персонажем и проверки движения
- Roblox Creator Docs: Animation Editor (на английском). приоритет анимации и публикация
- Roblox Creator Docs: Animator:LoadAnimation (на английском). какие анимации реплицируются с клиента
- Roblox Creator Docs: Debounce patterns (на английском). почему Touched срабатывает несколько раз за одно касание
Как проверялся код: каждый скрипт на этой странице проходит строгую проверку типов Luau с определениями Roblox API (luau-lsp, 12 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.