Туториал · Игровые системы

Как сделать меч в Roblox Studio

Меч в Roblox это Tool с тремя задачами, разделёнными между двумя скриптами: устройство игрока замечает клик и проигрывает взмах, а сервер решает, кто получил удар и сколько здоровья потерял. В этом гайде мы собираем оба скрипта, с кулдауном и хитбоксом, которые игроки не могут подделать, и показываем, куда встаёт анимация.

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

Коротко

Положите в 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.
  • Удары проходят сквозь стены или приходятся раньше, чем взмах визуально достаёт до цели? Возьмите версию серверного скрипта с замахом и проверкой стен.
На этой странице
  1. Как это устроено
  2. 1. Собираем Tool
  3. 2. Серверный скрипт
  4. 3. LocalScript
  5. Хитбокс
  6. Виды хитбокса
  7. Замах и проверка стен
  8. Анимация взмаха
  9. Старые туториалы
  10. Пределы защиты
  11. 4. Проверка
  12. Расширения
  13. Common errors
  14. С RoCode
  15. Частые вопросы
  16. Источники и что почитать

Как устроен рабочий меч

ИллюстрацияВзмахи с промежутком не меньше 0.6 секунды снимают по 20 здоровья, клик внутри кулдауна ничего не делает, а пятый удар выбивает риг.

Меч, который работает в настоящей игре, разделён между устройством игрока и сервером. На странице Roblox про инструменты сказано, что ввод для инструментов должен жить в LocalScript, потому что только устройство игрока знает, когда происходит ввод, и что большинству инструментов нужны LocalScript, серверный Script и RemoteEvent между ними. В этом гайде используется именно такое разделение. Один взмах выглядит так:

  1. Игрок кликает, тапает или нажимает триггер геймпада с экипированным Sword. В LocalScript срабатывает Tool.Activated.
  2. LocalScript проигрывает анимацию взмаха, если она есть, и вызывает RemoteEvent SwordSwing. Больше он ничего не отправляет.
  3. Серверный Script проверяет кулдаун, то, что игрок жив, и то, что Sword у него в руке.
  4. Сервер строит собственный хитбокс перед персонажем игрока и находит каждый Humanoid внутри него.
  5. Каждый из этих Humanoid один раз теряет здоровье через TakeDamage.
Из чего состоит меч
ЭлементГде находитсяЧто делает
Tool SwordStarterPackТо, что держит игрок. Roblox копирует всё из StarterPack в Backpack игрока при каждом спавне его персонажа.
Part HandleВнутри ToolПарт, за который держится персонаж. Клинок приварен к нему.
LocalScript SwordClientВнутри ToolСлышит клик, проигрывает анимацию взмаха и вызывает ремоут.
RemoteEvent SwordSwingReplicatedStorage (его создаёт SwordService)Несёт «я взмахнул» с устройства игрока на сервер, без аргументов.
Script SwordServiceServerScriptServiceПроверяет каждый взмах, находит, кто стоит перед игроком, и наносит урон. Единственное место, где может произойти удар.
Explorer, когда меч готов. SwordService добавляет RemoteEvent с именем SwordSwing в ReplicatedStorage, когда игра запущена.
ServerScriptService
  SwordService Script new
StarterPack
  Sword Tool new
    Handle Part new
    Blade Part new
      WeldConstraint WeldConstraint new
    SwordClient LocalScript new

Шаг 1: соберите Tool меча

  1. В Explorer наведите курсор на Workspace, нажмите кнопку + и вставьте Tool. Переименуйте его в Sword. Серверный скрипт ищет именно это имя. Меч вы собираете в Workspace, как советует страница Roblox про инструменты, потому что там видны его парты и их можно двигать и менять в размере. Последний шаг переносит его в StarterPack.
  2. Вставьте в Tool Part и назовите его Handle. Это рукоять, за которую персонаж держит меч. Он должен быть прямым потомком Tool и единственным партом с таким именем: при двух Handle Roblox выбирает один случайно, и персонаж может держать меч за клинок.
  3. Вставьте в Tool второй Part, назовите его Blade, придайте ему форму и поставьте так, чтобы он торчал из верха Handle.
  4. Вставьте в Blade WeldConstraint. В окне Properties задайте его Part0 равным Handle, а Part1 равным Blade, чтобы меч оставался целым, пока игрок его носит.
  5. Выделите оба парта и убедитесь, что Anchored выключен. Анкерный парт в инструменте приковывает персонажа к месту, когда тот его экипирует. Выключите у обоих и CanCollide, чтобы клинок при взмахе не натыкался на игроков и стены.
  6. Выделите Tool и снимите галочку CanBeDropped. Когда она стоит, нажатие Backspace выбрасывает меч в Workspace.
  7. Перетащите готовый Sword из Workspace в StarterPack. Tool, оставленный в Workspace, это подбираемый предмет, который забирает один игрок, а не меч, который с самого начала лежит в Backpack у каждого.

Меч из одного MeshPart тоже подойдёт: назовите этот MeshPart Handle и пропустите Weld. Если при тесте персонаж держит меч под странным углом, выделите Tool и подправьте его свойства хвата (GripPos, GripForward, GripRight и GripUp) в окне Properties.

Шаг 2: добавьте серверный скрипт

Наведите курсор на ServerScriptService, вставьте Script с именем SwordService и вставьте в него код ниже. Это единственное место, где может произойти удар мечом. Настройки в начале это строки, которые вам и положено менять.

Script в ServerScriptService с именем 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 мог бы найти ваш, а его на сервере никто не слушает.

