Kort fortalt
Læg et Tool med navnet Sword og en part med navnet Handle i StarterPack. Et LocalScript i Tool lytter efter Tool.Activated, afspiller en svinganimation og kalder en RemoteEvent uden argumenter. Et Script i ServerScriptService tjekker cooldown, og at spilleren er i live og holder sværdet, finder Humanoids i en boks foran spilleren med workspace:GetPartBoundsInBox og kalder Humanoid:TakeDamage én gang pr. mål.
- Giv ikke skade fra klingens
Touched-event: spillerens enhed styrer sin egen karakter og kan udløse Touched hvor som helst fra, og netop et sværd er brugt som eksempel på Roblox-siden om network ownership. - Klienten sender hverken mål eller skade. Serveren ejer cooldown, hitbox og skadens størrelse.
TakeDamagegør ingenting, så længe målet har et ForceField, for eksempel de første 10 sekunder efter spawn på en SpawnLocation.- Går slagene gennem vægge eller rammer de, før svinget visuelt når målet? Brug versionen af server-scriptet med wind-up og vægtjek.
På denne side
Sådan er et fungerende sværd bygget op
Et sværd, der virker i et rigtigt spil, er delt mellem spillerens enhed og serveren. På Roblox-siden om tools står der, at input til tools skal ligge i et LocalScript, fordi kun spillerens enhed ved, hvornår input sker, og at de fleste tools har brug for et LocalScript, et server-Script og en RemoteEvent imellem dem. Denne guide bruger netop den opdeling. Et enkelt sving ser sådan ud:
- Spilleren klikker, trykker eller trykker på gamepaddens trigger med Sword udstyret. I LocalScriptet udløses
Tool.Activated. - LocalScriptet afspiller svinganimationen, hvis der er en, og kalder RemoteEvent
SwordSwing. Det sender ikke andet. - Server-Scriptet tjekker cooldown, at spilleren er i live, og at Sword er i spillerens hånd.
- Serveren bygger sin egen hitbox foran spillerens karakter og finder hver Humanoid inden i den.
- Hver af disse Humanoids mister liv én gang via
TakeDamage.
| Element | Hvor det ligger | Hvad det gør |
|---|---|---|
Tool Sword | StarterPack | Det, spilleren holder. Roblox kopierer alt fra StarterPack til spillerens Backpack, hver gang karakteren spawner. |
Part Handle | Inde i Tool | Den part, karakteren holder i. Klingen er svejset fast på den. |
LocalScript SwordClient | Inde i Tool | Hører klikket, afspiller svinganimationen og kalder remoten. |
RemoteEvent SwordSwing | ReplicatedStorage (oprettes af SwordService) | Bærer "jeg svingede" fra spillerens enhed til serveren, uden argumenter. |
Script SwordService | ServerScriptService | Tjekker hvert sving, finder ud af, hvem der står foran spilleren, og giver skade. Det eneste sted, hvor et slag kan ske. |
ServerScriptService
SwordService Script new
StarterPack
Sword Tool new
Handle Part new
Blade Part new
WeldConstraint WeldConstraint new
SwordClient LocalScript new
Trin 1: byg sværdets Tool
- Hold musen over Workspace i Explorer, klik på knappen + og indsæt et Tool. Omdøb det til
Sword. Server-scriptet leder efter netop det navn. Du bygger sværdet i Workspace, som Roblox-siden om tools anbefaler, fordi dets parts kan ses der og kan flyttes og skaleres. Det sidste trin flytter det til StarterPack. - Indsæt en Part i Tool, og kald den
Handle. Det er grebet, som karakteren holder sværdet i. Den skal være et direkte barn af Tool og den eneste part med det navn: med to Handle vælger Roblox en tilfældigt, og karakteren kan komme til at holde sværdet i klingen. - Indsæt en anden Part i Tool, kald den
Blade, giv den form, og placér den, så den stikker op fra toppen af Handle. - Indsæt en WeldConstraint i Blade. I Properties-vinduet sætter du dens
Part0til Handle ogPart1til Blade, så sværdet holder sammen, mens spilleren bærer det. - Markér begge parts, og sørg for, at Anchored er slået fra. En ankret part i et tool lænker karakteren fast, når den udstyrer det. Slå også CanCollide fra på begge, så klingen ikke støder ind i spillere og vægge, når der svinges.
- Markér Tool, og fjern fluebenet ved CanBeDropped. Når det er sat, smider et tryk på Backspace sværdet ud i Workspace.
- Træk det færdige Sword fra Workspace til StarterPack. Et Tool, der bliver liggende i Workspace, er en genstand, som én spiller kan samle op, ikke et sværd, der ligger i alles Backpack fra start.
Et sværd af én MeshPart virker også: kald den MeshPart Handle, og spring Weld over. Hvis karakteren holder sværdet i en mærkelig vinkel under testen, så markér Tool og justér dets grebsegenskaber (GripPos, GripForward, GripRight og GripUp) i Properties-vinduet.
Trin 2: tilføj server-scriptet
Hold musen over ServerScriptService, indsæt et Script med navnet SwordService, og indsæt koden nedenfor i det. Det er det eneste sted, hvor et sværdslag kan ske. Indstillingerne øverst er de linjer, du er beregnet til at ændre.
-- Script i ServerScriptService med navnet SwordService.
-- Det eneste sted, hvor et sværdslag kan ske: tjekker svinget, finder mål foran
-- angriberen med sin egen hitbox og giver skade.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Indstillinger
local SWORD_NAME = "Sword" -- navnet på Tool i StarterPack
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- hold samme værdi i SwordClient
local HIT_RANGE = 6 -- studs foran angriberen
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false -- false: spillere på samme hold kan ikke skade hinanden
-- Sving sendt præcis COOLDOWN_SECONDS fra hinanden kan efter netværksforsinkelse komme
-- lidt tættere på hinanden, så serveren giver denne margin og afviser ikke et rigtigt sving
local NETWORK_SLACK = 0.1
-- Remoten, som sværdets LocalScript kalder. Den bærer ingen argumenter: hvem der bliver ramt,
-- afgør serveren, så klienten har intet at 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
-- Neutrale spillere (uden hold) kan altid slå hinanden
return not attacker.Neutral and not target.Neutral and attacker.Team == target.Team
end
local function onSwing(player: Player)
-- 1. Ét sving pr. cooldown, uanset hvor ofte remoten kaldes
local now = os.clock()
local last = lastSwing[player]
if last and now - last < COOLDOWN_SECONDS - NETWORK_SLACK then
return
end
-- 2. Angriberen skal være i live og holde 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. Serverens egen hitbox: en boks foran angriberens rodpart
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 af dens parts er inde 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, så længe målet har et ForceField
end
end
end
end
swingEvent.OnServerEvent:Connect(onSwing)
Players.PlayerRemoving:Connect(function(player: Player)
lastSwing[player] = nil
end)
SwordService opretter selv RemoteEvent SwordSwing, når spillet starter, så du behøver ikke at indsætte noget i ReplicatedStorage i hånden. Hvis du allerede har oprettet en RemoteEvent med det navn, så slet den: LocalScriptet kunne finde din, og den lytter ingen på serveren efter.
| Indstilling | Værdi her | Hvad den ændrer |
|---|---|---|
SWORD_NAME | "Sword" | Navnet på det Tool, serveren forventer i spillerens hånd. Ændr det, hvis dit Tool hedder noget andet. |
DAMAGE | 20 | Hvor meget liv hvert slag fjerner. En Humanoid starter med 100 liv, så fem slag slår en testrig ud. Spillerkarakterer genvinder som standard 1% af MaxHealth hvert sekund, så en spiller, der bliver slået med maksimal hastighed, overlever det femte slag, og der skal et sjette til. |
COOLDOWN_SECONDS | 0.6 | Tiden mellem sving. Sæt samme værdi i SwordClient. |
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT | 6, 5, 6 | Hitboxen i studs: hvor langt den rækker foran spilleren, og hvor bred og høj den er. |
FRIENDLY_FIRE | false | Med false kan spillere på samme hold ikke skade hinanden. Spillere uden hold kan altid slå hinanden, og NPC'er kan altid rammes. |
NETWORK_SLACK | 0.1 | Hvor meget før cooldown serveren stadig accepterer et sving. To klik med 0.6 sekunds mellemrum kan efter netværksforsinkelse komme lidt tættere på hinanden, og uden denne margin ville serveren afvise et rigtigt sving, som spilleren allerede har set. |
Trin 3: tilføj LocalScriptet i Tool
Indsæt et LocalScript i Tool Sword, kald det SwordClient, og indsæt denne kode i det:
-- LocalScript inde i Tool Sword med navnet SwordClient.
-- Tool.Activated udløses på spillerens enhed, så dette script lytter efter klik,
-- tryk eller trigger, afspiller svinganimationen og beder serveren om at 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 værdi som i SwordService
local SWING_ANIMATION_ID = "" -- valgfrit: "rbxassetid://" efterfulgt af id for din animation
local player = Players.LocalPlayer
local lastSwing = 0
local swingTrack: AnimationTrack? = nil
local trackCharacter: Model? = nil
-- Indlæs animationen én gang pr. karakter. Animationer, der startes på din egen
-- karakter fra din enhed, 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 tjekker det også; tjekket her sparer unødvendige forespørgsler
end
lastSwing = now
if swingTrack then
swingTrack:Play()
end
swingEvent:FireServer()
end)
Lad SWING_ANIMATION_ID være tom indtil videre. Sværdet virker også uden animation, fordi serveren under alle omstændigheder afgør træffet. Hvordan du udfylder den, vises i afsnittet Tilføj en svinganimation.
Activated udløses ved museklik, tryk på telefonen og trigger på gamepad, så det samme script virker på alle enheder. Roblox kopierer Tool og LocalScriptet i det til hver spillers Backpack, når karakteren spawner, så hver spiller kører sin egen kopi.
LocalScriptet har sin egen cooldown kun for ikke at sende forespørgsler, som serveren alligevel ignorerer. Det er ikke et sikkerhedstjek: en snyder kan slette det, ændre det eller kalde SwordSwing fra sin egen kode. Guiden til RemoteEvent forklarer, hvorfor hver remote skal tjekkes på serveren, og Script vs LocalScript vs ModuleScript (på engelsk) viser, hvad et LocalScript kan og ikke kan ændre.
Sådan afgør serveren, hvem der blev ramt
Når SwordSwing kommer, spørger SwordService ikke klienten om noget. Den bygger en boks foran angriberens karakter, der hvor serveren ser den, og spørger motoren, hvilke parts der er inden i, med workspace:GetPartBoundsInBox. Denne metode erstatter den ældre FindPartsInRegion3, som Roblox markerer som forældet.
Boksens centrum ligger 3 studs foran angriberens rodpart. Det er forskydningen CFrame.new(0, 0, -HIT_RANGE / 2): en CFrame kigger langs sin negative Z-akse, det er dens LookVector. Derfor strækker boksen sig fra midten af karakteren 6 studs fremad, og den er 5 studs bred og 6 høj. Forespørgslen sammenligner hver parts bounding box, en hurtig kasseformet tilnærmelse af dens rumfang, så runde parts og meshes tæller lidt større, end de ser ud. For et sværd er den lille margin nyttig.
| Trin | Kode | Hvorfor |
|---|---|---|
| Spring angriberen over | OverlapParams med Exclude og angriberens karakter | Angriberens egne arme, ben og sværd er også i boksen. |
| Find karakteren | part:FindFirstAncestorOfClass("Model") | En part i boksen kan være et lem, en hat eller et tool i hånden. FindFirstAncestorOfClass sammenligner det præcise klassenavn, 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 model. |
| Find Humanoid | model:FindFirstChildOfClass("Humanoid") | Alt med en Humanoid kan rammes: spillere, NPC'er og testdukker. Vægge og gulve springes over. |
| Én gang pr. Humanoid | tabellen alreadyHit | Der ender som regel flere parts fra den samme karakter i boksen. Uden tabellen ville hver af dem give skade igen. |
| Kun levende mål | target.Health > 0 | En karakter, der allerede er slået ud, rammes ikke igen. |
| Hold | isTeammate | Når FRIENDLY_FIRE er false, springes spillere på samme hold over. En spiller, hvis egenskab Neutral er true, har intet hold. |
| Skade | target:TakeDamage(DAMAGE) | Sænker Health, medmindre målet er beskyttet af et ForceField. |
Tabellen alreadyHit oprettes på ny ved hvert sving, så den samme spiller kan rammes igen med næste sving, når cooldown er gået. Det er reglen "én gang pr. mål pr. sving", som sværd baseret på Touched altid har problemer med.
Scriptet bruger TakeDamage og ikke en tildeling af Health. I Roblox-referencen står der, at TakeDamage ikke rører en Humanoid, så længe den er beskyttet af et ForceField, mens en direkte tildeling af Health ignorerer ForceField. En spiller, der spawner på en SpawnLocation, får som standard et ForceField i 10 sekunder (Duration på SpawnLocation), så nyankomne kan ikke rammes i det øjeblik, de dukker op.
Fire måder at lave en sværd-hitbox på: sammenligning
Sværd-tutorials adskiller sig mest på ét punkt: hvordan man finder ud af, hvad klingen ramte. Der er fire udbredte svar. De adskiller sig ved, hvor præcist de følger klingen, hvor meget arbejde de koster serveren, og om en snyder kan forfalske resultatet.
| Metode | Sådan virker den | Hvem afgør | Præcision | Bedst til |
|---|---|---|---|---|
Touched på klingen | Skade hver gang klingens part rører en karakter | Angriberens enhed, som ejer sin karakter og sværdet | Følger klingen, men udløses flere gange pr. berøring | Intet i et spil med andre spillere: angriberens enhed kan udløse den hvor som helst fra |
| Boks foran spilleren (denne guide) | Én GetPartBoundsInBox-forespørgsel på serveren pr. sving | Serveren | En fast boks, ikke klingens bane. Meshes tælles efter bounding boxes, så lidt gavmildt | De fleste spil: enkelt, billigt og intet at forfalske |
GetPartsInPart på en hitbox-part | En serverforespørgsel med en part formet som klingens bue, under svinget | Serveren | Præcise former: Roblox-dokumentationen siger, at den laver et fuldt geometrisk tjek, og foreslår forespørgsler med boks eller kugle, når mindre præcision er nok, fordi de er billigere | Store våben med usædvanlig form, for eksempel buen på en le |
| Raycasts langs klingen | Hvert frame af svinget sendes korte stråler fra punkter på klingen hen til, hvor de var i forrige frame | Den side, der sender dem. På serveren kræver det serverens eget billede af, hvor klingen er | Følger animationen tæt | Spil, hvor svingets præcise bane betyder noget. Sådan virker community-hitbox-moduler |
Boksen er det rigtige første valg. Det er én forespørgsel pr. sving, den afhænger aldrig af en animation, som en snyder kunne ændre, og den er nem at justere med tre tal. Skift til en part med den rigtige form eller stråler langs klingen, når spillerne klager over, at træf føles forkerte med et våben, hvis rækkevidde er langt fra en boks, og behold den samme regel: serveren kører forespørgslen og giver skaden.
Sværd-presets: fra dolk til tohåndssværd
Den samme SwordService laver vidt forskellige våben med fem indstillinger. Tabellen er et udgangspunkt, beregnet til en dukke fra Rig Generator med 100 Health. "Tid til knockout" tælles fra første slag, når hvert sving rammer, så snart cooldown tillader det.
| Våben | DAMAGE | COOLDOWN_SECONDS | HIT_RANGE | HIT_WIDTH | Slag (tid) | Skade pr. sekund |
|---|---|---|---|---|---|---|
| Dolk | 12 | 0.35 | 4 | 4 | 9 (2.8 s) | omkring 34 |
| Sværd (denne guide) | 20 | 0.6 | 6 | 5 | 5 (2.4 s) | omkring 33 |
| Tohåndssværd | 35 | 1.1 | 7 | 7 | 3 (2.2 s) | omkring 32 |
| Spyd | 18 | 0.8 | 9 | 3 | 6 (4 s) | omkring 23 |
- Spillere heler, dukker gør ikke. Spillerkarakterer genvinder som standard 1% af MaxHealth hvert sekund. Med præcis 100 skade på 5 slag overlever en spiller, der bliver slået med maksimal hastighed, det femte slag, og der skal et sjette til. Giv lidt margin, for eksempel 21 skade i stedet for 20, hvis det præcise antal slag betyder noget.
- Skalér NETWORK_SLACK sammen med cooldown. Guidens 0.1 sekund er en sjettedel af 0.6. Hvis du beholder 0.1 på en dolk med 0.35 sekunds cooldown, kunne en snyder slå hvert 0.25 sekund, 40% hurtigere. Brug cirka en sjettedel af
COOLDOWN_SECONDS: 0.06 til dolken. - Hold SwordClient i trit. Sæt samme
COOLDOWN_SECONDSder, ellers sender klienten sving, som serveren ignorerer.
Version 2: wind-up og ingen slag gennem vægge
Når grundsværdet virker, dukker der to klager op. Slaget rammer i samme øjeblik, som spilleren klikker, før svinganimationen når målet, og et sving kan ramme en, der står på den anden side af en tynd væg, fordi boksen ikke tager højde for vægge. Denne version af SwordService retter begge dele. Den erstatter scriptet fra trin 2: samme navn, samme remote, samme indstillinger, så SwordClient skal ikke ændres.
-- Script i ServerScriptService med navnet SwordService (version med wind-up og vægtjek).
-- Erstatter scriptet fra trin 2: samme indstillinger og remote plus to regler. Slaget rammer
-- WINDUP_SECONDS efter klikket, når svinget når målet, og rammer ingen
-- gennem en væg.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Indstillinger
local SWORD_NAME = "Sword"
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- hold samme værdi i SwordClient
local WINDUP_SECONDS = 0.15 -- tid fra klik til slag; tilpas til 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
-- Returnerer angriberens karakter og rodpart, så længe den er i live og holder 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 der ikke er andet end selve målet mellem angriberen 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)
-- Tjek igen efter wind-up: angriberen kan være død eller have lagt sværdet væk
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)
Slet først SwordService fra trin 2, ellers opretter begge scripts hver sin SwordSwing-remote. Sæt WINDUP_SECONDS til det øjeblik i din svinganimation, hvor klingen passerer foran karakteren; til et hurtigt sving passer 0.15.
- Wind-up. Cooldown og tjekkene "i live og holder sværdet" køres, når klikket kommer, derefter starter
task.delaystrikeefterWINDUP_SECONDS.striketjekker angriberen igen, fordi den i mellemtiden kan være død eller have lagt sværdet væk, og bygger først derefter boksen. Et mål, der er gået uden for rækkevidde under wind-up, bliver ikke ramt, og det er netop det, spillerne forventer, når de ser svinget. - Vægtjek. For hvert mål i boksen sender
hasClearLineen stråle fra angriberens rodpart til målets rodpart og springer angriberens egen karakter over. Hvis det første, strålen møder, tilhører målet, eller den ikke møder noget, tæller slaget. En væg, en dør eller en anden spiller imellem dem blokerer det. - Hvad det koster. Én ekstra stråle pr. mål pr. sving, hvilket er lidt i forhold til selve boksforespørgslen.
Wind-up gør også sværdet mere fair over for snydere, der slår i samme øjeblik, som de teleporterer hen til nogen: serveren leder efter mål et øjeblik senere, der hvor den ser karaktererne på det tidspunkt. Selve teleporten stopper det ikke; til det skal der et bevægelsestjek til, som er beskrevet i afsnittet Hvad en exploiter kan og ikke kan.
Tilføj en svinganimation (valgfrit)
SwordClient afspiller allerede en animation, så snart du giver den et ID. Animationen laver du én gang, i Animation Editor i Studio:
- Indsæt en rig til animationen. På fanen Avatar eller Home klikker du på Character for at åbne Rig Generator og vælger en rig, der passer til dit spils avatarer, for eksempel R15 og derefter Block Avatar.
- På fanen Avatar klikker du på Clip Editor for at åbne Animation Editor, markerer riggen og sætter positurer til et kort sving med højre arm.
- Sæt prioriteten til Action: klik på knappen … i editorens afspilningskontroller, hold musen over Set Animation Priority, og vælg Action. Action står over Movement, Idle og Core, så svinget afspilles oven på gå- og stå-animationerne i stedet for at tabe til dem.
- I samme …-menu vælger du Publish to Roblox. Hvis dit spil ejes af en gruppe, så vælg den gruppe i feltet Creator, før du sender.
- Kopiér animationens asset-ID fra Toolbox, og sæt i SwordClient
SWING_ANIMATION_IDtil"rbxassetid://"efterfulgt af det tal.
SwordClient indlæser svinget via karakterens Animator, ikke via den ældre Humanoid:LoadAnimation, som Roblox markerer som forældet. I Roblox-referencen for Animator står der, at animationer, som en spillers enhed starter på spillerens egen karakter, replikeres til serveren og til alle andre spillere, så et LocalScript kan afspille svinget, og alle kan se det. Der står også, at Animator skal oprettes på serveren, så opret den aldrig i et LocalScript. På spillerkarakterer ligger den som regel inde i Humanoid, og det er netop der, Robloxs eget animationseksempel leder efter den.
Animationen er kun til udseendet. Træf afhænger ikke af den, så en langsom, manglende eller ændret animation ændrer aldrig, hvem der bliver ramt.
Hvordan du afspiller en animation ved et tastetryk, i loop eller på en NPC, kan du læse i guiden til animation-scripts.
Hvad gamle sværd-tutorials tager fejl af
Hvis du sammenligner denne guide med en video eller et forumindlæg, er her de vigtige forskelle og grunden til, at hvert trick skaber et problem.
| Tutorial | Problem | Denne guide |
|---|---|---|
Giver skade i klingens Touched-event | Angriberens enhed kan udløse Touched på sit sværd hvor som helst fra (Roblox-siden om network ownership), og Touched udløses flere gange i træk for én berøring (Roblox-siden om debounce). | Serveren finder mål med sin egen boks, én gang pr. Humanoid pr. sving. |
| Sænker Health i et LocalScript | En ændring, som et LocalScript laver på en andens karakter, bliver på den ene enhed. | Al skade gives i SwordService. |
Bruger wait(0.5) til cooldown | Roblox markerer den globale wait() som forældet, i stedet bruges task.wait(), og en cooldown, der kun findes på klienten, stopper ingen. | Sammenligner tiden os.clock() på serveren. Intet venter. |
Afspiller svinget via Humanoid:LoadAnimation | Forældet, i stedet bruges Animator:LoadAnimation. | Indlæser svinget via Animator. |
Finder mål via Region3 og FindPartsInRegion3 | Forældet. Roblox anbefaler i nye projekter at bruge GetPartBoundsInBox med OverlapParams. | Bruger GetPartBoundsInBox. |
Lægger et server-Script inde i Tool, der lytter efter Activated | Hver spillers sværd kører sin egen kopi af serverkoden, og sådanne scripts giver ofte skade i Touched (første række). Med standardindstillingerne kører et Script kun i Workspace eller ServerScriptService, så et Script i Tool starter ikke, før sværdet udstyres første gang. Roblox-siden om tools beskriver de fleste tools som et LocalScript til input, et server-Script til effekten og en RemoteEvent imellem dem. | Én SwordService i ServerScriptService betjener alle sværd i spillet. |
Hvad en exploiter kan og ikke kan
Gå ud fra, at en snyder styrer alt på sin egen enhed. Den kan læse og ændre dine LocalScripts, og i Robloxs sikkerhedsguide står der, at den kan kalde RemoteEvents med en hvilken som helst hyppighed og vilkårlige argumenter. Her er, hvad det betyder for dette sværd.
| Snyderen prøver | Resultat | Hvorfor |
|---|---|---|
Kalde SwordSwing så hurtigt, som koden kan, eller bruge en autoclicker | Højst ét sving hvert 0.5 sekund tæller | Serverens cooldown er 0.6 sekund minus 0.1 sekunds netværksmargin. Den margin er det mest, snyderen vinder. |
| Sende et mål, et skadetal eller en position med remoten | Ignoreres | onSwing læser kun den spiller, som Roblox selv indsætter. Alt andet, der sendes med remoten, læses aldrig. |
| Ændre SwordClient, for eksempel fjerne dens cooldown | Påvirker ikke serveren | SwordService holder sine indstillinger i ServerScriptService, som aldrig sendes til spillerne. |
| Slå, mens den er død eller uden sværd i hånden | Ignoreres | SwordService tjekker, at dens Humanoid er i live, og at et Tool med navnet Sword ligger inde i dens karakter, hvor Roblox flytter toolet hen, når det udstyres. |
| Ramme nogen fra den anden ende af kortet | Der sker ingenting | Boksen bygges omkring angriberens karakter, der hvor serveren ser den, og rækker kun 6 studs frem. |
| Teleportere hen til en spiller og derefter slå | Muligt | Hver enhed styrer sin karakters bevægelse, og Roblox nævner teleportering til et hvilket som helst punkt blandt de ting, klienten kan gøre med sin karakter. Et bevægelsestjek på serveren kan fange det. |
| Slå gennem en tynd væg | Muligt inden for boksen på 6 studs | Boksforespørgslen fra trin 2 leder ikke efter vægge. Version 2 tilføjer et vægtjek. |
| Afspille en hvilken som helst animation eller ingen | Påvirker ikke træf | Træf afhænger aldrig af animationen. Roblox nævner, at snydere kan afspille vilkårlige animationer på deres karakter. |
To rækker siger "Muligt", og det er ærligt. Dette sværd lader ikke en snyder vælge, hvem den rammer, hvor hårdt eller hvor ofte. Det kan ikke forhindre den i at flytte sin egen karakter. Robloxs sikkerhedsdokumentation siger, at klienter styrer deres karakters bevægelse og fysik, og at bevægelsestjek skal tilpasses hvert spil. Til et konkurrencespil er næste lag et bevægelsestjek på serveren (sprint-guiden bygger sådan et, det advarer om grove speedhacks og lange teleporter) eller Robloxs server authority, som dokumentationen beskrev som beta, da vi tjekkede 13. oktober 2026.
Trin 4: test det
- Tilføj noget at slå på. På fanen Avatar eller Home klikker du på Character for at åbne Rig Generator, vælger en rig (for eksempel R15, derefter Block Avatar), og den indsættes i Workspace. Flyt den nogle studs væk fra din SpawnLocation.
- Tryk på Play, udstyr Sword fra hotbaren, gå hen til riggen, og klik. Efter første slag dukker en livbjælke op over den, fordi en Humanoid som standard kun viser bjælken, når dens Health er under MaxHealth. En Humanoid starter med 100 liv, så det femte slag slår den ud.
- Klik så hurtigt, du kan. Kun ét sving hvert 0.6 sekund gør noget.
- Gå cirka 8 studs væk fra riggen, eller vend ryggen til den, og sving. Der sker ingenting, fordi ingen af dens parts er i boksen.
- Test på en rigtig spiller. Vælg Server & Clients i rullemenuen med testtilstande, sæt 2 klienter, og tryk på Play. Slå den anden spiller inden for 10 sekunder efter, at den spawnede: der sker ingenting på grund af ForceField ved spawn. Derefter fjerner hvert slag 20. Som standard genvinder spillerkarakterer også 1% af MaxHealth hvert sekund, så mellem kampene kommer deres liv langsomt tilbage.
- Hvis dit spil har Teams, så sæt begge testspillere på samme hold. Når
FRIENDLY_FIREer false, gør deres sving ingenting ved hinanden.
Hold Output-vinduet åbent hele tiden (menuen Window, derefter Output). Når disse scripts virker, skriver de ingenting, så enhver rød fejl fra SwordService eller SwordClient er et reelt problem. Se Almindelige fejl.
Sådan udvider du sværdet til et kampsystem
Combos
Hold på serveren en tæller for sving pr. spiller ved siden af lastSwing. Hvis det forrige sving var for nylig, læg 1 til; ellers start forfra på 1. Vælg derefter skaden ud fra tælleren, for eksempel mere skade på hvert tredje slag, og ryd tælleren ved PlayerRemoving på samme måde. Klienten kan føre sin egen tælling for at vælge, hvilken animation der skal afspilles, fordi animationen aldrig afgør træffet. Boksen og tjekkene forbliver præcis de samme.
Knockback
Efter TakeDamage kan SwordService skubbe målet væk med ApplyImpulse på målets RootPart i retning af angriberens rootPart.CFrame.LookVector. I Roblox-referencen står der, at skubbet afhænger af målets masse, og at et server-Script kan kalde det på en part, som serveren ejer, eller på en part, som en klient automatisk ejer. Hver spillers enhed simulerer sin egen karakter, så test knockback på spillere via Server & Clients, ikke kun på en rig.
Kills til leaderboardet
Lige før target:TakeDamage(DAMAGE) gemmer du, hvem der ramte sidst, med target:SetAttribute("LastHitBy", player.UserId). I et server-Script forbinder du til Died-eventet på hver karakters Humanoid, læser attributten, finder angriberen med Players:GetPlayerByUserId og lægger 1 til IntValue Kills i dens leaderstats. Opret den ved siden af Coins og Wins som i trin 1 i guiden til leaderboards, og ændr den på serveren som i trin 2.
Blokering
Tilføj en anden RemoteEvent, som klienten kalder, når blokeringsknappen trykkes ned og slippes, og lad serveren sætte attributten Blocking på den spillers karakter med sin egen hyppighedsgrænse. I SwordService sænker du skaden eller springer den over, når målets karakter har Blocking sat. En snyder vælger stadig selv, hvornår den blokerer, så gør blokeringen kort, eller giv den en cooldown.
Sælg sværdet, eller giv det ud hver runde
StarterPack giver sværdet til hver spiller ved hvert spawn. For at sælge det i stedet lægger du det i mappen ShopItems fra guiden til butiks-GUI. Kataloget i den guide sælger allerede et Tool med navnet ClassicSword, så enten kalder du dette Tool ClassicSword og sætter samme SWORD_NAME, eller du ændrer posten i kataloget. For kun at give det ud i en runde bruger du scriptet GiveRoundTool fra guiden til rundesystemer: gem Sword i ServerStorage i stedet for StarterPack, og erstat "RoundTool" i det script med "Sword".
Fjender at kæmpe mod og afstandsvåben
Til en NPC, der jagter spillere, følger du guiden til pathfinding for NPC'er. Sværdet skader den som enhver anden Humanoid. Om våben, der rammer på afstand efter de samme serverregler, kan du læse i guiden til våben.
Almindelige fejl og løsninger
Åbn Output-vinduet (menuen Window, derefter Output), før du trykker på Play. De fleste problemer med sværdet skriver enten en fejl der eller skyldes et navn, der ikke passer.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("SwordSwing")'
SwordClient venter på remoten, som SwordService opretter, så SwordService kører ikke. Tjek, at det er et Script og ikke et LocalScript, at det ligger direkte i ServerScriptService, ikke er slået fra, og at der ikke er nogen fejl fra det i Output.
Jeg svinger, men ingen tager skade
Tjek i rækkefølge: SwordClient er et LocalScript, ikke et Script, og ligger direkte i Tool Sword; Tool hedder præcis Sword eller det, der står i SWORD_NAME; målet er højst 6 studs foran dig; målet spawnede for mere end 10 sekunder siden, så dets ForceField er væk; og hvis du bruger Teams, er I ikke på samme hold med FRIENDLY_FIRE sat til false.
Sværdet rammer spillere, men aldrig min NPC
Rumlige forespørgsler som GetPartBoundsInBox returnerer aldrig en part, hvor CanQuery er slået fra (CanQuery virker kun, når CanCollide også er slået fra). Slå CanQuery til igen på NPC'ens kropsdele, og tjek, at dens Humanoid er et direkte barn af NPC-modellen.
Min karakter sidder fast, når jeg udstyrer sværdet
En af sværdets parts er ankret. Markér alle parts inde i Tool, og slå Anchored fra.
Nogle sving rammer, og andre misser på samme afstand
I versionen med wind-up bliver et mål, der forlod boksen under WINDUP_SECONDS, ikke ramt, og vægtjekket springer alle over, der står bag en væg eller en anden spiller. Gør wind-up kortere, eller hæv HIT_WIDTH, hvis misserne føles unfair i playtests.
Karakteren holder sværdet i klingen
Der er mere end én part med navnet Handle, og Roblox valgte den forkerte. Behold præcis én Handle, grebet, og omdøb de andre. Justér derefter grebsegenskaberne på Tool, hvis vinklen stadig er forkert.
Klingen bliver stående eller falder, når jeg udstyrer sværdet
Klingen er ikke svejset til Handle. Tilføj en WeldConstraint, hvor Part0 er Handle og Part1 er klingen.
Skaden kan ses på min skærm, men den anden spillers liv ændrer sig ikke
Skaden gives fra et LocalScript, som kun ændrer din kopi af spillet. Giv kun skade i SwordService, som i trin 2.
Lav det med RoCode
Hvis du ikke har lyst til at bygge alt det her i hånden, kan RoCode gøre det i det place, du har åbent. Det er en uafhængig AI-agent til at skrive kode, ikke fra Roblox: du beskriver funktionen i dens webchat, og dens plugin til Roblox Studio opretter Tool, parts og scripts i din Explorer, så du ikke behøver at kopiere kode fra et chatvindue.
Lav et sværd: et Tool med navnet Sword i StarterPack med en Handle og en klinge svejset fast på den, et LocalScript, der kalder en RemoteEvent ved Activated, og et server-Script, der tjekker en cooldown på 0.6 sekund og giver 20 skade til alle Humanoids i en boks foran spilleren.
- Opretter Tool og dets parts med Create Instance og sætter deres egenskaber med Set Property
- Skriver SwordService og SwordClient med Create Script og kan først lede efter eksisterende kampscripts med Search Scripts
- Den er instrueret i at tjekke kompileringen af hvert script, den skriver, med Check Script, som kompilerer koden i Studio uden at køre den (den tjekker ikke typer)
- Sætter et fortrydelsespunkt før og efter hver pakke ændringer, så Ctrl+Z ruller én pakke tilbage ad gangen
RoCode kan ikke lave svinganimationen eller uploade den: lav den i Animation Editor, og indsæt dens ID. Med plugin 3.9 eller nyere kan RoCode køre en kort playtest og læse fejlene, og med plugin 3.9.11 eller nyere kan den styre en testfigur, men den klikker ikke i 3D-vinduet for at svinge, så svingene tester du selv. Siden sådan laver du et helt Roblox-spil med RoCode, system for system viser, hvor våben passer ind. Sådan forbinder RoCode til Studio.
Ofte stillede spørgsmål
Hvorfor rammer mit sværd den samme spiller flere gange i ét sving?
Fordi det giver skade fra Touched. Roblox-siden om debounce nævner, at Touched udløses flere gange i træk for én berøring, og hver af målets parts kan røre klingen. Denne guide finder mål med én boksforespørgsel pr. sving og fører en liste, så hver Humanoid mister liv én gang pr. sving.
Skal sværdets skade ligge i et LocalScript eller et Script?
I et Script på serveren. Skade givet fra et LocalScript ændrer kun den spillers kopi af spillet, og alt på spillerens enhed kan en snyder ændre. LocalScriptet skal kun høre klikket, afspille animationen og kalde RemoteEvent.
Hvordan giver jeg sværdet en svinganimation?
Lav den i Animation Editor, sæt prioriteten til Action, udgiv den til Roblox, og skriv dens asset-ID i SWING_ANIMATION_ID som rbxassetid:// efterfulgt af tallet. SwordClient afspiller den via karakterens Animator. Animationer, som en spillers enhed starter på spillerens egen karakter, vises for alle.
Hvorfor afspilles sværdets animation ikke?
Tjek tre ting. Prioritet: Action står over Movement, Idle og Core, så et sving med Action afspilles oven på gang og stillestående, mens en lavere prioritet kan tabe til dem. Ejer: hvis spillet ejes af en gruppe, så udgiv animationen med den gruppe valgt som Creator. ID: SWING_ANIMATION_ID skal være den fulde tekst rbxassetid:// med din animations tal, ikke en tom streng.
Hvilken hitbox er bedst til et sværd i Roblox?
Til de fleste spil er det en boksforespørgsel på serveren én gang pr. sving, som i denne guide: ét kald til GetPartBoundsInBox, intet for klienten at forfalske og tre tal at justere. Brug kun GetPartsInPart med en part i den rigtige form eller raycasts langs klingen, når våbnets rækkevidde er langt fra en boks. Sammenligning af de fire måder.
Hvordan forhindrer jeg sværdet i at slå gennem vægge?
Før skaden gives, sender du en stråle fra angriberens rodpart til målets rodpart, springer angriberens karakter over og tæller kun slaget, hvis det første, strålen møder, tilhører målet. Version 2 af SwordService gør det for hvert mål.
Hvorfor rammer slaget, før svinganimationen når målet?
Serveren tjekker hitboxen i samme øjeblik, som klikket kommer. Vent først en kort wind-up, for eksempel 0.15 sekund med task.delay, tjek derefter, at angriberen stadig er i live og holder sværdet, og byg boksen, som version 2 gør.
Kan exploitere stadig snyde med dette sværd?
De kan ikke vælge, hvem der bliver ramt, hvor meget skade et slag giver, eller hvor ofte de slår, fordi serveren afgør alle tre ting; det mest, de vinder, er 0.1 sekunds netværksmargin på cooldown. De kan stadig flytte deres karakter, for eksempel helt tæt på nogen, fordi hver enhed styrer sin karakters bevægelse. Næste lag er et bevægelsestjek på serveren.
Hvordan laver jeg et kampsystem med combos?
Hold på serveren en tæller for sving pr. spiller, nulstil den efter en kort pause, og vælg skade og animation ud fra tælleren. Træftjekket forbliver det samme. Afsnittet Sådan udvider du gennemgår også knockback, kills og blokering.
Kilder og videre læsning
- Roblox Creator Docs: In-game tools (på engelsk). byg et tool i Workspace, Handle, Weld, Grip, ankring og hvorfor de fleste tools bruger LocalScript, Script og RemoteEvent
- Roblox Creator Docs: WorldRoot:GetPartBoundsInBox (på engelsk). boksforespørgsel, OverlapParams og den forældede FindPartsInRegion3
- Roblox Creator Docs: Humanoid:TakeDamage (på engelsk). beskyttelse med ForceField, livbjælke og genvinding af liv
- Roblox Creator Docs: Network ownership (på engelsk). exploit med sværd baseret på Touched
- Roblox Creator Docs: Security tactics and cheat mitigation (på engelsk). stol aldrig på klienten
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (på engelsk). hvad klienten kan gøre med sin karakter, og bevægelsestjek
- Roblox Creator Docs: Animation Editor (på engelsk). animationsprioritet og udgivelse
- Roblox Creator Docs: Animator:LoadAnimation (på engelsk). hvilke animationer der replikeres fra klienten
- Roblox Creator Docs: Debounce patterns (på engelsk). hvorfor Touched udløses flere gange for én berøring
Sådan blev koden tjekket: hvert script på denne side gennemgår streng Luau-typekontrol med Roblox API-definitionerne (luau-lsp, 20. november 2026). Typekontrollen fanger fejl i API-navne og forkerte typer, men ikke fejl i spillogikken, så test alt i Studio, før du udgiver.