Ve zkratce
Dejte do StarterPack Tool s názvem Sword a partem s názvem Handle. LocalScript v Toolu poslouchá Tool.Activated, přehraje animaci švihu a zavolá RemoteEvent bez argumentů. Script ve ServerScriptService zkontroluje cooldown a to, že je hráč naživu a drží meč, najde Humanoidy v boxu před ním přes workspace:GetPartBoundsInBox a zavolá Humanoid:TakeDamage jednou na cíl.
- Neudílejte poškození z události
Touchedčepele: zařízení hráče ovládá svou postavu a může Touched vyvolat odkudkoli, a právě meč je uvedený jako příklad na stránce Robloxu o network ownership. - Klient neposílá ani cíl, ani poškození. Cooldown, hitbox i výši poškození má v rukou server.
TakeDamagenedělá nic, dokud má cíl ForceField, například prvních 10 sekund po spawnu na SpawnLocation.- Zásahy procházejí zdmi nebo přicházejí dřív, než švih viditelně dosáhne na cíl? Vezměte verzi serverového skriptu s nápřahem a kontrolou zdí.
Na této stránce
Jak je funkční meč postavený
Meč, který funguje ve skutečné hře, je rozdělený mezi zařízení hráče a server. Stránka Robloxu o nástrojích říká, že vstup pro nástroje má žít v LocalScriptu, protože jen zařízení hráče ví, kdy ke vstupu dochází, a že většina nástrojů potřebuje LocalScript, serverový Script a RemoteEvent mezi nimi. Tento návod používá přesně takové rozdělení. Jeden švih vypadá takto:
- Hráč klikne, klepne nebo stiskne spoušť gamepadu s vybaveným Sword. V LocalScriptu se spustí
Tool.Activated. - LocalScript přehraje animaci švihu, pokud nějaká je, a zavolá RemoteEvent
SwordSwing. Nic jiného neposílá. - Serverový Script zkontroluje cooldown, to, že je hráč naživu, a to, že má Sword v ruce.
- Server postaví vlastní hitbox před postavou hráče a najde každý Humanoid uvnitř.
- Každý z těchto Humanoidů jednou ztratí zdraví přes
TakeDamage.
| Prvek | Kde je | Co dělá |
|---|---|---|
Tool Sword | StarterPack | To, co hráč drží. Roblox při každém spawnu jeho postavy zkopíruje vše ze StarterPack do Backpacku hráče. |
Part Handle | Uvnitř Toolu | Part, za který postava drží. Čepel je k němu přivařená. |
LocalScript SwordClient | Uvnitř Toolu | Zachytí kliknutí, přehraje animaci švihu a zavolá remote. |
RemoteEvent SwordSwing | ReplicatedStorage (vytváří ho SwordService) | Nese „švihl jsem“ ze zařízení hráče na server, bez argumentů. |
Script SwordService | ServerScriptService | Zkontroluje každý švih, najde, kdo stojí před hráčem, a udělí poškození. Jediné místo, kde může dojít k zásahu. |
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če
- V Exploreru najeďte na Workspace, klikněte na tlačítko + a vložte Tool. Přejmenujte ho na
Sword. Serverový skript hledá právě tento název. Meč stavíte ve Workspace, jak radí stránka Robloxu o nástrojích, protože tam vidíte jeho party a můžete je posouvat a měnit jejich velikost. Poslední krok ho přesune do StarterPack. - Vložte do Toolu Part a pojmenujte ho
Handle. To je jílec, za který postava meč drží. Musí být přímým potomkem Toolu a jediným partem s tímto názvem: při dvou Handle Roblox jeden vybere náhodně a postava může držet meč za čepel. - Vložte do Toolu druhý Part, pojmenujte ho
Blade, dejte mu tvar a umístěte ho tak, aby trčel z horní části Handle. - Vložte do Blade WeldConstraint. V okně Properties nastavte jeho
Part0na Handle aPart1na Blade, aby meč zůstal pohromadě, zatímco ho hráč nosí. - Vyberte oba party a ověřte, že Anchored je vypnuté. Ukotvený part v nástroji přikove postavu na místo, když ho vybaví. U obou vypněte i CanCollide, aby čepel při švihu nenarážela do hráčů a zdí.
- Vyberte Tool a odškrtněte CanBeDropped. Když je zaškrtnuté, stisk Backspace meč vyhodí do Workspace.
- Přetáhněte hotový Sword z Workspace do StarterPack. Tool ponechaný ve Workspace je sebratelný předmět, který si vezme jeden hráč, ne meč, který má od začátku v Backpacku každý.
Poslouží i meč z jednoho MeshPartu: pojmenujte tento MeshPart Handle a Weld vynechte. Pokud při testu postava drží meč pod divným úhlem, vyberte Tool a dolaďte jeho vlastnosti úchopu (GripPos, GripForward, GripRight a GripUp) v okně Properties.
Krok 2: přidejte serverový skript
Najeďte na ServerScriptService, vložte Script s názvem SwordService a vložte do něj kód níže. Je to jediné místo, kde může dojít k zásahu mečem. Nastavení na začátku jsou řádky, které máte měnit.
-- Script ve ServerScriptService s názvem SwordService.
-- Jediné místo, kde může dojít k zásahu mečem: zkontroluje švih, najde cíle před
-- útočníkem vlastním hitboxem a udělí poškození.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Nastavení
local SWORD_NAME = "Sword" -- název Toolu ve StarterPack
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- držte stejnou hodnotu v SwordClient
local HIT_RANGE = 6 -- studů před útočníkem
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false -- false: hráči ze stejného týmu se nemohou zranit navzájem
-- Švihy odeslané přesně po COOLDOWN_SECONDS mohou po síťovém zpoždění dorazit
-- o něco blíž u sebe, proto server dává tuto rezervu a skutečný švih nezahodí
local NETWORK_SLACK = 0.1
-- Remote, který volá LocalScript meče. Nenese žádné argumenty: kdo dostane zásah,
-- rozhoduje server, takže klient nemá co podvrhnout.
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ální hráči (bez týmu) se mohou vždy navzájem zasáhnout
return not attacker.Neutral and not target.Neutral and attacker.Team == target.Team
end
local function onSwing(player: Player)
-- 1. Jeden švih za cooldown, ať se remote volá jakkoli č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í být naživu a držet 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 serveru: box před kořenovým partem ú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 boxu dostane poškození jednou, i když je uvnitř několik jeho partů
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) -- nedělá nic, dokud má cíl ForceField
end
end
end
end
swingEvent.OnServerEvent:Connect(onSwing)
Players.PlayerRemoving:Connect(function(player: Player)
lastSwing[player] = nil
end)
SwordService si při spuštění hry sám vytvoří RemoteEvent SwordSwing, takže do ReplicatedStorage nemusíte nic vkládat ručně. Pokud jste už RemoteEvent s tímto názvem vytvořili, smažte ho: LocalScript by mohl najít ten váš, a ten na serveru nikdo neposlouchá.
| Nastavení | Hodnota tady | Co mění |
|---|---|---|
SWORD_NAME | "Sword" | Název Toolu, který server očekává v ruce hráče. Změňte ho, pokud se váš Tool jmenuje jinak. |
DAMAGE | 20 | Kolik zdraví každý zásah ubere. Humanoid začíná se 100 zdraví, takže pět zásahů vyřadí testovací rig. Postavy hráčů ve výchozím stavu obnovují 1% z MaxHealth každou sekundu, takže hráč, kterého bijete maximální rychlostí, pátý zásah přežije a je potřeba šestý. |
COOLDOWN_SECONDS | 0.6 | Čas mezi švihy. Nastavte stejnou hodnotu v SwordClient. |
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT | 6, 5, 6 | Hitbox ve studech: jak daleko před hráče sahá, jak je široký a vysoký. |
FRIENDLY_FIRE | false | Při false se hráči ze stejného týmu nemohou zranit navzájem. Hráči bez týmu se mohou zasáhnout vždy a NPC lze zasáhnout vždy. |
NETWORK_SLACK | 0.1 | O kolik dřív před koncem cooldownu server švih ještě přijme. Dvě kliknutí s odstupem 0.6 sekundy mohou po síťovém zpoždění dorazit o něco blíž u sebe a bez této rezervy by server zahodil skutečný švih, který hráč už viděl. |
Krok 3: přidejte LocalScript do Toolu
Vložte do Toolu Sword LocalScript, pojmenujte ho SwordClient a vložte do něj tento kód:
-- LocalScript uvnitř Toolu Sword s názvem SwordClient.
-- Tool.Activated se spustí na zařízení hráče, takže tento skript poslouchá kliknutí,
-- klepnutí nebo spoušť, přehraje animaci švihu a požádá 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 -- stejná hodnota jako v SwordService
local SWING_ANIMATION_ID = "" -- nepovinné: "rbxassetid://" a za ním id vaší animace
local player = Players.LocalPlayer
local lastSwing = 0
local swingTrack: AnimationTrack? = nil
local trackCharacter: Model? = nil
-- Animaci načteme jednou na postavu. Animace spuštěné na vaší vlastní
-- postavě z vašeho zařízení se ukazují všem hráčům.
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 také; kontrola tady ušetří zbytečné požadavky
end
lastSwing = now
if swingTrack then
swingTrack:Play()
end
swingEvent:FireServer()
end)
Zatím nechte SWING_ANIMATION_ID prázdné. Meč funguje i bez animace, protože o zásahu tak jako tak rozhoduje server. Jak ho vyplnit, ukazuje oddíl Přidejte animaci švihu.
Activated se spustí na kliknutí myší, klepnutí na telefonu i spoušť na gamepadu, takže jeden a týž skript funguje na jakémkoli zařízení. Roblox při spawnu postavy zkopíruje Tool a LocalScript v něm do Backpacku každého hráče, takže každý hráč má spuštěnou vlastní kopii.
LocalScript drží vlastní cooldown jen proto, aby neposílal požadavky, které server stejně ignoruje. Není to bezpečnostní kontrola: podvodník ho může smazat, změnit nebo zavolat SwordSwing ze svého kódu. Návod k RemoteEventům vysvětluje, proč je potřeba každý remote kontrolovat na serveru, a Script vs LocalScript vs ModuleScript (anglicky) ukazuje, co LocalScript měnit může a co ne.
Jak server rozhoduje, kdo dostal zásah
Když přijde SwordSwing, SwordService se klienta na nic neptá. Postaví box před postavou útočníka tam, kde ji vidí server, a zeptá se enginu, které party jsou uvnitř, přes workspace:GetPartBoundsInBox. Tato metoda nahrazuje starší FindPartsInRegion3, který Roblox označuje za zastaralý.
Střed boxu je 3 study před kořenovým partem útočníka. To je posun CFrame.new(0, 0, -HIT_RANGE / 2): CFrame se dívá podél své záporné osy Z, to je jeho LookVector. Box se tedy táhne od středu postavy 6 studů dopředu, na šířku má 5 studů a na výšku 6. Dotaz porovnává ohraničující box (bounding box) každého partu, rychlou aproximaci jeho objemu ve tvaru krabice, takže kulaté party a meshe se počítají o něco větší, než vypadají. U meče je tato malá rezerva užitečná.
| Krok | Kód | Proč |
|---|---|---|
| Vynechat útočníka | OverlapParams s Exclude a postavou útočníka | Vlastní ruce, nohy a meč útočníka jsou v boxu také. |
| Najít postavu | part:FindFirstAncestorOfClass("Model") | Part v boxu může být končetina, klobouk nebo nástroj v ruce. FindFirstAncestorOfClass porovnává přesný název třídy, takže projde kolem klobouku (třída Accessory) i nástroje v ruce (třída Tool, i když Tool je druh Modelu) a zastaví se u modelu postavy. |
| Najít Humanoid | model:FindFirstChildOfClass("Humanoid") | Zasáhnout lze vše, co má Humanoid: hráče, NPC i testovací figuríny. Zdi a podlahy se přeskakují. |
| Jednou na Humanoid | tabulka alreadyHit | V boxu obvykle skončí několik partů jedné postavy. Bez tabulky by každý z nich udělil poškození znovu. |
| Jen živé cíle | target.Health > 0 | Už vyřazená postava se znovu nezasahuje. |
| Týmy | isTeammate | Při FRIENDLY_FIRE rovném false se hráči ze stejného týmu přeskakují. Hráč, jehož vlastnost Neutral je true, tým nemá. |
| Poškození | target:TakeDamage(DAMAGE) | Sníží Health, pokud cíl nechrání ForceField. |
Tabulka alreadyHit se vytváří znovu při každém švihu, takže stejného hráče lze dalším švihem zasáhnout znovu, jakmile uplyne cooldown. To je pravidlo „jednou na cíl za švih“, se kterým mají meče na Touched neustálé potíže.
Skript používá TakeDamage, ne přiřazení do Health. Reference Robloxu říká, že TakeDamage se Humanoidu nedotkne, dokud ho chrání ForceField, zatímco přímé přiřazení do Health ForceField ignoruje. Hráč, který se spawne na SpawnLocation, dostane ve výchozím stavu ForceField na 10 sekund (Duration u SpawnLocation), takže nově příchozí nelze zasáhnout ve chvíli, kdy se objeví.
Čtyři způsoby, jak udělat hitbox meče: srovnání
Tutoriály k mečům se liší hlavně v jednom: jak zjistit, co čepel zasáhla. Běžné odpovědi jsou čtyři. Liší se tím, jak přesně sledují čepel, kolik práce stojí server a jestli může podvodník výsledek podvrhnout.
| Způsob | Jak funguje | Kdo rozhoduje | Přesnost | K čemu je nejlepší |
|---|---|---|---|---|
Touched na čepeli | Poškození pokaždé, když se part čepele dotkne postavy | Zařízení útočníka, které vlastní jeho postavu i meč | Sleduje čepel, ale při jednom doteku se spustí několikrát | K ničemu ve hře s dalšími hráči: zařízení útočníka ho může vyvolat odkudkoli |
| Box před hráčem (tento návod) | Jeden dotaz GetPartBoundsInBox na serveru za švih | Server | Pevný box, ne dráha čepele. Meshe se počítají podle ohraničujících boxů, takže trochu velkoryse | Většina her: jednoduché, levné a není co podvrhnout |
GetPartsInPart na partu hitboxu | Serverový dotaz s partem ve tvaru oblouku čepele, během švihu | Server | Přesné tvary: dokumentace Robloxu říká, že provádí úplnou geometrickou kontrolu, a navrhuje dotazy podle boxu nebo koule, když stačí menší přesnost, protože jsou levnější | Velké zbraně neobvyklého tvaru, například oblouk kosy |
| Raycasty podél čepele | Každý snímek švihu se krátké paprsky vysílají z bodů na čepeli tam, kde byly v minulém snímku | Ta strana, která je vysílá. Na serveru je potřeba serverová představa o tom, kde čepel je | Těsně sleduje animaci | Hry, kde záleží na přesné dráze švihu. Tak fungují hitbox moduly komunity |
Box je správná první volba. Je to jeden dotaz na švih, nikdy nezávisí na animaci, kterou by podvodník mohl změnit, a snadno se ladí třemi čísly. Na part potřebného tvaru nebo paprsky podél čepele přejděte, když si hráči stěžují, že zásahy působí špatně u zbraně, jejíž dosah má k boxu daleko, a zachovejte stejné pravidlo: dotaz provádí a poškození uděluje server.
Předvolby mečů: od dýky po obouručák
Jeden a týž SwordService udělá pěti nastaveními velmi různé zbraně. Tabulka je výchozí bod spočítaný pro figurínu z Rig Generatoru se 100 Health. „Čas do vyřazení“ se počítá od prvního zásahu, když každý švih zasáhne hned, jak to cooldown dovolí.
| Zbraň | DAMAGE | COOLDOWN_SECONDS | HIT_RANGE | HIT_WIDTH | Zásahy (čas) | Poškození 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 |
| Obouruční meč | 35 | 1.1 | 7 | 7 | 3 (2.2 s) | asi 32 |
| Kopí | 18 | 0.8 | 9 | 3 | 6 (4 s) | asi 23 |
- Hráči se léčí, figuríny ne. Postavy hráčů ve výchozím stavu obnovují 1% z MaxHealth každou sekundu. Při přesně 100 poškození za 5 zásahů hráč, kterého bijete maximální rychlostí, pátý zásah přežije a je potřeba šestý. Nechte si rezervu, například 21 poškození místo 20, pokud záleží na přesném počtu zásahů.
- Škálujte NETWORK_SLACK spolu s cooldownem. 0.1 sekundy z návodu je šestina z 0.6. Pokud necháte 0.1 u dýky s cooldownem 0.35 sekundy, podvodník by mohl útočit každých 0.25 sekundy, o 40% rychleji. Berte zhruba šestinu z
COOLDOWN_SECONDS: 0.06 pro dýku. - Držte SwordClient v souladu. Nastavte tam stejné
COOLDOWN_SECONDS, jinak klient posílá švihy, které server ignoruje.
Verze 2: nápřah a žádné zásahy skrz zdi
Jakmile základní meč funguje, objeví se dvě stížnosti. Zásah přijde ve stejném okamžiku, kdy hráč kliknul, dřív, než animace švihu dojde k cíli, a švih může zasáhnout toho, kdo stojí na druhé straně tenké zdi, protože box zdi nebere v úvahu. Tato verze SwordService opravuje obojí. Nahrazuje skript z kroku 2: stejný název, stejný remote, stejná nastavení, takže SwordClient měnit nemusíte.
-- Script ve ServerScriptService s názvem SwordService (verze s nápřahem a kontrolou zdí).
-- Nahrazuje skript z kroku 2: stejná nastavení a remote plus dvě pravidla. Zásah přijde
-- WINDUP_SECONDS po kliknutí, když švih dojde k cíli, a nikoho nezasáhne
-- skrz zeď.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Nastavení
local SWORD_NAME = "Sword"
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- držte stejnou hodnotu v SwordClient
local WINDUP_SECONDS = 0.15 -- čas od kliknutí do zásahu; přizpůsobte ho své animaci š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
-- Vrací postavu a kořenový part útočníka, dokud je naživu 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, když mezi útočníkem a cílem není nic kromě samotného cíle
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ápřahu kontrolujeme znovu: útočník mohl zemřít nebo meč schovat
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)
Nejdřív smažte SwordService z kroku 2, jinak oba skripty vytvoří každý svůj remote SwordSwing. Nastavte WINDUP_SECONDS na okamžik ve vaší animaci švihu, kdy čepel prochází před postavou; pro rychlý švih se hodí 0.15.
- Nápřah. Cooldown a kontroly „je naživu a drží meč“ proběhnou, když přijde kliknutí, pak
task.delayspustístrikepoWINDUP_SECONDS.strikeútočníka zkontroluje ještě jednou, protože mezitím mohl zemřít nebo meč schovat, a teprve pak postaví box. Cíl, který během nápřahu vyšel z dosahu, zásah nedostane, a přesně to hráči čekají, když švih vidí. - Kontrola zdí. Pro každý cíl v boxu vyšle
hasClearLinepaprsek od kořenového partu útočníka ke kořenovému partu cíle, s vynecháním vlastní postavy útočníka. Pokud první, na co narazí, patří cíli, nebo nenarazí na nic, zásah se počítá. Zeď, dveře nebo jiný hráč mezi nimi ho zablokují. - Kolik to stojí. Jeden paprsek navíc na cíl za švih, což je málo ve srovnání se samotným dotazem boxu.
Nápřah také dělá meč férovějším proti podvodníkům, kteří útočí ve stejném okamžiku, kdy se k někomu teleportují: server hledá cíle o chvilku později, tam, kde v tu chvíli vidí postavy. Samotný teleport to nezastaví; k tomu je potřeba kontrola pohybu popsaná v oddílu Co exploiter může a co ne.
Přidejte animaci švihu (nepovinné)
SwordClient už animaci přehraje, jakmile mu dáte ID. Animaci uděláte jednou, v Animation Editoru ve Studiu:
- Vložte rig pro animaci. Na kartě Avatar nebo Home klikněte na Character, otevře se Rig Generator, a vyberte rig, který odpovídá avatarům vaší hry, například R15 a pak Block Avatar.
- Na kartě Avatar klikněte na Clip Editor, otevře se Animation Editor, vyberte rig a nastavte pózy pro krátký švih pravou rukou.
- Nastavte prioritu Action: klikněte na tlačítko … v ovládání přehrávání editoru, najeďte na Set Animation Priority a vyberte Action. Action stojí nad Movement, Idle a Core, takže švih se přehraje přes animace chůze a stání, místo aby jim prohrál.
- Ve stejné nabídce … zvolte Publish to Roblox. Pokud vaše hra patří skupině, vyberte tuto skupinu v poli Creator před odesláním.
- Zkopírujte asset ID animace z Toolboxu a v SwordClient nastavte
SWING_ANIMATION_IDna"rbxassetid://"a za ním toto číslo.
SwordClient načítá švih přes Animator postavy, ne přes starší Humanoid:LoadAnimation, který Roblox označuje za zastaralý. Reference Robloxu k Animatoru říká, že animace, které zařízení hráče spustí na vlastní postavě tohoto hráče, se replikují na server a všem ostatním hráčům, takže LocalScript může švih přehrát a uvidí ho všichni. Stejně tak říká, že Animator se má vytvářet na serveru, takže ho nikdy nevytvářejte v LocalScriptu. U postav hráčů obvykle leží uvnitř Humanoidu a přesně tam ho hledá i vlastní příklad animace od Robloxu.
Animace je jen pro vzhled. Zásahy na ní nezávisí, takže pomalá, chybějící nebo změněná animace nikdy nezmění, kdo zásah dostane.
Jak přehrát animaci po stisku klávesy, ve smyčce nebo na NPC, si přečtěte v návodu ke skriptu animace.
V čem se mýlí starší tutoriály k mečům
Pokud tento návod srovnáváte s videem nebo příspěvkem na fóru, tady jsou důležité rozdíly a důvod, proč každý postup způsobuje problém.
| Tutoriál | Problém | Tento návod |
|---|---|---|
Uděluje poškození v události Touched čepele | Zařízení útočníka může vyvolat Touched na svém meči odkudkoli (stránka Robloxu o network ownership) a Touched se při jednom doteku spustí několikrát po sobě (stránka Robloxu o debounce). | Server najde cíle vlastním boxem, jednou na Humanoid za švih. |
| Snižuje Health v LocalScriptu | Změna, kterou LocalScript udělá na cizí postavě, zůstane jen na tom jednom zařízení. | Veškeré poškození se uděluje v SwordService. |
Používá wait(0.5) pro cooldown | Roblox označuje globální wait() za zastaralý, místo něj se používá task.wait(), a cooldown, který existuje jen na klientovi, nikoho nezastaví. | Porovnává čas os.clock() na serveru. Nic nečeká. |
Přehrává švih přes Humanoid:LoadAnimation | Zastaralé, místo něj se používá Animator:LoadAnimation. | Načítá švih přes Animator. |
Hledá cíle přes Region3 a FindPartsInRegion3 | Zastaralé. Roblox v nových projektech radí používat GetPartBoundsInBox s OverlapParams. | Používá GetPartBoundsInBox. |
Dává serverový Script dovnitř Toolu a ten poslouchá Activated | Meč každého hráče spouští vlastní kopii serverového kódu a takové skripty často udělují poškození v Touched (první řádek). Ve výchozím nastavení Script běží jen ve Workspace nebo ServerScriptService, takže Script v Toolu se nespustí, dokud meč poprvé nevybavíte. Stránka Robloxu o nástrojích popisuje většinu nástrojů jako LocalScript pro vstup, serverový Script pro efekt a RemoteEvent mezi nimi. | Jeden SwordService ve ServerScriptService obsluhuje všechny meče ve hře. |
Co exploiter může a co ne
Počítejte s tím, že podvodník ovládá vše na svém zařízení. Může číst a měnit vaše LocalScripty a návod Robloxu k bezpečnosti říká, že může volat RemoteEventy s jakoukoli frekvencí a libovolnými argumenty. Tady je, co to znamená pro tento meč.
| Podvodník zkouší | Výsledek | Proč |
|---|---|---|
Volat SwordSwing tak rychle, jak jeho kód zvládne, nebo použít autoclicker | Počítá se nanejvýš jeden švih jednou za 0.5 sekundy | Serverový cooldown je 0.6 sekundy minus 0.1 sekundy síťové rezervy. Tato rezerva je maximum, které podvodník získá. |
| Poslat s remotem cíl, číslo poškození nebo pozici | Ignorováno | onSwing čte jen hráče, kterého dosadí sám Roblox. Nic dalšího poslaného s remotem se nikdy nečte. |
| Změnit SwordClient, například odstranit jeho cooldown | Na server to nemá vliv | SwordService drží svá nastavení ve ServerScriptService, který se hráčům nikdy neposílá. |
| Útočit mrtvý nebo bez meče v ruce | Ignorováno | SwordService ověří, že jeho Humanoid je naživu a že Tool s názvem Sword leží uvnitř jeho postavy, kam ho Roblox při vybavení přesune. |
| Zasáhnout někoho z druhého konce mapy | Nic se nestane | Box se staví kolem postavy útočníka tam, kde ji vidí server, a sahá jen 6 studů dopředu. |
| Teleportovat se k hráči a pak zasáhnout | Možné | Každé zařízení ovládá pohyb své postavy a Roblox uvádí teleport na jakékoli místo mezi tím, co klient se svou postavou může dělat. Serverová kontrola pohybu to může odhalit. |
| Zasáhnout skrz tenkou zeď | Možné v rámci boxu o 6 studech | Dotaz boxu z kroku 2 zdi nehledá. Verze 2 přidává kontrolu zdí. |
| Přehrát jakoukoli animaci nebo žádnou | Na zásahy to nemá vliv | Zásahy nikdy nezávisí na animaci. Roblox poznamenává, že podvodníci mohou na své postavě přehrávat libovolné animace. |
Ve dvou řádcích stojí „Možné“, a to je poctivé. Tento meč nedovolí podvodníkovi vybírat, koho zasáhne, jak silně a jak často. Nemůže mu zabránit pohybovat vlastní postavou. Dokumentace Robloxu k bezpečnosti říká, že klienti ovládají pohyb a fyziku své postavy a že kontroly pohybu je potřeba ladit pro každou hru zvlášť. Pro soutěžní hru je další vrstvou serverová kontrola pohybu (návod ke sprintu takovou staví, varuje před hrubými speedhacky a dalekými teleporty) nebo server authority od Robloxu, kterou dokumentace popisovala jako betu, když jsme to ověřovali 13. října 2026.
Krok 4: vyzkoušejte to
- Přidejte něco, do čeho bít. Na kartě Avatar nebo Home klikněte na Character, otevře se Rig Generator, vyberte rig (například R15, pak Block Avatar) a vloží se do Workspace. Posuňte ho o pár studů od svého SpawnLocation.
- Stiskněte Play, vybavte Sword z hotbaru, dojděte k rigu a klikněte. Po prvním zásahu se nad ním objeví ukazatel zdraví, protože Humanoid ve výchozím stavu ukazuje ukazatel jen tehdy, když je jeho Health pod MaxHealth. Humanoid začíná se 100 zdraví, takže pátý zásah ho vyřadí.
- Klikejte, jak nejrychleji umíte. Něco udělá jen jeden švih jednou za 0.6 sekundy.
- Poodejděte od rigu zhruba o 8 studů nebo se k němu otočte zády a švihněte. Nic se nestane, protože žádný jeho part není v boxu.
- Vyzkoušejte to na skutečném hráči. V rozbalovacím seznamu režimů testu zvolte Server & Clients, nastavte 2 klienty a stiskněte Play. Zasáhněte druhého hráče do 10 sekund po jeho spawnu: nic se nestane kvůli ForceField při spawnu. Potom každý zásah ubere 20. Ve výchozím stavu postavy hráčů navíc obnovují 1% z MaxHealth každou sekundu, takže mezi souboji se jim zdraví pomalu vrací.
- Pokud má vaše hra Teams, dejte oba testovací hráče do stejného týmu. Při
FRIENDLY_FIRErovném false si jejich švihy navzájem nic neudělají.
Celou dobu mějte otevřené okno Output (nabídka Window, pak Output). Když tyto skripty fungují, nic nevypisují, takže každá červená chyba od SwordService nebo SwordClient je skutečný problém. Viz Časté chyby.
Jak rozšířit meč na bojový systém
Komba
Držte na serveru počítadlo švihů pro každého hráče, vedle lastSwing. Pokud byl předchozí švih nedávno, přičtěte 1; jinak začněte znovu od 1. Pak vybírejte poškození podle počítadla, například víc poškození u každého třetího zásahu, a počítadlo mažte v PlayerRemoving stejným způsobem. Klient může vést vlastní počet, aby vybíral, kterou animaci přehrát, protože animace o zásahu nikdy nerozhoduje. Box i kontroly zůstávají úplně stejné.
Odhození
Po TakeDamage může SwordService cíl odstrčit přes ApplyImpulse na RootPart cíle, ve směru rootPart.CFrame.LookVector útočníka. Reference Robloxu říká, že odstrčení závisí na hmotnosti cíle a že serverový Script ho může volat na partu, který vlastní server, nebo na partu, který automaticky vlastní klient. Zařízení každého hráče simuluje jeho vlastní postavu, takže odhození zkoušejte na hráčích přes Server & Clients, ne jen na rigu.
Započítání zabití do žebříčku
Přímo před target:TakeDamage(DAMAGE) zapište, kdo zasáhl naposledy, přes target:SetAttribute("LastHitBy", player.UserId). V serverovém Scriptu připojte událost Died u Humanoidu každé postavy, přečtěte tento atribut, najděte útočníka přes Players:GetPlayerByUserId a přičtěte 1 k IntValue Kills v jeho leaderstats. Vytvořte ho vedle Coins a Wins jako v kroku 1 návodu k žebříčku a měňte ho na serveru jako v kroku 2.
Blok
Přidejte druhý RemoteEvent, který klient volá, když je tlačítko bloku stisknuté a puštěné, a ať server nastavuje atribut Blocking na postavě tohoto hráče, s vlastním limitem frekvence. V SwordService snižujte nebo přeskakujte poškození, když má postava cíle nastavené Blocking. Podvodník si stejně sám vybírá, kdy blokovat, takže dělejte blok krátký nebo mu dejte cooldown.
Prodej meče nebo jeho výdej na každé kolo
StarterPack dává meč každému hráči při každém spawnu. Pokud ho chcete místo toho prodávat, dejte ho do složky ShopItems z návodu ke GUI obchodu. Katalog toho návodu už prodává Tool s názvem ClassicSword, takže buď pojmenujte tento Tool ClassicSword a nastavte stejné SWORD_NAME, nebo změňte záznam v katalogu. Pokud ho chcete dávat jen po dobu kola, vezměte skript GiveRoundTool z návodu k systému kol: Sword držte v ServerStorage, ne ve StarterPack, a nahraďte "RoundTool" v tom skriptu za "Sword".
Nepřátelé k boji a zbraně na dálku
Pro NPC, které pronásleduje hráče, se řiďte návodem k hledání cesty pro NPC. Meč mu uděluje poškození jako jakémukoli jinému Humanoidu. O zbraních, které zasahují na dálku podle stejných serverových pravidel, si přečtěte v návodu ke zbraním.
Časté chyby a řešení
Před stisknutím Play otevřete okno Output (nabídka Window, pak Output). Většina problémů s mečem tam buď vypíše chybu, nebo vzniká kvůli názvu, který nesedí.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("SwordSwing")'
SwordClient čeká na remote, který vytváří SwordService, takže SwordService neběží. Ověřte, že je to Script, ne LocalScript, že leží přímo ve ServerScriptService, není vypnutý a že v Output od něj není chyba.
Švihám, ale nikdo nedostává poškození
Zkontrolujte popořadě: SwordClient je LocalScript, ne Script, a leží přímo v Toolu Sword; Tool se jmenuje přesně Sword nebo tak, jak je uvedeno v SWORD_NAME; cíl je nejvýš 6 studů před vámi; cíl se spawnul před víc než 10 sekundami, takže jeho ForceField už zmizel; a pokud používáte Teams, nejste ve stejném týmu při FRIENDLY_FIRE rovném false.
Meč zasahuje hráče, ale nikdy můj NPC
Prostorové dotazy jako GetPartBoundsInBox nikdy nevrátí part, který má vypnuté CanQuery (CanQuery platí, jen když je vypnuté i CanCollide). Zapněte CanQuery zpátky u částí těla NPC a ověřte, že jeho Humanoid je přímým potomkem modelu NPC.
Moje postava se zasekne, když vybavím meč
Některý part meče je ukotvený. Vyberte všechny party uvnitř Toolu a odškrtněte Anchored.
Některé švihy zasáhnou a jiné na stejnou vzdálenost minou
Ve verzi s nápřahem cíl, který za WINDUP_SECONDS vyšel z boxu, zásah nedostane, a kontrola zdí přeskočí každého, kdo stojí za zdí nebo za jiným hráčem. Zkraťte nápřah nebo zvětšete HIT_WIDTH, pokud se v playtestech minutí zdají nefér.
Postava drží meč za čepel
Partů s názvem Handle je víc než jeden a Roblox vybral ten špatný. Nechte přesně jeden Handle, jílec, a ostatní přejmenujte. Pak dolaďte vlastnosti úchopu u Toolu, pokud je úhel pořád špatně.
Čepel zůstane na místě nebo spadne, když vybavím meč
Čepel není přivařená k Handle. Přidejte WeldConstraint, jehož Part0 je Handle a Part1 je čepel.
Poškození je vidět na mé obrazovce, ale zdraví druhého hráče se nemění
Poškození se uděluje z LocalScriptu, který mění jen vaši kopii hry. Udělujte poškození jen v SwordService, jako v kroku 2.
Udělat s RoCode
Pokud se vám nechce stavět tohle všechno ručně, RoCode to může udělat ve vašem otevřeném place. Je to nezávislý AI agent pro psaní kódu, ne od Robloxu: funkci popíšete v jeho webovém chatu a jeho plugin pro Roblox Studio vytvoří Tool, party a skripty ve vašem Exploreru, takže nemusíte kopírovat kód z okna chatu.
Udělej meč: Tool s názvem Sword ve StarterPack s Handle a k němu přivařenou čepelí, LocalScript, který při Activated zavolá RemoteEvent, a serverový Script, který zkontroluje cooldown 0.6 sekundy a udělí 20 poškození všem Humanoidům v boxu před hráčem.
- Vytvoří Tool a jeho party přes Create Instance a nastaví jejich vlastnosti přes Set Property
- Napíše SwordService a SwordClient přes Create Script a může nejdřív vyhledat už existující bojové skripty přes Search Scripts
- Má pokyn ověřit kompilaci každého napsaného skriptu přes Check Script, který kód zkompiluje ve Studiu bez spuštění (typy nekontroluje)
- Před každou dávkou změn a po ní nastaví bod pro vrácení, takže Ctrl+Z vrací po jedné dávce
RoCode neumí vytvořit animaci švihu ani ji nahrát: udělejte ji v Animation Editoru a vložte její ID. S pluginem 3.9 nebo novějším může RoCode spustit krátký playtest a přečíst chyby, a s pluginem 3.9.11 nebo novějším může ovládat testovací postavu, ale neklikne ve 3D okně, aby švihnul, takže švihy ověřujete sami. Stránka jak vytvořit celou hru v Robloxu s RoCode, systém po systému ukazuje, kam zbraň patří. Jak se RoCode připojuje ke Studiu.
Časté otázky
Proč můj meč zasáhne jednoho hráče několikrát za jeden švih?
Protože uděluje poškození z Touched. Stránka Robloxu o debounce uvádí, že Touched se při jednom doteku spustí několikrát po sobě a každý part cíle se může čepele dotknout. Tento návod najde cíle jedním dotazem boxu za švih a vede seznam, takže každý Humanoid ztratí zdraví jednou za švih.
Má být poškození meče v LocalScriptu, nebo ve Scriptu?
Ve Scriptu na serveru. Poškození udělené z LocalScriptu mění jen kopii hry tohoto hráče a vše, co je na zařízení hráče, může podvodník změnit. LocalScript má jen zachytit kliknutí, přehrát animaci a zavolat RemoteEvent.
Jak přidat meči animaci švihu?
Udělejte ji v Animation Editoru, nastavte prioritu Action, publikujte ji do Robloxu a její asset ID zapište do SWING_ANIMATION_ID jako rbxassetid:// a za ním číslo. SwordClient ji přehraje přes Animator postavy. Animace, které zařízení hráče spustí na vlastní postavě tohoto hráče, se ukazují všem.
Proč se animace meče nepřehrává?
Zkontrolujte tři věci. Prioritu: Action stojí nad Movement, Idle a Core, takže švih s Action se přehraje přes chůzi a stání, zatímco nižší priorita jim může prohrát. Vlastníka: pokud hra patří skupině, publikujte animaci s touto skupinou jako Creator. ID: SWING_ANIMATION_ID musí být úplný text rbxassetid:// s číslem vaší animace, ne prázdný řetězec.
Jaký hitbox je pro meč v Robloxu nejlepší?
Pro většinu her dotaz boxu na serveru jednou za švih, jako v tomto návodu: jedno volání GetPartBoundsInBox, klient nemá co podvrhnout a tři čísla k ladění. GetPartsInPart s partem potřebného tvaru nebo raycasty podél čepele používejte, jen když má dosah zbraně k boxu daleko. Srovnání čtyř způsobů.
Jak zařídit, aby meč nezasahoval skrz zdi?
Před udělením poškození vyšlete paprsek od kořenového partu útočníka ke kořenovému partu cíle, s vynecháním postavy útočníka, a zásah počítejte, jen když první, na co paprsek narazí, patří cíli. Verze 2 SwordService to dělá pro každý cíl.
Proč zásah přijde dřív, než animace švihu dojde k cíli?
Server kontroluje hitbox ve stejném okamžiku, kdy přijde kliknutí. Nejdřív počkejte krátký nápřah, například 0.15 sekundy přes task.delay, pak ověřte, že útočník je stále naživu a drží meč, a postavte box, jako to dělá verze 2.
Mohou exploiteři s tímto mečem pořád podvádět?
Nemohou vybírat, kdo dostane zásah, kolik poškození zásah udělí ani jak často útočí, protože o všech třech věcech rozhoduje server; maximum, co získají, je 0.1 sekundy síťové rezervy u cooldownu. Pořád ale mohou pohybovat svou postavou, například až těsně k někomu, protože každé zařízení ovládá pohyb své postavy. Další vrstvou je serverová kontrola pohybu.
Jak udělat bojový systém s komby?
Držte na serveru počítadlo švihů pro každého hráče, po krátké pauze ho vynulujte a podle počítadla vybírejte poškození a animaci. Kontrola zásahu zůstává stejná. Oddíl Jak rozšířit rozebírá také odhození, započítání zabití a blok.
Zdroje a další čtení
- Roblox Creator Docs: In-game tools (anglicky). stavba nástroje ve Workspace, Handle, Weld, Grip, ukotvení a proč většina nástrojů používá LocalScript, Script a RemoteEvent
- Roblox Creator Docs: WorldRoot:GetPartBoundsInBox (anglicky). dotaz boxu, OverlapParams a zastaralý FindPartsInRegion3
- Roblox Creator Docs: Humanoid:TakeDamage (anglicky). ochrana ForceField, ukazatel zdraví a regenerace zdraví
- Roblox Creator Docs: Network ownership (anglicky). exploit s mečem na Touched
- Roblox Creator Docs: Security tactics and cheat mitigation (anglicky). nikdy nevěřte klientovi
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (anglicky). co klient může dělat se svou postavou a kontroly pohybu
- Roblox Creator Docs: Animation Editor (anglicky). priorita animace a publikování
- Roblox Creator Docs: Animator:LoadAnimation (anglicky). které animace se replikují z klienta
- Roblox Creator Docs: Debounce patterns (anglicky). proč se Touched při jednom doteku spustí několikrát
Jak byl kód ověřen: každý skript na této stránce prochází přísnou kontrolou typů Luau s definicemi Roblox API (luau-lsp, 20. listopadu 2026). Kontrola typů zachytí chyby v názvech API a špatné typy, ale ne chyby v herní logice, proto vše otestujte ve Studiu před publikováním.