Lewati ke konten

Bab 6: Manajer Audio & Efek Suara (ReplicatedStorage > Shared > SoundManager)

Bagian 2 • Audio & Musik

Sebuah game zombie tanpa suara tembakan dan musik yang menegangkan akan terasa hambar. Modul ini bertanggung jawab memutar 10 suara resmi gratis dari Roblox Creator Store secara otomatis dengan sistem transisi musik halus (Fade-in & Fade-out).

Langkah Pembuatan: Di dalam ReplicatedStorage > Shared, klik + lalu pilih ModuleScript. Beri nama SoundManager.

ReplicatedStorage > Shared > SoundManager (ModuleScript)
--!strict
local SoundService = game:GetService("SoundService")
local TweenService = game:GetService("TweenService")
local Debris = game:GetService("Debris")
local SoundManager = {}
local SOUND_DEFINITIONS = {
-- BGM Musik Latar (Looping terus menerus)
BGM_Ambient = { Id = "rbxassetid://126189820698933", DefaultVolume = 0.35, Looped = true },
BGM_Boss = { Id = "rbxassetid://94202180951351", DefaultVolume = 0.45, Looped = true },
-- SFX Efek Suara
PistolShot = { Id = "rbxassetid://127604219525464", DefaultVolume = 0.7, Looped = false },
ShotgunShot = { Id = "rbxassetid://132255180302885", DefaultVolume = 0.85, Looped = false },
BatSwing = { Id = "rbxassetid://5789211405", DefaultVolume = 0.6, Looped = false },
BatHit = { Id = "rbxassetid://126976659766267", DefaultVolume = 0.75, Looped = false },
Reload = { Id = "rbxassetid://117963160131194", DefaultVolume = 0.65, Looped = false },
ZombieGroan = { Id = "rbxassetid://121066883602737", DefaultVolume = 0.55, Looped = false },
CashBuy = { Id = "rbxassetid://134810204798705", DefaultVolume = 0.7, Looped = false },
WaveClear = { Id = "rbxassetid://132574644259001", DefaultVolume = 0.75, Looped = false },
}
local currentBGM: Sound? = nil
local currentBGMName: string? = nil
-- Wadah audio di SoundService
local sfxFolder = SoundService:FindFirstChild("SFX")
if not sfxFolder then
sfxFolder = Instance.new("Folder")
sfxFolder.Name = "SFX"
sfxFolder.Parent = SoundService
end
local bgmFolder = SoundService:FindFirstChild("BGM")
if not bgmFolder then
bgmFolder = Instance.new("Folder")
bgmFolder.Name = "BGM"
bgmFolder.Parent = SoundService
end
function SoundManager.PlaySFX(name: string, parentPart: Instance?, volumeScale: number?): Sound?
local def = SOUND_DEFINITIONS[name]
if not def then
warn("[SoundManager] SFX not found: " .. name)
return nil
end
local sound = Instance.new("Sound")
sound.Name = name
sound.SoundId = def.Id
sound.Volume = def.DefaultVolume * (volumeScale or 1.0)
sound.Looped = false
if parentPart and parentPart:IsA("BasePart") then
sound.RollOffMode = Enum.RollOffMode.Linear
sound.MinDistance = 10
sound.MaxDistance = 100
sound.Parent = parentPart
else
sound.Parent = sfxFolder
end
sound:Play()
sound.Ended:Once(function()
sound:Destroy()
end)
-- Fallback pembersihan otomatis dalam 8 detik
Debris:AddItem(sound, 8)
return sound
end
function SoundManager.PlayBGM(name: string, fadeTime: number?)
if currentBGMName == name and currentBGM and currentBGM.IsPlaying then
return
end
local def = SOUND_DEFINITIONS[name]
if not def then
warn("[SoundManager] BGM not found: " .. name)
return
end
local duration = fadeTime or 1.0
-- Fade out semua BGM lama yang sedang berbunyi
for _, sound in ipairs(bgmFolder:GetChildren()) do
if sound:IsA("Sound") then
local fadeOut = TweenService:Create(sound, TweenInfo.new(duration, Enum.EasingStyle.Quad, Enum.EasingDirection.In), {
Volume = 0
})
fadeOut:Play()
fadeOut.Completed:Once(function()
sound:Stop()
sound:Destroy()
end)
end
end
local newBGM = Instance.new("Sound")
newBGM.Name = name
newBGM.SoundId = def.Id
newBGM.Volume = 0
newBGM.Looped = true
newBGM.Parent = bgmFolder
newBGM:Play()
-- Fade in BGM baru agar transisi mulus
TweenService:Create(newBGM, TweenInfo.new(duration, Enum.EasingStyle.Quad, Enum.EasingDirection.Out), {
Volume = def.DefaultVolume
}):Play()
currentBGM = newBGM
currentBGMName = name
end
function SoundManager.StopBGM(fadeTime: number?)
local duration = fadeTime or 1.0
for _, sound in ipairs(bgmFolder:GetChildren()) do
if sound:IsA("Sound") then
local fadeOut = TweenService:Create(sound, TweenInfo.new(duration, Enum.EasingStyle.Quad), {
Volume = 0
})
fadeOut:Play()
fadeOut.Completed:Once(function()
sound:Stop()
sound:Destroy()
end)
end
end
currentBGM = nil
currentBGMName = nil
end
return SoundManager
Nama Suara Asset ID Resmi Kapan Diputar?
BGM_Ambient rbxassetid://126189820698933 Musik latar horor malam di lobi, intermisi, dan Wave 1-3.
BGM_Boss rbxassetid://94202180951351 Musik bertempo cepat dan mendebarkan saat Boss Wave 4 & 5 muncul!
PistolShot rbxassetid://127604219525464 Suara dentuman pistol setiap kali peluru ditembakkan.
ShotgunShot rbxassetid://132255180302885 Dentuman keras shotgun dengan efek gema bass tebal.
BatSwing rbxassetid://5789211405 Efek desingan angin saat tongkat baseball diayunkan.
BatHit rbxassetid://126976659766267 Suara hantaman tumpul saat pemukul mengenai tubuh zombie.
Reload rbxassetid://117963160131194 Suara kokang magasin senjata saat mengisi ulang peluru [R].
ZombieGroan rbxassetid://121066883602737 Geraman serak zombie saat mengejar dan menyerang pemain.
CashBuy rbxassetid://134810204798705 Efek denting kasir toko saat berhasil membeli upgrade/senjata.
WaveClear rbxassetid://132574644259001 Fanfare nada kemenangan saat semua zombie dalam wave musnah.