Veiledning · Spillsystemer

Slik lager du et sverd i Roblox Studio

Et sverd i Roblox er et Tool med tre oppgaver fordelt på to skript: spillerens enhet oppdager klikket og spiller av svingen, og serveren avgjør hvem som ble truffet og hvor mye liv de mistet. I denne guiden bygger vi begge skriptene, med en cooldown og en hitbox som spillerne ikke kan forfalske, og viser hvor animasjonen passer inn.

Oppdatert 20. november 202622 min lesingSkrevet av

Kort fortalt

Legg et Tool med navnet Sword og en part med navnet Handle i StarterPack. Et LocalScript i Tool lytter etter Tool.Activated, spiller av en svinganimasjon og kaller en RemoteEvent uten argumenter. Et Script i ServerScriptService sjekker cooldown, og at spilleren lever og holder sverdet, finner Humanoids i en boks foran spilleren med workspace:GetPartBoundsInBox og kaller Humanoid:TakeDamage én gang per mål.

  • Ikke gi skade fra klingens Touched-event: spillerens enhet styrer sin egen karakter og kan utløse Touched fra hvor som helst, og nettopp et sverd er brukt som eksempel på Roblox-siden om network ownership.
  • Klienten sender verken mål eller skade. Serveren eier cooldown, hitbox og hvor stor skaden er.
  • TakeDamage gjør ingenting så lenge målet har et ForceField, for eksempel de første 10 sekundene etter spawn på en SpawnLocation.
  • Går slagene gjennom vegger, eller treffer de før svingen visuelt når målet? Bruk versjonen av server-skriptet med wind-up og veggsjekk.
På denne siden
  1. Slik virker det
  2. 1. Bygg Tool
  3. 2. Server-skript
  4. 3. LocalScript
  5. Hitbox
  6. Typer hitbox
  7. Wind-up og veggsjekk
  8. Svinganimasjon
  9. Gamle veiledninger
  10. Grensene for beskyttelsen
  11. 4. Test
  12. Utvidelser
  13. Common errors
  14. Med RoCode
  15. Ofte stilte spørsmål
  16. Kilder og videre lesing

Slik er et fungerende sverd bygget opp

IllustrasjonSvinger med minst 0.6 sekunds mellomrom fjerner 20 liv hver, et klikk innenfor cooldown gjør ingenting, og det femte slaget slår ut riggen.

Et sverd som virker i et ekte spill, er delt mellom spillerens enhet og serveren. På Roblox-siden om tools står det at input til tools skal ligge i et LocalScript, fordi bare spillerens enhet vet når input skjer, og at de fleste tools trenger et LocalScript, et server-Script og en RemoteEvent mellom dem. Denne guiden bruker nettopp den oppdelingen. En enkelt sving ser slik ut:

  1. Spilleren klikker, trykker eller trykker på gamepadens trigger med Sword utstyrt. I LocalScriptet utløses Tool.Activated.
  2. LocalScriptet spiller av svinganimasjonen, hvis det finnes en, og kaller RemoteEvent SwordSwing. Det sender ikke noe annet.
  3. Server-Scriptet sjekker cooldown, at spilleren lever, og at Sword er i spillerens hånd.
  4. Serveren bygger sin egen hitbox foran spillerens karakter og finner hver Humanoid inne i den.
  5. Hver av disse Humanoids mister liv én gang via TakeDamage.
Hva sverdet består av
ElementHvor det liggerHva det gjør
Tool SwordStarterPackDet spilleren holder. Roblox kopierer alt fra StarterPack til spillerens Backpack hver gang karakteren spawner.
Part HandleInne i ToolParten karakteren holder i. Klingen er sveiset fast til den.
LocalScript SwordClientInne i ToolHører klikket, spiller av svinganimasjonen og kaller remoten.
RemoteEvent SwordSwingReplicatedStorage (lages av SwordService)Bærer "jeg svingte" fra spillerens enhet til serveren, uten argumenter.
Script SwordServiceServerScriptServiceSjekker hver sving, finner ut hvem som står foran spilleren, og gir skade. Det eneste stedet der et slag kan skje.
Explorer når sverdet er ferdig. SwordService legger til en RemoteEvent med navnet SwordSwing i ReplicatedStorage når spillet kjører.
ServerScriptService
  SwordService Script new
StarterPack
  Sword Tool new
    Handle Part new
    Blade Part new
      WeldConstraint WeldConstraint new
    SwordClient LocalScript new

