Накратко
Сложи в 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, преди да публикуваш.