Guide · Spelsystem

Så gör du ett svärd i Roblox Studio

Ett svärd i Roblox är ett Tool med tre uppgifter fördelade på två skript: spelarens enhet märker klicket och spelar svingen, och servern avgör vem som blev träffad och hur mycket hälsa hen förlorade. I den här guiden bygger vi båda skripten, med en cooldown och en hitbox som spelare inte kan förfalska, och visar var animationen passar in.

Uppdaterad 20 november 202622 min läsningSkriven av

I korthet

Lägg ett Tool som heter Sword i StarterPack med en part som heter Handle. Ett LocalScript i Tool lyssnar på Tool.Activated, spelar en svinganimation och anropar ett RemoteEvent utan argument. Ett Script i ServerScriptService kontrollerar cooldown och att spelaren lever och håller svärdet, hittar Humanoid i en låda framför hen med workspace:GetPartBoundsInBox och anropar Humanoid:TakeDamage en gång per mål.

  • Gör inte skada från klingans händelse Touched: spelarens enhet styr sin egen karaktär och kan utlösa Touched varifrån som helst, och just ett svärd är exemplet på Robloxs sida om network ownership.
  • Klienten skickar varken mål eller skada. Cooldown, hitbox och skadans storlek ägs av servern.
  • TakeDamage gör ingenting medan målet har ett ForceField, till exempel de första 10 sekunderna efter spawn på en SpawnLocation.
  • Går slagen genom väggar eller träffar de innan svingen visuellt når målet? Ta versionen av serverskriptet med uppladdning och väggkontroll.
På den här sidan
  1. Så fungerar det
  2. 1. Bygg Tool
  3. 2. Serverskriptet
  4. 3. LocalScript
  5. Hitbox
  6. Typer av hitbox
  7. Uppladdning och väggkontroll
  8. Svinganimation
  9. Äldre guider
  10. Skyddets gränser
  11. 4. Testa
  12. Utbyggnader
  13. Common errors
  14. Med RoCode
  15. Vanliga frågor
  16. Källor och vidare läsning

Så är ett fungerande svärd uppbyggt

IllustrationSvingar med minst 0.6 sekunders mellanrum tar 20 hälsa var, ett klick inom cooldown gör ingenting, och det femte slaget slår ut riggen.

Ett svärd som fungerar i ett riktigt spel är uppdelat mellan spelarens enhet och servern. Robloxs sida om verktyg säger att inmatning för verktyg ska ligga i ett LocalScript, eftersom bara spelarens enhet vet när inmatningen sker, och att de flesta verktyg behöver ett LocalScript, ett Script på servern och ett RemoteEvent mellan dem. Den här guiden använder just den uppdelningen. En sving ser ut så här:

  1. Spelaren klickar, trycker på skärmen eller trycker på handkontrollens avtryckare med Sword utrustat. I LocalScript utlöses Tool.Activated.
  2. LocalScript spelar svinganimationen, om det finns en, och anropar RemoteEvent SwordSwing. Mer skickar det inte.
  3. Serverns Script kontrollerar cooldown, att spelaren lever och att Sword finns i hens hand.
  4. Servern bygger sin egen hitbox framför spelarens karaktär och hittar varje Humanoid i den.
  5. Var och en av dessa Humanoid förlorar hälsa en gång via TakeDamage.
Vad svärdet består av
DelVar den finnsVad den gör
Tool SwordStarterPackDet som spelaren håller. Roblox kopierar allt från StarterPack till spelarens Backpack varje gång hens karaktär spawnar.
Part HandleInuti ToolParten som karaktären håller i. Klingan är svetsad fast vid den.
LocalScript SwordClientInuti ToolHör klicket, spelar svinganimationen och anropar remoten.
RemoteEvent SwordSwingReplicatedStorage (skapas av SwordService)Bär "jag svingade" från spelarens enhet till servern, utan argument.
Script SwordServiceServerScriptServiceKontrollerar varje sving, hittar vem som står framför spelaren och gör skada. Det enda stället där ett slag kan ske.
Explorer när svärdet är klart. SwordService lägger till ett RemoteEvent som heter SwordSwing i ReplicatedStorage när spelet körs.
ServerScriptService
  SwordService Script new
StarterPack
  Sword Tool new
    Handle Part new
    Blade Part new
      WeldConstraint WeldConstraint new
    SwordClient LocalScript new