Steg 1: bygg sverdets Tool

  1. Hold musen over Workspace i Explorer, klikk på knappen + og sett inn et Tool. Gi det nytt navn til Sword. Server-skriptet ser etter nettopp det navnet. Du bygger sverdet i Workspace, slik Roblox-siden om tools anbefaler, fordi partene kan ses der og kan flyttes og skaleres. Det siste steget flytter det til StarterPack.
  2. Sett inn en Part i Tool, og kall den Handle. Det er grepet som karakteren holder sverdet i. Den må være et direkte barn av Tool og den eneste parten med det navnet: med to Handle velger Roblox en tilfeldig, og karakteren kan ende opp med å holde sverdet i klingen.
  3. Sett inn en andre Part i Tool, kall den Blade, gi den form, og plasser den slik at den stikker opp fra toppen av Handle.
  4. Sett inn en WeldConstraint i Blade. I Properties-vinduet setter du Part0 til Handle og Part1 til Blade, så sverdet holder sammen mens spilleren bærer det.
  5. Marker begge partene, og sørg for at Anchored er slått av. En ankret part i et tool låser karakteren fast når den utstyrer det. Slå også av CanCollide på begge, så klingen ikke støter borti spillere og vegger når det svinges.
  6. Marker Tool, og fjern haken ved CanBeDropped. Når den er satt, slipper et trykk på Backspace sverdet ut i Workspace.
  7. Dra det ferdige Sword fra Workspace til StarterPack. Et Tool som blir liggende i Workspace, er en gjenstand som én spiller kan plukke opp, ikke et sverd som ligger i alles Backpack fra start.

Et sverd av én MeshPart virker også: kall den MeshParten Handle, og hopp over Weld. Hvis karakteren holder sverdet i en merkelig vinkel under testen, marker Tool og juster grepsegenskapene (GripPos, GripForward, GripRight og GripUp) i Properties-vinduet.

Steg 2: legg til server-skriptet

Hold musen over ServerScriptService, sett inn et Script med navnet SwordService, og lim inn koden nedenfor i det. Det er det eneste stedet der et sverdslag kan skje. Innstillingene øverst er linjene du er ment å endre.

Script i ServerScriptService med navnet SwordService
-- Script i ServerScriptService med navnet SwordService.
-- Det eneste stedet der et sverdslag kan skje: sjekker svingen, finner mål foran
-- angriperen med sin egen hitbox og gir skade.

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

-- Innstillinger
local SWORD_NAME = "Sword" -- navnet på Tool i StarterPack
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- hold samme verdi i SwordClient
local HIT_RANGE = 6 -- studs foran angriperen
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false -- false: spillere på samme lag kan ikke skade hverandre
-- Svinger sendt nøyaktig COOLDOWN_SECONDS fra hverandre kan etter nettverksforsinkelse komme
-- litt tettere, så serveren gir denne marginen og avviser ikke en ekte sving
local NETWORK_SLACK = 0.1

-- Remoten som sverdets LocalScript kaller. Den bærer ingen argumenter: hvem som blir truffet,
-- avgjør serveren, så klienten har ingenting å forfalske.
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
	-- Nøytrale spillere (uten lag) kan alltid slå hverandre
	return not attacker.Neutral and not target.Neutral and attacker.Team == target.Team
end

local function onSwing(player: Player)
	-- 1. Én sving per cooldown, uansett hvor ofte remoten kalles
	local now = os.clock()
	local last = lastSwing[player]
	if last and now - last < COOLDOWN_SECONDS - NETWORK_SLACK then
		return
	end

	-- 2. Angriperen må leve og holde sverdet
	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. Serverens egen hitbox: en boks foran angriperens 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. Hver Humanoid i boksen får skade én gang, selv om flere av partene dens er inne 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) -- gjør ingenting så lenge målet har et ForceField
			end
		end
	end
end

swingEvent.OnServerEvent:Connect(onSwing)

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

SwordService lager selv RemoteEvent SwordSwing når spillet starter, så du trenger ikke sette inn noe i ReplicatedStorage for hånd. Hvis du allerede har laget en RemoteEvent med det navnet, slett den: LocalScriptet kunne finne din, og den lytter ingen på serveren etter.

Innstillingene øverst i SwordService
InnstillingVerdi herHva den endrer
SWORD_NAME"Sword"Navnet på det Tool som serveren forventer i spillerens hånd. Endre det hvis ditt Tool heter noe annet.
DAMAGE20Hvor mye liv hvert slag fjerner. En Humanoid starter med 100 liv, så fem slag slår ut en testrigg. Spillerkarakterer får som standard tilbake 1% av MaxHealth hvert sekund, så en spiller som blir slått i maksimalt tempo, overlever det femte slaget, og det trengs et sjette.
COOLDOWN_SECONDS0.6Tiden mellom svinger. Sett samme verdi i SwordClient.
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT6, 5, 6Hitboxen i studs: hvor langt den rekker foran spilleren, og hvor bred og høy den er.
FRIENDLY_FIREfalseMed false kan spillere på samme lag ikke skade hverandre. Spillere uten lag kan alltid slå hverandre, og NPC-er kan alltid treffes.
NETWORK_SLACK0.1Hvor mye før cooldown serveren fortsatt godtar en sving. To klikk med 0.6 sekunds mellomrom kan etter nettverksforsinkelse komme litt tettere, og uten denne marginen ville serveren avvise en ekte sving som spilleren allerede har sett.

Steg 3: legg til LocalScriptet i Tool

Sett inn et LocalScript i Tool Sword, kall det SwordClient, og lim inn denne koden i det:

LocalScript i Tool Sword i StarterPack med navnet SwordClient
-- LocalScript inne i Tool Sword med navnet SwordClient.
-- Tool.Activated utløses på spillerens enhet, så dette skriptet lytter etter klikk,
-- trykk eller trigger, spiller av svinganimasjonen og ber serveren om å svinge.

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 -- samme verdi som i SwordService
local SWING_ANIMATION_ID = "" -- valgfritt: "rbxassetid://" etterfulgt av id-en til animasjonen din

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

-- Last animasjonen én gang per karakter. Animasjoner som startes på din egen
-- karakter fra enheten din, vises for alle spillere.
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 -- serveren sjekker det også; sjekken her sparer unødvendige forespørsler
	end
	lastSwing = now
	if swingTrack then
		swingTrack:Play()
	end
	swingEvent:FireServer()
end)

La SWING_ANIMATION_ID være tom foreløpig. Sverdet virker også uten animasjon, fordi serveren uansett avgjør treffet. Hvordan du fyller den ut, vises i avsnittet Legg til en svinganimasjon.

Activated utløses ved museklikk, trykk på mobilen og trigger på gamepad, så det samme skriptet virker på alle enheter. Roblox kopierer Tool og LocalScriptet i det til hver spillers Backpack når karakteren spawner, så hver spiller kjører sin egen kopi.

LocalScriptet har sin egen cooldown bare for å slippe å sende forespørsler som serveren uansett ignorerer. Det er ikke en sikkerhetssjekk: en jukser kan slette det, endre det eller kalle SwordSwing fra sin egen kode. Guiden til RemoteEvent forklarer hvorfor hver remote må sjekkes på serveren, og Script vs LocalScript vs ModuleScript (på engelsk) viser hva et LocalScript kan og ikke kan endre.

Slik avgjør serveren hvem som ble truffet

Når SwordSwing kommer, spør SwordService ikke klienten om noe. Den bygger en boks foran angriperens karakter, der serveren ser den, og spør motoren hvilke parts som er inne i den, med workspace:GetPartBoundsInBox. Denne metoden erstatter den eldre FindPartsInRegion3, som Roblox merker som utdatert.

Boksens sentrum ligger 3 studs foran angriperens rotpart. Det er forskyvningen CFrame.new(0, 0, -HIT_RANGE / 2): en CFrame ser langs sin negative Z-akse, det er dens LookVector. Derfor strekker boksen seg fra midten av karakteren 6 studs fremover, og den er 5 studs bred og 6 høy. Forespørselen sammenligner hver parts bounding box, en rask kasseformet tilnærming av volumet, så runde parts og meshes teller litt større enn de ser ut. For et sverd er den lille marginen nyttig.

Hva SwordService gjør med parts i boksen
StegKodeHvorfor
Hopp over angriperenOverlapParams med Exclude og angriperens karakterAngriperens egne armer, bein og sverd er også i boksen.
Finn karakterenpart:FindFirstAncestorOfClass("Model")En part i boksen kan være et lem, en hatt eller et tool i hånden. FindFirstAncestorOfClass sammenligner det nøyaktige klassenavnet, så den går forbi hatten (klassen Accessory) og toolet i hånden (klassen Tool, selv om Tool er en slags Model) og stopper ved karakterens modell.
Finn Humanoidmodel:FindFirstChildOfClass("Humanoid")Alt med en Humanoid kan treffes: spillere, NPC-er og testdukker. Vegger og gulv hoppes over.
Én gang per Humanoidtabellen alreadyHitDet havner som regel flere parts fra den samme karakteren i boksen. Uten tabellen ville hver av dem gi skade på nytt.
Bare levende måltarget.Health > 0En karakter som allerede er slått ut, treffes ikke igjen.
LagisTeammateNår FRIENDLY_FIRE er false, hoppes spillere på samme lag over. En spiller der egenskapen Neutral er true, har ikke noe lag.
Skadetarget:TakeDamage(DAMAGE)Senker Health, med mindre målet er beskyttet av et ForceField.

Tabellen alreadyHit lages på nytt ved hver sving, så den samme spilleren kan treffes igjen med neste sving når cooldown er over. Det er regelen "én gang per mål per sving", som sverd basert på Touched alltid har problemer med.

Skriptet bruker TakeDamage og ikke en tildeling av Health. I Roblox-referansen står det at TakeDamage ikke rører en Humanoid så lenge den er beskyttet av et ForceField, mens en direkte tildeling av Health ignorerer ForceField. En spiller som spawner på en SpawnLocation, får som standard et ForceField i 10 sekunder (Duration på SpawnLocation), så nyankomne kan ikke treffes i det øyeblikket de dukker opp.

Fire måter å lage en sverd-hitbox på: sammenligning

Sverd-veiledninger skiller seg mest på ett punkt: hvordan man finner ut hva klingen traff. Det finnes fire vanlige svar. De skiller seg i hvor nøyaktig de følger klingen, hvor mye arbeid de koster serveren, og om en jukser kan forfalske resultatet.

