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.
--!strictlocal 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") :: RemoteEventlocal ReloadRequest = Remotes:WaitForChild("ReloadRequest") :: RemoteEventlocal 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 = handleend
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 endend
return WeaponServicePenjelasan Teknis & Kalibrasi Penting:
Section titled “Penjelasan Teknis & Kalibrasi Penting:”- Posisi Pegang Pistol yang Presisi: Di baris 61-64, pistol dipasang pada
RightHandmenggunakan Weld dengan rotasimath.rad(90)dan offsetC1 = 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
castBulletmenembakkan 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.