Logs

Buffer paket/event log level rendah per client. Ini yang di-tail halaman Logs aplikasi desktop — setiap paket TCP (incoming + outgoing), perubahan state framework bot, anti-AFK tick, dan output print() skrip kamu kalau bot lagi di-bind.

Logger adalah wrapper tipis dari ConsoleHandle yang SAMA kayak [Console] — :add() di sini muncul di pane Console dashboard juga, dan sebaliknya. Bedanya cuma di shape entries-nya: Logger.entries itu array string flat (gak ada metadata timestamp / type), sedangkan Console.entries bawa row lengkap.

local client = getClient()
local logs   = client:logger()   -- atau `getLogs()` buat client yang di-bind di skrip aktif

Constructors

getLogs()

Field	Type
Signature	() → Logger
Returns	Logger — view string flat di atas console shared runtime
Async	no

Buffer backing-nya sama kayak getConsole(), tapi field entries berupa list string mentah (tanpa wrapper timestamp / type).

client:logger()

Field	Type
Signature	(self: Client) → Logger
Returns	Logger — buffer yang sama yang dibaca getLogs()
Async	no

Fields

logs.entries

Field	Type
Signature	Logger.entries: {string}
Returns	{string} — list 1-indexed string pesan saja

Snapshot pas akses — gak update live. Re-read tiap kali butuh view fresh.

Methods

logs:add(msg)

Field	Type
Signature	(self: Logger, msg: string) → ()
Returns	nothing
Async	no

Push satu entry tagged "info". Berguna buat tagging momen penting di tengah stream paket biar forensik gampang nanti.

logs:add("--- mulai run auto-mine ---")
client:warp("MINEWORLD")
sleep(2000)
logs:add("--- nyampe, mulai loop ---")

Di halaman Logs aplikasi desktop, dua line add() itu muncul di-interleave sama paket TCP yang jalan di antaranya — handy buat forensik "kapan tepatnya off the rails".

logs:clear()

Field	Type
Signature	(self: Logger) → ()
Returns	nothing
Async	no

Hapus semua isi buffer console shared. Pane Console juga ke-wipe.

Iterasi snapshot

--!strict
local client = getClient()
if not client then return end

local logs = client:logger()
for i, line in ipairs(logs.entries) do
    if line:find("KErr") then
        print(("entry %d: server error → %s"):format(i, line))
    end
end

Kapan pake apa

Butuh	Pakai
Print ke konsol skrip-ku	print(...)
Capture error dari skrip	Console entries[i].type == "error"
Lihat setiap paket TCP	logs.entries
Tag momen buat debug nanti	logs:add("...")
Stream log ke backend	logs.entries di-poll + http.post(...)