7. Buat sistem upgrade

Yang akan kamu pelajari

Di akhir materi ini, kamu akan bisa:

• Menghubungkan client dan server menggunakan RemoteFunction di ReplicatedStorage.
• Membuat JumpService di ServerScriptService untuk memproses upgrade lompatan.
• Memvalidasi saldo koin di server sebelum menyetujui transaksi.
• Memotong koin dengan PlayerData.updateValue dan memperbarui JumpPower karakter.
• Menjaga nilai JumpPower tetap aktif saat karakter respawn dengan CharacterAdded.

Sebelum mulai

• Selesaikan materi Buat checkpoint.
• Pastikan modul Leaderboard dan PlayerData sudah ada di ServerStorage.
• Kumpulkan beberapa koin saat playtest untuk mencoba pembelian upgrade.

1. Siapkan RemoteFunction di ReplicatedStorage

ReplicatedStorage adalah tempat menyimpan objek yang dapat diakses bersama oleh client (pemain) dan server.

1. Di Explorer, arahkan kursor ke ReplicatedStorage, lalu buat Folder bernama Instances.
2. Di dalam folder Instances, tambahkan sebuah RemoteFunction.
3. Ubah namanya menjadi IncreaseJumpPowerFunction.

2. Buat JumpService di ServerScriptService

1. Di ServerScriptService, buat sebuah Script baru.
2. Beri nama JumpService.
3. Isi kodenya dengan:

Diagram Alur

flowchart LR
    classDef trigger fill:#0369a1,stroke:#38bdf8,stroke-width:2px,color:#ffffff;
    classDef condition fill:#b45309,stroke:#f59e0b,stroke-width:2px,color:#ffffff;
    classDef action fill:#047857,stroke:#10b981,stroke-width:2px,color:#ffffff;
    classDef finish fill:#334155,stroke:#94a3b8,stroke-width:2px,color:#ffffff;

    Invoke["<b>Panggilan Remote</b><br/>OnServerInvoke"]:::trigger
    Check{"<b>Validasi Saldo</b><br/>Koin >= 5?"}:::condition
    Upgrade["<b>Terapkan Upgrade</b><br/>Potong 5 koin & Jump +30"]:::action
    UpdateBoard["<b>Update Skor</b><br/>Leaderboard.setStat"]:::action
    Success(["<b>Sukses</b><br/>return true"]):::finish
    Reject(["<b>Ditolak</b><br/>return false"]):::finish

    Invoke --> Check
    Check -- "Ya" --> Upgrade --> UpdateBoard --> Success
    Check -- "Tidak" --> Reject

Penjelasan Baris per Baris

• Baris 1-13: Mengambil service dan memuat objek RemoteFunction dari ReplicatedStorage.Instances.
• Baris 15-18: Menentukan parameter upgrade: kenaikan lompatan (JUMP_POWER_INCREMENT = 30) dan harga koin (JUMP_COIN_COST = 5).
• Baris 20-33: Fungsi updateJumpPower memperbarui nilai Jump di PlayerData, menerapkan humanoid.JumpPower = newJumpPower, dan memperbarui angka di Leaderboard.
• Baris 35-55: onPurchaseJumpIncrease adalah callback server ketika client meminta pembelian. Server mengecek apakah saldo koin cukup. Jika cukup, lompatan dinaikkan dan koin dipotong.
• Baris 57-65: onCharacterAdded memastikan saat pemain respawn, kekuatan lompatan yang sudah dibeli tetap diterapkan ke karakter baru.
• Baris 78: Menyambungkan fungsi ke IncreaseJumpPowerFunction.OnServerInvoke.

Kode Lengkap

ServerScriptService > JumpService (Script)

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
local Players = game:GetService("Players")

-- Modules
local Leaderboard = require(ServerStorage:WaitForChild("Leaderboard"))
local PlayerData = require(ServerStorage:WaitForChild("PlayerData"))

-- Events
local instancesFolder = ReplicatedStorage:WaitForChild("Instances")
local IncreaseJumpPowerFunction = instancesFolder:WaitForChild("IncreaseJumpPowerFunction")

local JUMP_KEY_NAME = PlayerData.JUMP_KEY_NAME
local COIN_KEY_NAME = PlayerData.COIN_KEY_NAME
local JUMP_POWER_INCREMENT = 30
local JUMP_COIN_COST = 5

local function updateJumpPower(player, updateFunction)
    local newJumpPower = PlayerData.updateValue(player, JUMP_KEY_NAME, updateFunction)

    local character = player.Character
    if character then
        local humanoid = character:FindFirstChildWhichIsA("Humanoid")
        if humanoid then
            humanoid.UseJumpPower = true
            humanoid.JumpPower = newJumpPower
            Leaderboard.setStat(player, JUMP_KEY_NAME, newJumpPower)
        end
    end
end

local function onPurchaseJumpIncrease(player)
    local coinAmount = PlayerData.getValue(player, COIN_KEY_NAME) or 0
    if coinAmount < JUMP_COIN_COST then
        return false
    end

    -- Tambah kekuatan lompatan
    updateJumpPower(player, function(oldJumpPower)
        oldJumpPower = oldJumpPower or 50
        return oldJumpPower + JUMP_POWER_INCREMENT
    end)

    -- Potong saldo koin
    local newCoinAmount = PlayerData.updateValue(player, COIN_KEY_NAME, function(oldCoinAmount)
        oldCoinAmount = oldCoinAmount or 0
        return oldCoinAmount - JUMP_COIN_COST
    end)
    Leaderboard.setStat(player, COIN_KEY_NAME, newCoinAmount)

    print(player.Name .. " berhasil upgrade Jump Power seharga " .. JUMP_COIN_COST .. " koin!")
    return true