Настройки в начале SwordService
НастройкаЗначение здесьЧто меняет
SWORD_NAME"Sword"Имя Tool, который сервер ожидает в руке игрока. Измените его, если ваш Tool называется иначе.
DAMAGE20Сколько здоровья снимает каждый удар. Humanoid начинает со 100 здоровья, поэтому пять ударов выбивают тестовый риг. Персонажи игроков по умолчанию восстанавливают 1% от MaxHealth каждую секунду, поэтому игрок, которого бьют с максимальной скоростью, переживает пятый удар, и нужен шестой.
COOLDOWN_SECONDS0.6Время между взмахами. Задайте то же значение в SwordClient.
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT6, 5, 6Хитбокс в стадах: как далеко он достаёт перед игроком, какой он ширины и высоты.
FRIENDLY_FIREfalseПри false игроки одной команды не могут ранить друг друга. Игроки без команды всегда могут бить друг друга, а NPC всегда можно ударить.
NETWORK_SLACK0.1На сколько раньше кулдауна сервер всё ещё принимает взмах. Два клика с промежутком 0.6 секунды после сетевой задержки могут прийти чуть ближе друг к другу, и без этого запаса сервер отбросил бы настоящий взмах, который игрок уже увидел.

Шаг 3: добавьте LocalScript в Tool

Вставьте в Tool Sword LocalScript, назовите его SwordClient и вставьте в него этот код:

LocalScript в Tool Sword в StarterPack с именем 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) каждого парта, быстрое приближение его объёма в форме коробки, поэтому круглые парты и меши считаются чуть больше, чем выглядят. Для меча этот небольшой запас полезен.

Что SwordService делает с партами в боксе
ШагКодЗачем
Пропустить атакующегоOverlapParams с Exclude и персонажем атакующегоСобственные руки, ноги и меч атакующего тоже находятся в боксе.
Найти персонажаpart:FindFirstAncestorOfClass("Model")Парт в боксе может быть конечностью, шляпой или инструментом в руке. FindFirstAncestorOfClass сравнивает точное имя класса, поэтому проходит мимо шляпы (класс Accessory) и инструмента в руке (класс Tool, хотя Tool это разновидность Model) и останавливается на модели персонажа.
Найти Humanoidmodel: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. «Время до нокаута» считается от первого удара, когда каждый взмах попадает сразу, как только позволяет кулдаун.

Настройки SwordService для распространённого оружия ближнего боя, с числом ударов и временем до нокаута манекена со 100 Health. Рассчитано, а не измерено
ОружиеDAMAGECOOLDOWN_SECONDSHIT_RANGEHIT_WIDTHУдары (время)Урон в секунду
Кинжал120.35449 (2.8 с)около 34
Меч (этот гайд)200.6655 (2.4 с)около 33
Двуручный меч351.1773 (2.2 с)около 32
Копьё180.8936 (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
-- 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:

  1. Вставьте риг для анимации. На вкладке Avatar или Home нажмите Character, чтобы открыть Rig Generator, и выберите риг, который соответствует аватарам вашей игры, например R15 и затем Block Avatar.
  2. На вкладке Avatar нажмите Clip Editor, чтобы открыть Animation Editor, выделите риг и поставьте позы для короткого взмаха правой рукой.
  3. Задайте приоритет Action: нажмите кнопку … в элементах управления воспроизведением редактора, наведите курсор на Set Animation Priority и выберите Action. Action стоит выше Movement, Idle и Core, поэтому взмах проигрывается поверх анимаций ходьбы и стояния, а не проигрывает им.
  4. В том же меню … выберите Publish to Roblox. Если ваша игра принадлежит группе, выберите эту группу в поле Creator перед отправкой.
  5. Скопируйте 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 с любой частотой и произвольными аргументами. Вот что это значит для этого меча.

Что может попробовать читер и что с этим делает SwordService
Читер пытаетсяРезультатПочему
Вызывать 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: проверьте

  1. Добавьте то, по чему бить. На вкладке Avatar или Home нажмите Character, чтобы открыть Rig Generator, выберите риг (например, R15, затем Block Avatar), и он вставится в Workspace. Отодвиньте его на несколько стадов от вашего SpawnLocation.
  2. Нажмите Play, экипируйте Sword из хотбара, подойдите к ригу и кликните. После первого удара над ним появляется полоска здоровья, потому что по умолчанию Humanoid показывает полоску, только когда его Health ниже MaxHealth. Humanoid начинает со 100 здоровья, поэтому пятый удар его выбивает.
  3. Кликайте так быстро, как можете. Что-то делает только один взмах раз в 0.6 секунды.
  4. Отойдите от рига примерно на 8 стадов или повернитесь к нему спиной и взмахните. Ничего не происходит, потому что ни один его парт не находится в боксе.
  5. Проверьте на настоящем игроке. Выберите Server & Clients в выпадающем списке режимов теста, задайте 2 клиента и нажмите Play. Ударьте другого игрока в течение 10 секунд после его спавна: ничего не происходит из-за ForceField при спавне. После этого каждый удар снимает 20. По умолчанию персонажи игроков ещё и восстанавливают 1% от MaxHealth каждую секунду, поэтому между драками их здоровье понемногу возвращается.
  6. Если в вашей игре есть 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 в боксе перед игроком.

RoCode делает
  • Создаёт 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 секунды сетевого запаса на кулдауне. Они по-прежнему могут двигать своего персонажа, например вплотную к кому-то, потому что каждое устройство управляет движением своего персонажа. Следующий слой это серверная проверка движения.

Как сделать боевую систему с комбо?

Держите на сервере счётчик взмахов на игрока, сбрасывайте его после короткой паузы и выбирайте урон и анимацию по счётчику. Проверка попадания остаётся той же. Раздел Как расширить разбирает ещё отбрасывание, зачёт убийств и блок.

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

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

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

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