Steg 1: bygg svärdets Tool

  1. I Explorer, håll muspekaren över Workspace, klicka på knappen + och infoga ett Tool. Byt namn på det till Sword. Serverskriptet letar efter just det namnet. Du bygger svärdet i Workspace, som Robloxs sida om verktyg rekommenderar, eftersom dess parts syns där och kan flyttas och ändras i storlek. Det sista steget flyttar det till StarterPack.
  2. Infoga en Part i Tool och kalla den Handle. Det är fästet som karaktären håller svärdet i. Den måste vara ett direkt barn till Tool och den enda parten med det namnet: med två Handle väljer Roblox en slumpmässigt, och karaktären kan hålla svärdet i klingan.
  3. Infoga en andra Part i Tool, kalla den Blade, ge den form och placera den så att den sticker upp ur toppen av Handle.
  4. Infoga en WeldConstraint i Blade. I fönstret Properties, sätt dess Part0 till Handle och Part1 till Blade, så att svärdet håller ihop medan spelaren bär det.
  5. Markera båda parts och se till att Anchored är avstängt. En förankrad part i ett verktyg spikar fast karaktären på stället när hen utrustar det. Stäng också av CanCollide på båda, så att klingan inte stöter i spelare och väggar under svingen.
  6. Markera Tool och avmarkera CanBeDropped. När den är markerad kastar Backspace svärdet ut i Workspace.
  7. Dra det färdiga Sword från Workspace till StarterPack. Ett Tool som lämnas i Workspace är ett föremål som en spelare plockar upp, inte ett svärd som finns i allas Backpack från början.

Ett svärd av en enda MeshPart fungerar också: kalla den MeshPart Handle och hoppa över Weld. Om karaktären håller svärdet i en konstig vinkel när du testar, markera Tool och justera dess grepp-egenskaper (GripPos, GripForward, GripRight och GripUp) i fönstret Properties.

Steg 2: lägg till serverskriptet

Håll muspekaren över ServerScriptService, infoga ett Script som heter SwordService och klistra in koden nedan. Det är det enda stället där ett svärdsslag kan ske. Inställningarna i början är raderna som du är tänkt att ändra.

Script i ServerScriptService med namnet SwordService
-- Script i ServerScriptService som heter SwordService.
-- Det enda stället där ett svärdsslag kan ske: kontrollerar svingen, hittar målen framför
-- angriparen med sin egen hitbox och gör skada.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Inställningar
local SWORD_NAME = "Sword" -- namnet på Tool i StarterPack
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- håll samma värde i SwordClient
local HIT_RANGE = 6 -- studs framför angriparen
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false -- false: spelare i samma lag kan inte skada varandra
-- Svingar som skickas exakt COOLDOWN_SECONDS isär kan efter nätverksfördröjning komma
-- lite närmare varandra, så servern ger den här marginalen och kastar inte en riktig sving
local NETWORK_SLACK = 0.1

-- Remoten som svärdets LocalScript anropar. Den bär inga argument: vem som blir träffad
-- avgör servern, så klienten har inget att förfalska.
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
	-- Neutrala spelare (utan lag) kan alltid slå varandra
	return not attacker.Neutral and not target.Neutral and attacker.Team == target.Team
end

local function onSwing(player: Player)
	-- 1. En sving per cooldown, hur ofta remoten än anropas
	local now = os.clock()
	local last = lastSwing[player]
	if last and now - last < COOLDOWN_SECONDS - NETWORK_SLACK then
		return
	end

	-- 2. Angriparen måste leva och hålla svärdet
	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. Serverns egen hitbox: en låda framför angriparens rotpart
	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. Varje Humanoid i lådan tar skada en gång, även om flera av dess parts finns i den
	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) -- gör ingenting medan målet har ett ForceField
			end
		end
	end
end

swingEvent.OnServerEvent:Connect(onSwing)

Players.PlayerRemoving:Connect(function(player: Player)
	lastSwing[player] = nil
end)

SwordService skapar själv RemoteEvent SwordSwing när spelet startar, så du behöver inte infoga något i ReplicatedStorage för hand. Om du redan har skapat ett RemoteEvent med det namnet, ta bort det: LocalScript kunde hitta ditt, och ingen på servern lyssnar på det.

Inställningarna i början av SwordService
InställningVärde härVad den ändrar
SWORD_NAME"Sword"Namnet på det Tool som servern förväntar sig i spelarens hand. Ändra det om ditt Tool heter något annat.
DAMAGE20Hur mycket hälsa varje slag tar. En Humanoid börjar med 100 hälsa, så fem slag slår ut en testrigg. Spelarkaraktärer återfår som standard 1 % av MaxHealth varje sekund, så en spelare som slås i maximal takt överlever det femte slaget, och ett sjätte behövs.
COOLDOWN_SECONDS0.6Tiden mellan svingar. Sätt samma värde i SwordClient.
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT6, 5, 6Hitboxen i studs: hur långt den når framför spelaren, hur bred och hur hög den är.
FRIENDLY_FIREfalseMed false kan spelare i samma lag inte skada varandra. Spelare utan lag kan alltid slå varandra, och NPC:er kan alltid träffas.
NETWORK_SLACK0.1Hur mycket före cooldown servern fortfarande godtar en sving. Två klick med 0.6 sekunders mellanrum kan efter nätverksfördröjning komma lite närmare varandra, och utan den marginalen skulle servern kasta en riktig sving som spelaren redan har sett.

Steg 3: lägg till LocalScript i Tool

Infoga ett LocalScript i Tool Sword, kalla det SwordClient och klistra in den här koden:

