🎮GTPS Cloud Docs
🎮

GTPS Cloud Lua API

Dokumentasi lengkap Lua scripting untuk GTPS Cloud. Buat sistem custom, events, dialog, dan masih banyak lagi — semua bisa lewat Lua!

🔔
44
Callbacks
👤
55
Player Methods
🌍
32
World Methods
⚡
194
Total Methods

🚀 Quick Start

Script Lua di GTPS Cloud diload otomatis saat server start. Buat file .lua dan upload lewat File Manager di dashboard.

Gunakan loadDataFromServer dan saveDataToServer untuk penyimpanan data permanen. Data akan tetap ada setelah server restart.

lua
-- Contoh script dasar GTPS Cloud
print("(Loaded) My Script - by Developer")

-- Daftarkan command
registerLuaCommand({
    command = "hello",
    roleRequired = 0,
    description = "Sapa player"
})

-- Handle command
onPlayerCommandCallback(function(world, player, fullCommand)
    local cmd = fullCommand:match("^(%S+)")
    if cmd ~= "hello" then return false end
    
    local name = player:getCleanName()
    player:onConsoleMessage("`6Halo, " .. name .. "! Welcome!")
    player:onTalkBubble(player:getNetID(), "Halo!", 1)
    return true
end)

-- Handle login
onPlayerLoginCallback(function(player)
    player:sendVariant({
        "OnAddNotification",
        "interface/science_button.rttex",
        "`wSelamat datang di server!",
        "audio/hub_open.wav"
    })
end)

⚠️ Hal Penting

🔒
Jangan pass Player object ke timer
Gunakan getUserID() dan panggil getPlayer() di dalam timer. Player object bisa invalid setelah disconnect.
💾
Simpan data di onAutoSaveRequest
Server memanggil ini secara berkala. Simpan semua data Lua kamu di sini untuk persistensi.
⚡
Hindari heavy computation di onTick/onWorldTick
Callback ini dipanggil sangat sering (setiap 100ms). Loop besar atau kalkulasi berat bisa lag server.
🔁
Gunakan coroutine untuk HTTP requests
Semua http.get() dan http.post() harus dibungkus dalam coroutine.wrap() agar tidak blocking.

🎨 Color Codes

Gunakan backtick + angka/huruf untuk warna text di console message, dialog, dll.

`0
White
`1
Purple
`2
Green
`3
Yellow
`4
Red
`5
Cyan
`6
Gold
`7
Orange
`8
Gray
`9
Blue
`w
White2
`o
Orange2