Måter å lage en sverd-hitbox på. "Hvem avgjør" er den siden der svaret teller
MetodeSlik virker denHvem avgjørPresisjonBest for
Touched på klingenSkade hver gang klingens part berører en karakterAngriperens enhet, som eier karakteren sin og sverdetFølger klingen, men utløses flere ganger per berøringIngenting i et spill med andre spillere: angriperens enhet kan utløse den fra hvor som helst
Boks foran spilleren (denne guiden)Én GetPartBoundsInBox-forespørsel på serveren per svingServerenEn fast boks, ikke klingens bane. Meshes telles etter bounding boxes, så litt raustDe fleste spill: enkelt, billig og ingenting å forfalske
GetPartsInPart på en hitbox-partEn serverforespørsel med en part formet som klingens bue, under svingenServerenNøyaktige former: Roblox-dokumentasjonen sier at den gjør en full geometrisk sjekk, og foreslår forespørsler med boks eller kule når mindre presisjon holder, fordi de er billigereStore våpen med uvanlig form, for eksempel buen til en ljå
Raycasts langs klingenHver frame av svingen sendes korte stråler fra punkter på klingen til der de var i forrige frameSiden som sender dem. På serveren krever det serverens eget bilde av hvor klingen erFølger animasjonen tettSpill der svingens nøyaktige bane betyr noe. Slik virker community-hitbox-moduler

Boksen er det riktige førstevalget. Det er én forespørsel per sving, den avhenger aldri av en animasjon som en jukser kunne endre, og den er lett å justere med tre tall. Bytt til en part med riktig form eller stråler langs klingen når spillerne klager over at treff føles feil med et våpen der rekkevidden er langt fra en boks, og behold den samme regelen: serveren kjører forespørselen og gir skaden.

Sverd-presets: fra dolk til tohåndssverd

Den samme SwordService lager helt ulike våpen med fem innstillinger. Tabellen er et utgangspunkt, beregnet for en dukke fra Rig Generator med 100 Health. "Tid til knockout" telles fra første slag, når hver sving treffer så snart cooldown tillater det.

SwordService-innstillinger for vanlige nærkampvåpen, med antall slag og tid til knockout av en dukke med 100 Health. Beregnet, ikke målt
VåpenDAMAGECOOLDOWN_SECONDSHIT_RANGEHIT_WIDTHSlag (tid)Skade per sekund
Dolk120.35449 (2.8 s)omtrent 34
Sverd (denne guiden)200.6655 (2.4 s)omtrent 33
Tohåndssverd351.1773 (2.2 s)omtrent 32
Spyd180.8936 (4 s)omtrent 23
  • Spillere heles, dukker gjør ikke det. Spillerkarakterer får som standard tilbake 1% av MaxHealth hvert sekund. Med nøyaktig 100 skade på 5 slag overlever en spiller som blir slått i maksimalt tempo, det femte slaget, og det trengs et sjette. Gi litt margin, for eksempel 21 skade i stedet for 20, hvis det nøyaktige antallet slag betyr noe.
  • Skaler NETWORK_SLACK sammen med cooldown. Guidens 0.1 sekund er en sjettedel av 0.6. Hvis du beholder 0.1 på en dolk med 0.35 sekunds cooldown, kunne en jukser slå hvert 0.25 sekund, 40% raskere. Bruk omtrent en sjettedel av COOLDOWN_SECONDS: 0.06 for dolken.
  • Hold SwordClient i takt. Sett samme COOLDOWN_SECONDS der, ellers sender klienten svinger som serveren ignorerer.

Versjon 2: wind-up og ingen slag gjennom vegger

Når grunnsverdet virker, dukker det opp to klager. Slaget treffer i samme øyeblikk som spilleren klikker, før svinganimasjonen når målet, og en sving kan treffe noen som står på den andre siden av en tynn vegg, fordi boksen ikke tar hensyn til vegger. Denne versjonen av SwordService retter begge deler. Den erstatter skriptet fra steg 2: samme navn, samme remote, samme innstillinger, så SwordClient trenger ikke endres.

Script i ServerScriptService med navnet SwordService
-- Script i ServerScriptService med navnet SwordService (versjon med wind-up og veggsjekk).
-- Erstatter skriptet fra steg 2: samme innstillinger og remote pluss to regler. Slaget treffer
-- WINDUP_SECONDS etter klikket, når svingen når målet, og treffer ingen
-- gjennom en vegg.

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

-- Innstillinger
local SWORD_NAME = "Sword"
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- hold samme verdi i SwordClient
local WINDUP_SECONDS = 0.15 -- tid fra klikk til slag; tilpass til svinganimasjonen din
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

-- Returnerer angriperens karakter og rotpart så lenge den lever og holder sverdet
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 ikke er noe annet enn selve målet mellom angriperen og 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)
	-- Sjekk igjen etter wind-up: angriperen kan ha dødd eller lagt bort sverdet
	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)