LocalScript i Tool Sword i StarterPack med namnet SwordClient
-- LocalScript inuti Tool Sword som heter SwordClient.
-- Tool.Activated utlöses på spelarens enhet, så det här skriptet lyssnar på klicket,
-- trycket eller avtryckaren, spelar svinganimationen och ber servern göra svingen.

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 -- samma värde som i SwordService
local SWING_ANIMATION_ID = "" -- valfritt: "rbxassetid://" följt av din animations id

local player = Players.LocalPlayer
local lastSwing = 0
local swingTrack: AnimationTrack? = nil
local trackCharacter: Model? = nil

-- Ladda animationen en gång per karaktär. Animationer som startas på din egen
-- karaktär från din enhet visas för alla spelare.
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 -- servern kontrollerar det också; kontrollen här sparar onödiga förfrågningar
	end
	lastSwing = now
	if swingTrack then
		swingTrack:Play()
	end
	swingEvent:FireServer()
end)

Lämna SWING_ANIMATION_ID tomt tills vidare. Svärdet fungerar utan animation, eftersom servern avgör träffen i vilket fall som helst. Hur du fyller i det visas i avsnittet Lägg till en svinganimation.

Activated utlöses av ett musklick, ett tryck på mobilen och en avtryckare på handkontrollen, så samma skript fungerar på alla enheter. Roblox kopierar Tool och LocalScript i det till varje spelares Backpack när hens karaktär spawnar, så varje spelare kör sin egen kopia.

LocalScript har sin egen cooldown bara för att inte skicka förfrågningar som servern ändå ignorerar. Det är ingen säkerhetskontroll: en fuskare kan ta bort den, ändra den eller anropa SwordSwing från sin egen kod. Guiden om RemoteEvent förklarar varför varje remote måste kontrolleras på servern, och Script vs LocalScript vs ModuleScript (på engelska) visar vad ett LocalScript kan och inte kan ändra.

Hur servern avgör vem som blev träffad

När SwordSwing kommer frågar SwordService inte klienten om någonting. Den bygger en låda framför angriparens karaktär där servern ser den och frågar motorn vilka parts som finns i den med workspace:GetPartBoundsInBox. Den metoden ersätter den äldre FindPartsInRegion3, som Roblox markerar som föråldrad.

Lådans mitt ligger 3 studs framför angriparens rotpart. Det är förskjutningen CFrame.new(0, 0, -HIT_RANGE / 2): en CFrame tittar längs sin negativa Z-axel, dess LookVector. Därför sträcker sig lådan från karaktärens mitt 6 studs framåt, och den är 5 studs bred och 6 studs hög. Frågan jämför varje parts omslutande låda (bounding box), en snabb approximation av dess volym i form av en låda, så runda parts och meshes räknas som lite större än de ser ut. För ett svärd är den lilla marginalen bra.

Vad SwordService gör med parts i lådan
StegKodVarför
Hoppa över angriparenOverlapParams med Exclude och angriparens karaktärAngriparens egna armar, ben och svärd finns också i lådan.
Hitta karaktärenpart:FindFirstAncestorOfClass("Model")En part i lådan kan vara en kroppsdel, en hatt eller ett verktyg i handen. FindFirstAncestorOfClass jämför det exakta klassnamnet, så den går förbi hatten (klassen Accessory) och verktyget i handen (klassen Tool, fast Tool är en sorts Model) och stannar vid karaktärens modell.
Hitta Humanoidmodel:FindFirstChildOfClass("Humanoid")Allt som har en Humanoid kan träffas: spelare, NPC:er och testdockor. Väggar och golv hoppas över.
En gång per Humanoidtabellen alreadyHitI lådan hamnar oftast flera parts från samma karaktär. Utan tabellen skulle var och en göra skada på nytt.
Bara levande måltarget.Health > 0En karaktär som redan är utslagen träffas inte igen.
LagisTeammateNär FRIENDLY_FIRE är false hoppas spelare i samma lag över. En spelare vars egenskap Neutral är true har inget lag.
Skadatarget:TakeDamage(DAMAGE)Sänker Health, om målet inte skyddas av ett ForceField.

Tabellen alreadyHit skapas på nytt vid varje sving, så samma spelare kan träffas igen av nästa sving när cooldown har gått. Det är regeln "en gång per mål och sving", som svärd byggda på Touched ständigt har problem med.

Skriptet använder TakeDamage och inte en tilldelning av Health. Robloxs referens säger att TakeDamage inte rör en Humanoid medan ett ForceField skyddar den, medan en direkt tilldelning av Health ignorerar ForceField. En spelare som spawnar på en SpawnLocation får som standard ett ForceField i 10 sekunder (Duration på SpawnLocation), så nyanlända kan inte träffas i samma ögonblick som de dyker upp.

Fyra sätt att göra ett svärds hitbox: en jämförelse

Svärdsguider skiljer sig främst i en sak: hur man vet vad klingan träffade. Det finns fyra vanliga svar. De skiljer sig i hur noga de följer klingan, hur mycket arbete de kostar servern och om en fuskare kan förfalska resultatet.