end

local function onCharacterAdded(player, character)
    local humanoid = character:WaitForChild("Humanoid", 5)
    local currentJumpPower = PlayerData.getValue(player, JUMP_KEY_NAME) or 50
    if humanoid then
        humanoid.UseJumpPower = true
        humanoid.JumpPower = currentJumpPower
        Leaderboard.setStat(player, JUMP_KEY_NAME, currentJumpPower)
    end
end

local function onPlayerAdded(player)
    player.CharacterAdded:Connect(function(char)
        onCharacterAdded(player, char)
    end)

    if player.Character then
        onCharacterAdded(player, player.Character)
    end
end

for _, player in ipairs(Players:GetPlayers()) do
    onPlayerAdded(player)
end

IncreaseJumpPowerFunction.OnServerInvoke = onPurchaseJumpIncrease
Players.PlayerAdded:Connect(onPlayerAdded)

Prompt MCP

Salin prompt berikut ke chat AI di Visual Studio Code (dengan Roblox Studio MCP aktif):

Prompt AI / MCP — Buat Skrip JumpService

Buatkan Script bernama "JumpService" di ServerScriptService:
- Layani RemoteFunction IncreaseJumpPowerFunction di ReplicatedStorage.Instances.
- Jika koin >= 5: kurangi 5 koin, tambah Jump Power +30, dan update leaderboard.
- Terapkan Jump Power saat pemain respawn.

3. Trigger Pembelian dari Client / Interaksi

Untuk memanggil fungsi upgrade di server dari tombol UI (ScreenGui) atau skrip interaksi client di StarterPlayerScripts, gunakan pemanggilan InvokeServer():

Diagram Alur

flowchart LR
    classDef trigger fill:#0369a1,stroke:#38bdf8,stroke-width:2px,color:#ffffff;
    classDef condition fill:#b45309,stroke:#f59e0b,stroke-width:2px,color:#ffffff;
    classDef action fill:#047857,stroke:#10b981,stroke-width:2px,color:#ffffff;
    classDef finish fill:#334155,stroke:#94a3b8,stroke-width:2px,color:#ffffff;

    Call["<b>InvokeServer</b><br/>Kirim permintaan beli"]:::trigger
    Check{"<b>Respon Server</b><br/>Hasil boolean?"}:::condition
    Success(["<b>Sukses</b><br/>'Upgrade berhasil!'"]):::action
    Fail(["<b>Gagal</b><br/>'Koin kurang!'"]):::finish

    Call --> Check
    Check -- "true" --> Success
    Check -- "false" --> Fail

Penjelasan Baris per Baris

• Baris 1-3: Mengambil referensi service ReplicatedStorage dan mencari objek IncreaseJumpPowerFunction di dalam folder Instances.
• Baris 5: Memanggil server dengan method :InvokeServer(). Client akan menunggu respon balasan (boolean true atau false) dari server.
• Baris 7-11: Memeriksa nilai kembalian server; jika true berarti koin cukup dan upgrade aktif, jika false berarti transaksi ditolak karena saldo koin kurang.

Kode Lengkap

StarterPlayerScripts > UpgradeTrigger (LocalScript)

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local instancesFolder = ReplicatedStorage:WaitForChild("Instances")
local IncreaseJumpPowerFunction = instancesFolder:WaitForChild("IncreaseJumpPowerFunction")

local success = IncreaseJumpPowerFunction:InvokeServer()

if success then
    print("Upgrade berhasil dibeli!")
else
    print("Koin tidak mencukupi!")
end

Prompt MCP

Salin prompt berikut ke chat AI di Visual Studio Code (dengan Roblox Studio MCP aktif):

Prompt AI / MCP — Buat Skrip UpgradeTrigger

Buatkan LocalScript bernama "UpgradeTrigger" di StarterPlayerScripts:
- Panggil IncreaseJumpPowerFunction di ReplicatedStorage.Instances via InvokeServer.
- Cetak status berhasil atau koin kurang ke Output.

Checkpoint

Materi ini selesai jika:

• IncreaseJumpPowerFunction berada di dalam ReplicatedStorage.Instances;
• JumpService aktif di dalam ServerScriptService;
• pembelian hanya berhasil jika koin pemain minimal 5;
• saat upgrade dibeli, nilai Coins berkurang 5 dan Jump bertambah 30;
• kekuatan lompatan tetap bertahan saat karakter respawn;
• tidak ada pesan error merah di jendela Output.

Tantangan

Cobalah buat batasan maksimal level lompatan (misal maksimal JumpPower = 140) di dalam fungsi onPurchaseJumpIncrease agar karakter tidak melompat terlalu tinggi melompati seluruh peta.

Rangkuman

Kamu telah membuat sistem upgrade client-server yang aman menggunakan RemoteFunction, JumpService, dan PlayerData. Seluruh validasi ekonomi dan peningkatan stat dikontrol penuh oleh server.