Skip to main content

🚩 Script Event Hook

event hook ada untuk menjalankan script kamu, dengan event hook yang beragam kamu bisa gunakan untuk logic saat menjalankan script

Agar lebih mengerti, disarankan untuk coba - coba sendiri ya!

# none​

tidak ada event hook, alahasil script tidak akan dijalankan secara otomatis. Kecuali di panggil nama kodenya dengan command function penjelasan ada di bagian command

# OnLoad​

dipanggil saat script berhasil di load (alias setiap tekan tombol reload atau server selesai restart)

danger

setiap command di dalam OnLoad ini pasti akan di execute lebih dulu daripada hook yang lain, kecuali kalau ada OnTick karena itu berdasarkan waktu maka OnTick tidak peduli kalau sedang menjalankan OnLoad

# variable khusus​

  • isInit : Boolean -> akan true kalau OnLoad nya ini di panggil setelah server hydra restart

# contoh kode​

di log kamu akan muncul pesan kalau script di load

print "{script.name} loaded"

on load juga cocok untuk reset variable di script, command dibawah akan reset variable di bot

var clear true

akan menjalankan print kalau OnLoad dipanggil saat setelah server hydra restart

execute if-true [{event.isInit}="true"] print "server restart"

# preview​

tidak perlu preview

# OnChat​

dipanggil saat ada player yang chat di dalam world dan chat tersebut diawali dengan !h

# variable khusus​

  • sender : Object of player -> player yang mengirim chat
  • message : String -> pesan chat
  • args : Array of String -> pesan chat yang dipisah dengan spasi

# contoh kode​

akan sapa user

chat "Halo {sender.name}"

# argument​

chat message memiliki sistem argument juga, argument ini parse dengan cara yang lumayan unik (bukan spasi saja). Contohnya:

RudeusKami1: !h arg0 arg1 "arg number 2" arg3

akan kena parse menjadi

  • arg0 -> {sender.args.0}
  • arg1 -> {sender.args.1}
  • arg number 2 -> {sender.args.2}
  • arg3 -> {sender.args.3}

nah jadi setiap arg itu ditentukan dengan spasinya, kecuali kalau di kurung dengan "" dan juga ingat ya, karena array maka dimulai dari 0

# preview​

img.png
bot menjalankan chat

# OnTick​

dipanggil setiap detik. Kamu dapat setel detiknya dengan merubah nama kode saat membuat menjadi x_seconds, contoh 5_seconds kode akan di eksekusi setiap 5 detik

# variable​

  • tidak ada

# contoh kode​

chat "5 detik berlalu"

# preview​

img.png
bot menjalankan chat

# OnPlayerJoinWorld​

dipanggil kalau ada player yang join world

# variable khusus​

  • player : Object of player -> player yang join world

# contoh kode​

chat "Halo {event.player.name}"

# preview​

img.png
bot chat saat player join world

# OnPlayerExitWorld​

dipanggil kalau ada player yang keluar dari world

# variable khusus​

  • player : Object of player -> player yang keluar dari world

# contoh kode​

chat "/msg {event.player.name} good bye"

# preview​

img.png
bot mengirim message ke player yang keluar world

# OnDisconnect​

dipanggil saat bot ter disconnect oleh user atau server Growtopia

# variable khusus​

  • errorConnecting : Boolean -> untuk cek apakah kena disconnect karena errcon
  • byGrowtopia : Boolean -> untuk cek apakah bot kena disconnect oleh server Growtopia

# contoh kode​

notifikasi bot disconnect

execute if-true [{event.byGrowtopia}="true"] notification raw "bot {bot.name} disconnected!"

# preview​

event hook biasa, tidak perlu preview

# OnInventoryUpdate​

dipanggil saat ada item yang ditambahkan ke inventory bot atau dikeluarkan

# variable khusus​

  • adding : Boolean -> apakah item nya di tambahkan atau di keluarkan
  • item : Object of item -> item yang ditambahkan ke inventory

# contoh kode​

bot akan chat item yang di tambahkan

chat "added {event.adding} {event.item.name} x{event.item.amount}"

# preview​

img.png
bot chat saat inventory ter update (ada item masuk)

# OnJobUpdate​

dipanggil saat ada job yang ditambahkan atau selesai untuk

# variable khusus​

  • job : Object of job -> job yang ter update, antara di schedule atau di cancel

# contoh kode​

bot akan chat kalau job ter update