Sätt att göra ett svärds hitbox. "Vem avgör" är den sida vars svar räknas
SättHur det fungerarVem avgörPrecisionBäst för
Touched på klinganSkada varje gång en part på klingan rör vid en karaktärAngriparens enhet, som äger sin karaktär och sitt svärdFöljer klingan, men utlöses flera gånger per beröringIngenting i ett spel med andra spelare: angriparens enhet kan utlösa det varifrån som helst
En låda framför spelaren (den här guiden)En fråga med GetPartBoundsInBox på servern per svingServernEn fast låda, inte klingans bana. Meshes räknas med omslutande lådor, så lite generöstDe flesta spel: enkelt, billigt och inget att förfalska
GetPartsInPart på en hitbox-partEn fråga på servern med en part formad som klingans båge, under svingenServernExakta former: Robloxs dokumentation säger att den gör en fullständig geometrisk kontroll och föreslår frågor med låda eller sfär när lägre precision räcker, eftersom de är billigareStora vapen med ovanlig form, till exempel en lies båge
Raycasts längs klinganVarje bildruta i svingen skickas korta strålar från punkter på klingan till där de var i förra bildrutanDen sida som skickar dem. På servern behövs serverns bild av var klingan ärFöljer animationen näraSpel där svingens exakta bana spelar roll. Så fungerar communityns hitbox-moduler

Lådan är rätt förstaval. Det är en fråga per sving, den beror aldrig på en animation som en fuskare kan ändra, och den är lätt att ställa in med tre tal. Byt till en formad part eller strålar längs klingan när spelare klagar på att träffarna känns fel med ett vapen vars räckvidd är långt från en låda, och behåll samma regel: frågan körs och skadan görs av servern.

Förinställningar för svärd: från dolk till tvåhandssvärd

Samma SwordService gör mycket olika vapen med fem inställningar. Tabellen är en utgångspunkt, beräknad för en docka från Rig Generator med 100 Health. "Tid till knockout" räknas från första slaget, när varje sving träffar så fort cooldown tillåter.

Inställningar för SwordService för vanliga närstridsvapen, med antal slag och tid till knockout för en docka med 100 Health. Beräknat, inte uppmätt
VapenDAMAGECOOLDOWN_SECONDSHIT_RANGEHIT_WIDTHSlag (tid)Skada per sekund
Dolk120.35449 (2.8 s)ungefär 34
Svärd (den här guiden)200.6655 (2.4 s)ungefär 33
Tvåhandssvärd351.1773 (2.2 s)ungefär 32
Spjut180.8936 (4 s)ungefär 23
  • Spelare läker, dockor gör det inte. Spelarkaraktärer återfår som standard 1 % av MaxHealth varje sekund. Med exakt 100 skada på 5 slag överlever en spelare som slås i maximal takt det femte slaget, och ett sjätte behövs. Lämna en marginal, till exempel 21 skada i stället för 20, om det exakta antalet slag spelar roll.
  • Skala NETWORK_SLACK tillsammans med cooldown. Guidens 0.1 sekunder är en sjättedel av 0.6. Om du behåller 0.1 för en dolk med 0.35 sekunders cooldown kan en fuskare slå var 0.25:e sekund, 40 % snabbare. Ta ungefär en sjättedel av COOLDOWN_SECONDS: 0.06 för dolken.
  • Håll SwordClient i takt. Sätt samma COOLDOWN_SECONDS där, annars skickar klienten svingar som servern ignorerar.

Version 2: uppladdning och inga slag genom väggar

När grundsvärdet fungerar dyker två klagomål upp. Slaget träffar i samma ögonblick som spelaren klickar, innan svinganimationen når målet, och en sving kan nå någon som står på andra sidan en tunn vägg, eftersom lådan inte tar hänsyn till väggar. Den här versionen av SwordService rättar båda. Den ersätter skriptet från steg 2: samma namn, samma remote, samma inställningar, så SwordClient behöver inte ändras.

Script i ServerScriptService med namnet SwordService
-- Script i ServerScriptService som heter SwordService (versionen med uppladdning och väggkontroll).
-- Ersätter skriptet från steg 2: samma inställningar och remote plus två regler. Slaget träffar
-- WINDUP_SECONDS efter klicket, när svingen når målet, och träffar ingen
-- genom en vägg.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Inställningar
local SWORD_NAME = "Sword"
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- håll samma värde i SwordClient
local WINDUP_SECONDS = 0.15 -- tiden från klick till slag; anpassa efter din svinganimation
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

-- Returnerar angriparens karaktär och rotpart så länge hen lever och håller svärdet
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 när det inte finns något mellan angriparen och målet utom själva målet
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)
	-- Kontrollera igen efter uppladdningen: angriparen kan ha dött eller lagt undan svärdet
	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)

