Lewati ke konten

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.

ServerScriptService > Services > PlayerDataService (ModuleScript)
--!strict
local 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)
end
end
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 data
end
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 data
end
function PlayerDataService.GetAll(): { [Player]: PlayerData }
return sessionData
end
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)
end
end
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 false
end
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)
end
end
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
end
end
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 PlayerDataService
  • 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 lewat PlayerStatsUpdated agar bar darah dan angka uang di layar langsung berubah.