Global Basics

Basic Operations¶

Use the Global instance to store and read data at the account level.

All operations here use the string-based method format and apply to the entire owner account.

Data stored here is shared across all bots under the same account.

Use Global.set() to store values.

Global.set("version", "1.0.0")
Global.set("max_limit", 100, "number")

If the type is not provided, it is auto-detected.

Use Global.get() to read stored values.

let version = Global.get("version")
let limit = Global.get("max_limit")

Bot.sendMessage("Version: " + version + ", Limit: " + limit)

Reading data is synchronous and returns the value directly.

If a key does not exist, it returns null.

Remove a specific global value.

Global.del("max_limit")

let limit = Global.get("max_limit")   // null
Bot.sendMessage("After delete, limit = " + limit)

Deleting a non-existing key does nothing and does not throw an error.

Bulk operations let you work with all global data at once.

These are useful for inspecting or resetting account-level data.

let all = Global.getAll()
Bot.inspect(all)

Example output:

{
  "version": "1.0.0",
  "maintenance": false
}

This returns an object containing all stored global keys and values.

Global.delAll()

let all2 = Global.getAll()
Bot.inspect(all2)

This clears all global data for the account.