Ta först bort SwordService från steg 2, annars skapar båda skripten var sin remote SwordSwing. Sätt WINDUP_SECONDS till ögonblicket i din svinganimation då klingan passerar framför karaktären; för en snabb sving passar 0.15.

  • Uppladdning. Cooldown och kontrollerna "lever och håller svärdet" körs när klicket kommer, sedan startar task.delay strike efter WINDUP_SECONDS. strike kontrollerar angriparen en gång till, eftersom hen kan ha dött eller lagt undan svärdet under tiden, och bygger först därefter lådan. Ett mål som har lämnat räckhåll under uppladdningen träffas inte, och det är precis vad spelare förväntar sig när de ser svingen.
  • Väggkontroll. För varje mål i lådan skickar hasClearLine en stråle från angriparens rotpart till målets rotpart och hoppar över angriparens egen karaktär. Om det första den möter tillhör målet, eller om den inte möter något, räknas slaget. En vägg, en dörr eller en annan spelare mellan dem blockerar det.
  • Vad det kostar. En extra stråle per mål och sving, vilket är lite jämfört med själva frågan om lådan.

Uppladdningen gör också svärdet rättvisare mot fuskare som slår i samma ögonblick som de teleporterar sig till någon: servern letar efter mål ett ögonblick senare, där den ser karaktärerna just då. Själva teleporten stoppas inte av det; för det behövs en rörelsekontroll, som beskrivs i avsnittet Vad en exploiter kan och inte kan göra.

Lägg till en svinganimation (valfritt)

SwordClient spelar redan en animation så fort du ger det ett ID. Animationen gör du en gång, i Animation Editor i Studio:

  1. Infoga en rigg att animera. På fliken Avatar eller Home, klicka på Character för att öppna Rig Generator, och välj en rigg som matchar avatarerna i ditt spel, till exempel R15 och sedan Block Avatar.
  2. På fliken Avatar, klicka på Clip Editor för att öppna Animation Editor, markera riggen och sätt poser för en kort sving med höger arm.
  3. Sätt prioriteten Action: klicka på knappen … bland redigerarens uppspelningskontroller, håll muspekaren över Set Animation Priority och välj Action. Action ligger över Movement, Idle och Core, så svingen spelas ovanpå gång- och ståanimationerna i stället för att förlora mot dem.
  4. I samma meny …, välj Publish to Roblox. Om ditt spel ägs av en grupp, välj den gruppen i fältet Creator innan du skickar.
  5. Kopiera animationens asset-ID från Toolbox och sätt i SwordClient SWING_ANIMATION_ID till "rbxassetid://" följt av det talet.

SwordClient laddar svingen via karaktärens Animator, inte via den äldre Humanoid:LoadAnimation, som Roblox markerar som föråldrad. Robloxs referens för Animator säger att animationer som spelarens enhet startar på spelarens egen karaktär replikeras till servern och till alla andra spelare, så ett LocalScript kan spela svingen och alla ser den. Där står också att Animator ska skapas på servern, så skapa den aldrig i ett LocalScript. På spelarkaraktärer ligger den oftast i Humanoid, och det är där Robloxs eget animationsexempel letar efter den.

Animationen behövs bara för utseendet. Träffarna beror inte på den, så en långsam, saknad eller ändrad animation ändrar aldrig vem som blir träffad.

Hur du spelar en animation vid ett tangenttryck, i en loop eller på en NPC kan du läsa i guiden om animationsskript.

Vad äldre svärdsguider gör fel

Om du jämför den här guiden med en video eller ett foruminlägg, här är de viktiga skillnaderna och varför varje knep skapar ett problem.

Vanliga knep i svärdsguider och vad den här guiden gör i stället
GuidenProblemetDen här guiden
Gör skada i klingans händelse TouchedAngriparens enhet kan utlösa Touched på sitt svärd varifrån som helst (Robloxs sida om network ownership), och Touched utlöses flera gånger i rad för en enda beröring (Robloxs sida om debounce).Servern hittar målen med sin egen låda, en gång per Humanoid och sving.
Sänker Health i ett LocalScriptEn ändring som ett LocalScript gör på någon annans karaktär stannar på den enda enheten.All skada görs i SwordService.
Använder wait(0.5) för cooldownRoblox markerar den globala wait() som föråldrad, i stället används task.wait(), och en cooldown som bara finns på klienten stoppar ingen.Jämför tiden från os.clock() på servern. Ingenting väntar.
Spelar svingen med Humanoid:LoadAnimationFöråldrad, i stället används Animator:LoadAnimation.Laddar svingen via Animator.
Letar efter mål med Region3 och FindPartsInRegion3Föråldrat. Roblox rekommenderar GetPartBoundsInBox med OverlapParams i nya projekt.Använder GetPartBoundsInBox.
Lägger ett Script för servern inuti Tool, och det lyssnar på ActivatedVarje spelares svärd kör sin egen kopia av serverkoden, och sådana skript gör ofta skada i Touched (första raden). Med standardinställningarna körs ett Script bara i Workspace eller ServerScriptService, så ett Script i Tool startar inte förrän svärdet utrustas första gången. Robloxs sida om verktyg beskriver de flesta verktyg som ett LocalScript för inmatning, ett Script på servern för effekten och ett RemoteEvent mellan dem.En enda SwordService i ServerScriptService hanterar alla svärd i spelet.

Vad en exploiter kan och inte kan göra

