Tutoriál · Herní systémy

Jak udělat meč v Roblox Studiu

Meč je v Robloxu Tool se třemi úkoly rozdělenými mezi dva skripty: zařízení hráče zachytí kliknutí a přehraje švih a server rozhodne, kdo dostal zásah a kolik zdraví ztratil. V tomto návodu postavíme oba skripty, s cooldownem a hitboxem, které hráči nemohou podvrhnout, a ukážeme, kam patří animace.

Aktualizováno 20. listopadu 202620 min čteníAutor:

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.
  • TakeDamage nedě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
  1. Jak je postavený
  2. 1. Stavíme Tool
  3. 2. Serverový skript
  4. 3. LocalScript
  5. Hitbox
  6. Druhy hitboxu
  7. Nápřah a kontrola zdí
  8. Animace švihu
  9. Starší tutoriály
  10. Meze ochrany
  11. 4. Kontrola
  12. Rozšíření
  13. Common errors
  14. S RoCode
  15. Časté otázky
  16. Zdroje a další čtení

Jak je funkční meč postavený

IlustraceŠvihy s odstupem nejméně 0.6 sekundy berou po 20 zdraví, kliknutí uvnitř cooldownu nic nedělá a pátý zásah rig vyřadí.

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:

  1. Hráč klikne, klepne nebo stiskne spoušť gamepadu s vybaveným Sword. V LocalScriptu se spustí Tool.Activated.
  2. LocalScript přehraje animaci švihu, pokud nějaká je, a zavolá RemoteEvent SwordSwing. Nic jiného neposílá.
  3. Serverový Script zkontroluje cooldown, to, že je hráč naživu, a to, že má Sword v ruce.
  4. Server postaví vlastní hitbox před postavou hráče a najde každý Humanoid uvnitř.
  5. Každý z těchto Humanoidů jednou ztratí zdraví přes TakeDamage.
Z čeho se meč skládá
PrvekKde jeCo dělá
Tool SwordStarterPackTo, co hráč drží. Roblox při každém spawnu jeho postavy zkopíruje vše ze StarterPack do Backpacku hráče.
Part HandleUvnitř TooluPart, za který postava drží. Čepel je k němu přivařená.
LocalScript SwordClientUvnitř TooluZachytí kliknutí, přehraje animaci švihu a zavolá remote.
RemoteEvent SwordSwingReplicatedStorage (vytváří ho SwordService)Nese „švihl jsem“ ze zařízení hráče na server, bez argumentů.
Script SwordServiceServerScriptServiceZkontroluje 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.
Explorer, když je meč hotový. SwordService přidá do ReplicatedStorage RemoteEvent s názvem SwordSwing, když hra běží.
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

  1. 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.
  2. 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.
  3. 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.
  4. Vložte do Blade WeldConstraint. V okně Properties nastavte jeho Part0 na Handle a Part1 na Blade, aby meč zůstal pohromadě, zatímco ho hráč nosí.
  5. 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í.
  6. Vyberte Tool a odškrtněte CanBeDropped. Když je zaškrtnuté, stisk Backspace meč vyhodí do Workspace.
  7. 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 v ServerScriptService s názvem SwordService
-- 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í na začátku SwordService
NastaveníHodnota tadyCo 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.
DAMAGE20Kolik 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_SECONDS0.6Čas mezi švihy. Nastavte stejnou hodnotu v SwordClient.
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT6, 5, 6Hitbox ve studech: jak daleko před hráče sahá, jak je široký a vysoký.
FRIENDLY_FIREfalsePř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_SLACK0.1O 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 v Toolu Sword ve StarterPack s názvem SwordClient
-- 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á.

