Singkatnya
Taruh Tool bernama Sword dengan part bernama Handle di StarterPack. Sebuah LocalScript di dalam Tool mendengarkan Tool.Activated, memutar animasi ayunan dan memicu RemoteEvent tanpa argumen. Sebuah Script di ServerScriptService mengecek cooldown dan bahwa pemain hidup serta memegang pedang, mencari Humanoid di dalam kotak di depan mereka dengan workspace:GetPartBoundsInBox, dan memanggil Humanoid:TakeDamage sekali per target.
- Jangan memberi damage dari event
Touchedmilik bilah: perangkat pemain mengendalikan karakternya sendiri dan bisa memicu Touched dari mana saja, dan halaman network ownership Roblox memakai pedang sebagai contohnya. - Client tidak mengirim target maupun damage. Server yang memiliki cooldown, hitbox dan jumlah damage.
TakeDamagetidak berbuat apa-apa selagi target punya ForceField, seperti 10 detik setelah spawn di SpawnLocation.- Hit menembus dinding, atau hit yang mendarat sebelum ayunan terlihat mengenai? Pakai versi wind-up dan pengecekan dinding dari script server.
Di halaman ini
Cara pedang yang berfungsi tersusun
Pedang yang berfungsi di game live dibagi antara perangkat pemain dan server. Halaman tools Roblox menyebut input tool tempatnya di LocalScript, karena hanya perangkat pemain yang tahu kapan input terjadi, dan bahwa kebanyakan tool butuh LocalScript, Script server dan RemoteEvent di antara keduanya. Panduan ini memakai pembagian persis itu. Satu ayunan berjalan seperti ini:
- Pemain mengklik, mengetuk atau menekan trigger gamepad dengan Sword sedang dipegang.
Tool.Activatedterjadi di LocalScript. - LocalScript memutar animasi ayunan, kalau ada, dan memicu RemoteEvent
SwordSwing. Tidak ada hal lain yang dikirim. - Script server mengecek cooldown, bahwa pemain hidup dan bahwa Sword ada di tangannya.
- Server membuat hitbox miliknya sendiri di depan karakter pemain dan mencari setiap Humanoid di dalamnya.
- Masing-masing Humanoid itu kehilangan health satu kali, lewat
TakeDamage.
| Bagian | Tempatnya | Fungsinya |
|---|---|---|
Tool Sword | StarterPack | Yang dipegang pemain. Roblox menyalin semua isi StarterPack ke Backpack pemain setiap kali karakternya spawn. |
Part Handle | Di dalam Tool | Part yang digenggam karakter. Bilahnya di-weld ke part ini. |
LocalScript SwordClient | Di dalam Tool | Mendengar klik, memutar animasi ayunan dan memicu remote. |
RemoteEvent SwordSwing | ReplicatedStorage (dibuat SwordService) | Membawa "aku mengayun" dari perangkat pemain ke server, tanpa argumen. |
Script SwordService | ServerScriptService | Mengecek setiap ayunan, mencari siapa yang ada di depan pemain dan memberi damage. Satu-satunya tempat hit bisa terjadi. |
ServerScriptService
SwordService Script new
StarterPack
Sword Tool new
Handle Part new
Blade Part new
WeldConstraint WeldConstraint new
SwordClient LocalScript new
Langkah 1: Buat Tool pedangnya
- Di Explorer, arahkan kursor ke Workspace, klik tombol + dan sisipkan Tool. Ganti namanya menjadi
Sword. Script server mencari nama yang persis ini. Kamu membuat pedangnya di Workspace, seperti saran halaman tools Roblox, karena di situlah kamu bisa melihat part-nya serta memindahkan dan mengubah ukurannya. Langkah terakhir memindahkannya ke StarterPack. - Sisipkan Part ke dalam Tool dan beri nama
Handle. Ini gagangnya, tempat karakter memegang pedang. Part ini harus anak langsung dari Tool, dan harus satu-satunya part dengan nama itu: dengan dua Handle, Roblox memilih salah satu secara acak, dan karakter bisa saja memegang pedang di bilahnya. - Sisipkan Part kedua ke dalam Tool, beri nama
Blade, lalu bentuk dan taruh supaya mencuat dari bagian atas Handle. - Sisipkan WeldConstraint ke dalam Blade. Di jendela Properties, atur
Part0-nya ke Handle danPart1-nya ke Blade, supaya pedang tetap utuh selagi pemain membawanya. - Pilih kedua part dan pastikan Anchored mati. Part yang di-anchor di dalam tool menahan karakter di tempat saat mereka memegangnya. Matikan juga CanCollide di keduanya, supaya bilah tidak menabrak pemain dan dinding saat kamu mengayun.
- Pilih Tool-nya dan hilangkan centang CanBeDropped. Kalau dicentang, menekan Backspace menjatuhkan pedang ke Workspace.
- Seret Sword yang sudah jadi dari Workspace ke StarterPack. Tool yang dibiarkan di Workspace adalah pickup yang diambil satu pemain, bukan pedang yang sudah ada di Backpack setiap pemain sejak awal.
Pedang dari satu MeshPart juga bisa: beri nama MeshPart itu Handle dan lewati weld-nya. Kalau karakter memegang pedang dengan sudut yang aneh saat kamu mengetes, pilih Tool-nya dan sesuaikan properti grip-nya (GripPos, GripForward, GripRight dan GripUp) di jendela Properties.
Langkah 2: Tambahkan script server
Arahkan kursor ke ServerScriptService, sisipkan Script bernama SwordService dan tempel kode di bawah. Inilah satu-satunya tempat hit pedang bisa terjadi. Pengaturan di bagian atas adalah baris yang memang untuk kamu ubah.
-- Script di ServerScriptService bernama SwordService.
-- Satu-satunya tempat hit pedang bisa terjadi: script mengecek ayunannya, mencari target di depan
-- penyerang dengan hitbox miliknya sendiri, dan memberi damage.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Pengaturan
local SWORD_NAME = "Sword" -- nama Tool di StarterPack
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- samakan nilainya di SwordClient
local HIT_RANGE = 6 -- stud di depan penyerang
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false -- false: pemain di tim yang sama tidak bisa saling melukai
-- Ayunan yang dikirim tepat berjarak COOLDOWN_SECONDS bisa tiba sedikit lebih rapat setelah
-- delay jaringan, jadi server memberi kelonggaran sebesar ini supaya ayunan sungguhan tidak dibuang
local NETWORK_SLACK = 0.1
-- Remote yang dipicu LocalScript pedang. Tidak membawa argumen: server yang
-- memutuskan siapa yang terkena, jadi tidak ada yang bisa dipalsukan client.
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
-- Pemain netral (tanpa tim) selalu bisa saling mengenai
return not attacker.Neutral and not target.Neutral and attacker.Team == target.Team
end
local function onSwing(player: Player)
-- 1. Satu ayunan per cooldown, sesering apa pun remote dipicu
local now = os.clock()
local last = lastSwing[player]
if last and now - last < COOLDOWN_SECONDS - NETWORK_SLACK then
return
end
-- 2. Penyerang harus hidup dan memegang pedang
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. Hitbox milik server sendiri: kotak di depan root part penyerang
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. Beri damage ke setiap Humanoid di kotak satu kali, meski beberapa part-nya ada di dalam
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) -- tidak berbuat apa-apa selagi target punya ForceField
end
end
end
end
swingEvent.OnServerEvent:Connect(onSwing)
Players.PlayerRemoving:Connect(function(player: Player)
lastSwing[player] = nil
end)
SwordService sendiri yang membuat RemoteEvent SwordSwing saat game dimulai, jadi tidak ada yang perlu disisipkan ke ReplicatedStorage secara manual. Kalau kamu sudah membuat RemoteEvent dengan nama itu, hapus: LocalScript bisa menemukan milikmu, yang tidak didengarkan apa pun di server.
| Pengaturan | Nilai di sini | Yang diubahnya |
|---|---|---|
SWORD_NAME | "Sword" | Nama Tool yang diharapkan server ada di tangan pemain. Ubah kalau Tool kamu bernama lain. |
DAMAGE | 20 | Health yang diambil setiap hit. Humanoid mulai dengan 100 health, jadi lima hit menjatuhkan rig tes. Karakter pemain secara default memulihkan 1% MaxHealth-nya setiap detik, jadi pemain yang dipukul dengan kecepatan ayunan penuh selamat dari hit kelima dan butuh hit keenam. |
COOLDOWN_SECONDS | 0.6 | Waktu antar ayunan. Atur nilai yang sama di SwordClient. |
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT | 6, 5, 6 | Hitbox dalam stud: seberapa jauh jangkauannya di depan pemain, seberapa lebar dan seberapa tinggi. |
FRIENDLY_FIRE | false | Kalau false, pemain di tim yang sama tidak bisa saling melukai. Pemain tanpa tim selalu bisa saling mengenai, dan NPC selalu bisa dikenai. |
NETWORK_SLACK | 0.1 | Seberapa lebih awal dari cooldown server masih menerima ayunan. Dua klik berjarak 0,6 detik bisa tiba sedikit lebih rapat setelah delay jaringan, dan tanpa kelonggaran ini server akan membuang ayunan sungguhan yang sudah dilihat pemain. |
Langkah 3: Tambahkan LocalScript di dalam Tool
Sisipkan LocalScript ke dalam Tool Sword, beri nama SwordClient dan tempel ini:
-- LocalScript di dalam Tool Sword, bernama SwordClient.
-- Tool.Activated terjadi di perangkat pemain, jadi script ini mendengarkan klik,
-- ketukan atau trigger, memutar animasi ayunan dan meminta server mengayun.
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 -- nilai yang sama seperti di SwordService
local SWING_ANIMATION_ID = "" -- opsional: "rbxassetid://" diikuti id animasimu
local player = Players.LocalPlayer
local lastSwing = 0
local swingTrack: AnimationTrack? = nil
local trackCharacter: Model? = nil
-- Muat animasinya sekali per karakter. Animasi yang dimulai pada karaktermu sendiri
-- dari perangkatmu diperlihatkan ke setiap pemain.
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 -- server juga menegakkan ini; mengecek di sini menghindari request yang sia-sia
end
lastSwing = now
if swingTrack then
swingTrack:Play()
end
swingEvent:FireServer()
end)
Biarkan SWING_ANIMATION_ID kosong untuk sekarang. Pedang berfungsi tanpa animasi, karena server yang memutuskan hit-nya bagaimanapun juga. Menambahkan animasi ayunan menunjukkan cara mengisinya.
Activated terjadi untuk klik mouse, ketukan di ponsel dan trigger di gamepad, jadi script yang sama berfungsi di setiap perangkat. Roblox menyalin Tool, dan LocalScript di dalamnya, ke Backpack setiap pemain saat karakternya spawn, jadi setiap pemain menjalankan salinannya sendiri.
LocalScript menyimpan cooldown-nya sendiri hanya supaya tidak mengirim request yang toh akan diabaikan server. Itu bukan pengecekan keamanan: cheater bisa menghapusnya, mengeditnya atau memicu SwordSwing dari kodenya sendiri. Panduan RemoteEvent menjelaskan kenapa setiap remote harus dicek di server, dan Script vs LocalScript vs ModuleScript (dalam bahasa Inggris) menunjukkan apa yang bisa dan tidak bisa diubah LocalScript.
Cara server memutuskan siapa yang terkena
Saat SwordSwing tiba, SwordService tidak bertanya apa pun ke client. Script membuat kotak di depan karakter penyerang, di tempat server melihatnya, dan bertanya ke engine part mana yang ada di dalamnya dengan workspace:GetPartBoundsInBox. Method itu menggantikan FindPartsInRegion3 yang lebih lama, yang ditandai Roblox sebagai deprecated.
Kotaknya berpusat 3 stud di depan root part penyerang. Itulah offset CFrame.new(0, 0, -HIT_RANGE / 2): sebuah CFrame menghadap sepanjang sumbu Z negatifnya, yaitu LookVector-nya. Jadi kotaknya menjangkau dari tengah karakter sampai 6 stud ke depan, dengan lebar 5 stud dan tinggi 6 stud. Query-nya membandingkan bounding box setiap part, perkiraan cepat berbentuk kotak atas volumenya, jadi part bulat dan mesh dihitung sedikit lebih besar dari tampilannya. Untuk pedang, selisih kecil itu membantu.
| Langkah | Kode | Alasannya |
|---|---|---|
| Lewati penyerang | OverlapParams dengan Exclude dan karakter penyerang | Lengan, kaki dan pedang penyerang sendiri juga ada di dalam kotak. |
| Cari karakternya | part:FindFirstAncestorOfClass("Model") | Part di dalam kotak bisa berupa anggota tubuh, topi atau tool yang dipegang. FindFirstAncestorOfClass mencocokkan nama class yang persis, jadi melewati topi (class Accessory) dan tool yang dipegang (class Tool, meski Tool adalah sejenis Model) dan berhenti di model karakter. |
| Cari Humanoid-nya | model:FindFirstChildOfClass("Humanoid") | Apa pun yang punya Humanoid bisa dikenai: pemain, NPC dan dummy tes. Dinding dan lantai dilewati. |
| Sekali per Humanoid | table alreadyHit | Biasanya beberapa part dari satu karakter ada di dalam kotak. Tanpa table itu, masing-masing akan memberi damage lagi. |
| Hanya target yang hidup | target.Health > 0 | Karakter yang sudah jatuh tidak dikenai lagi. |
| Tim | isTeammate | Dengan FRIENDLY_FIRE false, pemain di tim yang sama dilewati. Pemain yang properti Neutral-nya true tidak punya tim. |
| Damage | target:TakeDamage(DAMAGE) | Menurunkan Health kecuali ForceField melindungi target. |
Table alreadyHit dibuat baru di setiap ayunan, jadi pemain yang sama bisa dikenai lagi di ayunan berikutnya setelah cooldown lewat. Itulah aturan "sekali per target per ayunan" yang sulit dicapai pedang berbasis Touched.
Script memakai TakeDamage, bukan mengatur Health. Referensi Roblox menyebut TakeDamage membiarkan Humanoid selagi ForceField melindunginya, dan bahwa mengatur Health secara langsung mengabaikan ForceField. Pemain yang spawn di SpawnLocation mendapat ForceField selama 10 detik secara default (Duration milik SpawnLocation), jadi pendatang baru tidak bisa dikenai begitu mereka muncul.
Empat cara membuat hitbox pedang, dibandingkan
Tutorial pedang paling sering berbeda pendapat soal satu hal: cara mengetahui apa yang dikenai bilah. Ada empat jawaban umum. Bedanya ada pada seberapa dekat mengikuti bilah, seberapa besar beban kerjanya bagi server, dan apakah cheater bisa memalsukan hasilnya.
| Metode | Cara kerjanya | Siapa yang memutuskan | Akurasi | Paling cocok untuk |
|---|---|---|---|---|
Touched pada bilah | Damage setiap kali part bilah menyentuh karakter | Perangkat penyerang, yang memiliki karakter dan pedangnya sendiri | Mengikuti bilah, tapi terjadi beberapa kali per sentuhan | Tidak untuk apa pun di game dengan pemain lain: perangkat penyerang bisa memicunya dari mana saja |
| Kotak di depan pemain (panduan ini) | Satu query GetPartBoundsInBox di server per ayunan | Server | Kotak tetap, bukan lintasan bilah. Mesh dihitung lewat bounding box-nya, jadi sedikit longgar | Kebanyakan game: sederhana, murah, dan tidak ada yang bisa dipalsukan |
GetPartsInPart pada part hitbox | Query di sisi server dengan part yang berbentuk seperti sapuan bilah, selama ayunan | Server | Bentuk persis: dokumentasi Roblox menyebut method ini melakukan pengecekan geometri penuh, dan menyarankan query kotak atau bola kalau akurasi lebih rendah sudah cukup karena lebih murah | Senjata besar dengan bentuk aneh, seperti busur sabit |
| Raycast sepanjang bilah | Di setiap frame ayunan, tembakkan ray pendek dari titik-titik di bilah ke posisinya di frame sebelumnya | Sisi mana pun yang menembakkannya. Di server, ini butuh gambaran server tentang letak bilah | Mengikuti animasi dengan dekat | Game yang lintasan persis ayunannya penting. Module hitbox buatan komunitas bekerja seperti ini |
Kotak adalah pilihan pertama yang tepat. Hanya satu query per ayunan, tidak pernah bergantung pada animasi yang bisa diubah cheater, dan mudah disetel dengan tiga angka. Pindah ke part berbentuk atau ray bilah saat pemain mengeluh hit terasa salah untuk senjata yang jangkauannya jauh dari bentuk kotak, dan pertahankan aturannya: server yang menjalankan query dan memberi damage.
Preset pedang: dari dagger sampai greatsword
SwordService yang sama menghasilkan senjata yang sangat berbeda dari lima pengaturan. Tabel ini adalah titik awal, dihitung terhadap dummy Rig Generator dengan 100 Health. "Waktu menjatuhkan" dihitung dari hit pertama, dengan setiap ayunan mendarat secepat yang diizinkan cooldown.
| Senjata | DAMAGE | COOLDOWN_SECONDS | HIT_RANGE | HIT_WIDTH | Hit (waktu) | Damage per detik |
|---|---|---|---|---|---|---|
| Dagger | 12 | 0.35 | 4 | 4 | 9 (2,8 detik) | sekitar 34 |
| Pedang (panduan ini) | 20 | 0.6 | 6 | 5 | 5 (2,4 detik) | sekitar 33 |
| Greatsword | 35 | 1.1 | 7 | 7 | 3 (2,2 detik) | sekitar 32 |
| Tombak | 18 | 0.8 | 9 | 3 | 6 (4 detik) | sekitar 23 |
- Pemain pulih, dummy tidak. Karakter pemain secara default memulihkan 1% MaxHealth-nya setiap detik. Dengan tepat 100 damage dalam 5 hit, pemain yang dipukul dengan kecepatan penuh selamat dari hit kelima dan butuh hit keenam. Sisakan selisih, misalnya 21 damage sebagai ganti 20, kalau jumlah hit tertentu penting.
- Skalakan NETWORK_SLACK dengan cooldown. Nilai 0,1 detik di panduan ini adalah seperenam dari 0,6. Kalau dibiarkan 0,1 pada dagger 0,35 detik, cheater bisa mengayun setiap 0,25 detik, 40% lebih cepat. Pakai kira-kira seperenam dari
COOLDOWN_SECONDS: 0,06 untuk dagger. - Jaga SwordClient tetap selaras. Atur
COOLDOWN_SECONDSyang sama di sana, kalau tidak client mengirim ayunan yang diabaikan server.
Versi 2: wind-up dan tanpa hit menembus dinding
Dua keluhan muncul begitu pedang dasar berfungsi. Hit mendarat seketika saat pemain mengklik, sebelum animasi ayunan sampai ke target, dan sebuah ayunan bisa mengenai orang di sisi lain dinding tipis, karena kotaknya mengabaikan dinding. Versi SwordService ini memperbaiki keduanya. Versi ini menggantikan script Langkah 2: nama yang sama, remote yang sama, pengaturan yang sama, jadi SwordClient tidak perlu diubah.
-- Script di ServerScriptService bernama SwordService (versi wind-up dan pengecekan dinding).
-- Menggantikan script Langkah 2: pengaturan dan remote yang sama, ditambah dua aturan. Hit mendarat
-- WINDUP_SECONDS setelah klik, saat ayunan sampai ke target, dan tidak ada yang dikenai
-- menembus dinding.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Pengaturan
local SWORD_NAME = "Sword"
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- samakan nilainya di SwordClient
local WINDUP_SECONDS = 0.15 -- waktu dari klik sampai hit; cocokkan dengan animasi ayunanmu
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
-- Mengembalikan karakter dan root part penyerang selagi mereka hidup dan memegang pedang
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 kalau tidak ada apa pun selain target yang berdiri di antara penyerang dan target
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)
-- Dicek lagi setelah wind-up: penyerang mungkin sudah mati atau menyimpan pedangnya
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)
Hapus dulu SwordService dari Langkah 2, kalau tidak kedua script masing-masing membuat remote SwordSwing. Atur WINDUP_SECONDS ke momen di animasi ayunanmu saat bilah lewat di depan karakter; 0.15 cocok untuk ayunan cepat.
- Wind-up. Cooldown dan pengecekan "hidup dan memegang pedang" berjalan saat klik tiba, lalu
task.delaymenjalankanstrikeWINDUP_SECONDSkemudian.strikemengecek penyerang lagi, karena mereka mungkin sudah mati atau menyimpan pedangnya di antaranya, dan baru setelah itu membuat kotaknya. Target yang melangkah keluar jangkauan selama wind-up tidak terkena, dan itulah yang diharapkan pemain saat melihat ayunannya. - Pengecekan dinding. Untuk setiap target di dalam kotak,
hasClearLinemenembakkan ray dari root part penyerang ke root part target, melewati karakter penyerang sendiri. Kalau hal pertama yang ditemuinya milik target, atau tidak ada apa pun, hit-nya dihitung. Dinding, pintu atau pemain lain di antaranya memblokirnya. - Biayanya. Satu ray tambahan per target per ayunan, yang kecil dibandingkan query kotaknya sendiri.
Wind-up juga membuat pedang lebih adil terhadap cheater yang mengayun begitu mereka teleport ke samping seseorang: server mencari target sesaat kemudian, di tempat server melihat karakter-karakternya saat itu. Ini tidak menghentikan teleport-nya sendiri; itu butuh pengecekan gerakan yang dijelaskan di Apa yang bisa dan tidak bisa dilakukan exploiter.
Menambahkan animasi ayunan (opsional)
SwordClient sudah memutar animasi begitu kamu memberinya ID. Kamu membuat animasinya sekali, di Animation Editor milik Studio:
- Sisipkan rig untuk dianimasikan. Di tab Avatar atau Home, klik Character untuk membuka Rig Generator dan pilih rig yang cocok dengan avatar game kamu, misalnya R15 lalu Block Avatar.
- Di tab Avatar, klik Clip Editor untuk membuka Animation Editor, pilih rig-nya, dan buat pose ayunan pendek lengan kanan.
- Atur prioritasnya ke Action: klik tombol … di kontrol playback editor, arahkan kursor ke Set Animation Priority dan pilih Action. Action berada di atas Movement, Idle dan Core, jadi ayunannya diputar di atas animasi berjalan dan berdiri, tidak kalah oleh keduanya.
- Dari menu … yang sama, pilih Publish to Roblox. Kalau game kamu milik sebuah grup, pilih grup itu di kolom Creator sebelum mengirim.
- Salin asset ID animasi itu dari Toolbox, dan di SwordClient isi
SWING_ANIMATION_IDdengan"rbxassetid://"diikuti angka itu.
SwordClient memuat ayunan lewat Animator milik karakter, bukan Humanoid:LoadAnimation yang lebih lama, yang ditandai Roblox sebagai deprecated. Referensi Animator Roblox menyebut animasi yang dimulai perangkat pemain pada karakter pemain itu sendiri direplikasi ke server dan ke setiap pemain lain, jadi LocalScript bisa memutar ayunan dan semua orang melihatnya. Referensi itu juga menyebut Animator harus dibuat di server, jadi jangan pernah membuatnya di LocalScript. Karakter pemain biasanya punya satu di dalam Humanoid, dan di situlah contoh animasi Roblox sendiri mencarinya.
Animasinya hanya untuk tampilan. Hit tidak bergantung padanya, jadi animasi yang lambat, tidak ada atau diedit tidak pernah mengubah siapa yang terkena.
Untuk memutar animasi saat tombol ditekan, sebagai loop atau pada NPC, lihat panduan script animasi.
Kesalahan di tutorial pedang yang lebih lama
Kalau kamu membandingkan panduan ini dengan video atau postingan forum, inilah perbedaan yang penting, beserta alasan tiap pola bermasalah.
| Tutorialnya | Masalahnya | Panduan ini |
|---|---|---|
Memberi damage di event Touched milik bilah | Perangkat penyerang bisa memicu Touched pada pedangnya sendiri dari mana saja (halaman network ownership Roblox), dan Touched terjadi beberapa kali berturut-turut dengan cepat untuk satu sentuhan (halaman debounce Roblox). | Server mencari target dengan kotaknya sendiri, sekali per Humanoid per ayunan. |
| Menurunkan Health di LocalScript | Perubahan yang dibuat LocalScript pada karakter lain tetap di satu perangkat itu. | Semua damage terjadi di SwordService. |
Memakai wait(0.5) untuk cooldown | Roblox menandai wait() global deprecated dan digantikan task.wait(), dan cooldown yang hanya ada di client tidak menghentikan siapa pun. | Membandingkan waktu os.clock() di server. Tidak ada yang menunggu. |
Memutar ayunan dengan Humanoid:LoadAnimation | Deprecated dan digantikan Animator:LoadAnimation. | Memuat ayunan lewat Animator. |
Mencari target dengan Region3 dan FindPartsInRegion3 | Deprecated. Roblox menyarankan GetPartBoundsInBox dengan OverlapParams untuk pekerjaan baru. | Memakai GetPartBoundsInBox. |
Menaruh Script server di dalam Tool yang mendengarkan Activated | Pedang setiap pemain menjalankan salinan kode servernya sendiri, dan script seperti ini sering memberi damage di Touched (baris pertama). Dengan pengaturan default, Script hanya berjalan di bawah Workspace atau ServerScriptService, jadi Script di dalam Tool tidak mulai sampai pedang pertama kali dipegang. Halaman tools Roblox menggambarkan kebanyakan tool sebagai LocalScript untuk input, Script server untuk efeknya dan RemoteEvent di antara keduanya. | Satu SwordService di ServerScriptService menangani setiap pedang di game. |
Apa yang bisa dan tidak bisa dilakukan exploiter
Anggap cheater mengendalikan segala sesuatu di perangkatnya sendiri. Mereka bisa membaca dan mengubah LocalScript kamu, dan panduan keamanan Roblox menyebut mereka bisa memicu RemoteEvent "at any frequency with arbitrary arguments" (dengan frekuensi berapa pun dan argumen sembarang). Inilah artinya bagi pedang ini.
| Cheater mencoba | Hasil | Alasannya |
|---|---|---|
Memicu SwordSwing secepat yang bisa dilakukan kodenya, atau memakai auto-clicker | Paling banyak satu ayunan setiap 0,5 detik yang dihitung | Cooldown server adalah 0,6 detik dikurangi kelonggaran jaringan 0,1 detik. Kelonggaran itu adalah keuntungan terbesar yang didapat cheater. |
| Mengirim target, angka damage atau posisi bersama remote | Diabaikan | onSwing hanya membaca player, yang diisi Roblox sendiri. Apa pun lainnya yang dikirim bersama remote tidak pernah dibaca. |
| Mengedit SwordClient, misalnya untuk menghapus cooldown-nya | Tidak berpengaruh di server | SwordService menyimpan pengaturannya sendiri di ServerScriptService, yang tidak pernah dikirim ke pemain. |
| Mengayun saat mati, atau tanpa pedang di tangan | Diabaikan | SwordService mengecek bahwa Humanoid mereka hidup dan bahwa Tool bernama Sword ada di dalam karakter mereka, tempat Roblox memindahkan tool saat dipegang. |
| Mengenai seseorang dari seberang map | Tidak terjadi apa-apa | Kotaknya dibuat di sekitar karakter penyerang di tempat server melihatnya, dan hanya menjangkau 6 stud ke depan. |
| Teleport ke samping pemain, lalu mengayun | Mungkin | Setiap perangkat mengendalikan gerakan karakternya sendiri, dan Roblox mencantumkan teleport ke posisi mana pun di antara hal yang bisa dilakukan client dengan karakternya sendiri. Pengecekan gerakan di sisi server bisa menandainya. |
| Mengayun menembus dinding tipis | Mungkin di dalam kotak 6 stud | Query kotak Langkah 2 tidak mencari dinding. Versi 2 menambahkan pengecekan dinding. |
| Memutar animasi apa pun, atau tidak sama sekali | Tidak berpengaruh pada hit | Hit tidak pernah bergantung pada animasi. Roblox mencatat bahwa cheater bisa memutar animasi sembarang pada karakternya sendiri. |
Dua baris bertuliskan "Mungkin", dan itu jujur. Pedang ini mencegah cheater memilih siapa yang mereka kenai, seberapa keras dan seberapa sering. Pedang ini tidak bisa mencegah mereka menggerakkan karakternya sendiri. Dokumentasi keamanan Roblox menyebut client mengendalikan gerakan dan fisika karakternya, dan bahwa pengecekan gerakan harus disetel untuk tiap game. Untuk game kompetitif, pengecekan gerakan di sisi server adalah lapisan berikutnya (panduan sprint membuat satu, yang memperingatkan speed hack kasar dan teleport jauh), atau server authority milik Roblox, yang digambarkan dokumentasinya sebagai beta saat kami mengecek pada 13 Oktober 2026.
Langkah 4: Tes
- Tambahkan sesuatu untuk dipukul. Di tab Avatar atau Home, klik Character untuk membuka Rig Generator, pilih rig (misalnya R15, lalu Block Avatar) dan rig itu disisipkan ke Workspace. Pindahkan beberapa stud dari SpawnLocation kamu.
- Tekan Play, pegang Sword dari hotbar, berjalanlah ke rig dan klik. Health bar muncul di atasnya setelah hit pertama, karena secara default Humanoid baru menampilkan bar-nya setelah Health-nya di bawah MaxHealth. Humanoid mulai dengan 100 health, jadi hit kelima menjatuhkannya.
- Klik secepat yang kamu bisa. Hanya satu ayunan setiap 0,6 detik yang berpengaruh.
- Mundur kira-kira 8 stud dari rig, atau membelakanginya, lalu mengayun. Tidak terjadi apa-apa, karena tidak ada part-nya yang berada di dalam kotak.
- Tes melawan pemain sungguhan. Pilih Server & Clients di dropdown mode tes, atur 2 client dan tekan Play. Pukul pemain lain dalam 10 detik sejak mereka spawn: tidak terjadi apa-apa, karena ForceField spawn. Setelah itu, setiap hit mengambil 20. Secara default, karakter pemain juga memulihkan 1% MaxHealth-nya setiap detik, jadi health mereka naik pelan-pelan di antara pertarungan.
- Kalau game kamu memakai Teams, taruh kedua pemain tes di tim yang sama. Dengan
FRIENDLY_FIREfalse, ayunan mereka tidak berpengaruh satu sama lain.
Biarkan jendela Output terbuka (menu Window, lalu Output) sepanjang waktu. Script-script ini tidak mencetak apa pun saat berfungsi, jadi error merah apa pun dari SwordService atau SwordClient adalah masalah sungguhan. Lihat Error umum.
Mengembangkannya menjadi combat system
Combo
Simpan penghitung ayunan per pemain di server, di samping lastSwing. Kalau ayunan sebelumnya baru saja terjadi, tambah 1; kalau tidak, mulai lagi dari 1. Lalu pilih damage dari hitungannya, misalnya damage lebih besar di setiap hit ketiga, dan bersihkan penghitungnya di PlayerRemoving dengan cara yang sama. Client boleh menyimpan hitungannya sendiri untuk memilih animasi mana yang diputar, karena animasi tidak pernah menentukan hit. Kotak dan pengecekannya tetap persis sama.
Knockback
Setelah TakeDamage, SwordService bisa mendorong target menjauh dengan ApplyImpulse pada RootPart target, ke arah rootPart.CFrame.LookVector penyerang. Referensi Roblox menyebut dorongannya bergantung pada massa target, dan bahwa Script server bisa memanggilnya pada part yang dimiliki server atau part yang dimiliki client secara otomatis. Perangkat setiap pemain mensimulasikan karakternya sendiri, jadi tes knockback pada pemain dengan Server & Clients, bukan hanya pada rig.
Kredit kill untuk leaderboard
Tepat sebelum target:TakeDamage(DAMAGE), catat siapa yang terakhir memukul dengan target:SetAttribute("LastHitBy", player.UserId). Di Script server, sambungkan event Died milik Humanoid setiap karakter, baca atribut itu, cari penyerangnya dengan Players:GetPlayerByUserId dan tambahkan 1 ke IntValue Kills di leaderstats mereka. Buat di samping Coins dan Wins seperti di Langkah 1 panduan leaderboard, dan ubah di server seperti di Langkah 2.
Blocking
Tambahkan RemoteEvent kedua yang dipicu client saat tombol block ditekan dan dilepas, dan buat server mengatur atribut Blocking di karakter pemain itu, dengan rate limit-nya sendiri. Di SwordService, kurangi atau lewati damage saat karakter target punya Blocking. Cheater tetap memilih kapan mereka block, jadi buat block-nya singkat atau beri cooldown.
Menjual pedang atau membagikannya setiap ronde
StarterPack memberi setiap pemain pedang di setiap spawn. Untuk menjualnya, taruh di folder ShopItems dari panduan shop GUI. Katalog panduan itu sudah menjual Tool bernama ClassicSword, jadi beri nama Tool ini ClassicSword dan samakan SWORD_NAME, atau ubah entri katalognya. Untuk membagikannya hanya selama ronde, pakai script GiveRoundTool dari panduan round system: simpan Sword di ServerStorage, bukan StarterPack, dan ubah "RoundTool" di script itu menjadi "Sword".
Musuh untuk dilawan, dan senjata jarak jauh
Untuk NPC yang mengejar pemain, ikuti panduan pathfinding NPC. Pedang memberinya damage seperti Humanoid lain. Untuk senjata yang mengenai dari jauh dengan aturan sisi server yang sama, lihat panduan gun (dalam bahasa Inggris).
Error umum dan cara memperbaikinya
Buka jendela Output (menu Window, lalu Output) sebelum kamu menekan Play. Sebagian besar masalah pedang mencetak error di sana atau berasal dari nama yang tidak cocok.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("SwordSwing")'
SwordClient sedang menunggu remote yang dibuat SwordService, jadi SwordService tidak berjalan. Cek bahwa itu Script, bukan LocalScript, langsung di dalam ServerScriptService, tidak dinonaktifkan, dan Output tidak menampilkan error darinya.
Aku mengayun tapi tidak ada yang terkena damage
Cek ini secara berurutan: SwordClient adalah LocalScript, bukan Script, langsung di dalam Tool Sword; Tool-nya bernama persis Sword, atau apa pun isi SWORD_NAME; target berada dalam 6 stud di depanmu; target spawn lebih dari 10 detik lalu, jadi ForceField spawn-nya sudah hilang; dan, kalau kamu memakai Teams, kalian tidak berada di tim yang sama selagi FRIENDLY_FIRE false.
Pedang mengenai pemain tapi tidak pernah NPC-ku
Spatial query seperti GetPartBoundsInBox tidak pernah mengembalikan part yang CanQuery-nya mati (CanQuery hanya berpengaruh selagi CanCollide juga mati). Nyalakan lagi CanQuery untuk bagian tubuh NPC, dan cek bahwa Humanoid-nya adalah anak langsung dari model NPC.
Karakterku macet saat memegang pedang
Salah satu part pedang di-anchor. Pilih setiap part di dalam Tool dan hilangkan centang Anchored.
Sebagian ayunan kena dan sebagian meleset pada jarak yang sama
Dengan versi wind-up, target yang bergerak keluar kotak selama WINDUP_SECONDS tidak terkena, dan pengecekan dinding melewati siapa pun di balik dinding atau pemain lain. Kurangi wind-up, atau lebarkan HIT_WIDTH, kalau ayunan yang meleset terasa tidak adil saat playtest.
Karakter memegang pedang di bilahnya
Ada lebih dari satu part bernama Handle, jadi Roblox memilih yang salah. Sisakan tepat satu Handle, yaitu gagangnya, dan ganti nama yang lain. Lalu sesuaikan properti grip Tool kalau sudutnya masih salah.
Bilah tertinggal atau jatuh saat aku memegang pedang
Bilahnya tidak di-weld ke Handle. Tambahkan WeldConstraint dengan Part0 diatur ke Handle dan Part1 diatur ke bilah.
Damage terlihat di layarku tapi health pemain lain tidak berubah
Damage-nya diberikan dari LocalScript, yang hanya mengubah salinan game milikmu sendiri. Beri damage hanya di SwordService, seperti di Langkah 2.
Buat dengan RoCode
Kalau kamu tidak mau merangkai ini secara manual, RoCode bisa membuatnya di place yang sedang kamu buka. RoCode adalah agen coding AI independen, bukan buatan Roblox: kamu menjelaskan fiturnya di web chat-nya, dan plugin Roblox Studio-nya membuat Tool, part dan script di Explorer kamu, jadi kamu tidak menyalin kode dari jendela chat.
Buat pedang: Tool bernama Sword di StarterPack dengan Handle dan bilah yang di-weld ke Handle, LocalScript yang memicu RemoteEvent saat Activated, dan Script server yang mengecek cooldown 0,6 detik dan memberi 20 damage ke Humanoid di dalam kotak di depan pemain.
- Membuat Tool dan part-nya dengan Create Instance dan mengatur propertinya dengan Set Property
- Menulis SwordService dan SwordClient dengan Create Script, dan bisa lebih dulu mencari script combat yang sudah ada dengan Search Scripts
- Diperintahkan untuk mengecek compile setiap script yang ditulisnya dengan Check Script, yang meng-compile kodenya di Studio tanpa menjalankannya (tanpa type check)
- Memasang titik undo sebelum dan sesudah setiap batch perubahan, jadi Ctrl+Z mundur satu batch setiap kali
RoCode tidak bisa membuat animasi ayunan atau mengunggahnya: buat di Animation Editor dan tempel ID-nya. Dengan plugin 3.9 atau lebih baru RoCode bisa menjalankan playtest singkat dan membaca error-nya, dan dengan plugin 3.9.11 atau lebih baru RoCode bisa mengendalikan karakter tes, tapi tidak mengklik di tampilan 3D untuk mengayun, jadi kamu sendiri yang mengetes ayunannya. Membuat game Roblox utuh dengan RoCode, sistem demi sistem menunjukkan di mana senjata ditempatkan. Cara RoCode tersambung ke Studio.
Pertanyaan umum
Kenapa pedangku mengenai pemain yang sama beberapa kali dalam satu ayunan?
Karena damage-nya diberikan dari Touched. Halaman debounce Roblox sendiri mencatat bahwa Touched terjadi beberapa kali berturut-turut dengan cepat untuk satu sentuhan, dan setiap part target bisa menyentuh bilah. Panduan ini mencari target dengan satu query kotak per ayunan dan menyimpan daftar, jadi setiap Humanoid kehilangan health sekali per ayunan.
Damage pedang sebaiknya di LocalScript atau Script?
Di Script, di server. Damage yang diberikan dari LocalScript hanya mengubah salinan game milik pemain itu sendiri, dan apa pun di perangkat pemain bisa diubah cheater. LocalScript sebaiknya hanya mendengar klik, memutar animasi dan memicu RemoteEvent.
Bagaimana cara menambahkan animasi ayunan ke pedang?
Buat di Animation Editor, atur prioritasnya ke Action, publish ke Roblox, dan masukkan asset ID-nya ke SWING_ANIMATION_ID sebagai rbxassetid:// diikuti angkanya. SwordClient memutarnya dengan Animator karakter. Animasi yang dimulai perangkat pemain pada karakter pemain itu sendiri diperlihatkan ke semua orang.
Kenapa animasi pedangku tidak diputar?
Cek tiga hal. Prioritasnya: Action berada di atas Movement, Idle dan Core, jadi ayunan Action diputar di atas berjalan dan berdiri, sedangkan prioritas lebih rendah bisa kalah. Pemiliknya: kalau game milik sebuah grup, publish animasinya dengan grup itu dipilih sebagai Creator. ID-nya: SWING_ANIMATION_ID harus berupa teks rbxassetid:// lengkap dengan angka animasimu, bukan string kosong.
Apa hitbox terbaik untuk pedang Roblox?
Untuk kebanyakan game, query kotak di server sekali per ayunan, seperti di panduan ini: satu panggilan ke GetPartBoundsInBox, tidak ada yang bisa dipalsukan client, dan tiga angka untuk disetel. Pakai GetPartsInPart dengan part berbentuk, atau raycast sepanjang bilah, hanya kalau jangkauan senjata jauh dari bentuk kotak. Perbandingan keempat metode.
Bagaimana cara mencegah pedang mengenai orang menembus dinding?
Sebelum memberi damage, tembakkan ray dari root part penyerang ke root part target, melewati karakter penyerang, dan hitung hit-nya hanya kalau hal pertama yang ditemui ray milik target. Versi 2 SwordService melakukan ini untuk setiap target.
Kenapa hit mendarat sebelum animasi ayunanku sampai ke target?
Server mengecek hitbox seketika saat klik tiba. Tunggu wind-up singkat dulu, misalnya 0,15 detik dengan task.delay, lalu cek bahwa penyerang masih hidup dan memegang pedang dan buat kotaknya, seperti yang dilakukan Versi 2.
Apakah exploiter masih bisa curang dengan pedang ini?
Mereka tidak bisa memilih siapa yang terkena, berapa damage sebuah hit atau seberapa sering mereka mengayun, karena server memutuskan ketiganya; keuntungan terbesar mereka adalah kelonggaran jaringan 0,1 detik pada cooldown. Mereka masih bisa menggerakkan karakternya sendiri, misalnya tepat ke samping seseorang, karena setiap perangkat mengendalikan gerakan karakternya sendiri. Pengecekan gerakan di sisi server adalah lapisan berikutnya.
Bagaimana cara membuat combat system dengan combo?
Simpan penghitung ayunan per pemain di server, reset setelah jeda singkat, dan pilih damage serta animasinya dari hitungan itu. Pengecekan hit-nya tetap sama. Mengembangkannya juga membahas knockback, kredit kill dan blocking.
Sumber dan bacaan lanjutan
- Roblox Creator Docs: In-game tools (dalam bahasa Inggris). membuat tool di Workspace, Handle, welding, Grip, anchoring, dan kenapa kebanyakan tool memakai LocalScript, Script dan RemoteEvent
- Roblox Creator Docs: WorldRoot:GetPartBoundsInBox (dalam bahasa Inggris). query kotak, OverlapParams dan FindPartsInRegion3 yang deprecated
- Roblox Creator Docs: Humanoid:TakeDamage (dalam bahasa Inggris). perlindungan ForceField, health bar dan regenerasi health
- Roblox Creator Docs: Network ownership (dalam bahasa Inggris). exploit pedang lewat Touched
- Roblox Creator Docs: Security tactics and cheat mitigation (dalam bahasa Inggris). jangan pernah percaya pada client
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (dalam bahasa Inggris). apa yang bisa dilakukan client dengan karakternya sendiri, dan pengecekan gerakan
- Roblox Creator Docs: Animation Editor (dalam bahasa Inggris). prioritas animasi dan publish
- Roblox Creator Docs: Animator:LoadAnimation (dalam bahasa Inggris). animasi mana yang direplikasi dari client
- Roblox Creator Docs: Debounce patterns (dalam bahasa Inggris). kenapa Touched terjadi beberapa kali untuk satu sentuhan
Cara kode ini dicek: setiap skrip di halaman ini lolos pemeriksa tipe strict Luau dengan definisi API Roblox (luau-lsp, 12 November 2026). Pemeriksaan tipe menangkap nama API yang salah ketik dan tipe yang keliru, bukan logika game, jadi uji dulu di Studio sebelum dipublikasikan.