Slett først SwordService fra steg 2, ellers lager begge skriptene hver sin SwordSwing-remote. Sett WINDUP_SECONDS til øyeblikket i svinganimasjonen din der klingen passerer foran karakteren; for en rask sving passer 0.15.

  • Wind-up. Cooldown og sjekkene "lever og holder sverdet" kjøres når klikket kommer, deretter starter task.delay strike etter WINDUP_SECONDS. strike sjekker angriperen på nytt, fordi den i mellomtiden kan ha dødd eller lagt bort sverdet, og bygger først deretter boksen. Et mål som har gått ut av rekkevidde under wind-up, blir ikke truffet, og det er nettopp det spillerne forventer når de ser svingen.
  • Veggsjekk. For hvert mål i boksen sender hasClearLine en stråle fra angriperens rotpart til målets rotpart og hopper over angriperens egen karakter. Hvis det første strålen treffer, tilhører målet, eller den ikke treffer noe, teller slaget. En vegg, en dør eller en annen spiller mellom dem blokkerer det.
  • Hva det koster. Én ekstra stråle per mål per sving, som er lite sammenlignet med selve boksforespørselen.

Wind-up gjør også sverdet mer rettferdig overfor juksere som slår i samme øyeblikk som de teleporterer bort til noen: serveren ser etter mål et øyeblikk senere, der den ser karakterene på det tidspunktet. Selve teleporten stopper det ikke; til det trengs en bevegelsessjekk, som er beskrevet i avsnittet Hva en exploiter kan og ikke kan.

Legg til en svinganimasjon (valgfritt)

SwordClient spiller allerede av en animasjon så snart du gir den en ID. Animasjonen lager du én gang, i Animation Editor i Studio:

  1. Sett inn en rigg for animasjonen. På fanen Avatar eller Home klikker du på Character for å åpne Rig Generator og velger en rigg som passer til avatarene i spillet ditt, for eksempel R15 og deretter Block Avatar.
  2. På fanen Avatar klikker du på Clip Editor for å åpne Animation Editor, markerer riggen og setter positurer for en kort sving med høyre arm.
  3. Sett prioriteten til Action: klikk på knappen … i editorens avspillingskontroller, hold musen over Set Animation Priority, og velg Action. Action står over Movement, Idle og Core, så svingen spilles av oppå gå- og stå-animasjonene i stedet for å tape mot dem.
  4. I den samme …-menyen velger du Publish to Roblox. Hvis spillet ditt eies av en gruppe, velg den gruppen i feltet Creator før du sender.
  5. Kopier animasjonens asset-ID fra Toolbox, og sett SWING_ANIMATION_ID i SwordClient til "rbxassetid://" etterfulgt av det tallet.

SwordClient laster svingen via karakterens Animator, ikke via den eldre Humanoid:LoadAnimation, som Roblox merker som utdatert. I Roblox-referansen for Animator står det at animasjoner som en spillers enhet starter på spillerens egen karakter, replikeres til serveren og til alle andre spillere, så et LocalScript kan spille av svingen, og alle kan se den. Det står også at Animator skal lages på serveren, så lag den aldri i et LocalScript. På spillerkarakterer ligger den som regel inne i Humanoid, og det er nettopp der Robloxs eget animasjonseksempel ser etter den.

Animasjonen er bare for utseendet. Treff avhenger ikke av den, så en langsom, manglende eller endret animasjon endrer aldri hvem som blir truffet.

Hvordan du spiller av en animasjon ved et tastetrykk, i loop eller på en NPC, kan du lese i guiden til animasjonsskript.

Hva gamle sverd-veiledninger tar feil av

Hvis du sammenligner denne guiden med en video eller et foruminnlegg, er dette de viktige forskjellene og grunnen til at hvert triks skaper et problem.

Vanlige triks i sverd-veiledninger, og hva denne guiden gjør i stedet
VeiledningProblemDenne guiden
Gir skade i klingens Touched-eventAngriperens enhet kan utløse Touched på sverdet sitt fra hvor som helst (Roblox-siden om network ownership), og Touched utløses flere ganger på rad for én berøring (Roblox-siden om debounce).Serveren finner mål med sin egen boks, én gang per Humanoid per sving.
Senker Health i et LocalScriptEn endring som et LocalScript gjør på en annens karakter, blir værende på den ene enheten.All skade gis i SwordService.
Bruker wait(0.5) for cooldownRoblox merker den globale wait() som utdatert, i stedet brukes task.wait(), og en cooldown som bare finnes på klienten, stopper ingen.Sammenligner tiden os.clock() på serveren. Ingenting venter.
Spiller av svingen via Humanoid:LoadAnimationUtdatert, i stedet brukes Animator:LoadAnimation.Laster svingen via Animator.
Finner mål via Region3 og FindPartsInRegion3Utdatert. Roblox anbefaler i nye prosjekter å bruke GetPartBoundsInBox med OverlapParams.Bruker GetPartBoundsInBox.
Legger et server-Script inne i Tool som lytter etter ActivatedHver spillers sverd kjører sin egen kopi av serverkoden, og slike skript gir ofte skade i Touched (første rad). Med standardinnstillingene kjører et Script bare i Workspace eller ServerScriptService, så et Script i Tool starter ikke før sverdet utstyres første gang. Roblox-siden om tools beskriver de fleste tools som et LocalScript for input, et server-Script for effekten og en RemoteEvent mellom dem.Én SwordService i ServerScriptService betjener alle sverd i spillet.

Hva en exploiter kan og ikke kan

