Difference between revisions of "Bot Playground/Commands/getLocation"
From SmartBots Developers Docs
| Line 50: | Line 50: | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| + | |||
| + | Example output: | ||
| + | <syntaxhighlight lang="json"> | ||
| + | { | ||
| + | "online":true, | ||
| + | "region":"DuoLife", | ||
| + | "position":{ | ||
| + | "x":230, | ||
| + | "y":78, | ||
| + | "z":32 | ||
| + | }, | ||
| + | "exactPosition":{ | ||
| + | "x":229.6, | ||
| + | "y":77.69, | ||
| + | "z":32.1 | ||
| + | } | ||
| + | } | ||
| + | <syntaxhighlight> | ||
{{NavMenu}} | {{NavMenu}} | ||
__NOTOC__ | __NOTOC__ | ||
Revision as of 08:47, 27 February 2025
Returns current location of the bot bot.
const res = await Bot.getLocation();
console.log("Bot location:", res);
Reference
This command accepts the following parameters:
| Variable | Required | Description
| |
|---|---|---|---|
| Input: | |||
| Output: | |||
| Function returns a Promise with the following data: | |||
| success | bool | true if command completed successfully | |
| error | string | error string if command has failed | |
| online | boolean | Bot online flag | |
| region | string | Bot region name | |
| position | object | Current bot position, rounded to integer:
{
x: number; // 100
y: number; // 110
z: number; // 20
}
| |
| exactPosition | object | Exact bot position (the same as 'position' but with decimals):
{
x: number; // 100.01
y: number; // 109.65
z: number; // 20.4
}
| |
Details
Command returns bot position, mostly in real-time. Use this command to track actual bot position.
Note: Bot.status() command also returns 'location' but it may be cached for up to 30 seconds.
Examples
const loc = await Bot.getLocation();
if(loc.region == "DuoLife") {
console.log("Wow, I'm in SmartBots region now!");
}
Example output:
{
"online":true,
"region":"DuoLife",
"position":{
"x":230,
"y":78,
"z":32
},
"exactPosition":{
"x":229.6,
"y":77.69,
"z":32.1
}
}
<syntaxhighlight>
{{NavMenu}}
__NOTOC__
