Bab 8: Buku Data Pemain Server (ServerScriptService > Services > PlayerDataService)
Bagian 2 • Data Server
Modul ini bertindak sebagai bank dan buku rapor pemain di server. Semua data seperti sisa darah (HP), darah maksimal, uang tabungan, senjata yang sudah dibeli, dan sisa peluru dicatat di sini secara aman.
Langkah Pembuatan: Di dalam ServerScriptService > Services, klik + lalu pilih ModuleScript. Beri nama PlayerDataService.
--!strictlocal Players = game:GetService("Players")local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Config = require(ReplicatedStorage:WaitForChild("Config") :: ModuleScript)local Signal = require(ReplicatedStorage:WaitForChild("Shared"):WaitForChild("Signal") :: ModuleScript)local Remotes = ReplicatedStorage:WaitForChild("Remotes")local PlayerStatsUpdated = Remotes:WaitForChild("PlayerStatsUpdated") :: RemoteEvent
local PlayerDataService = {}PlayerDataService.PlayerDied = Signal.new()PlayerDataService.StatsChanged = Signal.new()
export type PlayerData = { Health: number, MaxHealth: number, Speed: number, Cash: number, DamageMultiplier: number, IsAlive: boolean, Upgrades: { [string]: number }, UnlockedWeapons: { [string]: boolean }, EquippedWeapon: string, CurrentAmmo: { [string]: number }, ReserveAmmo: { [string]: number },}
local sessionData: { [Player]: PlayerData } = {}
function PlayerDataService.Init() Players.PlayerAdded:Connect(function(player) PlayerDataService.CreateData(player) end)
Players.PlayerRemoving:Connect(function(player) sessionData[player] = nil end)
for _, player in ipairs(Players:GetPlayers()) do PlayerDataService.CreateData(player) endend
function PlayerDataService.CreateData(player: Player): PlayerData local data: PlayerData = { Health = Config.Player.BaseHealth, MaxHealth = Config.Player.BaseHealth, Speed = Config.Player.BaseSpeed, Cash = Config.Player.StartingCash, DamageMultiplier = 1.0, IsAlive = true, Upgrades = { MaxHealthUpgrade = 0, SpeedUpgrade = 0, DamageUpgrade = 0, }, UnlockedWeapons = { Bat = true, Pistol = true, Shotgun = false, }, EquippedWeapon = "Pistol", CurrentAmmo = { Pistol = Config.Weapons.Pistol.ClipSize, Shotgun = Config.Weapons.Shotgun.ClipSize, }, ReserveAmmo = { Pistol = Config.Weapons.Pistol.MaxReserveAmmo, Shotgun = Config.Weapons.Shotgun.MaxReserveAmmo, }, } sessionData[player] = data PlayerDataService.Sync(player) return dataend
function PlayerDataService.Get(player: Player): PlayerData? if not player or not player:IsA("Player") then return nil end local data = sessionData[player] if not data then data = PlayerDataService.CreateData(player) end return dataend
function PlayerDataService.GetAll(): { [Player]: PlayerData } return sessionDataend
function PlayerDataService.Sync(player: Player) local data = sessionData[player] if not data then return end PlayerStatsUpdated:FireClient(player, data) PlayerDataService.StatsChanged:Fire(player, data)end
function PlayerDataService.AddCash(player: Player, amount: number) local data = sessionData[player] if data and amount > 0 then data.Cash += amount PlayerDataService.Sync(player) endend
function PlayerDataService.DeductCash(player: Player, amount: number): boolean local data = sessionData[player] if data and data.Cash >= amount then data.Cash -= amount PlayerDataService.Sync(player) return true end return falseend
function PlayerDataService.SetHealth(player: Player, newHealth: number) local data = sessionData[player] if not data then return end
data.Health = math.clamp(newHealth, 0, data.MaxHealth) local char = player.Character if char then local humanoid = char:FindFirstChildOfClass("Humanoid") if humanoid then humanoid.MaxHealth = data.MaxHealth humanoid.Health = data.Health end end
PlayerDataService.Sync(player)
if data.Health <= 0 and data.IsAlive then data.IsAlive = false PlayerDataService.PlayerDied:Fire(player) PlayerDataService.Sync(player) endend
function PlayerDataService.ApplyStatsToCharacter(player: Player) local data = sessionData[player] local char = player.Character if not data or not char then return end
local humanoid = char:FindFirstChildOfClass("Humanoid") if humanoid then humanoid.MaxHealth = data.MaxHealth humanoid.Health = data.Health humanoid.WalkSpeed = data.Speed endend
function PlayerDataService.RevivePlayer(player: Player, spawnCFrame: CFrame?) local data = sessionData[player] if not data then return end
data.IsAlive = true data.Health = data.MaxHealth player:LoadCharacter() task.wait(0.1)
local char = player.Character if char then local root = char:FindFirstChild("HumanoidRootPart") :: BasePart? if root and spawnCFrame then root.CFrame = spawnCFrame + Vector3.new(0, 3, 0) end PlayerDataService.ApplyStatsToCharacter(player) end PlayerDataService.Sync(player)end
function PlayerDataService.ResetForNewGame(player: Player) local data = sessionData[player] if not data then return end
data.Health = Config.Player.BaseHealth data.MaxHealth = Config.Player.BaseHealth data.Speed = Config.Player.BaseSpeed data.Cash = Config.Player.StartingCash data.DamageMultiplier = 1.0 data.IsAlive = true data.Upgrades.MaxHealthUpgrade = 0 data.Upgrades.SpeedUpgrade = 0 data.Upgrades.DamageUpgrade = 0 data.UnlockedWeapons.Shotgun = false data.EquippedWeapon = "Pistol" data.CurrentAmmo.Pistol = Config.Weapons.Pistol.ClipSize data.CurrentAmmo.Shotgun = Config.Weapons.Shotgun.ClipSize data.ReserveAmmo.Pistol = Config.Weapons.Pistol.MaxReserveAmmo data.ReserveAmmo.Shotgun = Config.Weapons.Shotgun.MaxReserveAmmo
PlayerDataService.Sync(player)end
return PlayerDataServicePenjelasan Fungsi-Fungsi Kunci:
Section titled “Penjelasan Fungsi-Fungsi Kunci:”PlayerDataService.CreateData(player): Memberi modal awal berupa 100 HP, kecepatan 16, uang $150, serta membuka senjata Baseball Bat dan M1911 Pistol.PlayerDataService.AddCash(player, amount): Menambah uang pemain setiap kali berhasil membunuh zombie atau menyelesaikan wave.PlayerDataService.DeductCash(player, amount): Mengurangi uang saat belanja di toko (akan menolak transaksi jika uang tidak cukup).PlayerDataService.SetHealth(player, newHealth): Mengubah darah pemain. Jika darah menyentuh 0, otomatis memicu sinyal kematian pemain (PlayerDied).PlayerDataService.Sync(player): Mengirimkan data terbaru ke laptop/HP pemain lewatPlayerStatsUpdatedagar bar darah dan angka uang di layar langsung berubah.