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