V skratke
Do StarterPack dajte Tool s názvom Sword a partom s názvom Handle. LocalScript v Tool počúva Tool.Activated, prehrá animáciu švihu a zavolá RemoteEvent bez argumentov. Script v ServerScriptService skontroluje cooldown a to, že hráč žije a drží meč, nájde Humanoid v boxe pred ním cez workspace:GetPartBoundsInBox a zavolá Humanoid:TakeDamage raz na každý cieľ.
- Nedávajte poškodenie z udalosti
Touchedčepele: zariadenie hráča ovláda svoju postavu a môže vyvolať Touched odkiaľkoľvek, a práve meč je uvedený ako príklad na stránke Robloxu o network ownership. - Klient neposiela ani cieľ, ani poškodenie. Cooldown, hitbox a výšku poškodenia vlastní server.
TakeDamagenerobí nič, kým má cieľ ForceField, napríklad prvých 10 sekúnd po spawne na SpawnLocation.- Údery prechádzajú cez steny alebo zasiahnu skôr, než švih vizuálne dosiahne cieľ? Použite verziu serverového skriptu s nápriahom a kontrolou stien.
Na tejto stránke
Ako funguje funkčný meč
Meč, ktorý funguje v skutočnej hre, je rozdelený medzi zariadenie hráča a server. Stránka Robloxu o nástrojoch uvádza, že vstup pre nástroje má žiť v LocalScripte, pretože len zariadenie hráča vie, kedy vstup nastane, a že väčšina nástrojov potrebuje LocalScript, serverový Script a RemoteEvent medzi nimi. Tento návod používa presne takéto rozdelenie. Jeden švih vyzerá takto:
- Hráč klikne, ťukne alebo stlačí spúšť gamepadu s nasadeným Sword. V LocalScripte sa spustí
Tool.Activated. - LocalScript prehrá animáciu švihu, ak existuje, a zavolá RemoteEvent
SwordSwing. Nič iné neposiela. - Serverový Script skontroluje cooldown, to, že hráč žije, a to, že má Sword v ruke.
- Server postaví vlastný hitbox pred postavou hráča a nájde každý Humanoid v ňom.
- Každý z týchto Humanoidov raz stratí zdravie cez
TakeDamage.
| Prvok | Kde je | Čo robí |
|---|---|---|
Tool Sword | StarterPack | To, čo hráč drží. Roblox skopíruje všetko zo StarterPack do Backpacku hráča pri každom spawne jeho postavy. |
Part Handle | Vnútri Tool | Part, za ktorý postava drží. Čepeľ je k nemu privarená. |
LocalScript SwordClient | Vnútri Tool | Počuje kliknutie, prehrá animáciu švihu a zavolá remote. |
RemoteEvent SwordSwing | ReplicatedStorage (vytvára ho SwordService) | Nesie „švihol som“ zo zariadenia hráča na server, bez argumentov. |
Script SwordService | ServerScriptService | Overí každý švih, nájde, kto stojí pred hráčom, a dá poškodenie. Jediné miesto, kde môže nastať úder. |
ServerScriptService
SwordService Script new
StarterPack
Sword Tool new
Handle Part new
Blade Part new
WeldConstraint WeldConstraint new
SwordClient LocalScript new
Krok 1: postavte Tool meča
- V Exploreri nabehnite kurzorom na Workspace, kliknite na tlačidlo + a vložte Tool. Premenujte ho na
Sword. Serverový skript hľadá presne tento názov. Meč staviate vo Workspace, ako radí stránka Robloxu o nástrojoch, pretože tam vidíte jeho party a môžete ich posúvať a meniť ich veľkosť. Posledný krok ho presunie do StarterPack. - Do Tool vložte Part a pomenujte ho
Handle. Je to rukoväť, za ktorú postava meč drží. Musí byť priamym potomkom Tool a jediným partom s týmto názvom: pri dvoch Handle Roblox vyberie jeden náhodne a postava môže držať meč za čepeľ. - Do Tool vložte druhý Part, pomenujte ho
Blade, dajte mu tvar a umiestnite ho tak, aby trčal z vrchu Handle. - Do Blade vložte WeldConstraint. V okne Properties nastavte jeho
Part0na Handle aPart1na Blade, aby meč zostal celý, kým ho hráč nosí. - Označte oba party a uistite sa, že Anchored je vypnuté. Ukotvený part v nástroji prikuje postavu na miesto, keď si ho nasadí. Obom vypnite aj CanCollide, aby čepeľ pri švihu nenarážala do hráčov a stien.
- Označte Tool a zrušte zaškrtnutie CanBeDropped. Keď je zaškrtnuté, stlačenie Backspace vyhodí meč do Workspace.
- Presuňte hotový Sword z Workspace do StarterPack. Tool ponechaný vo Workspace je predmet na zdvihnutie, ktorý si vezme jeden hráč, nie meč, ktorý má od začiatku v Backpacku každý.
Poslúži aj meč z jedného MeshPartu: pomenujte tento MeshPart Handle a Weld preskočte. Ak pri teste postava drží meč pod zvláštnym uhlom, označte Tool a dolaďte jeho vlastnosti úchopu (GripPos, GripForward, GripRight a GripUp) v okne Properties.
Krok 2: pridajte serverový skript
Nabehnite kurzorom na ServerScriptService, vložte Script s názvom SwordService a vložte doň kód nižšie. Je to jediné miesto, kde môže nastať úder mečom. Nastavenia na začiatku sú riadky, ktoré máte meniť.
-- Script v ServerScriptService s názvom SwordService.
-- Jediné miesto, kde môže nastať úder mečom: overí švih, nájde ciele pred
-- útočníkom vlastným hitboxom a dá poškodenie.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Nastavenia
local SWORD_NAME = "Sword" -- názov Tool v StarterPack
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- rovnakú hodnotu majte v SwordClient
local HIT_RANGE = 6 -- study pred útočníkom
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false -- false: hráči toho istého tímu sa nemôžu zraniť
-- Švihy poslané presne po COOLDOWN_SECONDS môžu po sieťovom oneskorení prísť
-- o niečo bližšie k sebe, preto server dáva takúto rezervu a neodmietne skutočný švih
local NETWORK_SLACK = 0.1
-- Remote, ktorý volá LocalScript meča. Nenesie argumenty: kto dostane úder,
-- rozhoduje server, takže klient nemá čo falšovať.
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
-- Neutrálni hráči (bez tímu) sa môžu biť vždy
return not attacker.Neutral and not target.Neutral and attacker.Team == target.Team
end
local function onSwing(player: Player)
-- 1. Jeden švih za cooldown, nech sa remote volá akokoľvek často
local now = os.clock()
local last = lastSwing[player]
if last and now - last < COOLDOWN_SECONDS - NETWORK_SLACK then
return
end
-- 2. Útočník musí žiť a držať meč
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. Vlastný hitbox servera: box pred koreňovým partom útočníka
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. Každý Humanoid v boxe dostane poškodenie raz, aj keď je v ňom viac jeho partov
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) -- nerobí nič, kým má cieľ ForceField
end
end
end
end
swingEvent.OnServerEvent:Connect(onSwing)
Players.PlayerRemoving:Connect(function(player: Player)
lastSwing[player] = nil
end)
SwordService si RemoteEvent SwordSwing vytvorí sám pri spustení hry, takže do ReplicatedStorage nemusíte nič vkladať ručne. Ak ste už RemoteEvent s týmto názvom vytvorili, odstráňte ho: LocalScript by mohol nájsť ten váš a ten na serveri nikto nepočúva.
| Nastavenie | Hodnota tu | Čo mení |
|---|---|---|
SWORD_NAME | "Sword" | Názov Tool, ktorý server očakáva v ruke hráča. Zmeňte ho, ak sa váš Tool volá inak. |
DAMAGE | 20 | Koľko zdravia uberie každý úder. Humanoid začína so 100 zdravia, takže päť úderov vyradí testovací rig. Postavy hráčov si predvolene obnovujú 1 % z MaxHealth každú sekundu, takže hráč, ktorého bijete maximálnou rýchlosťou, piaty úder prežije a treba šiesty. |
COOLDOWN_SECONDS | 0.6 | Čas medzi švihmi. Rovnakú hodnotu nastavte v SwordClient. |
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT | 6, 5, 6 | Hitbox v studoch: ako ďaleko pred hráča siaha, aký je široký a vysoký. |
FRIENDLY_FIRE | false | Pri false sa hráči toho istého tímu nemôžu zraniť. Hráči bez tímu sa môžu biť vždy a NPC sa dá zasiahnuť vždy. |
NETWORK_SLACK | 0.1 | O koľko skôr pred koncom cooldownu server ešte prijme švih. Dve kliknutia s odstupom 0.6 sekundy môžu po sieťovom oneskorení prísť o niečo bližšie k sebe a bez tejto rezervy by server odmietol skutočný švih, ktorý hráč už videl. |
Krok 3: pridajte LocalScript do Tool
Do Tool Sword vložte LocalScript, pomenujte ho SwordClient a vložte doň tento kód:
-- LocalScript vnútri Tool Sword s názvom SwordClient.
-- Tool.Activated sa spúšťa na zariadení hráča, preto tento skript počúva kliknutie,
-- ťuknutie alebo spúšť, prehrá animáciu švihu a požiada server o švih.
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 -- rovnaká hodnota ako v SwordService
local SWING_ANIMATION_ID = "" -- nepovinné: "rbxassetid://" a za tým id vašej animácie
local player = Players.LocalPlayer
local lastSwing = 0
local swingTrack: AnimationTrack? = nil
local trackCharacter: Model? = nil
-- Animáciu načítame raz na postavu. Animácie spustené na vašej vlastnej
-- postave z vášho zariadenia vidia všetci hráči.
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 -- server to kontroluje tiež; kontrola tu ušetrí zbytočné požiadavky
end
lastSwing = now
if swingTrack then
swingTrack:Play()
end
swingEvent:FireServer()
end)
Zatiaľ nechajte SWING_ANIMATION_ID prázdne. Meč funguje aj bez animácie, pretože zásah aj tak rozhoduje server. Ako ho vyplniť, ukazuje časť Pridajte animáciu švihu.
Activated sa spúšťa na kliknutie myšou, ťuknutie na telefóne aj spúšť na gamepade, takže ten istý skript funguje na akomkoľvek zariadení. Roblox kopíruje Tool a LocalScript v ňom do Backpacku každého hráča pri spawne jeho postavy, takže každému hráčovi beží vlastná kópia.
LocalScript má vlastný cooldown len preto, aby neposielal požiadavky, ktoré server aj tak ignoruje. Nie je to bezpečnostná kontrola: cheater ho môže odstrániť, zmeniť alebo volať SwordSwing zo svojho kódu. Návod na RemoteEvent vysvetľuje, prečo treba každý remote overovať na serveri, a Script vs LocalScript vs ModuleScript (po anglicky) ukazuje, čo LocalScript môže a čo nemôže meniť.
Ako server rozhoduje, kto dostal úder
Keď príde SwordSwing, SwordService sa klienta na nič nepýta. Postaví box pred postavou útočníka tam, kde ju vidí server, a cez workspace:GetPartBoundsInBox sa opýta enginu, ktoré party sú v ňom. Táto metóda nahrádza staršiu FindPartsInRegion3, ktorú Roblox označuje ako zastaranú.
Stred boxu je 3 study pred koreňovým partom útočníka. Je to posun CFrame.new(0, 0, -HIT_RANGE / 2): CFrame sa pozerá pozdĺž svojej zápornej osi Z, to je jeho LookVector. Preto sa box ťahá od stredu postavy 6 studov dopredu, na šírku má 5 studov a na výšku 6. Dopyt porovnáva ohraničujúci box (bounding box) každého partu, rýchle priblíženie jeho objemu v tvare kvádra, takže okrúhle party a meshe sa počítajú o niečo väčšie, ako vyzerajú. Pre meč je táto malá rezerva užitočná.
| Krok | Kód | Prečo |
|---|---|---|
| Preskočiť útočníka | OverlapParams s Exclude a postavou útočníka | Vlastné ruky, nohy a meč útočníka sú v boxe tiež. |
| Nájsť postavu | part:FindFirstAncestorOfClass("Model") | Part v boxe môže byť končatina, klobúk alebo nástroj v ruke. FindFirstAncestorOfClass porovnáva presný názov triedy, takže obíde klobúk (trieda Accessory) aj nástroj v ruke (trieda Tool, hoci Tool je druh Model) a zastaví sa na modeli postavy. |
| Nájsť Humanoid | model:FindFirstChildOfClass("Humanoid") | Zasiahnuť sa dá všetko, čo má Humanoid: hráči, NPC aj testovacie figuríny. Steny a podlahy sa preskočia. |
| Raz na Humanoid | tabuľka alreadyHit | V boxe je zvyčajne viac partov tej istej postavy. Bez tabuľky by každý z nich dal poškodenie znova. |
| Len živé ciele | target.Health > 0 | Už vyradenú postavu znova neudrie. |
| Tímy | isTeammate | Pri FRIENDLY_FIRE rovnom false sa hráči toho istého tímu preskočia. Hráč, ktorého vlastnosť Neutral je true, tím nemá. |
| Poškodenie | target:TakeDamage(DAMAGE) | Zníži Health, ak cieľ nechráni ForceField. |
Tabuľka alreadyHit sa vytvára nanovo pri každom švihu, takže toho istého hráča môžete ďalším švihom zasiahnuť znova, keď uplynie cooldown. To je pravidlo „raz na cieľ za švih“, s ktorým majú meče na Touched neustále problémy.
Skript používa TakeDamage, nie priradenie Health. Referencia Robloxu uvádza, že TakeDamage sa Humanoidu nedotkne, kým ho chráni ForceField, zatiaľ čo priame priradenie Health ForceField ignoruje. Hráč, ktorý sa spawne na SpawnLocation, predvolene dostane ForceField na 10 sekúnd (Duration pri SpawnLocation), takže nováčikov nemožno zasiahnuť v momente, keď sa objavia.
Štyri spôsoby, ako urobiť hitbox meča: porovnanie
Návody na meče sa líšia hlavne v jednom: ako zistiť, čo čepeľ zasiahla. Bežné sú štyri odpovede. Líšia sa tým, ako presne sledujú čepeľ, koľko práce stoja server a či cheater dokáže výsledok sfalšovať.
| Spôsob | Ako funguje | Kto rozhoduje | Presnosť | Na čo je najlepší |
|---|---|---|---|---|
Touched na čepeli | Poškodenie zakaždým, keď sa part čepele dotkne postavy | Zariadenie útočníka, ktoré vlastní svoju postavu aj meč | Sleduje čepeľ, ale pri dotyku sa spustí niekoľkokrát | Na nič v hre s inými hráčmi: zariadenie útočníka ho môže vyvolať odkiaľkoľvek |
| Box pred hráčom (tento návod) | Jeden dopyt GetPartBoundsInBox na serveri za švih | Server | Pevný box, nie dráha čepele. Meshe sa počítajú podľa ohraničujúcich boxov, takže trochu štedro | Väčšina hier: jednoduché, lacné a nie je čo falšovať |
GetPartsInPart na parte hitboxu | Serverový dopyt s partom v tvare oblúka čepele, počas švihu | Server | Presné tvary: dokumentácia Robloxu uvádza, že robí úplnú geometrickú kontrolu, a odporúča dopyty boxom alebo guľou, keď stačí menšia presnosť, pretože sú lacnejšie | Veľké zbrane nezvyčajného tvaru, napríklad oblúk kosy |
| Raycasty pozdĺž čepele | Každý snímok švihu sa krátke lúče púšťajú z bodov na čepeli tam, kde boli v minulom snímku | Tá strana, ktorá ich púšťa. Na serveri treba serverovú predstavu o tom, kde je čepeľ | Tesne sleduje animáciu | Hry, kde záleží na presnej dráhe švihu. Takto fungujú hitbox moduly komunity |
Box je správna prvá voľba. Je to jeden dopyt na švih, nikdy nezávisí od animácie, ktorú by cheater mohol zmeniť, a ľahko sa nastavuje tromi číslami. Na part správneho tvaru alebo lúče pozdĺž čepele prejdite, keď sa hráči sťažujú, že zásahy pôsobia zle pri zbrani, ktorej dosah je ďaleko od boxu, a zachovajte to isté pravidlo: dopyt vykonáva a poškodenie dáva server.
Predvoľby mečov: od dýky po obojručák
Ten istý SwordService urobí piatimi nastaveniami veľmi odlišné zbrane. Tabuľka je východiskový bod vypočítaný pre figurínu z Rig Generatora so 100 Health. „Čas do vyradenia“ sa počíta od prvého úderu, keď každý švih zasiahne hneď, ako to cooldown dovolí.
| Zbraň | DAMAGE | COOLDOWN_SECONDS | HIT_RANGE | HIT_WIDTH | Údery (čas) | Poškodenie za sekundu |
|---|---|---|---|---|---|---|
| Dýka | 12 | 0.35 | 4 | 4 | 9 (2.8 s) | asi 34 |
| Meč (tento návod) | 20 | 0.6 | 6 | 5 | 5 (2.4 s) | asi 33 |
| Obojručný meč | 35 | 1.1 | 7 | 7 | 3 (2.2 s) | asi 32 |
| Kopija | 18 | 0.8 | 9 | 3 | 6 (4 s) | asi 23 |
- Hráči sa liečia, figuríny nie. Postavy hráčov si predvolene obnovujú 1 % z MaxHealth každú sekundu. Pri presne 100 poškodenia za 5 úderov hráč, ktorého bijete maximálnou rýchlosťou, piaty úder prežije a treba šiesty. Nechajte si rezervu, napríklad 21 poškodenia namiesto 20, ak vám záleží na presnom počte úderov.
- Škálujte NETWORK_SLACK spolu s cooldownom. 0.1 sekundy z návodu je šestina z 0.6. Ak necháte 0.1 pri dýke s cooldownom 0.35 sekundy, cheater by mohol biť každých 0.25 sekundy, o 40 % rýchlejšie. Berte približne šestinu z
COOLDOWN_SECONDS: 0.06 pre dýku. - Udržujte SwordClient v súlade. Nastavte tam ten istý
COOLDOWN_SECONDS, inak klient posiela švihy, ktoré server ignoruje.
Verzia 2: nápriah a žiadne údery cez steny
Keď základný meč funguje, objavia sa dve sťažnosti. Úder zasiahne v tom istom okamihu, keď hráč klikol, skôr ako animácia švihu dosiahne cieľ, a švih môže zasiahnuť niekoho, kto stojí na druhej strane tenkej steny, pretože box steny neberie do úvahy. Táto verzia SwordService opravuje oboje. Nahrádza skript z kroku 2: rovnaký názov, rovnaký remote, rovnaké nastavenia, takže SwordClient meniť netreba.
-- Script v ServerScriptService s názvom SwordService (verzia s nápriahom a kontrolou stien).
-- Nahrádza skript z kroku 2: rovnaké nastavenia a remote plus dve pravidlá. Úder zasiahne
-- WINDUP_SECONDS po kliknutí, keď švih dosiahne cieľ, a nikoho nezasiahne
-- cez stenu.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Nastavenia
local SWORD_NAME = "Sword"
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- rovnakú hodnotu majte v SwordClient
local WINDUP_SECONDS = 0.15 -- čas od kliknutia po úder; prispôsobte svojej animácii švihu
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
-- Vráti postavu a koreňový part útočníka, kým žije a drží meč
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, keď medzi útočníkom a cieľom nie je nič okrem samotného cieľa
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)
-- Po nápriahu kontrolujeme znova: útočník mohol zomrieť alebo odložiť meč
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)
Najprv odstráňte SwordService z kroku 2, inak oba skripty vytvoria každý svoj remote SwordSwing. Nastavte WINDUP_SECONDS na moment vo vašej animácii švihu, keď čepeľ prechádza pred postavou; pre rýchly švih sa hodí 0.15.
- Nápriah. Cooldown a kontroly „žije a drží meč“ sa vykonajú, keď príde kliknutie, potom
task.delayspustístrikepoWINDUP_SECONDS.strikeútočníka skontroluje ešte raz, pretože medzitým mohol zomrieť alebo odložiť meč, a až potom postaví box. Cieľ, ktorý počas nápriahu vyšiel z dosahu, úder nedostane, a presne to hráči čakajú, keď vidia švih. - Kontrola stien. Pre každý cieľ v boxe
hasClearLinepustí lúč od koreňového partu útočníka ku koreňovému partu cieľa a preskočí vlastnú postavu útočníka. Ak prvé, na čo narazí, patrí cieľu, alebo nenarazí na nič, úder sa započíta. Stena, dvere alebo iný hráč medzi nimi ho zablokujú. - Koľko to stojí. Jeden lúč navyše na cieľ za švih, čo je málo v porovnaní so samotným dopytom boxu.
Nápriah robí meč aj spravodlivejším voči cheaterom, ktorí udrú v tom istom okamihu, keď sa k niekomu teleportujú: server hľadá ciele o chvíľku neskôr, tam, kde v tom momente vidí postavy. Samotný teleport to nezastaví; na to treba kontrolu pohybu opísanú v časti Čo exploiter môže a čo nemôže.
Pridajte animáciu švihu (nepovinné)
SwordClient prehrá animáciu hneď, ako mu dáte ID. Animáciu urobíte raz, v Animation Editore v Studiu:
- Vložte rig na animáciu. Na karte Avatar alebo Home kliknite na Character, aby sa otvoril Rig Generator, a vyberte rig, ktorý zodpovedá avatarom vašej hry, napríklad R15 a potom Block Avatar.
- Na karte Avatar kliknite na Clip Editor, aby sa otvoril Animation Editor, označte rig a nastavte pózy pre krátky švih pravou rukou.
- Nastavte prioritu Action: kliknite na tlačidlo … v ovládaní prehrávania editora, nabehnite kurzorom na Set Animation Priority a vyberte Action. Action je nad Movement, Idle a Core, takže švih sa prehrá nad animáciami chôdze a státia a neprehrá s nimi.
- V tom istom menu … vyberte Publish to Roblox. Ak vaša hra patrí skupine, vyberte túto skupinu v poli Creator pred odoslaním.
- Skopírujte asset ID animácie z Toolboxu a v SwordClient nastavte
SWING_ANIMATION_IDna"rbxassetid://"a za tým toto číslo.
SwordClient načítava švih cez Animator postavy, nie cez starší Humanoid:LoadAnimation, ktorý Roblox označuje ako zastaraný. Referencia Robloxu k Animatoru uvádza, že animácie, ktoré zariadenie hráča spustí na vlastnej postave tohto hráča, sa replikujú na server a všetkým ostatným hráčom, takže LocalScript môže prehrať švih a uvidia ho všetci. Tiež uvádza, že Animator sa má vytvárať na serveri, preto ho nikdy nevytvárajte v LocalScripte. Pri postavách hráčov je zvyčajne vnútri Humanoidu a presne tam ho hľadá aj vlastný príklad animácie od Robloxu.
Animácia slúži len na vzhľad. Zásahy od nej nezávisia, takže pomalá, chýbajúca alebo zmenená animácia nikdy nezmení, kto dostane úder.
Ako prehrať animáciu stlačením klávesu, v slučke alebo na NPC, si prečítajte v návode na skript animácie.
V čom sa mýlia staršie návody na meče
Ak tento návod porovnávate s videom alebo príspevkom na fóre, toto sú dôležité rozdiely a dôvod, prečo každý z postupov spôsobuje problém.
| Návod | Problém | Tento návod |
|---|---|---|
Dáva poškodenie v udalosti Touched čepele | Zariadenie útočníka môže vyvolať Touched na svojom meči odkiaľkoľvek (stránka Robloxu o network ownership) a Touched sa pri jednom dotyku spustí niekoľkokrát za sebou (stránka Robloxu o debounce). | Server nájde ciele vlastným boxom, raz na Humanoid za švih. |
| Znižuje Health v LocalScripte | Zmena, ktorú LocalScript urobí na cudzej postave, zostane len na tomto jednom zariadení. | Všetko poškodenie sa dáva v SwordService. |
Používa wait(0.5) na cooldown | Roblox označuje globálne wait() ako zastarané, namiesto neho sa používa task.wait(), a cooldown, ktorý existuje len na klientovi, nikoho nezastaví. | Porovnáva čas os.clock() na serveri. Nič nečaká. |
Prehráva švih cez Humanoid:LoadAnimation | Je zastaraný, namiesto neho sa používa Animator:LoadAnimation. | Načítava švih cez Animator. |
Hľadá ciele cez Region3 a FindPartsInRegion3 | Zastarané. Roblox odporúča v nových projektoch používať GetPartBoundsInBox s OverlapParams. | Používa GetPartBoundsInBox. |
Dáva serverový Script do Tool a ten počúva Activated | Meč každého hráča spúšťa vlastnú kópiu serverového kódu a takéto skripty často dávajú poškodenie v Touched (prvý riadok). S predvolenými nastaveniami Script beží len vo Workspace alebo ServerScriptService, takže Script v Tool sa nespustí, kým si meč niekto prvýkrát nenasadí. Stránka Robloxu o nástrojoch opisuje väčšinu nástrojov ako LocalScript na vstup, serverový Script na efekt a RemoteEvent medzi nimi. | Jeden SwordService v ServerScriptService obsluhuje všetky meče v hre. |
Čo exploiter môže a čo nemôže
Počítajte s tým, že cheater ovláda všetko na svojom zariadení. Môže čítať a meniť vaše LocalScripty a bezpečnostný návod Robloxu uvádza, že môže volať RemoteEventy s akoukoľvek frekvenciou a ľubovoľnými argumentmi. Toto to znamená pre tento meč.
| Cheater sa pokúsi | Výsledok | Prečo |
|---|---|---|
Volať SwordSwing tak rýchlo, ako jeho kód dokáže, alebo použiť autoclicker | Započíta sa najviac jeden švih raz za 0.5 sekundy | Serverový cooldown je 0.6 sekundy mínus 0.1 sekundy sieťovej rezervy. Táto rezerva je maximum, čo cheater získa. |
| Poslať s remotom cieľ, číslo poškodenia alebo pozíciu | Ignoruje sa | onSwing číta len hráča, ktorého Roblox dosadí sám. Nič iné poslané s remotom sa nikdy nečíta. |
| Zmeniť SwordClient, napríklad odstrániť jeho cooldown | Na server to nemá vplyv | SwordService má svoje nastavenia v ServerScriptService, ktorý sa hráčom nikdy neposiela. |
| Biť, keď je mŕtvy alebo nemá meč v ruke | Ignoruje sa | SwordService kontroluje, že jeho Humanoid žije a že Tool s názvom Sword je vnútri jeho postavy, kam Roblox nástroj presunie pri nasadení. |
| Zasiahnuť niekoho z druhého konca mapy | Nič sa nestane | Box sa stavia okolo postavy útočníka tam, kde ju vidí server, a siaha len 6 studov dopredu. |
| Teleportovať sa k hráčovi a potom udrieť | Možné | Každé zariadenie ovláda pohyb svojej postavy a Roblox uvádza teleportovanie kamkoľvek medzi tým, čo klient môže so svojou postavou robiť. Serverová kontrola pohybu to môže odhaliť. |
| Udrieť cez tenkú stenu | Možné v rámci boxu 6 studov | Dopyt boxu z kroku 2 steny nehľadá. Verzia 2 pridáva kontrolu stien. |
| Prehrať akúkoľvek animáciu alebo žiadnu | Na zásahy to nemá vplyv | Zásahy nikdy nezávisia od animácie. Roblox uvádza, že cheateri môžu na svojej postave prehrávať ľubovoľné animácie. |
V dvoch riadkoch je „Možné“ a je to úprimné. Tento meč nedovolí cheaterovi vyberať, koho udrie, ako silno a ako často. Nedokáže mu zabrániť hýbať vlastnou postavou. Bezpečnostná dokumentácia Robloxu uvádza, že klienti ovládajú pohyb a fyziku svojej postavy a že kontroly pohybu treba nastaviť pre každú hru zvlášť. Pre súťažnú hru je ďalšou vrstvou serverová kontrola pohybu (návod na sprint takú stavia, upozorňuje na hrubé speedhacky a vzdialené teleporty) alebo server authority od Robloxu, ktorú dokumentácia opisovala ako betu, keď sme to kontrolovali 13. októbra 2026.
Krok 4: otestujte
- Pridajte niečo, do čoho sa dá biť. Na karte Avatar alebo Home kliknite na Character, aby sa otvoril Rig Generator, vyberte rig (napríklad R15, potom Block Avatar) a vloží sa do Workspace. Odsuňte ho o niekoľko studov od svojho SpawnLocation.
- Stlačte Play, nasaďte si Sword z hotbaru, podíďte k rigu a kliknite. Po prvom údere sa nad ním objaví ukazovateľ zdravia, pretože Humanoid predvolene ukazuje ukazovateľ, len keď je jeho Health pod MaxHealth. Humanoid začína so 100 zdravia, takže piaty úder ho vyradí.
- Klikajte tak rýchlo, ako vládzete. Niečo urobí len jeden švih raz za 0.6 sekundy.
- Odíďte od rigu asi na 8 studov alebo sa k nemu otočte chrbtom a švihnite. Nič sa nestane, pretože žiadny jeho part nie je v boxe.
- Otestujte to na skutočnom hráčovi. V rozbaľovacom zozname režimov testu vyberte Server & Clients, nastavte 2 klientov a stlačte Play. Udrite druhého hráča do 10 sekúnd po jeho spawne: nič sa nestane kvôli ForceField pri spawne. Potom každý úder uberie 20. Postavy hráčov si predvolene navyše obnovujú 1 % z MaxHealth každú sekundu, takže medzi bojmi sa im zdravie postupne vracia.
- Ak má vaša hra Teams, dajte oboch testovacích hráčov do jedného tímu. Pri
FRIENDLY_FIRErovnom false si ich švihy navzájom nič neurobia.
Celý čas majte otvorené okno Output (menu Window, potom Output). Keď tieto skripty fungujú, nič nevypisujú, takže každá červená chyba od SwordService alebo SwordClient je skutočný problém. Pozrite si Časté chyby.
Ako rozšíriť meč na bojový systém
Kombá
Na serveri majte počítadlo švihov pre každého hráča vedľa lastSwing. Ak bol predchádzajúci švih nedávno, pripočítajte 1; inak začnite znova od 1. Potom vyberajte poškodenie podľa počítadla, napríklad viac poškodenia pri každom treťom údere, a počítadlo čistite pri PlayerRemoving rovnakým spôsobom. Klient si môže viesť vlastný počet, aby vybral, ktorú animáciu prehrá, pretože animácia nikdy nerozhoduje o zásahu. Box a kontroly zostávajú presne rovnaké.
Odhodenie
Po TakeDamage môže SwordService cieľ odstrčiť cez ApplyImpulse na RootPart cieľa v smere rootPart.CFrame.LookVector útočníka. Referencia Robloxu uvádza, že náraz závisí od hmotnosti cieľa a že serverový Script ho môže volať na parte, ktorý vlastní server, alebo na parte, ktorý automaticky vlastní klient. Zariadenie každého hráča simuluje jeho vlastnú postavu, preto odhodenie testujte na hráčoch cez Server & Clients, nielen na rigu.
Započítanie zabití do rebríčka
Tesne pred target:TakeDamage(DAMAGE) zaznamenajte, kto udrel naposledy, cez target:SetAttribute("LastHitBy", player.UserId). V serverovom Scripte pripojte udalosť Died pri Humanoide každej postavy, prečítajte tento atribút, nájdite útočníka cez Players:GetPlayerByUserId a pripočítajte 1 k IntValue Kills v jeho leaderstats. Vytvorte ho vedľa Coins a Wins ako v kroku 1 návodu na rebríček a meňte ho na serveri ako v kroku 2.
Blok
Pridajte druhý RemoteEvent, ktorý klient zavolá, keď sa tlačidlo bloku stlačí a pustí, a nech server nastavuje atribút Blocking na postave tohto hráča s vlastným limitom frekvencie. V SwordService znížte alebo preskočte poškodenie, keď má postava cieľa nastavený Blocking. Cheater si aj tak sám volí, kedy blokovať, preto urobte blok krátky alebo mu dajte cooldown.
Predaj meča alebo jeho rozdávanie na každé kolo
StarterPack dáva meč každému hráčovi pri každom spawne. Ak ho chcete namiesto toho predávať, dajte ho do priečinka ShopItems z návodu na GUI obchodu. Katalóg toho návodu už predáva Tool s názvom ClassicSword, takže tento Tool buď pomenujte ClassicSword a nastavte rovnaký SWORD_NAME, alebo zmeňte záznam v katalógu. Ak ho chcete dávať len na čas kola, použite skript GiveRoundTool z návodu na systém kôl: Sword majte v ServerStorage, nie v StarterPack, a v tom skripte nahraďte "RoundTool" za "Sword".
Nepriatelia na boj a zbrane na diaľku
Pre NPC, ktoré prenasleduje hráčov, postupujte podľa návodu na hľadanie cesty pre NPC. Meč mu dáva poškodenie ako každému inému Humanoidu. O zbrani, ktorá zasahuje na diaľku podľa rovnakých serverových pravidiel, si prečítajte v návode na zbrane.
Časté chyby a riešenia
Pred stlačením Play otvorte okno Output (menu Window, potom Output). Väčšina problémov s mečom tam buď vypíše chybu, alebo vzniká kvôli názvu, ktorý sa nezhoduje.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("SwordSwing")'
SwordClient čaká na remote, ktorý vytvára SwordService, takže SwordService nebeží. Skontrolujte, že je to Script, nie LocalScript, že je priamo v ServerScriptService, nie je vypnutý a že v Output nie je chyba od neho.
Švihám, ale nikto nedostáva poškodenie
Skontrolujte po poradí: SwordClient je LocalScript, nie Script, a je priamo v Tool Sword; Tool sa volá presne Sword alebo tak, ako je uvedené v SWORD_NAME; cieľ nie je ďalej ako 6 studov pred vami; cieľ sa spawnol pred viac ako 10 sekundami, takže jeho ForceField už zmizol; a ak používate Teams, nie ste v tom istom tíme pri FRIENDLY_FIRE rovnom false.
Meč zasahuje hráčov, ale nikdy nezasiahne moje NPC
Priestorové dopyty ako GetPartBoundsInBox nikdy nevrátia part, ktorý má vypnuté CanQuery (CanQuery platí, len keď je vypnuté aj CanCollide). Zapnite CanQuery späť pri častiach tela NPC a skontrolujte, že jeho Humanoid je priamym potomkom modelu NPC.
Moja postava sa zasekne, keď si nasadím meč
Niektorý part meča je ukotvený. Označte všetky party vnútri Tool a zrušte Anchored.
Niektoré švihy zasiahnu a iné minú na tú istú vzdialenosť
Vo verzii s nápriahom cieľ, ktorý vyšiel z boxu počas WINDUP_SECONDS, úder nedostane, a kontrola stien preskočí každého, kto stojí za stenou alebo za iným hráčom. Ak v playtestoch pôsobia minutia nespravodlivo, skráťte nápriah alebo zväčšite HIT_WIDTH.
Postava drží meč za čepeľ
Partov s názvom Handle je viac ako jeden a Roblox vybral nesprávny. Nechajte presne jeden Handle, rukoväť, a ostatné premenujte. Potom dolaďte vlastnosti úchopu pri Tool, ak je uhol stále zlý.
Čepeľ zostane na mieste alebo spadne, keď si nasadím meč
Čepeľ nie je privarená k Handle. Pridajte WeldConstraint, ktorého Part0 je Handle a Part1 je čepeľ.
Poškodenie vidím na svojej obrazovke, ale zdravie druhého hráča sa nemení
Poškodenie sa dáva z LocalScriptu, ktorý mení len vašu kópiu hry. Poškodenie dávajte len v SwordService, ako v kroku 2.
Urobiť s RoCode
Ak sa vám to všetko nechce stavať ručne, RoCode to môže urobiť vo vašom otvorenom place. Je to nezávislý AI agent na písanie kódu, nie od Robloxu: funkciu opíšete v jeho webovom chate a jeho plugin pre Roblox Studio vytvorí Tool, party a skripty vo vašom Exploreri, takže nemusíte kopírovať kód z okna chatu.
Urob meč: Tool s názvom Sword v StarterPack s Handle a k nemu privarenou čepeľou, LocalScript, ktorý pri Activated zavolá RemoteEvent, a serverový Script, ktorý skontroluje cooldown 0.6 sekundy a dá 20 poškodenia všetkým Humanoidom v boxe pred hráčom.
- Vytvorí Tool a jeho party cez Create Instance a nastaví ich vlastnosti cez Set Property
- Napíše SwordService a SwordClient cez Create Script a môže najprv vyhľadať existujúce bojové skripty cez Search Scripts
- Má za úlohu overiť kompiláciu každého napísaného skriptu cez Check Script, ktorý skompiluje kód v Studiu bez spustenia (typy nekontroluje)
- Pred každou dávkou zmien aj po nej vytvorí bod na vrátenie, takže Ctrl+Z vracia po jednej dávke
RoCode nedokáže urobiť animáciu švihu ani ju nahrať: urobte ju v Animation Editore a vložte jej ID. S pluginom 3.9 alebo novším môže RoCode spustiť krátky playtest a prečítať chyby a s pluginom 3.9.11 alebo novším môže ovládať testovaciu postavu, ale neklikne v 3D okne, aby švihol, takže švihy kontrolujete sami. Stránka ako vytvoriť celú hru v Robloxe s RoCode, systém po systéme ukazuje, kam patria zbrane. Ako sa RoCode pripája k Studiu.
Časté otázky
Prečo môj meč zasiahne jedného hráča viackrát za jeden švih?
Pretože dáva poškodenie z Touched. Stránka Robloxu o debounce uvádza, že Touched sa pri jednom dotyku spustí niekoľkokrát za sebou a každý part cieľa sa môže dotknúť čepele. Tento návod hľadá ciele jedným dopytom boxu za švih a vedie zoznam, takže každý Humanoid stratí zdravie raz za švih.
Má byť poškodenie meča v LocalScripte alebo v Scripte?
V Scripte na serveri. Poškodenie dané z LocalScriptu mení len kópiu hry tohto hráča a všetko, čo je na zariadení hráča, môže cheater zmeniť. LocalScript má len počuť kliknutie, prehrať animáciu a zavolať RemoteEvent.
Ako pridať meču animáciu švihu?
Urobte ju v Animation Editore, nastavte prioritu Action, publikujte ju do Robloxu a jej asset ID zapíšte do SWING_ANIMATION_ID ako rbxassetid:// a za tým číslo. SwordClient ju prehrá cez Animator postavy. Animácie, ktoré zariadenie hráča spustí na vlastnej postave tohto hráča, vidia všetci.
Prečo sa animácia meča neprehráva?
Skontrolujte tri veci. Prioritu: Action je nad Movement, Idle a Core, takže švih s Action sa prehrá nad chôdzou a státím, kým nižšia priorita s nimi môže prehrať. Vlastníka: ak hra patrí skupine, publikujte animáciu s touto skupinou ako Creator. ID: SWING_ANIMATION_ID musí byť celý text rbxassetid:// s číslom vašej animácie, nie prázdny reťazec.
Aký hitbox je najlepší pre meč v Robloxe?
Pre väčšinu hier dopyt boxu na serveri raz za švih ako v tomto návode: jedno volanie GetPartBoundsInBox, klient nemá čo falšovať a tri čísla na nastavenie. GetPartsInPart s partom správneho tvaru alebo raycasty pozdĺž čepele použite, len keď je dosah zbrane ďaleko od boxu. Porovnanie štyroch spôsobov.
Ako urobiť, aby meč nezasahoval cez steny?
Pred daním poškodenia pustite lúč od koreňového partu útočníka ku koreňovému partu cieľa, preskočte postavu útočníka a úder započítajte, len ak prvé, na čo lúč narazí, patrí cieľu. Verzia 2 SwordService to robí pre každý cieľ.
Prečo úder zasiahne skôr, než animácia švihu dosiahne cieľ?
Server kontroluje hitbox v tom istom okamihu, keď príde kliknutie. Najprv počkajte krátky nápriah, napríklad 0.15 sekundy cez task.delay, potom skontrolujte, že útočník stále žije a drží meč, a postavte box, ako to robí verzia 2.
Môžu exploiteri s týmto mečom aj tak cheatovať?
Nemôžu vyberať, kto dostane úder, koľko poškodenia úder dá ani ako často bijú, pretože všetky tri veci rozhoduje server; maximum, čo získajú, je 0.1 sekundy sieťovej rezervy na cooldowne. Stále môžu hýbať svojou postavou, napríklad tesne k niekomu, pretože každé zariadenie ovláda pohyb svojej postavy. Ďalšou vrstvou je serverová kontrola pohybu.
Ako urobiť bojový systém s kombami?
Na serveri majte počítadlo švihov pre každého hráča, po krátkej pauze ho vynulujte a poškodenie aj animáciu vyberajte podľa počítadla. Kontrola zásahu zostáva rovnaká. Časť Ako rozšíriť rozoberá aj odhodenie, započítanie zabití a blok.
Zdroje a ďalšie čítanie
- Roblox Creator Docs: In-game tools (po anglicky). stavba nástroja vo Workspace, Handle, Weld, Grip, ukotvenie a prečo väčšina nástrojov používa LocalScript, Script a RemoteEvent
- Roblox Creator Docs: WorldRoot:GetPartBoundsInBox (po anglicky). dopyt boxu, OverlapParams a zastarané FindPartsInRegion3
- Roblox Creator Docs: Humanoid:TakeDamage (po anglicky). ochrana ForceField, ukazovateľ zdravia a regenerácia zdravia
- Roblox Creator Docs: Network ownership (po anglicky). exploit s mečom na Touched
- Roblox Creator Docs: Security tactics and cheat mitigation (po anglicky). nikdy neverte klientovi
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (po anglicky). čo klient môže robiť so svojou postavou a kontroly pohybu
- Roblox Creator Docs: Animation Editor (po anglicky). priorita animácie a publikovanie
- Roblox Creator Docs: Animator:LoadAnimation (po anglicky). ktoré animácie sa replikujú z klienta
- Roblox Creator Docs: Debounce patterns (po anglicky). prečo sa Touched pri jednom dotyku spustí niekoľkokrát
Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.