chat "job update {event.job.name} cancelled {event.job.cancelled} reason: {event.job.cancelReason}"

# preview​

img.png
bot chat saat job di update, untuk preview ini job collect yang di cancel

# OnConsoleMessage​

dipanggil kalau ada pesan dari Growtopia, misalnya broadcast atau hal lain. Semua pesan akan masuk kecuali world chat karena ngespam

# variable khusus​

  • message : String -> pesan console
  • messageType : String -> tipe pesan console nya

# tipe pesan console​

  • tipe SYSTEM tidak ada variable khusus, ini kalau dapat pesan dari sistem Growtopia
  • tipe SYSTEM_LOG tidak ada variable khusus, ini kalu dapat pesan dari sistem Growtopia juga tapi seringan saat login
  • tipe SERVER_NOTIFICATION tidak ada variable khusus, ini kalau dapat pesan event dari Growtopia
  • tipe TALK_BUBBLE tidak ada variable khusus, ini kalau dapat pesan chat dari Growtopia misalnya kalau kena Ghost Shark

# filtered message​

untuk mencegah lag, pesan console saat collect item (ex: Collected 1 Dirt Seed) tidak akan di anggap sebagai OnConsoleMessage

# contoh kode​

print ke console kalau kena sub server (bisa 2 tipe karena dari Growtopia nya)

execute if-true [{event.messageType}="SYSTEM_LOG",{event.message}~"sub server"] print "[LOG] {event.message}"
execute if-true [{event.messageType}="SYSTEM",{event.message}~"sub server"] print "[SYSTEM] {event.message}"

print ke console kalau kena ghost shark

execute if-true [{event.messageType}="TALK_BUBBLE",{event.message}~"CHOMP"] print "[Ghost Shark] {event.message}"
execute if-true [{event.messageType}="TALK_BUBBLE",{event.message}~"GHOST"] print "[Ghost Shark] {event.message}"
execute if-true [{event.messageType}="TALK_BUBBLE",{event.message}~"GHOOOOST"] print "[Ghost Shark] {event.message}"

# preview​

img.png
pesan broadcast dikirim ke log bot kamu

# OnCall​

script yang ini lumayan kompleks dan kalau bukan advanced user, aku engga yakin kamu bakalan butuh event ini. Jadi kalau bukan advanced user bisa di skip.

dipanggil jika ada script yang pakai command call, berbeda dengan command function menggunakan call bisa memanggil fungsi dari script lain yang bisa beda bot juga. Dengan ini, kamu bisa menjalankan kode dari script lain dengan mudah. Contoh penggunaan: mau panggil kode tertentu yang kalau di copas ke setiap script tidak efisien.

# variable khusus​

  • data : Object -> variable yang bisa kamu berikan saat menjalankan OnCall

# contoh kode​

anggap kedua kode ini beda script

# script 1​

di hook OnChat

call [custom="data aku"]

# script 2​

di hook OnCall

print "Script called with data {event.data.custom}"

# OnBotBanned​

dipanggil saat ada bot yang kena ban sistem / auto ban

# variable khusus​

  • duration : Integer -> waktu ban dalam hari

# contoh kode​

di log kamu akan muncul pesan "{nama bot} banned selama {jumlah hari} hari"

print "{bot.name} banned selama {event.duration} hari"

# OnServerNotification​

dipanggil saat ada notifikasi masuk dari server Growtopia, alias notifikasi popup kalau ada event, dll

# variable khusus​

  • message : String -> pesan notifikasi

# contoh kode​

di log akan muncul pesan notifikasinya

print "{event.message}"

jika ingin notifikasi khusus, bisa pake operator ~ di logic untuk cek apakah message berisi text tertentu

condition [{event.message}~"toxic"] continue[] terminate[]
print "ada toxic waste!"

# OnWorldJoin​

dipanggil saat bot join world

# variable khusus​

tidak ada

# contoh kode​

bot akan chat Halo setelah join world

chat "Halo"

bot akan chat Hai setelah join ke world ANAKFFMAJU

execute if-true [{bot.world.name}="ANAKFFMAJU"] chat "Hai"

# OnPlayerLeveledUp​

dipanggil saat bot level up

# variable khusus​

  • lastLevel -> level sebelumnya
  • newLevel -> level sekarang

# contoh kode​

notifikasi akan dikirim lewat url webhook nya setiap bot level up

notification raw "{bot.name} level up! {event.lastLevel} -> {event.newLevel}"