W skrócie
Włóż do StarterPack Tool o nazwie Sword z partem o nazwie Handle. LocalScript w Toolu nasłuchuje Tool.Activated, odtwarza animację machnięcia i wywołuje RemoteEvent bez argumentów. Script w ServerScriptService sprawdza cooldown oraz to, że gracz żyje i trzyma miecz, znajduje Humanoidy w pudełku przed nim przez workspace:GetPartBoundsInBox i wywołuje Humanoid:TakeDamage raz na cel.
- Nie zadawaj obrażeń ze zdarzenia
Touchedostrza: urządzenie gracza steruje swoją postacią i może wywołać Touched skądkolwiek, a miecz jest podany jako przykład właśnie na stronie Roblox o network ownership. - Klient nie wysyła ani celu, ani obrażeń. Cooldown, hitbox i wielkość obrażeń należą do serwera.
TakeDamagenic nie robi, dopóki cel ma ForceField, na przykład przez pierwsze 10 sekund po spawnie na SpawnLocation.- Ciosy przechodzą przez ściany albo trafiają, zanim machnięcie wizualnie dosięgnie celu? Weź wersję skryptu serwera z zamachem i sprawdzaniem ścian.
Na tej stronie
Jak działa sprawny miecz
Miecz, który działa w prawdziwej grze, jest podzielony między urządzenie gracza a serwer. Strona Roblox o narzędziach mówi, że wejście dla narzędzi powinno żyć w LocalScript, bo tylko urządzenie gracza wie, kiedy pojawia się wejście, i że większość narzędzi potrzebuje LocalScript, Script na serwerze i RemoteEvent między nimi. Ten poradnik używa właśnie takiego podziału. Jedno machnięcie wygląda tak:
- Gracz klika, dotyka ekranu albo naciska spust pada z założonym Sword. W LocalScript odpala się
Tool.Activated. - LocalScript odtwarza animację machnięcia, jeśli jest, i wywołuje RemoteEvent
SwordSwing. Nic więcej nie wysyła. - Script na serwerze sprawdza cooldown, to, że gracz żyje, i to, że trzyma Sword w ręce.
- Serwer buduje własny hitbox przed postacią gracza i znajduje każdy Humanoid w środku.
- Każdy z tych Humanoidów raz traci zdrowie przez
TakeDamage.
| Element | Gdzie jest | Co robi |
|---|---|---|
Tool Sword | StarterPack | To, co trzyma gracz. Roblox kopiuje wszystko ze StarterPack do Backpacka gracza przy każdym spawnie jego postaci. |
Part Handle | W Toolu | Part, za który trzyma postać. Ostrze jest do niego przyspawane. |
LocalScript SwordClient | W Toolu | Słyszy kliknięcie, odtwarza animację machnięcia i wywołuje remote. |
RemoteEvent SwordSwing | ReplicatedStorage (tworzy go SwordService) | Niesie „machnąłem” z urządzenia gracza na serwer, bez argumentów. |
Script SwordService | ServerScriptService | Sprawdza każde machnięcie, znajduje, kto stoi przed graczem, i zadaje obrażenia. Jedyne miejsce, gdzie może dojść do ciosu. |
ServerScriptService
SwordService Script new
StarterPack
Sword Tool new
Handle Part new
Blade Part new
WeldConstraint WeldConstraint new
SwordClient LocalScript new
Krok 1: złóż Tool miecza
- W Explorerze najedź na Workspace, kliknij przycisk + i wstaw Tool. Zmień jego nazwę na
Sword. Skrypt serwera szuka dokładnie tej nazwy. Miecz składasz w Workspace, jak radzi strona Roblox o narzędziach, bo tam widać jego party i można je przesuwać i zmieniać ich rozmiar. Ostatni krok przenosi go do StarterPack. - Wstaw do Toola Part i nazwij go
Handle. To rękojeść, za którą postać trzyma miecz. Musi być bezpośrednim dzieckiem Toola i jedynym partem o tej nazwie: przy dwóch Handle Roblox wybiera jeden losowo i postać może trzymać miecz za ostrze. - Wstaw do Toola drugi Part, nazwij go
Blade, nadaj mu kształt i ustaw tak, żeby wystawał z góry Handle. - Wstaw do Blade WeldConstraint. W oknie Properties ustaw jego
Part0na Handle, aPart1na Blade, żeby miecz trzymał się w całości, gdy gracz go nosi. - Zaznacz oba party i upewnij się, że Anchored jest wyłączone. Zakotwiczony part w narzędziu przykuwa postać do miejsca, gdy je założy. Wyłącz w obu także CanCollide, żeby ostrze przy machnięciu nie zahaczało o graczy i ściany.
- Zaznacz Tool i odznacz CanBeDropped. Gdy jest zaznaczone, naciśnięcie Backspace wyrzuca miecz do Workspace.
- Przeciągnij gotowy Sword z Workspace do StarterPack. Tool zostawiony w Workspace to przedmiot do podniesienia, który zabiera jeden gracz, a nie miecz, który od początku leży w Backpacku każdego.
Miecz z jednego MeshPart też się nada: nazwij ten MeshPart Handle i pomiń Weld. Jeśli podczas testu postać trzyma miecz pod dziwnym kątem, zaznacz Tool i popraw jego właściwości chwytu (GripPos, GripForward, GripRight i GripUp) w oknie Properties.
Krok 2: dodaj skrypt serwera
Najedź na ServerScriptService, wstaw Script o nazwie SwordService i wklej do niego kod poniżej. To jedyne miejsce, gdzie może dojść do ciosu mieczem. Ustawienia na początku to linie, które masz zmieniać.
-- Script w ServerScriptService o nazwie SwordService.
-- Jedyne miejsce, gdzie może dojść do ciosu mieczem: sprawdza machnięcie, znajduje cele przed
-- atakującym własnym hitboxem i zadaje obrażenia.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Ustawienia
local SWORD_NAME = "Sword" -- nazwa Toola w StarterPack
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- trzymaj tę samą wartość w SwordClient
local HIT_RANGE = 6 -- study przed atakującym
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false -- false: gracze z jednej drużyny nie mogą się nawzajem ranić
-- Machnięcia wysłane dokładnie co COOLDOWN_SECONDS po opóźnieniu sieci mogą przyjść
-- trochę bliżej siebie, więc serwer daje taki zapas i nie odrzuca prawdziwego machnięcia
local NETWORK_SLACK = 0.1
-- Remote, który wywołuje LocalScript miecza. Nie niesie argumentów: kto dostanie cios,
-- decyduje serwer, więc klient nie ma czego podrabiać.
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
-- Neutralni gracze (bez drużyny) zawsze mogą się nawzajem bić
return not attacker.Neutral and not target.Neutral and attacker.Team == target.Team
end
local function onSwing(player: Player)
-- 1. Jedno machnięcie na cooldown, niezależnie od tego, jak często wywoływany jest remote
local now = os.clock()
local last = lastSwing[player]
if last and now - last < COOLDOWN_SECONDS - NETWORK_SLACK then
return
end
-- 2. Atakujący musi żyć i trzymać miecz
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. Własny hitbox serwera: pudełko przed głównym partem atakującego
local params = OverlapParams.new()
params.FilterType = Enum.RaycastFilterType.Exclude
params.FilterDescendantsInstances = { character }
local boxCFrame = rootPart.CFrame * CFrame.new(0, 0, -HIT_RANGE / 2)
local parts = workspace:GetPartBoundsInBox(boxCFrame, Vector3.new(HIT_WIDTH, HIT_HEIGHT, HIT_RANGE), params)
-- 4. Każdy Humanoid w pudełku dostaje obrażenia raz, nawet jeśli w środku jest kilka jego partów
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) -- nic nie robi, dopóki cel ma ForceField
end
end
end
end
swingEvent.OnServerEvent:Connect(onSwing)
Players.PlayerRemoving:Connect(function(player: Player)
lastSwing[player] = nil
end)
SwordService sam tworzy RemoteEvent SwordSwing przy starcie gry, więc nie musisz niczego ręcznie wstawiać do ReplicatedStorage. Jeśli już utworzyłeś RemoteEvent o tej nazwie, usuń go: LocalScript mógłby znaleźć twój, a tego na serwerze nikt nie nasłuchuje.
| Ustawienie | Wartość tutaj | Co zmienia |
|---|---|---|
SWORD_NAME | "Sword" | Nazwa Toola, którego serwer oczekuje w ręce gracza. Zmień ją, jeśli twój Tool nazywa się inaczej. |
DAMAGE | 20 | Ile zdrowia zabiera każdy cios. Humanoid zaczyna ze 100 zdrowia, więc pięć ciosów nokautuje testowego riga. Postacie graczy domyślnie odnawiają 1% MaxHealth co sekundę, więc gracz bity z maksymalną szybkością przeżywa piąty cios i potrzebny jest szósty. |
COOLDOWN_SECONDS | 0.6 | Czas między machnięciami. Ustaw tę samą wartość w SwordClient. |
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT | 6, 5, 6 | Hitbox w studach: jak daleko sięga przed graczem, jaki jest szeroki i wysoki. |
FRIENDLY_FIRE | false | Przy false gracze z jednej drużyny nie mogą się nawzajem ranić. Gracze bez drużyny zawsze mogą się bić, a NPC zawsze można uderzyć. |
NETWORK_SLACK | 0.1 | O ile wcześniej niż cooldown serwer wciąż przyjmuje machnięcie. Dwa kliknięcia w odstępie 0.6 sekundy po opóźnieniu sieci mogą przyjść trochę bliżej siebie i bez tego zapasu serwer odrzuciłby prawdziwe machnięcie, które gracz już zobaczył. |
Krok 3: dodaj LocalScript do Toola
Wstaw do Toola Sword LocalScript, nazwij go SwordClient i wklej do niego ten kod:
-- LocalScript w Tool Sword o nazwie SwordClient.
-- Tool.Activated odpala się na urządzeniu gracza, więc ten skrypt nasłuchuje kliknięcia,
-- dotknięcia albo spustu, odtwarza animację machnięcia i prosi serwer o machnięcie.
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 -- ta sama wartość co w SwordService
local SWING_ANIMATION_ID = "" -- opcjonalnie: "rbxassetid://", a po nim id twojej animacji
local player = Players.LocalPlayer
local lastSwing = 0
local swingTrack: AnimationTrack? = nil
local trackCharacter: Model? = nil
-- Wczytujemy animację raz na postać. Animacje uruchomione na twojej własnej
-- postaci z twojego urządzenia pokazują się wszystkim graczom.
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 -- serwer też to sprawdza; sprawdzenie tutaj oszczędza zbędnych żądań
end
lastSwing = now
if swingTrack then
swingTrack:Play()
end
swingEvent:FireServer()
end)
Na razie zostaw SWING_ANIMATION_ID puste. Miecz działa też bez animacji, bo o trafieniu i tak decyduje serwer. Jak je wypełnić, pokazuje sekcja Dodaj animację machnięcia.
Activated odpala się na kliknięcie myszą, dotknięcie na telefonie i spust na padzie, więc ten sam skrypt działa na każdym urządzeniu. Roblox kopiuje Tool i LocalScript w nim do Backpacka każdego gracza przy spawnie jego postaci, więc każdy gracz ma własną działającą kopię.
LocalScript trzyma własny cooldown tylko po to, żeby nie wysyłać żądań, które serwer i tak zignoruje. To nie jest zabezpieczenie: oszust może go usunąć, zmienić albo wywołać SwordSwing z własnego kodu. Poradnik o RemoteEvent wyjaśnia, dlaczego każdy remote trzeba sprawdzać na serwerze, a Script vs LocalScript vs ModuleScript (po angielsku) pokazuje, co LocalScript może, a czego nie może zmieniać.
Jak serwer decyduje, kto dostał cios
Gdy przychodzi SwordSwing, SwordService o nic nie pyta klienta. Buduje pudełko przed postacią atakującego tam, gdzie widzi ją serwer, i pyta silnik, jakie party są w środku, przez workspace:GetPartBoundsInBox. Ta metoda zastępuje starszą FindPartsInRegion3, którą Roblox oznacza jako przestarzałą.
Środek pudełka jest 3 study przed głównym partem atakującego. To przesunięcie CFrame.new(0, 0, -HIT_RANGE / 2): CFrame patrzy wzdłuż swojej ujemnej osi Z, to jego LookVector. Dlatego pudełko ciągnie się od środka postaci 6 studów do przodu, a ma 5 studów szerokości i 6 wysokości. Zapytanie porównuje pudełko ograniczające (bounding box) każdego partu, szybkie przybliżenie jego objętości w kształcie pudełka, więc okrągłe party i meshe liczą się jako trochę większe, niż wyglądają. Dla miecza ten mały zapas jest przydatny.
| Krok | Kod | Po co |
|---|---|---|
| Pominąć atakującego | OverlapParams z Exclude i postacią atakującego | Własne ręce, nogi i miecz atakującego też są w pudełku. |
| Znaleźć postać | part:FindFirstAncestorOfClass("Model") | Part w pudełku może być kończyną, czapką albo narzędziem w ręce. FindFirstAncestorOfClass porównuje dokładną nazwę klasy, więc mija czapkę (klasa Accessory) i narzędzie w ręce (klasa Tool, choć Tool to odmiana Model) i zatrzymuje się na modelu postaci. |
| Znaleźć Humanoid | model:FindFirstChildOfClass("Humanoid") | Uderzyć można wszystko, co ma Humanoid: graczy, NPC i testowe manekiny. Ściany i podłogi są pomijane. |
| Raz na Humanoid | tabela alreadyHit | W pudełku zwykle jest kilka partów jednej postaci. Bez tabeli każdy z nich zadawałby obrażenia od nowa. |
| Tylko żywe cele | target.Health > 0 | Postaci już znokautowanej nie bije się ponownie. |
| Drużyny | isTeammate | Przy FRIENDLY_FIRE równym false gracze z jednej drużyny są pomijani. Gracz, którego właściwość Neutral jest równa true, nie ma drużyny. |
| Obrażenia | target:TakeDamage(DAMAGE) | Obniża Health, jeśli celu nie chroni ForceField. |
Tabela alreadyHit powstaje od nowa przy każdym machnięciu, więc tego samego gracza można znowu uderzyć następnym machnięciem, gdy minie cooldown. To właśnie zasada „raz na cel na machnięcie”, z którą miecze na Touched mają ciągłe kłopoty.
Skrypt używa TakeDamage, a nie przypisania Health. Dokumentacja Roblox mówi, że TakeDamage nie rusza Humanoida, dopóki chroni go ForceField, a bezpośrednie przypisanie Health ignoruje ForceField. Gracz, który spawnuje się na SpawnLocation, domyślnie dostaje ForceField na 10 sekund (Duration w SpawnLocation), więc nowo przybyłych nie da się uderzyć w chwili pojawienia się.
Cztery sposoby na hitbox miecza: porównanie
Poradniki o mieczach różnią się głównie jednym: jak ustalić, w co trafiło ostrze. Są cztery popularne odpowiedzi. Różnią się tym, jak dokładnie podążają za ostrzem, ile pracy kosztują serwer i czy oszust może podrobić wynik.
| Sposób | Jak działa | Kto decyduje | Dokładność | Do czego najlepszy |
|---|---|---|---|---|
Touched na ostrzu | Obrażenia za każdym razem, gdy part ostrza dotknie postaci | Urządzenie atakującego, które jest właścicielem jego postaci i miecza | Podąża za ostrzem, ale odpala się kilka razy na dotknięcie | Do niczego w grze z innymi graczami: urządzenie atakującego może je wywołać skądkolwiek |
| Pudełko przed graczem (ten poradnik) | Jedno zapytanie GetPartBoundsInBox na serwerze na machnięcie | Serwer | Stałe pudełko, a nie tor ostrza. Meshe liczone są po pudełkach ograniczających, więc trochę hojnie | Większość gier: proste, tanie i nie ma czego podrabiać |
GetPartsInPart na parcie hitboksa | Zapytanie serwera z partem w kształcie łuku ostrza, w trakcie machnięcia | Serwer | Dokładne kształty: dokumentacja Roblox mówi, że robi pełne sprawdzenie geometrii, i proponuje zapytania po pudełku albo kuli, gdy wystarczy mniejsza dokładność, bo są tańsze | Duża broń o nietypowym kształcie, na przykład łuk kosy |
| Raycasty wzdłuż ostrza | W każdej klatce machnięcia krótkie promienie lecą z punktów na ostrzu tam, gdzie były w poprzedniej klatce | Ta strona, która je wysyła. Na serwerze potrzebny jest serwerowy obraz tego, gdzie jest ostrze | Blisko podąża za animacją | Gry, w których liczy się dokładny tor machnięcia. Tak działają moduły hitboksa od społeczności |
Pudełko to właściwy pierwszy wybór. To jedno zapytanie na machnięcie, nigdy nie zależy od animacji, którą oszust mógłby zmienić, i łatwo je dostroić trzema liczbami. Przejdź na part o odpowiednim kształcie albo promienie wzdłuż ostrza, gdy gracze skarżą się, że trafienia wydają się złe przy broni, której zasięg daleko odbiega od pudełka, i zachowaj tę samą zasadę: zapytanie wykonuje i obrażenia zadaje serwer.
Presety mieczy: od sztyletu do dwuręcznego
Ten sam SwordService robi bardzo różną broń pięcioma ustawieniami. Tabela to punkt wyjścia, policzony dla manekina z Rig Generator ze 100 Health. „Czas do nokautu” liczy się od pierwszego ciosu, gdy każde machnięcie trafia od razu, gdy tylko pozwala cooldown.
| Broń | DAMAGE | COOLDOWN_SECONDS | HIT_RANGE | HIT_WIDTH | Ciosy (czas) | Obrażenia na sekundę |
|---|---|---|---|---|---|---|
| Sztylet | 12 | 0.35 | 4 | 4 | 9 (2.8 s) | około 34 |
| Miecz (ten poradnik) | 20 | 0.6 | 6 | 5 | 5 (2.4 s) | około 33 |
| Miecz dwuręczny | 35 | 1.1 | 7 | 7 | 3 (2.2 s) | około 32 |
| Włócznia | 18 | 0.8 | 9 | 3 | 6 (4 s) | około 23 |
- Gracze się leczą, manekiny nie. Postacie graczy domyślnie odnawiają 1% MaxHealth co sekundę. Przy równo 100 obrażeń w 5 ciosach gracz bity z maksymalną szybkością przeżywa piąty cios i potrzebny jest szósty. Zostaw zapas, na przykład 21 obrażeń zamiast 20, jeśli liczy się dokładna liczba ciosów.
- Skaluj NETWORK_SLACK razem z cooldownem. 0.1 sekundy z poradnika to szósta część z 0.6. Jeśli zostawisz 0.1 przy sztylecie z cooldownem 0.35 sekundy, oszust mógłby bić co 0.25 sekundy, o 40% szybciej. Bierz mniej więcej szóstą część
COOLDOWN_SECONDS: 0.06 dla sztyletu. - Trzymaj SwordClient w zgodzie. Ustaw tam ten sam
COOLDOWN_SECONDS, inaczej klient wysyła machnięcia, które serwer ignoruje.
Wersja 2: zamach i żadnych ciosów przez ściany
Gdy podstawowy miecz już działa, pojawiają się dwie skargi. Cios trafia w tej samej chwili, w której gracz kliknął, zanim animacja machnięcia dojdzie do celu, a machnięcie może dosięgnąć kogoś, kto stoi po drugiej stronie cienkiej ściany, bo pudełko nie uwzględnia ścian. Ta wersja SwordService naprawia jedno i drugie. Zastępuje skrypt z kroku 2: ta sama nazwa, ten sam remote, te same ustawienia, więc SwordClient nie trzeba zmieniać.
-- Script w ServerScriptService o nazwie SwordService (wersja z zamachem i sprawdzaniem ścian).
-- Zastępuje skrypt z kroku 2: te same ustawienia i remote plus dwie zasady. Cios trafia
-- WINDUP_SECONDS po kliknięciu, gdy machnięcie dochodzi do celu, i nikogo nie trafia
-- przez ścianę.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Ustawienia
local SWORD_NAME = "Sword"
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- trzymaj tę samą wartość w SwordClient
local WINDUP_SECONDS = 0.15 -- czas od kliknięcia do ciosu; dopasuj do swojej animacji machnięcia
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
-- Zwraca postać i główny part atakującego, dopóki żyje i trzyma miecz
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, gdy między atakującym a celem nie ma nic poza samym celem
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)
-- Sprawdzamy znowu po zamachu: atakujący mógł zginąć albo schować miecz
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)
Najpierw usuń SwordService z kroku 2, inaczej oba skrypty utworzą po remote SwordSwing. Ustaw WINDUP_SECONDS na moment w twojej animacji machnięcia, w którym ostrze przechodzi przed postacią; do szybkiego machnięcia pasuje 0.15.
- Zamach. Cooldown i sprawdzenia „żyje i trzyma miecz” wykonują się, gdy przychodzi kliknięcie, potem
task.delayuruchamiastrikepoWINDUP_SECONDS.strikesprawdza atakującego jeszcze raz, bo w tym czasie mógł zginąć albo schować miecz, i dopiero potem buduje pudełko. Cel, który w trakcie zamachu wyszedł poza zasięg, nie dostaje ciosu, i właśnie tego gracze oczekują, gdy widzą machnięcie. - Sprawdzanie ścian. Dla każdego celu w pudełku
hasClearLinewysyła promień od głównego partu atakującego do głównego partu celu, pomijając własną postać atakującego. Jeśli pierwsze, na co trafi, należy do celu, albo nie trafi na nic, cios się liczy. Ściana, drzwi albo inny gracz pomiędzy nimi go blokują. - Ile to kosztuje. Jeden dodatkowy promień na cel na machnięcie, czyli niewiele w porównaniu z samym zapytaniem pudełka.
Zamach czyni też miecz uczciwszym wobec oszustów, którzy biją w tej samej chwili, w której teleportują się do kogoś: serwer szuka celów chwilę później, tam, gdzie widzi postacie w tym momencie. Samego teleportu to nie zatrzymuje; do tego potrzebne jest sprawdzanie ruchu opisane w sekcji Co może, a czego nie może exploiter.
Dodaj animację machnięcia (opcjonalnie)
SwordClient już odtwarza animację, gdy tylko dasz mu ID. Animację robisz raz, w Animation Editor w Studio:
- Wstaw rig do animacji. Na karcie Avatar albo Home kliknij Character, żeby otworzyć Rig Generator, i wybierz rig pasujący do awatarów twojej gry, na przykład R15, a potem Block Avatar.
- Na karcie Avatar kliknij Clip Editor, żeby otworzyć Animation Editor, zaznacz rig i ustaw pozy krótkiego machnięcia prawą ręką.
- Ustaw priorytet Action: kliknij przycisk … w kontrolkach odtwarzania edytora, najedź na Set Animation Priority i wybierz Action. Action stoi wyżej niż Movement, Idle i Core, więc machnięcie odtwarza się ponad animacjami chodzenia i stania, a nie przegrywa z nimi.
- W tym samym menu … wybierz Publish to Roblox. Jeśli twoja gra należy do grupy, wybierz tę grupę w polu Creator przed wysłaniem.
- Skopiuj asset ID animacji z Toolboxa i w SwordClient ustaw
SWING_ANIMATION_IDna"rbxassetid://", a po nim tę liczbę.
SwordClient wczytuje machnięcie przez Animator postaci, a nie przez starszy Humanoid:LoadAnimation, który Roblox oznacza jako przestarzały. Dokumentacja Roblox o Animator mówi, że animacje, które urządzenie gracza uruchamia na własnej postaci tego gracza, replikują się na serwer i do wszystkich innych graczy, więc LocalScript może odtworzyć machnięcie i zobaczą je wszyscy. Mówi też, że Animator musi być tworzony na serwerze, więc nigdy nie twórz go w LocalScript. W postaciach graczy zwykle leży w Humanoidzie i właśnie tam szuka go przykład animacji od samego Roblox.
Animacja jest tylko dla wyglądu. Trafienia od niej nie zależą, więc wolna, brakująca albo zmieniona animacja nigdy nie zmienia tego, kto dostanie cios.
Jak odtworzyć animację po naciśnięciu klawisza, w pętli albo na NPC, przeczytasz w poradniku o skrypcie animacji.
W czym mylą się starsze poradniki o mieczach
Jeśli porównujesz ten poradnik z filmem albo postem na forum, oto ważne różnice i powód, dla którego każdy sposób tworzy problem.
| Poradnik | Problem | Ten poradnik |
|---|---|---|
Zadaje obrażenia w zdarzeniu Touched ostrza | Urządzenie atakującego może wywołać Touched na swoim mieczu skądkolwiek (strona Roblox o network ownership), a Touched odpala się kilka razy z rzędu przy jednym dotknięciu (strona Roblox o debounce). | Serwer znajduje cele własnym pudełkiem, raz na Humanoid na machnięcie. |
| Obniża Health w LocalScript | Zmiana, którą LocalScript wprowadza w cudzej postaci, zostaje na tym jednym urządzeniu. | Wszystkie obrażenia zadaje SwordService. |
Używa wait(0.5) do cooldownu | Roblox oznacza globalne wait() jako przestarzałe, zamiast niego używa się task.wait(), a cooldown, który istnieje tylko na kliencie, nikogo nie zatrzymuje. | Porównuje czas os.clock() na serwerze. Nic nie czeka. |
Odtwarza machnięcie przez Humanoid:LoadAnimation | Przestarzałe, zamiast tego używa się Animator:LoadAnimation. | Wczytuje machnięcie przez Animator. |
Szuka celów przez Region3 i FindPartsInRegion3 | Przestarzałe. Roblox radzi w nowych projektach używać GetPartBoundsInBox z OverlapParams. | Używa GetPartBoundsInBox. |
Wkłada Script serwera do Toola i nasłuchuje w nim Activated | Miecz każdego gracza uruchamia własną kopię kodu serwera, a takie skrypty często zadają obrażenia w Touched (pierwszy wiersz). Przy domyślnych ustawieniach Script działa tylko w Workspace albo ServerScriptService, więc Script w Toolu nie uruchamia się, dopóki miecz nie zostanie założony po raz pierwszy. Strona Roblox o narzędziach opisuje większość narzędzi jako LocalScript do wejścia, Script na serwerze do efektu i RemoteEvent między nimi. | Jeden SwordService w ServerScriptService obsługuje wszystkie miecze w grze. |
Co może, a czego nie może exploiter
Załóż, że oszust kontroluje wszystko na swoim urządzeniu. Może czytać i zmieniać twoje LocalScripty, a poradnik Roblox o bezpieczeństwie mówi, że może wywoływać RemoteEvent z dowolną częstotliwością i dowolnymi argumentami. Oto co to znaczy dla tego miecza.
| Oszust próbuje | Wynik | Dlaczego |
|---|---|---|
Wywoływać SwordSwing tak szybko, jak pozwala jego kod, albo użyć autoklikera | Liczy się najwyżej jedno machnięcie co 0.5 sekundy | Cooldown serwera to 0.6 sekundy minus 0.1 sekundy zapasu na sieć. Ten zapas to maksimum, jakie zyskuje oszust. |
| Wysłać z remote cel, liczbę obrażeń albo pozycję | Ignorowane | onSwing czyta tylko gracza, którego Roblox podstawia sam. Niczego innego wysłanego z remote nigdy się nie czyta. |
| Zmienić SwordClient, na przykład usunąć jego cooldown | Nie wpływa na serwer | SwordService trzyma swoje ustawienia w ServerScriptService, który nigdy nie jest wysyłany graczom. |
| Bić, będąc martwym albo bez miecza w ręce | Ignorowane | SwordService sprawdza, czy jego Humanoid żyje i czy Tool o nazwie Sword leży w jego postaci, dokąd Roblox przenosi narzędzie przy zakładaniu. |
| Uderzyć kogoś z drugiego końca mapy | Nic się nie dzieje | Pudełko buduje się wokół postaci atakującego tam, gdzie widzi ją serwer, i sięga tylko 6 studów do przodu. |
| Teleportować się do gracza i potem uderzyć | Możliwe | Każde urządzenie steruje ruchem swojej postaci, a Roblox wymienia teleport w dowolne miejsce wśród tego, co klient może robić ze swoją postacią. Sprawdzanie ruchu na serwerze może to wyłapać. |
| Uderzyć przez cienką ścianę | Możliwe w granicach pudełka 6 studów | Zapytanie pudełka z kroku 2 nie szuka ścian. Wersja 2 dodaje sprawdzanie ścian. |
| Odtworzyć dowolną animację albo żadną | Nie wpływa na trafienia | Trafienia nigdy nie zależą od animacji. Roblox zaznacza, że oszuści mogą odtwarzać dowolne animacje na swojej postaci. |
W dwóch wierszach stoi „Możliwe” i to jest uczciwe. Ten miecz nie pozwala oszustowi wybierać, kogo bije, jak mocno i jak często. Nie może mu przeszkodzić w poruszaniu własną postacią. Dokumentacja Roblox o bezpieczeństwie mówi, że klienci sterują ruchem i fizyką swojej postaci i że sprawdzanie ruchu trzeba dostroić do każdej gry. W grze rywalizacyjnej następną warstwą jest sprawdzanie ruchu na serwerze (poradnik o sprincie buduje takie, ostrzega o grubych speedhackach i dalekich teleportach) albo server authority od Roblox, którą dokumentacja opisywała jako betę, gdy sprawdzaliśmy 13 października 2026.
Krok 4: sprawdź
- Dodaj coś do bicia. Na karcie Avatar albo Home kliknij Character, żeby otworzyć Rig Generator, wybierz rig (na przykład R15, potem Block Avatar), a wstawi się do Workspace. Odsuń go kilka studów od swojego SpawnLocation.
- Kliknij Play, załóż Sword z hotbara, podejdź do riga i kliknij. Po pierwszym ciosie nad nim pojawia się pasek zdrowia, bo domyślnie Humanoid pokazuje pasek tylko wtedy, gdy jego Health jest niższe niż MaxHealth. Humanoid zaczyna ze 100 zdrowia, więc piąty cios go nokautuje.
- Klikaj tak szybko, jak możesz. Coś robi tylko jedno machnięcie co 0.6 sekundy.
- Odejdź od riga na około 8 studów albo odwróć się do niego plecami i machnij. Nic się nie dzieje, bo żaden jego part nie jest w pudełku.
- Sprawdź na prawdziwym graczu. Wybierz Server & Clients z rozwijanej listy trybów testu, ustaw 2 klientów i kliknij Play. Uderz drugiego gracza w ciągu 10 sekund od jego spawnu: nic się nie dzieje przez ForceField przy spawnie. Potem każdy cios zabiera 20. Domyślnie postacie graczy dodatkowo odnawiają 1% MaxHealth co sekundę, więc między walkami ich zdrowie powoli wraca.
- Jeśli twoja gra ma Teams, umieść obu testowych graczy w jednej drużynie. Przy
FRIENDLY_FIRErównym false ich machnięcia nic sobie nie robią.
Cały czas trzymaj otwarte okno Output (menu Window, potem Output). Gdy te skrypty działają, niczego nie wypisują, więc każdy czerwony błąd od SwordService albo SwordClient to prawdziwy problem. Zobacz Częste błędy.
Jak rozbudować miecz do systemu walki
Combo
Trzymaj na serwerze licznik machnięć na gracza, obok lastSwing. Jeśli poprzednie machnięcie było niedawno, dodawaj 1; inaczej zaczynaj znowu od 1. Potem wybieraj obrażenia według licznika, na przykład więcej obrażeń przy co trzecim ciosie, i czyść licznik przy PlayerRemoving w ten sam sposób. Klient może prowadzić własny licznik, żeby wybierać, którą animację odtworzyć, bo animacja nigdy nie decyduje o trafieniu. Pudełko i sprawdzenia zostają dokładnie takie same.
Odrzut
Po TakeDamage SwordService może odepchnąć cel przez ApplyImpulse na RootPart celu, w kierunku rootPart.CFrame.LookVector atakującego. Dokumentacja Roblox mówi, że pchnięcie zależy od masy celu i że Script na serwerze może je wywołać na parcie, którego właścicielem jest serwer, albo na parcie, którego właścicielem automatycznie jest klient. Urządzenie każdego gracza symuluje jego własną postać, więc sprawdzaj odrzut na graczach przez Server & Clients, a nie tylko na rigu.
Zaliczanie zabójstw do tablicy wyników
Tuż przed target:TakeDamage(DAMAGE) zapisz, kto uderzył ostatni, przez target:SetAttribute("LastHitBy", player.UserId). W Script na serwerze podłącz zdarzenie Died Humanoida każdej postaci, odczytaj ten atrybut, znajdź atakującego przez Players:GetPlayerByUserId i dodaj 1 do IntValue Kills w jego leaderstats. Utwórz go obok Coins i Wins, jak w kroku 1 poradnika o tablicy wyników, i zmieniaj na serwerze, jak w kroku 2.
Blok
Dodaj drugi RemoteEvent, który klient wywołuje, gdy przycisk bloku zostaje naciśnięty i puszczony, i niech serwer ustawia atrybut Blocking na postaci tego gracza, z własnym limitem częstotliwości. W SwordService zmniejszaj albo pomijaj obrażenia, gdy na postaci celu ustawione jest Blocking. Oszust i tak sam wybiera, kiedy blokować, więc rób blok krótki albo daj mu cooldown.
Sprzedaż miecza albo wydawanie go na każdą rundę
StarterPack daje miecz każdemu graczowi przy każdym spawnie. Żeby zamiast tego go sprzedawać, włóż go do folderu ShopItems z poradnika o GUI sklepu. Katalog tamtego poradnika już sprzedaje Tool o nazwie ClassicSword, więc albo nazwij ten Tool ClassicSword i ustaw taki sam SWORD_NAME, albo zmień wpis w katalogu. Żeby wydawać go tylko na czas rundy, weź skrypt GiveRoundTool z poradnika o systemie rund: trzymaj Sword w ServerStorage, a nie w StarterPack, i zamień "RoundTool" w tamtym skrypcie na "Sword".
Wrogowie do walki i broń dystansowa
Dla NPC, który ściga graczy, idź za poradnikiem o szukaniu ścieżki dla NPC. Miecz zadaje mu obrażenia jak każdemu innemu Humanoidowi. O broni, która trafia z odległości według tych samych zasad serwera, przeczytasz w poradniku o broni.
Częste błędy i rozwiązania
Otwórz okno Output (menu Window, potem Output) przed kliknięciem Play. Większość problemów z mieczem albo wypisuje tam błąd, albo wynika z nazwy, która się nie zgadza.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("SwordSwing")'
SwordClient czeka na remote, który tworzy SwordService, więc SwordService nie działa. Sprawdź, czy to Script, a nie LocalScript, czy leży bezpośrednio w ServerScriptService, nie jest wyłączony i czy w Output nie ma od niego błędu.
Machnąłem, ale nikt nie dostaje obrażeń
Sprawdź po kolei: SwordClient to LocalScript, a nie Script, i leży bezpośrednio w Toolu Sword; Tool nazywa się dokładnie Sword albo tak, jak podano w SWORD_NAME; cel jest nie dalej niż 6 studów przed tobą; cel zespawnował się ponad 10 sekund temu, więc jego ForceField już zniknął; a jeśli używasz Teams, nie jesteście w jednej drużynie przy FRIENDLY_FIRE równym false.
Miecz bije graczy, ale nigdy nie bije mojego NPC
Zapytania przestrzenne takie jak GetPartBoundsInBox nigdy nie zwracają partu z wyłączonym CanQuery (CanQuery działa tylko wtedy, gdy wyłączone jest też CanCollide). Włącz z powrotem CanQuery w częściach ciała NPC i sprawdź, czy jego Humanoid to bezpośrednie dziecko modelu NPC.
Moja postać utyka w miejscu, gdy zakładam miecz
Któryś part miecza jest zakotwiczony. Zaznacz wszystkie party w Toolu i odznacz Anchored.
Jedne machnięcia trafiają, a inne pudłują z tej samej odległości
W wersji z zamachem cel, który wyszedł z pudełka w ciągu WINDUP_SECONDS, nie dostaje ciosu, a sprawdzanie ścian pomija każdego, kto stoi za ścianą albo za innym graczem. Skróć zamach albo zwiększ HIT_WIDTH, jeśli w playtestach pudła wydają się niesprawiedliwe.
Postać trzyma miecz za ostrze
Partów o nazwie Handle jest więcej niż jeden i Roblox wybrał zły. Zostaw dokładnie jeden Handle, rękojeść, i zmień nazwy pozostałych. Potem popraw właściwości chwytu Toola, jeśli kąt wciąż jest zły.
Ostrze zostaje w miejscu albo spada, gdy zakładam miecz
Ostrze nie jest przyspawane do Handle. Dodaj WeldConstraint, w którym Part0 to Handle, a Part1 to ostrze.
Obrażenia widać na moim ekranie, ale zdrowie innego gracza się nie zmienia
Obrażenia zadaje LocalScript, który zmienia tylko twoją kopię gry. Zadawaj obrażenia tylko w SwordService, jak w kroku 2.
Zrób to z RoCode
Jeśli nie chce ci się składać tego wszystkiego ręcznie, RoCode może to zrobić w grze, którą masz otwartą. To niezależny agent AI do pisania kodu, nie robi go Roblox: opisujesz funkcję na jego czacie w przeglądarce, a jego plugin do Roblox Studio tworzy Tool, party i skrypty w twoim Explorerze, więc nie musisz kopiować kodu z okna czatu.
Zrób miecz: Tool o nazwie Sword w StarterPack z Handle i przyspawanym do niego ostrzem, LocalScript, który wywołuje RemoteEvent przy Activated, i Script na serwerze, który sprawdza cooldown 0.6 sekundy i zadaje 20 obrażeń wszystkim Humanoidom w pudełku przed graczem.
- Tworzy Tool i jego party przez Create Instance i ustawia ich właściwości przez Set Property
- Pisze SwordService i SwordClient przez Create Script i może najpierw poszukać istniejących skryptów walki przez Search Scripts
- Ma polecenie sprawdzać kompilację każdego napisanego skryptu przez Check Script, który kompiluje kod w Studio bez uruchamiania (typów nie sprawdza)
- Stawia punkt cofania przed i po każdej paczce zmian, więc Ctrl+Z cofa po jednej paczce
RoCode nie umie zrobić animacji machnięcia ani jej wgrać: zrób ją w Animation Editor i wstaw jej ID. Z pluginem 3.9 lub nowszym RoCode może uruchomić krótki playtest i przeczytać błędy, a z pluginem 3.9.11 lub nowszym może sterować testową postacią, ale nie klika w oknie 3D, żeby machnąć, więc machnięcia sprawdzasz sam. Strona jak stworzyć całą grę Roblox z RoCode, system po systemie pokazuje, gdzie pasuje broń. Jak RoCode łączy się ze Studio.
Najczęstsze pytania
Dlaczego mój miecz bije jednego gracza kilka razy przy jednym machnięciu?
Bo zadaje obrażenia z Touched. Strona Roblox o debounce zaznacza, że Touched odpala się kilka razy z rzędu przy jednym dotknięciu, a każdy part celu może dotknąć ostrza. Ten poradnik znajduje cele jednym zapytaniem pudełka na machnięcie i prowadzi listę, więc każdy Humanoid traci zdrowie raz na machnięcie.
Obrażenia miecza powinny być w LocalScript czy w Script?
W Script na serwerze. Obrażenia zadane z LocalScript zmieniają tylko kopię gry tego gracza, a wszystko, co jest na urządzeniu gracza, oszust może zmienić. LocalScript powinien tylko słyszeć kliknięcie, odtwarzać animację i wywoływać RemoteEvent.
Jak dodać mieczowi animację machnięcia?
Zrób ją w Animation Editor, ustaw priorytet Action, opublikuj w Roblox i wpisz jej asset ID do SWING_ANIMATION_ID jako rbxassetid://, a po nim liczbę. SwordClient odtwarza ją przez Animator postaci. Animacje, które urządzenie gracza uruchamia na własnej postaci tego gracza, widzą wszyscy.
Dlaczego animacja miecza się nie odtwarza?
Sprawdź trzy rzeczy. Priorytet: Action stoi wyżej niż Movement, Idle i Core, więc machnięcie z Action odtwarza się ponad chodzeniem i staniem, a niższy priorytet może z nimi przegrać. Właściciel: jeśli gra należy do grupy, publikuj animację, wybierając tę grupę jako Creator. ID: SWING_ANIMATION_ID musi być pełnym tekstem rbxassetid:// z liczbą twojej animacji, a nie pustym napisem.
Jaki hitbox jest najlepszy dla miecza w Roblox?
W większości gier zapytanie pudełka na serwerze raz na machnięcie, jak w tym poradniku: jedno wywołanie GetPartBoundsInBox, klient nie ma czego podrabiać, a do strojenia są trzy liczby. Używaj GetPartsInPart z partem o odpowiednim kształcie albo raycastów wzdłuż ostrza tylko wtedy, gdy zasięg broni daleko odbiega od pudełka. Porównanie czterech sposobów.
Jak sprawić, żeby miecz nie bił przez ściany?
Przed zadaniem obrażeń wyślij promień od głównego partu atakującego do głównego partu celu, pomijając postać atakującego, i zaliczaj cios tylko wtedy, gdy pierwsze, na co trafi promień, należy do celu. Wersja 2 SwordService robi to dla każdego celu.
Dlaczego cios trafia, zanim animacja machnięcia dojdzie do celu?
Serwer sprawdza hitbox w tej samej chwili, w której przychodzi kliknięcie. Najpierw odczekaj krótki zamach, na przykład 0.15 sekundy przez task.delay, potem sprawdź, czy atakujący wciąż żyje i trzyma miecz, i zbuduj pudełko, jak robi wersja 2.
Czy exploiterzy mogą mimo to oszukiwać z tym mieczem?
Nie mogą wybierać, kto dostanie cios, ile obrażeń zadaje cios ani jak często biją, bo o wszystkich trzech rzeczach decyduje serwer; najwięcej zyskują 0.1 sekundy zapasu na sieć przy cooldownie. Nadal mogą ruszać swoją postacią, na przykład tuż obok kogoś, bo każde urządzenie steruje ruchem swojej postaci. Następną warstwą jest sprawdzanie ruchu na serwerze.
Jak zrobić system walki z combo?
Trzymaj na serwerze licznik machnięć na gracza, zeruj go po krótkiej przerwie i wybieraj obrażenia i animację według licznika. Sprawdzanie trafienia zostaje takie samo. Sekcja Jak rozbudować omawia jeszcze odrzut, zaliczanie zabójstw i blok.
Źródła i dalsza lektura
- Roblox Creator Docs: In-game tools (po angielsku). składanie narzędzia w Workspace, Handle, Weld, Grip, kotwiczenie i dlaczego większość narzędzi używa LocalScript, Script i RemoteEvent
- Roblox Creator Docs: WorldRoot:GetPartBoundsInBox (po angielsku). zapytanie pudełka, OverlapParams i przestarzałe FindPartsInRegion3
- Roblox Creator Docs: Humanoid:TakeDamage (po angielsku). ochrona ForceField, pasek zdrowia i regeneracja zdrowia
- Roblox Creator Docs: Network ownership (po angielsku). exploit z mieczem na Touched
- Roblox Creator Docs: Security tactics and cheat mitigation (po angielsku). nigdy nie ufaj klientowi
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (po angielsku). co klient może robić ze swoją postacią i sprawdzanie ruchu
- Roblox Creator Docs: Animation Editor (po angielsku). priorytet animacji i publikacja
- Roblox Creator Docs: Animator:LoadAnimation (po angielsku). które animacje replikują się z klienta
- Roblox Creator Docs: Debounce patterns (po angielsku). dlaczego Touched odpala się kilka razy przy jednym dotknięciu
Jak sprawdziliśmy kod: każdy skrypt na tej stronie przechodzi ścisłe sprawdzanie typów Luau z definicjami API Robloxa (luau-lsp, 20 listopada 2026). Sprawdzanie typów wyłapuje źle wpisane API i błędne typy, ale nie logikę gry, więc przetestuj go w Studio przed publikacją.