Räkna med att en fuskare styr allt på sin egen enhet. Hen kan läsa och ändra dina LocalScript, och Robloxs guide om säkerhet säger att hen kan anropa RemoteEvents i vilken takt som helst och med godtyckliga argument. Så här ser det ut för det här svärdet.

Vad en fuskare kan försöka och vad SwordService gör åt det
Fuskaren försökerResultatVarför
Anropa SwordSwing så snabbt som koden klarar, eller använda en autoklickareHögst en sving räknas per 0.5 sekunderServerns cooldown är 0.6 sekunder minus 0.1 sekunders nätverksmarginal. Den marginalen är det mesta en fuskare vinner.
Skicka ett mål, ett skadetal eller en position med remotenIgnorerasonSwing läser bara spelaren som Roblox själv fyller i. Allt annat som skickas med remoten läses aldrig.
Ändra SwordClient, till exempel ta bort dess cooldownPåverkar inte servernSwordService har sina inställningar i ServerScriptService, som aldrig skickas till spelare.
Slå när hen är död eller inte har svärdet i handenIgnorerasSwordService kontrollerar att hens Humanoid lever och att ett Tool som heter Sword finns i hens karaktär, dit Roblox flyttar verktyget när det utrustas.
Träffa någon från andra sidan kartanIngenting händerLådan byggs runt angriparens karaktär där servern ser den och når bara 6 studs framåt.
Teleportera sig till en spelare och sedan slåMöjligtVarje enhet styr sin karaktärs rörelse, och Roblox nämner teleportering till vilken punkt som helst bland det som en klient kan göra med sin karaktär. En rörelsekontroll på servern kan upptäcka det.
Slå genom en tunn väggMöjligt inom lådan på 6 studsLådfrågan från steg 2 letar inte efter väggar. Version 2 lägger till en väggkontroll.
Spela vilken animation som helst eller ingen allsPåverkar inte träffarnaTräffarna beror aldrig på animationen. Roblox påpekar att fuskare kan spela godtyckliga animationer på sin karaktär.

Två rader säger "Möjligt", och det är ärligt. Det här svärdet låter inte en fuskare välja vem hen slår, hur hårt eller hur ofta. Det kan inte hindra hen från att flytta sin egen karaktär. Robloxs dokumentation om säkerhet säger att klienter styr sin karaktärs rörelse och fysik och att rörelsekontroller måste anpassas för varje spel. För ett tävlingsspel är nästa lager en rörelsekontroll på servern (guiden om sprint bygger en sådan, den varnar för grova speedhacks och långa teleporter) eller Robloxs server authority, som dokumentationen beskrev som en beta när vi kontrollerade den 13 oktober 2026.

Steg 4: testa

  1. Lägg till något att slå på. På fliken Avatar eller Home, klicka på Character för att öppna Rig Generator, välj en rigg (till exempel R15, sedan Block Avatar), och den infogas i Workspace. Flytta den några studs bort från din SpawnLocation.
  2. Tryck på Play, utrusta Sword från hotbaren, gå fram till riggen och klicka. Efter första slaget visas en hälsomätare ovanför den, eftersom en Humanoid som standard bara visar mätaren när dess Health är under MaxHealth. En Humanoid börjar med 100 hälsa, så det femte slaget slår ut den.
  3. Klicka så snabbt du kan. Bara en sving per 0.6 sekunder gör något.
  4. Gå ungefär 8 studs bort från riggen eller vänd ryggen mot den och svinga. Ingenting händer, eftersom ingen av dess parts finns i lådan.
  5. Testa på en riktig spelare. Välj Server & Clients i rullgardinslistan för testläge, ange 2 klienter och tryck på Play. Slå den andra spelaren inom 10 sekunder efter att hen spawnat: ingenting händer på grund av ForceField vid spawn. Därefter tar varje slag 20. Som standard återfår spelarkaraktärer också 1 % av MaxHealth varje sekund, så mellan striderna kommer deras hälsa sakta tillbaka.
  6. Om ditt spel har Teams, lägg båda testspelarna i samma lag. När FRIENDLY_FIRE är false gör deras svingar ingenting mot varandra.

Håll fönstret Output öppet hela tiden (menyn Window, sedan Output). När de här skripten fungerar skriver de ingenting, så varje rött fel från SwordService eller SwordClient är ett riktigt problem. Se Vanliga fel.

Så bygger du ut svärdet till ett stridssystem

Kombinationer

Ha en räknare av svingar per spelare på servern, bredvid lastSwing. Om den förra svingen var nyligen, lägg till 1; annars börja om från 1. Välj sedan skadan efter räknaren, till exempel mer skada vid vart tredje slag, och rensa räknaren vid PlayerRemoving på samma sätt. Klienten kan föra sin egen räkning för att välja vilken animation som ska spelas, eftersom animationen aldrig avgör träffen. Lådan och kontrollerna förblir exakt desamma.

Knockback

