Koneksi
client:connect()
| Field | Type |
|---|---|
| Signature | (self: Client) → string? |
| Returns | string? — nil kalau sukses, kode Errors.* kalau gagal |
| Common errors | Errors.ALREADY_CONNECTED, Errors.AUTH_FAILED, Errors.TIMEOUT, Errors.BANNED |
| Async | yes |
local err = client:connect()
if err then print("connect gagal:", err) end
client:disconnect()
| Field | Type |
|---|---|
| Signature | (self: Client) → string? |
| Returns | string? — nil kalau shutdown bersih, kode Errors.* kalau runtime nolak |
| Async | yes |
client:connected()
| Field | Type |
|---|---|
| Signature | (self: Client) → boolean |
| Returns | boolean — true kalau status MENU_READY atau IN_WORLD |
| Async | yes |
client:status()
| Field | Type |
|---|---|
| Signature | (self: Client) → string |
| Returns | string — salah satu konstanta Status.* ("CONNECTING", "MENU_READY", "IN_WORLD", …) |
| Async | yes |
while client:status() ~= Status.IN_WORLD do
sleep(200)
end
client:isAlive()
| Field | Type |
|---|---|
| Signature | (self: Client) → boolean |
| Returns | boolean — true selama runtime TCP bot masih hidup |
| Async | yes |
client:ping()
| Field | Type |
|---|---|
| Signature | (self: Client) → number? |
| Returns | number? — RTT sekarang dalam ms, atau nil sebelum cycle ping pertama |
| Async | yes |
client:lastError()
| Field | Type |
|---|---|
| Signature | (self: Client) → string? |
| Returns | string? — string error server terakhir, atau nil |
| Async | yes |
client:setSubserver(name)
| Field | Type |
|---|---|
| Signature | (self: Client, name: string) → string? |
| Returns | string? — nil kalau sukses |
| Async | yes |
Re-point lobby buat connect() berikutnya. No-op kalau socket masih hidup — panggil disconnect() dulu kalau mau ganti subserver.
client:setSubserver("game-lava.pixelworlds.pw")
client:refresh()
| Field | Type |
|---|---|
| Signature | (self: Client) → () |
| Returns | nothing — re-snapshot field akun yang di-cache (gems, level, xp, …) di tempat |
| Async | yes |
Akun
client.id
client.userid
client.username
client.email
client.gems
client.bytecoins
client.level
client.xp
client:refresh() -- re-snapshot field di atas
| Field | Type |
|---|---|
id | string — id bot (mirip UUID) |
userid | string? — id user PlayFab, di-set setelah login |
username | string? — nick in-game (atau email kalau nggak ada nick) |
email | string? — email beneran kalau add via email/password |
gems | number? — currency live (read-through ke state) |
bytecoins | number? |
level | number? — level XP |
xp | number? — jumlah XP |