Gå ut fra at en jukser styrer alt på sin egen enhet. Den kan lese og endre LocalScriptene dine, og i Robloxs sikkerhetsguide står det at den kan kalle RemoteEvents med hvilken som helst frekvens og vilkårlige argumenter. Her er hva det betyr for dette sverdet.

Hva en jukser kan prøve, og hva SwordService gjør med det
Jukseren prøverResultatHvorfor
Kalle SwordSwing så raskt som koden klarer, eller bruke en autoclickerHøyst én sving hvert 0.5 sekund tellerServerens cooldown er 0.6 sekund minus 0.1 sekunds nettverksmargin. Den marginen er det meste jukseren vinner.
Sende et mål, et skadetall eller en posisjon med remotenIgnoreresonSwing leser bare spilleren som Roblox selv setter inn. Alt annet som sendes med remoten, leses aldri.
Endre SwordClient, for eksempel fjerne cooldownenPåvirker ikke serverenSwordService holder innstillingene sine i ServerScriptService, som aldri sendes til spillerne.
Slå mens den er død eller uten sverd i håndenIgnoreresSwordService sjekker at dens Humanoid lever, og at et Tool med navnet Sword ligger inne i karakteren, der Roblox flytter toolet når det utstyres.
Treffe noen fra den andre enden av kartetIngenting skjerBoksen bygges rundt angriperens karakter, der serveren ser den, og rekker bare 6 studs frem.
Teleportere bort til en spiller og deretter slåMuligHver enhet styrer bevegelsen til karakteren sin, og Roblox nevner teleportering til et hvilket som helst punkt blant tingene klienten kan gjøre med karakteren sin. En bevegelsessjekk på serveren kan fange det.
Slå gjennom en tynn veggMulig innenfor boksen på 6 studsBoksforespørselen fra steg 2 ser ikke etter vegger. Versjon 2 legger til en veggsjekk.
Spille av hvilken som helst animasjon eller ingenPåvirker ikke treffTreff avhenger aldri av animasjonen. Roblox nevner at juksere kan spille av vilkårlige animasjoner på karakteren sin.

To rader sier "Mulig", og det er ærlig. Dette sverdet lar ikke en jukser velge hvem den treffer, hvor hardt eller hvor ofte. Det kan ikke hindre den i å flytte sin egen karakter. Robloxs sikkerhetsdokumentasjon sier at klienter styrer bevegelsen og fysikken til karakteren sin, og at bevegelsessjekker må tilpasses hvert spill. For et konkurransespill er neste lag en bevegelsessjekk på serveren (sprint-guiden bygger en slik, den advarer om grove speedhacks og lange teleporter) eller Robloxs server authority, som dokumentasjonen beskrev som beta da vi sjekket 13. oktober 2026.

Steg 4: test det

  1. Legg til noe å slå på. På fanen Avatar eller Home klikker du på Character for å åpne Rig Generator, velger en rigg (for eksempel R15, deretter Block Avatar), og den settes inn i Workspace. Flytt den noen studs bort fra din SpawnLocation.
  2. Trykk på Play, utstyr Sword fra hotbaren, gå bort til riggen, og klikk. Etter første slag dukker det opp en livsbar over den, fordi en Humanoid som standard bare viser baren når Health er under MaxHealth. En Humanoid starter med 100 liv, så det femte slaget slår den ut.
  3. Klikk så raskt du kan. Bare én sving hvert 0.6 sekund gjør noe.
  4. Gå omtrent 8 studs bort fra riggen, eller snu ryggen til den, og sving. Ingenting skjer, fordi ingen av partene dens er i boksen.
  5. Test på en ekte spiller. Velg Server & Clients i nedtrekksmenyen med testmoduser, sett 2 klienter, og trykk på Play. Slå den andre spilleren innen 10 sekunder etter at den spawnet: ingenting skjer på grunn av ForceField ved spawn. Etter det fjerner hvert slag 20. Som standard får spillerkarakterer også tilbake 1% av MaxHealth hvert sekund, så mellom kampene kommer livet deres sakte tilbake.
  6. Hvis spillet ditt har Teams, sett begge testspillerne på samme lag. Når FRIENDLY_FIRE er false, gjør svingene deres ingenting mot hverandre.

Hold Output-vinduet åpent hele tiden (menyen Window, deretter Output). Når disse skriptene virker, skriver de ingenting, så enhver rød feil fra SwordService eller SwordClient er et reelt problem. Se Vanlige feil.

Slik utvider du sverdet til et kampsystem

Comboer

Hold på serveren en teller for svinger per spiller ved siden av lastSwing. Hvis forrige sving var nylig, legg til 1; ellers start på nytt på 1. Velg deretter skaden ut fra telleren, for eksempel mer skade på hvert tredje slag, og tøm telleren ved PlayerRemoving på samme måte. Klienten kan føre sin egen telling for å velge hvilken animasjon som skal spilles av, fordi animasjonen aldri avgjør treffet. Boksen og sjekkene forblir nøyaktig de samme.

Knockback