Efter TakeDamage kan SwordService knuffa målet med ApplyImpulse på målets RootPart, i riktningen för angriparens rootPart.CFrame.LookVector. Robloxs referens säger att knuffen beror på målets massa och att ett Script på servern kan anropa den på en part som servern äger eller på en part som en klient automatiskt äger. Varje spelares enhet simulerar hens egen karaktär, så testa knockback på spelare via Server & Clients och inte bara på riggen.

Räkna kills för topplistan

Precis före target:TakeDamage(DAMAGE), skriv ner vem som slog sist med target:SetAttribute("LastHitBy", player.UserId). I ett Script på servern, koppla händelsen Died på varje karaktärs Humanoid, läs attributet, hitta angriparen med Players:GetPlayerByUserId och lägg till 1 till IntValue Kills i hens leaderstats. Skapa den bredvid Coins och Wins, som i steg 1 i guiden om topplistor, och ändra den på servern, som i steg 2.

Blockering

Lägg till ett andra RemoteEvent som klienten anropar när blockeringsknappen trycks ned och släpps, och låt servern sätta attributet Blocking på den spelarens karaktär, med en egen gräns för takten. I SwordService, sänk eller hoppa över skadan när målets karaktär har Blocking satt. En fuskare väljer ändå själv när hen blockerar, så gör blockeringen kort eller ge den en cooldown.

Sälja svärdet eller dela ut det varje runda

StarterPack ger svärdet till varje spelare vid varje spawn. För att sälja det i stället, lägg det i mappen ShopItems från guiden om en butiks-GUI. Den guidens katalog säljer redan ett Tool som heter ClassicSword, så antingen kallar du det här Tool ClassicSword och sätter samma SWORD_NAME, eller så ändrar du posten i katalogen. För att bara dela ut det under en runda, ta skriptet GiveRoundTool från guiden om rundsystem: förvara Sword i ServerStorage och inte i StarterPack, och ersätt "RoundTool" i det skriptet med "Sword".

Fiender att slåss mot och avståndsvapen

För en NPC som jagar spelare, följ guiden om pathfinding för NPC:er. Svärdet skadar den som vilken annan Humanoid som helst. Om vapen som träffar på avstånd med samma serverregler kan du läsa i guiden om vapen.

Vanliga fel och lösningar

Öppna fönstret Output (menyn Window, sedan Output) innan du trycker på Play. De flesta problem med svärdet skriver antingen ett fel där eller beror på ett namn som inte stämmer.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("SwordSwing")'

SwordClient väntar på remoten som SwordService skapar, alltså körs inte SwordService. Kontrollera att det är ett Script och inte ett LocalScript, att det ligger direkt i ServerScriptService, inte är avstängt och att Output inte visar något fel från det.

Jag svingar, men ingen tar skada

Kontrollera i tur och ordning: SwordClient är ett LocalScript, inte ett Script, och ligger direkt i Tool Sword; Tool heter exakt Sword eller det som anges i SWORD_NAME; målet är högst 6 studs framför dig; målet spawnade för mer än 10 sekunder sedan, så dess ForceField är borta; och, om du använder Teams, att ni inte är i samma lag när FRIENDLY_FIRE är false.

Svärdet träffar spelare men aldrig min NPC

Rumsliga frågor som GetPartBoundsInBox returnerar aldrig en part där CanQuery är avstängt (CanQuery gäller bara när även CanCollide är avstängt). Slå på CanQuery igen på NPC:ns kroppsdelar och kontrollera att dess Humanoid är ett direkt barn till NPC:ns modell.

Min karaktär fastnar när jag utrustar svärdet

Någon part i svärdet är förankrad. Markera alla parts i Tool och avmarkera Anchored.

Vissa svingar träffar och andra missar på samma avstånd

I versionen med uppladdning träffas inte ett mål som lämnade lådan under WINDUP_SECONDS, och väggkontrollen hoppar över alla som står bakom en vägg eller en annan spelare. Korta uppladdningen eller öka HIT_WIDTH om missarna känns orättvisa i speltester.

Karaktären håller svärdet i klingan

Det finns mer än en part som heter Handle, och Roblox valde fel. Behåll exakt en Handle, fästet, och byt namn på de andra. Justera sedan grepp-egenskaperna på Tool om vinkeln fortfarande är fel.

Klingan stannar kvar eller faller när jag utrustar svärdet

Klingan är inte svetsad vid Handle. Lägg till en WeldConstraint där Part0 är Handle och Part1 är klingan.

Skadan syns på min skärm, men den andra spelarens hälsa ändras inte

Skadan görs från ett LocalScript, som bara ändrar din kopia av spelet. Gör skada bara i SwordService, som i steg 2.

Gör det med RoCode

Om du inte vill bygga allt det här för hand kan RoCode göra det i din öppna place. Det är en oberoende AI-agent för kod, inte från Roblox: du beskriver funktionen i dess webbchatt, och dess plugin för Roblox Studio skapar Tool, parts och skript i din Explorer, så du behöver inte kopiera kod från ett chattfönster.

Du skriver

