Lewati ke konten

Bab 10: Sistem Senjata di Server (ServerScriptService > Services > WeaponService)

Bagian 3 • Sistem Senjata

Modul ini mengelola 3 senjata yang bisa digunakan pemain: Baseball Bat (serangan area jarak dekat), M1911 Pistol (tembakan akurat lurus), dan Pump Shotgun (6 butir pelet menyebar ber-damage tinggi).

Langkah Pembuatan: Di dalam ServerScriptService > Services, klik + lalu pilih ModuleScript. Beri nama WeaponService.

ServerScriptService > Services > WeaponService (ModuleScript)
--!strict
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
local Debris = game:GetService("Debris")
local Config = require(ReplicatedStorage:WaitForChild("Config") :: ModuleScript)
local Remotes = ReplicatedStorage:WaitForChild("Remotes")
local AttackRequest = Remotes:WaitForChild("AttackRequest") :: RemoteEvent
local ReloadRequest = Remotes:WaitForChild("ReloadRequest") :: RemoteEvent
local EquipRequest = Remotes:WaitForChild("EquipRequest") :: RemoteEvent
local PlayerDataService = require(script.Parent:WaitForChild("PlayerDataService") :: ModuleScript)
local CombatService = require(script.Parent:WaitForChild("CombatService") :: ModuleScript)
local WeaponService = {}
local lastAttackTimes: { [Player]: { [string]: number } } = {}
local isReloading: { [Player]: { [string]: boolean } } = {}
local function updateVisualWeapon(player: Player, weaponKey: string)
local char = player.Character
if not char then return end
local oldVisual = char:FindFirstChild("EquippedWeaponVisual")
if oldVisual then
oldVisual:Destroy()
end
local rightArm = char:FindFirstChild("RightHand") or char:FindFirstChild("Right Arm")
if not rightArm or not rightArm:IsA("BasePart") then return end
local weaponsFolder = ServerStorage:WaitForChild("Weapons")
local template = weaponsFolder:FindFirstChild(weaponKey)
if not template then return end
local model = template:Clone() :: Model
model.Name = "EquippedWeaponVisual"
local handle = model.PrimaryPart or model:FindFirstChild("Handle") :: BasePart?
if not handle then return end
for _, p in ipairs(model:GetDescendants()) do
if p:IsA("BasePart") then
p.CanCollide = false
p.CanTouch = false
p.CanQuery = false
p.Massless = true
p.Anchored = false
end
end
model.Parent = char
local weld = Instance.new("Weld")
weld.Name = "WeaponWeld"
weld.Part0 = rightArm
weld.Part1 = handle
if weaponKey == "Bat" then
weld.C0 = CFrame.new(0, -0.85, -0.2) * CFrame.Angles(math.rad(-50), 0, 0)
elseif weaponKey == "Pistol" then
-- Kalibrasi presisi: Laras menghadap lurus ke depan sejajar arah pandang
weld.C1 = CFrame.new(-0.35, -0.05, 0)
weld.C0 = CFrame.new(0, -0.1, -0.05) * CFrame.Angles(0, math.rad(90), 0)
elseif weaponKey == "Shotgun" then
weld.C1 = CFrame.new(0, -0.2, 0.78)
weld.C0 = CFrame.new(0, -0.2, -0.1)
end
weld.Parent = handle
end
local function replicateTracer(fromPos: Vector3, toPos: Vector3)
local dist = (toPos - fromPos).Magnitude
if dist < 0.5 then return end
local tracer = Instance.new("Part")
tracer.Name = "BulletTracer"
tracer.Size = Vector3.new(0.15, 0.15, dist)
tracer.CFrame = CFrame.lookAt(fromPos, toPos) * CFrame.new(0, 0, -dist / 2)
tracer.Anchored = true
tracer.CanCollide = false
tracer.Material = Enum.Material.Neon
tracer.Color = Color3.fromRGB(255, 220, 120)
tracer.Transparency = 0.2
tracer.Parent = workspace
Debris:AddItem(tracer, 0.06)
end
local function castBullet(origin: Vector3, dir: Vector3, range: number, ignoreChar: Model): (RaycastResult?, Vector3)
local filterList: { Instance } = { ignoreChar }
local arenaSpawns = workspace:FindFirstChild("Arena") and workspace.Arena:FindFirstChild("PlayerSpawns")
if arenaSpawns then
table.insert(filterList, arenaSpawns)
end
local rayParams = RaycastParams.new()
rayParams.FilterDescendantsInstances = filterList
rayParams.FilterType = Enum.RaycastFilterType.Exclude
local currentOrigin = origin
local remainingDist = range
local currentDir = dir.Unit
for _ = 1, 5 do
if remainingDist <= 0 then break end
local result = workspace:Raycast(currentOrigin, currentDir * remainingDist, rayParams)
if not result then
return nil, currentOrigin + (currentDir * remainingDist)
end
local hitPart = result.Instance
local hitModel = hitPart:FindFirstAncestorOfClass("Model")
if hitModel and hitModel:GetAttribute("IsZombie") then
return result, result.Position
end
if not hitPart.CanCollide or hitPart:IsA("SpawnLocation") or hitPart.Transparency >= 0.6 or hitPart.Name == "BulletTracer" or hitPart.Name == "EnemySpawn" then
table.insert(filterList, hitPart)
rayParams.FilterDescendantsInstances = filterList
local stepDist = (result.Position - currentOrigin).Magnitude
remainingDist = remainingDist - stepDist - 0.1
currentOrigin = result.Position + (currentDir * 0.1)
else
return result, result.Position
end
end
return nil, origin + (dir.Unit * range)
end
function WeaponService.Init()
AttackRequest.OnServerEvent:Connect(function(player: Player, weaponKey: any, origin: any, targetDir: any)
if typeof(weaponKey) ~= "string" or typeof(origin) ~= "Vector3" or typeof(targetDir) ~= "Vector3" then
return
end
WeaponService.ProcessAttack(player, weaponKey, origin, targetDir)
end)
ReloadRequest.OnServerEvent:Connect(function(player: Player, weaponKey: any)
if typeof(weaponKey) ~= "string" then return end
WeaponService.ProcessReload(player, weaponKey)
end)
EquipRequest.OnServerEvent:Connect(function(player: Player, weaponKey: any)
if typeof(weaponKey) ~= "string" then return end
WeaponService.EquipWeapon(player, weaponKey)
end)
Players.PlayerRemoving:Connect(function(player)
lastAttackTimes[player] = nil
isReloading[player] = nil
end)
end
function WeaponService.EquipWeapon(player: Player, weaponKey: string)
local pData = PlayerDataService.Get(player)
if not pData or not pData.IsAlive then return end
local wCfg = Config.Weapons[weaponKey]
if not wCfg then return end
if not pData.UnlockedWeapons[weaponKey] then
return
end
pData.EquippedWeapon = weaponKey
updateVisualWeapon(player, weaponKey)
PlayerDataService.Sync(player)
end
function WeaponService.ProcessReload(player: Player, weaponKey: string)
local pData = PlayerDataService.Get(player)
if not pData or not pData.IsAlive then return end
local wCfg = Config.Weapons[weaponKey]
if not wCfg or wCfg.Type == "Melee" then return end
if not isReloading[player] then
isReloading[player] = {}
end
if isReloading[player][weaponKey] then return end
local curClip = pData.CurrentAmmo[weaponKey] or 0
local reserve = pData.ReserveAmmo[weaponKey] or 0
if curClip >= wCfg.ClipSize or reserve <= 0 then
return
end
isReloading[player][weaponKey] = true
task.delay(wCfg.ReloadTime, function()
if not isReloading[player] then return end
isReloading[player][weaponKey] = false
local currentData = PlayerDataService.Get(player)
if not currentData or not currentData.IsAlive then return end
local needed = wCfg.ClipSize - (currentData.CurrentAmmo[weaponKey] or 0)
local toAdd = math.min(needed, currentData.ReserveAmmo[weaponKey] or 0)
currentData.CurrentAmmo[weaponKey] = (currentData.CurrentAmmo[weaponKey] or 0) + toAdd
currentData.ReserveAmmo[weaponKey] = math.max(0, (currentData.ReserveAmmo[weaponKey] or 0) - toAdd)
PlayerDataService.Sync(player)
end)
end
function WeaponService.ProcessAttack(player: Player, weaponKey: string, clientOrigin: Vector3, dir: Vector3)
local pData = PlayerDataService.Get(player)
if not pData or not pData.IsAlive then return end
if pData.EquippedWeapon ~= weaponKey or not pData.UnlockedWeapons[weaponKey] then
return
end
local wCfg = Config.Weapons[weaponKey]
if not wCfg then return end
if not lastAttackTimes[player] then
lastAttackTimes[player] = {}
end
local now = os.clock()
local lastAtk = lastAttackTimes[player][weaponKey] or 0
if (now - lastAtk) < (wCfg.AttackCooldown * 0.85) then
return
end
lastAttackTimes[player][weaponKey] = now
local char = player.Character
if not char then return end
local hrp = char:FindFirstChild("HumanoidRootPart") :: BasePart?
if not hrp then return end
if (clientOrigin - hrp.Position).Magnitude > 14 then
clientOrigin = hrp.Position + Vector3.new(0, 1.5, 0)
end
local unitDir = dir.Magnitude > 0 and dir.Unit or hrp.CFrame.LookVector
-- SERANGAN MELEE (Tongkat Bat)
if wCfg.Type == "Melee" then
local overlapParams = OverlapParams.new()
overlapParams.FilterDescendantsInstances = { char }
overlapParams.FilterType = Enum.RaycastFilterType.Exclude
local hitBoxCenter = hrp.Position + (unitDir * (wCfg.Range * 0.5))
local hitParts = workspace:GetPartBoundsInBox(CFrame.new(hitBoxCenter, hitBoxCenter + unitDir), Vector3.new(6, 6, wCfg.Range), overlapParams)
local hitZombies = {}
for _, part in ipairs(hitParts) do
local zModel = part:FindFirstAncestorOfClass("Model")
if zModel and zModel:GetAttribute("IsZombie") and not hitZombies[zModel] then
hitZombies[zModel] = true
CombatService.DamageZombie(player, zModel, wCfg.Damage, part)
end
end
-- SERANGAN JARAK JAUH (Pistol & Shotgun)
elseif wCfg.Type == "Ranged" then
local clip = pData.CurrentAmmo[weaponKey] or 0
if clip <= 0 then
return
end
pData.CurrentAmmo[weaponKey] = clip - 1
PlayerDataService.Sync(player)
if weaponKey == "Pistol" then
local result, hitPos = castBullet(clientOrigin, unitDir, wCfg.Range, char)
replicateTracer(clientOrigin, hitPos)
if result then
local hitModel = result.Instance:FindFirstAncestorOfClass("Model")
if hitModel and hitModel:GetAttribute("IsZombie") then
CombatService.DamageZombie(player, hitModel, wCfg.Damage, result.Instance)
end
end
elseif weaponKey == "Shotgun" then
local pellets = wCfg.Pellets or 6
local spreadRad = math.rad(wCfg.SpreadAngle or 6.0)
for _ = 1, pellets do
local spreadX = (math.random() - 0.5) * spreadRad
local spreadY = (math.random() - 0.5) * spreadRad
local pelletDir = (CFrame.new(Vector3.zero, unitDir) * CFrame.Angles(spreadY, spreadX, 0)).LookVector
local result, hitPos = castBullet(clientOrigin, pelletDir, wCfg.Range, char)
replicateTracer(clientOrigin, hitPos)
if result then
local hitModel = result.Instance:FindFirstAncestorOfClass("Model")
if hitModel and hitModel:GetAttribute("IsZombie") then
CombatService.DamageZombie(player, hitModel, wCfg.Damage, result.Instance)
end
end
end
end
end
end
return WeaponService
  • Posisi Pegang Pistol yang Presisi: Di baris 61-64, pistol dipasang pada RightHand menggunakan Weld dengan rotasi math.rad(90) dan offset C1 = CFrame.new(-0.35, -0.05, 0). Ini memastikan laras pistol menghadap 100% lurus ke depan dan tangan pemain menggenggam gagang secara alami tepat di bawah pelatuk!
  • Raycast Penembus Rintangan: Fungsi castBullet menembakkan sinar tak kasat mata (Raycast). Jika mengenai part transparan atau spawn location, sinar akan terus menembus hingga mengenai tubuh zombie.
  • Garis Kilatan Peluru (Tracer): Setiap tembakan memunculkan part neon kuning tipis berkecepatan tinggi selama 0.06 detik untuk memberikan efek visual peluru terbang yang keren.