Etter TakeDamage kan SwordService dytte målet bort med ApplyImpulse på målets RootPart i retning av angriperens rootPart.CFrame.LookVector. I Roblox-referansen står det at dyttet avhenger av målets masse, og at et server-Script kan kalle det på en part som serveren eier, eller på en part som en klient automatisk eier. Hver spillers enhet simulerer sin egen karakter, så test knockback på spillere via Server & Clients, ikke bare på en rigg.

Kills til leaderboardet

Rett før target:TakeDamage(DAMAGE) lagrer du hvem som traff sist, med target:SetAttribute("LastHitBy", player.UserId). I et server-Script kobler du til Died-eventet på hver karakters Humanoid, leser attributtet, finner angriperen med Players:GetPlayerByUserId og legger til 1 i IntValue Kills i dens leaderstats. Lag den ved siden av Coins og Wins som i steg 1 i guiden til leaderboards, og endre den på serveren som i steg 2.

Blokkering

Legg til en andre RemoteEvent som klienten kaller når blokkeringsknappen trykkes ned og slippes, og la serveren sette attributtet Blocking på den spillerens karakter med sin egen frekvensgrense. I SwordService senker du skaden eller hopper over den når målets karakter har Blocking satt. En jukser velger fortsatt selv når den blokkerer, så gjør blokkeringen kort, eller gi den en cooldown.

Selg sverdet, eller del det ut hver runde

StarterPack gir sverdet til hver spiller ved hver spawn. For å selge det i stedet legger du det i mappen ShopItems fra guiden til butikk-GUI. Katalogen i den guiden selger allerede et Tool med navnet ClassicSword, så enten kaller du dette Tool ClassicSword og setter samme SWORD_NAME, eller så endrer du oppføringen i katalogen. For å dele det ut bare i en runde bruker du skriptet GiveRoundTool fra guiden til rundesystemer: lagre Sword i ServerStorage i stedet for StarterPack, og erstatt "RoundTool" i det skriptet med "Sword".

Fiender å kjempe mot og avstandsvåpen

For en NPC som jakter på spillere, følger du guiden til pathfinding for NPC-er. Sverdet skader den som enhver annen Humanoid. Om våpen som treffer på avstand etter de samme serverreglene, kan du lese i guiden til våpen.

Vanlige feil og løsninger

Åpne Output-vinduet (menyen Window, deretter Output) før du trykker på Play. De fleste problemer med sverdet skriver enten en feil der eller skyldes et navn som ikke stemmer.

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

SwordClient venter på remoten som SwordService lager, så SwordService kjører ikke. Sjekk at det er et Script og ikke et LocalScript, at det ligger rett i ServerScriptService, ikke er slått av, og at det ikke er noen feil fra det i Output.

Jeg svinger, men ingen tar skade

Sjekk i rekkefølge: SwordClient er et LocalScript, ikke et Script, og ligger rett i Tool Sword; Tool heter nøyaktig Sword eller det som står i SWORD_NAME; målet er høyst 6 studs foran deg; målet spawnet for mer enn 10 sekunder siden, så ForceField er borte; og hvis du bruker Teams, er dere ikke på samme lag med FRIENDLY_FIRE satt til false.

Sverdet treffer spillere, men aldri NPC-en min

Romlige forespørsler som GetPartBoundsInBox returnerer aldri en part der CanQuery er slått av (CanQuery virker bare når CanCollide også er slått av). Slå på CanQuery igjen på NPC-ens kroppsdeler, og sjekk at dens Humanoid er et direkte barn av NPC-modellen.

Karakteren min sitter fast når jeg utstyrer sverdet

En av sverdets parts er ankret. Marker alle parts inne i Tool, og slå av Anchored.

Noen svinger treffer og andre bommer på samme avstand

I versjonen med wind-up blir et mål som forlot boksen under WINDUP_SECONDS, ikke truffet, og veggsjekken hopper over alle som står bak en vegg eller en annen spiller. Gjør wind-up kortere, eller øk HIT_WIDTH, hvis bommene føles urettferdige i playtester.

Karakteren holder sverdet i klingen

Det er mer enn én part med navnet Handle, og Roblox valgte feil. Behold nøyaktig én Handle, grepet, og gi de andre nytt navn. Juster deretter grepsegenskapene på Tool hvis vinkelen fortsatt er feil.

Klingen blir stående eller faller når jeg utstyrer sverdet

Klingen er ikke sveiset til Handle. Legg til en WeldConstraint der Part0 er Handle og Part1 er klingen.

Skaden vises på skjermen min, men den andre spillerens liv endrer seg ikke

Skaden gis fra et LocalScript, som bare endrer din kopi av spillet. Gi skade bare i SwordService, som i steg 2.

Lag det med RoCode

Hvis du ikke har lyst til å bygge alt dette for hånd, kan RoCode gjøre det i placen du har åpen. Det er en uavhengig AI-agent for å skrive kode, ikke fra Roblox: du beskriver funksjonen i webchatten, og pluginen for Roblox Studio lager Tool, parts og skript i Explorer for deg, så du ikke trenger å kopiere kode fra et chattevindu.

Du skriver

