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.
TakeDamagegö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
Så är ett fungerande svärd uppbyggt
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:
- Spelaren klickar, trycker på skärmen eller trycker på handkontrollens avtryckare med Sword utrustat. I LocalScript utlöses
Tool.Activated. - LocalScript spelar svinganimationen, om det finns en, och anropar RemoteEvent
SwordSwing. Mer skickar det inte. - Serverns Script kontrollerar cooldown, att spelaren lever och att Sword finns i hens hand.
- Servern bygger sin egen hitbox framför spelarens karaktär och hittar varje Humanoid i den.
- Var och en av dessa Humanoid förlorar hälsa en gång via
TakeDamage.
| Del | Var den finns | Vad den gör |
|---|---|---|
Tool Sword | StarterPack | Det som spelaren håller. Roblox kopierar allt från StarterPack till spelarens Backpack varje gång hens karaktär spawnar. |
Part Handle | Inuti Tool | Parten som karaktären håller i. Klingan är svetsad fast vid den. |
LocalScript SwordClient | Inuti Tool | Hör klicket, spelar svinganimationen och anropar remoten. |
RemoteEvent SwordSwing | ReplicatedStorage (skapas av SwordService) | Bär "jag svingade" från spelarens enhet till servern, utan argument. |
Script SwordService | ServerScriptService | Kontrollerar varje sving, hittar vem som står framför spelaren och gör skada. Det enda stället där ett slag kan ske. |
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
- 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. - 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. - Infoga en andra Part i Tool, kalla den
Blade, ge den form och placera den så att den sticker upp ur toppen av Handle. - Infoga en WeldConstraint i Blade. I fönstret Properties, sätt dess
Part0till Handle ochPart1till Blade, så att svärdet håller ihop medan spelaren bär det. - 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.
- Markera Tool och avmarkera CanBeDropped. När den är markerad kastar Backspace svärdet ut i Workspace.
- 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 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ällning | Värde här | Vad 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. |
DAMAGE | 20 | Hur 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_SECONDS | 0.6 | Tiden mellan svingar. Sätt samma värde i SwordClient. |
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT | 6, 5, 6 | Hitboxen i studs: hur långt den når framför spelaren, hur bred och hur hög den är. |
FRIENDLY_FIRE | false | Med false kan spelare i samma lag inte skada varandra. Spelare utan lag kan alltid slå varandra, och NPC:er kan alltid träffas. |
NETWORK_SLACK | 0.1 | Hur 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 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.
| Steg | Kod | Varför |
|---|---|---|
| Hoppa över angriparen | OverlapParams med Exclude och angriparens karaktär | Angriparens egna armar, ben och svärd finns också i lådan. |
| Hitta karaktären | part: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 Humanoid | model: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 Humanoid | tabellen alreadyHit | I 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ål | target.Health > 0 | En karaktär som redan är utslagen träffas inte igen. |
| Lag | isTeammate | När FRIENDLY_FIRE är false hoppas spelare i samma lag över. En spelare vars egenskap Neutral är true har inget lag. |
| Skada | target: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 | Hur det fungerar | Vem avgör | Precision | Bäst för |
|---|---|---|---|---|
Touched på klingan | Skada varje gång en part på klingan rör vid en karaktär | Angriparens enhet, som äger sin karaktär och sitt svärd | Följer klingan, men utlöses flera gånger per beröring | Ingenting 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 sving | Servern | En fast låda, inte klingans bana. Meshes räknas med omslutande lådor, så lite generöst | De flesta spel: enkelt, billigt och inget att förfalska |
GetPartsInPart på en hitbox-part | En fråga på servern med en part formad som klingans båge, under svingen | Servern | Exakta 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 billigare | Stora vapen med ovanlig form, till exempel en lies båge |
| Raycasts längs klingan | Varje bildruta i svingen skickas korta strålar från punkter på klingan till där de var i förra bildrutan | Den sida som skickar dem. På servern behövs serverns bild av var klingan är | Följer animationen nära | Spel 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.
| Vapen | DAMAGE | COOLDOWN_SECONDS | HIT_RANGE | HIT_WIDTH | Slag (tid) | Skada per sekund |
|---|---|---|---|---|---|---|
| Dolk | 12 | 0.35 | 4 | 4 | 9 (2.8 s) | ungefär 34 |
| Svärd (den här guiden) | 20 | 0.6 | 6 | 5 | 5 (2.4 s) | ungefär 33 |
| Tvåhandssvärd | 35 | 1.1 | 7 | 7 | 3 (2.2 s) | ungefär 32 |
| Spjut | 18 | 0.8 | 9 | 3 | 6 (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_SECONDSdä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 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.delaystrikeefterWINDUP_SECONDS.strikekontrollerar 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
hasClearLineen 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:
- 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.
- 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.
- 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.
- 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.
- Kopiera animationens asset-ID från Toolbox och sätt i SwordClient
SWING_ANIMATION_IDtill"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.
| Guiden | Problemet | Den här guiden |
|---|---|---|
Gör skada i klingans händelse Touched | Angriparens 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 LocalScript | En ä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 cooldown | Roblox 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:LoadAnimation | Föråldrad, i stället används Animator:LoadAnimation. | Laddar svingen via Animator. |
Letar efter mål med Region3 och FindPartsInRegion3 | Fö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å Activated | Varje 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.
| Fuskaren försöker | Resultat | Varför |
|---|---|---|
Anropa SwordSwing så snabbt som koden klarar, eller använda en autoklickare | Högst en sving räknas per 0.5 sekunder | Serverns 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 remoten | Ignoreras | onSwing 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 cooldown | Påverkar inte servern | SwordService har sina inställningar i ServerScriptService, som aldrig skickas till spelare. |
| Slå när hen är död eller inte har svärdet i handen | Ignoreras | SwordService 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 kartan | Ingenting händer | Lå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öjligt | Varje 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ägg | Möjligt inom lådan på 6 studs | Lå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 alls | Påverkar inte träffarna | Trä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
- 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.
- 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.
- Klicka så snabbt du kan. Bara en sving per 0.6 sekunder gör något.
- 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.
- 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.
- 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.
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.
- 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
- Roblox Creator Docs: In-game tools (på engelska). att bygga ett verktyg i Workspace, Handle, Weld, Grip, förankring och varför de flesta verktyg använder LocalScript, Script och RemoteEvent
- Roblox Creator Docs: WorldRoot:GetPartBoundsInBox (på engelska). lådfrågan, OverlapParams och den föråldrade FindPartsInRegion3
- Roblox Creator Docs: Humanoid:TakeDamage (på engelska). skydd av ForceField, hälsomätaren och hälsoåterhämtning
- Roblox Creator Docs: Network ownership (på engelska). exploiten med ett svärd på Touched
- Roblox Creator Docs: Security tactics and cheat mitigation (på engelska). lita aldrig på klienten
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (på engelska). vad en klient kan göra med sin karaktär och rörelsekontroller
- Roblox Creator Docs: Animation Editor (på engelska). animationsprioritet och publicering
- Roblox Creator Docs: Animator:LoadAnimation (på engelska). vilka animationer som replikeras från klienten
- Roblox Creator Docs: Debounce patterns (på engelska). varför Touched utlöses flera gånger för en enda beröring
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.