Co SwordService dělá s party v boxu
KrokKódProč
Vynechat útočníkaOverlapParams s Exclude a postavou útočníkaVlastní ruce, nohy a meč útočníka jsou v boxu také.
Najít postavupart: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 Humanoidmodel: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 Humanoidtabulka alreadyHitV boxu obvykle skončí několik partů jedné postavy. Bez tabulky by každý z nich udělil poškození znovu.
Jen živé cíletarget.Health > 0Už vyřazená postava se znovu nezasahuje.
TýmyisTeammatePř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ůsoby, jak udělat hitbox meče. „Kdo rozhoduje“ je strana, jejíž odpověď se počítá
ZpůsobJak fungujeKdo rozhodujePřesnostK čemu je nejlepší
Touched na čepeliPoškození pokaždé, když se part čepele dotkne postavyZařízení útočníka, které vlastní jeho postavu i mečSleduje čepel, ale při jednom doteku se spustí několikrátK 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 švihServerPevný box, ne dráha čepele. Meshe se počítají podle ohraničujících boxů, takže trochu velkoryseVětšina her: jednoduché, levné a není co podvrhnout
GetPartsInPart na partu hitboxuServerový dotaz s partem ve tvaru oblouku čepele, během švihuServerPř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 čepeleKaždý snímek švihu se krátké paprsky vysílají z bodů na čepeli tam, kde byly v minulém snímkuTa strana, která je vysílá. Na serveru je potřeba serverová představa o tom, kde čepel jeTěsně sleduje animaciHry, 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í.

Nastavení SwordService pro běžné zbraně na blízko, s počtem zásahů a časem do vyřazení figuríny se 100 Health. Spočítáno, ne naměřeno
ZbraňDAMAGECOOLDOWN_SECONDSHIT_RANGEHIT_WIDTHZásahy (čas)Poškození za sekundu
Dýka120.35449 (2.8 s)asi 34
Meč (tento návod)200.6655 (2.4 s)asi 33
Obouruční meč351.1773 (2.2 s)asi 32
Kopí180.8936 (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 v ServerScriptService s názvem SwordService
-- 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.delay spustí strike po WINDUP_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 hasClearLine paprsek 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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. Zkopírujte asset ID animace z Toolboxu a v SwordClient nastavte SWING_ANIMATION_ID na "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.

Časté postupy v tutoriálech k mečům a co místo nich dělá tento návod
TutoriálProblémTento návod
Uděluje poškození v události Touched čepeleZaří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 LocalScriptuZmě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 cooldownRoblox 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:LoadAnimationZastaralé, místo něj se používá Animator:LoadAnimation.Načítá švih přes Animator.
Hledá cíle přes Region3 a FindPartsInRegion3Zastaralé. Roblox v nových projektech radí používat GetPartBoundsInBox s OverlapParams.Používá GetPartBoundsInBox.
Dává serverový Script dovnitř Toolu a ten poslouchá ActivatedMeč 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č.

Co může podvodník zkusit a co s tím dělá SwordService
Podvodník zkoušíVýsledekProč
Volat SwordSwing tak rychle, jak jeho kód zvládne, nebo použít autoclickerPočítá se nanejvýš jeden švih jednou za 0.5 sekundyServerový 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 poziciIgnorovánoonSwing č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 cooldownNa server to nemá vlivSwordService drží svá nastavení ve ServerScriptService, který se hráčům nikdy neposílá.
Útočit mrtvý nebo bez meče v ruceIgnorovánoSwordService 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 mapyNic se nestaneBox 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áhnoutMož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 studechDotaz boxu z kroku 2 zdi nehledá. Verze 2 přidává kontrolu zdí.
Přehrát jakoukoli animaci nebo žádnouNa zásahy to nemá vlivZá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

  1. 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.
  2. 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í.
  3. Klikejte, jak nejrychleji umíte. Něco udělá jen jeden švih jednou za 0.6 sekundy.
  4. 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.
  5. 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í.
  6. Pokud má vaše hra Teams, dejte oba testovací hráče do stejného týmu. Při FRIENDLY_FIRE rovné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.

Napíšete

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.

RoCode udělá
  • 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í

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.

Vyzkoušejte RoCode ve své hře.

Kredity zdarma každý den, bez karty. Nainstalujte plugin, popište funkci a podívejte se, co se objeví ve Studiu.