Lag et sverd: et Tool med navnet Sword i StarterPack med en Handle og en klinge sveiset fast til den, et LocalScript som kaller en RemoteEvent ved Activated, og et server-Script som sjekker en cooldown på 0.6 sekund og gir 20 skade til alle Humanoids i en boks foran spilleren.

RoCode gjør
  • Lager Tool og partene med Create Instance og setter egenskapene med Set Property
  • Skriver SwordService og SwordClient med Create Script og kan først se etter eksisterende kampskript med Search Scripts
  • Den er instruert til å sjekke kompileringen av hvert skript den skriver, med Check Script, som kompilerer koden i Studio uten å kjøre den (den sjekker ikke typer)
  • Setter et angrepunkt før og etter hver pakke med endringer, så Ctrl+Z ruller tilbake én pakke om gangen

RoCode kan ikke lage svinganimasjonen eller laste den opp: lag den i Animation Editor og lim inn ID-en. Med plugin 3.9 eller nyere kan RoCode kjøre en kort playtest og lese feilene, og med plugin 3.9.11 eller nyere kan den styre en testfigur, men den klikker ikke i 3D-vinduet for å svinge, så svingene tester du selv. Siden slik lager du et helt Roblox-spill med RoCode, system for system viser hvor våpen passer inn. Slik kobler RoCode seg til Studio.

Ofte stilte spørsmål

Hvorfor treffer sverdet mitt den samme spilleren flere ganger i én sving?

Fordi det gir skade fra Touched. Roblox-siden om debounce nevner at Touched utløses flere ganger på rad for én berøring, og hver av målets parts kan berøre klingen. Denne guiden finner mål med én boksforespørsel per sving og fører en liste, så hver Humanoid mister liv én gang per sving.

Skal sverdets skade ligge i et LocalScript eller et Script?

I et Script på serveren. Skade gitt fra et LocalScript endrer bare den spillerens kopi av spillet, og alt på spillerens enhet kan en jukser endre. LocalScriptet skal bare høre klikket, spille av animasjonen og kalle RemoteEvent.

Hvordan gir jeg sverdet en svinganimasjon?

Lag den i Animation Editor, sett prioriteten til Action, publiser den til Roblox, og skriv asset-ID-en i SWING_ANIMATION_ID som rbxassetid:// etterfulgt av tallet. SwordClient spiller den av via karakterens Animator. Animasjoner som en spillers enhet starter på spillerens egen karakter, vises for alle.

Hvorfor spilles ikke sverdets animasjon av?

Sjekk tre ting. Prioritet: Action står over Movement, Idle og Core, så en sving med Action spilles av oppå gåing og stillestående, mens en lavere prioritet kan tape mot dem. Eier: hvis spillet eies av en gruppe, publiser animasjonen med den gruppen valgt som Creator. ID: SWING_ANIMATION_ID må være hele teksten rbxassetid:// med tallet til animasjonen din, ikke en tom streng.

Hvilken hitbox er best for et sverd i Roblox?

For de fleste spill er det en boksforespørsel på serveren én gang per sving, som i denne guiden: ett kall til GetPartBoundsInBox, ingenting for klienten å forfalske og tre tall å justere. Bruk GetPartsInPart med en part i riktig form eller raycasts langs klingen bare når våpenets rekkevidde er langt fra en boks. Sammenligning av de fire måtene.

Hvordan hindrer jeg sverdet i å slå gjennom vegger?

Før skaden gis, sender du en stråle fra angriperens rotpart til målets rotpart, hopper over angriperens karakter og teller slaget bare hvis det første strålen treffer, tilhører målet. Versjon 2 av SwordService gjør det for hvert mål.

Hvorfor treffer slaget før svinganimasjonen når målet?

Serveren sjekker hitboxen i samme øyeblikk som klikket kommer. Vent først en kort wind-up, for eksempel 0.15 sekund med task.delay, sjekk deretter at angriperen fortsatt lever og holder sverdet, og bygg boksen, slik versjon 2 gjør.

Kan exploitere fortsatt jukse med dette sverdet?

De kan ikke velge hvem som blir truffet, hvor mye skade et slag gir, eller hvor ofte de slår, fordi serveren avgjør alle tre; det meste de vinner, er 0.1 sekunds nettverksmargin på cooldown. De kan fortsatt flytte karakteren sin, for eksempel helt inntil noen, fordi hver enhet styrer bevegelsen til karakteren sin. Neste lag er en bevegelsessjekk på serveren.

Hvordan lager jeg et kampsystem med comboer?

Hold på serveren en teller for svinger per spiller, nullstill den etter en kort pause, og velg skade og animasjon ut fra telleren. Treffsjekken forblir den samme. Avsnittet Slik utvider du går også gjennom knockback, kills og blokkering.

Kilder og videre lesing

Slik ble koden sjekket: hvert skript på denne siden går gjennom streng Luau-typesjekk med Roblox API-definisjonene (luau-lsp, 20. november 2026). Typesjekken fanger feil i API-navn og feil typer, men ikke feil i spillogikken, så test alt i Studio før du publiserer.

Prøv RoCode i ditt eget spill.

Gratis credits hver dag, uten kort. Installer pluginen, beskriv en funksjon og se hva som dukker opp i Studio.