Gör ett svärd: ett Tool som heter Sword i StarterPack med en Handle och en klinga svetsad vid den, ett LocalScript som anropar ett RemoteEvent vid Activated, och ett Script på servern som kontrollerar en cooldown på 0.6 sekunder och gör 20 skada på alla Humanoid i en låda framför spelaren.

RoCode gör
  • Skapar Tool och dess parts med Create Instance och sätter deras egenskaper med Set Property
  • Skriver SwordService och SwordClient med Create Script och kan först söka efter befintliga stridsskript med Search Scripts
  • Den är instruerad att kontrollera att varje skript den skriver kompilerar med Check Script, som kompilerar koden i Studio utan att köra den (den typkontrollerar inte)
  • Sätter en ångrapunkt före och efter varje omgång ändringar, så Ctrl+Z backar en omgång i taget

RoCode kan inte göra svinganimationen eller ladda upp den: gör den i Animation Editor och klistra in dess ID. Med plugin 3.9 eller nyare kan RoCode köra ett kort speltest och läsa felen, och med plugin 3.9.11 eller nyare kan den styra en testkaraktär, men den klickar inte i 3D-fönstret för att svinga, så svingarna testar du själv. Sidan hur du skapar ett helt Roblox-spel med RoCode, system för system visar var vapnen passar in. Så ansluter RoCode till Studio.

Vanliga frågor

Varför träffar mitt svärd samma spelare flera gånger på en sving?

Eftersom det gör skada från Touched. Robloxs sida om debounce påpekar att Touched utlöses flera gånger i rad för en enda beröring, och varje part på målet kan röra vid klingan. Den här guiden hittar målen med en enda lådfråga per sving och för en lista, så varje Humanoid förlorar hälsa en gång per sving.

Ska svärdets skada ligga i ett LocalScript eller ett Script?

I ett Script på servern. Skada som görs från ett LocalScript ändrar bara den spelarens kopia av spelet, och allt som finns på spelarens enhet kan en fuskare ändra. LocalScript ska bara höra klicket, spela animationen och anropa RemoteEvent.

Hur lägger jag till en svinganimation på svärdet?

Gör den i Animation Editor, sätt prioriteten Action, publicera den till Roblox och skriv in dess asset-ID i SWING_ANIMATION_ID som rbxassetid:// följt av talet. SwordClient spelar den via karaktärens Animator. Animationer som spelarens enhet startar på spelarens egen karaktär visas för alla.

Varför spelas inte svärdets animation?

Kontrollera tre saker. Prioritet: Action ligger över Movement, Idle och Core, så en sving med Action spelas ovanpå gång och stående, medan en lägre prioritet kan förlora mot dem. Ägare: om spelet ägs av en grupp, publicera animationen med den gruppen vald som Creator. ID: SWING_ANIMATION_ID måste vara hela texten rbxassetid:// med din animations tal, inte en tom sträng.

Vilken hitbox är bäst för ett svärd i Roblox?

För de flesta spel är det en lådfråga på servern en gång per sving, som i den här guiden: ett anrop till GetPartBoundsInBox, inget för klienten att förfalska, och tre tal att ställa in. Använd GetPartsInPart med en formad part eller raycasts längs klingan bara när vapnets räckvidd är långt från en låda. Jämförelse av de fyra sätten.

Hur hindrar jag svärdet från att slå genom väggar?

Innan du gör skada, skicka en stråle från angriparens rotpart till målets rotpart och hoppa över angriparens karaktär, och räkna slaget bara om det första strålen möter tillhör målet. Version 2 av SwordService gör det för varje mål.

Varför träffar slaget innan svinganimationen når målet?

Servern kontrollerar hitboxen i samma ögonblick som klicket kommer. Vänta först en kort uppladdning, till exempel 0.15 sekunder med task.delay, kontrollera sedan att angriparen fortfarande lever och håller svärdet, och bygg lådan, som version 2 gör.

Kan exploiters ändå fuska med det här svärdet?

De kan inte välja vem som blir träffad, hur mycket skada ett slag gör eller hur ofta de slår, eftersom servern avgör alla tre; det mesta de vinner är 0.1 sekunders nätverksmarginal på cooldown. De kan fortfarande flytta sin karaktär, till exempel tätt intill någon, eftersom varje enhet styr sin karaktärs rörelse. Nästa lager är en rörelsekontroll på servern.

Hur gör jag ett stridssystem med kombinationer?

Ha en räknare av svingar per spelare på servern, nollställ den efter en kort paus och välj skada och animation efter räknaren. Träffkontrollen förblir densamma. Avsnittet Så bygger du ut går också igenom knockback, att räkna kills och blockering.

Källor och vidare läsning

Så kontrollerades koden: varje skript på den här sidan klarar strikt Luau-typkontroll mot Roblox API-definitionerna (luau-lsp, 20 november 2026). Typkontrollen fångar felstavade API-namn och fel typer, men inte fel i spellogiken, så testa allt i Studio innan du publicerar.

Testa RoCode i ditt eget spel.

Gratis krediter varje dag, inget kort krävs. Installera pluginet, beskriv en funktion och kontrollera vad som dök upp i Studio.