Difference between revisions of "Bot Playground/Commands/walkTo"
From SmartBots Developers Docs
Line 45: | Line 45: | ||
console.log("Script is running, waiting for autopilot events"); | console.log("Script is running, waiting for autopilot events"); | ||
+ | // Start autopilot | ||
Bot.walkTo(203, 37, 93); | Bot.walkTo(203, 37, 93); | ||
− | setTimeout(() => process.exit(), | + | // Gracefully end test script in 10 seconds |
+ | setTimeout(() => process.exit(), 10_000); | ||
/* | /* | ||
Line 53: | Line 55: | ||
07/12/2023 13:28:39 | 07/12/2023 13:28:39 | ||
Script is running, waiting for autopilot events | Script is running, waiting for autopilot events | ||
+ | |||
07/12/2023 13:28:42 | 07/12/2023 13:28:42 | ||
Autopilot completed: { | Autopilot completed: { |
Revision as of 10:30, 7 December 2023
Walk to a position within the current region.
Bot.walkTo(x, y, z);
Reference
This command accepts the following parameters:
Variable | Required | Description
| |
---|---|---|---|
Input: | |||
x | yes | The X coordinate of the destination point | |
y | yes | The Y coordinate of the destination point | |
z | yes | The Z coordinate of the destination point | |
Output: | |||
Function returns a Promise with the following data: | |||
success | bool | true if command completed successfully | |
error | string | error string if command has failed |
Details
Bot does not "navigate" to the point. Instead, it walks straight to the specified point, hitting all obstacles on the way. If bot gets stuck for 2 seconds (for example, hitting the wall), the autopiloting ends.
You can use fly command to start flying and reach the higher destination point.
These events deliver the autopilot status:
- autopilot_started - autopilot started
- autopilot_completed - autopilot reached destination point
- autopilot_stuck - autopilot got stuck (and stopped)
Examples
// Bots Playground script: [TEST] Autopilot events (build 1 by Glaznah Gassner)
Bot.on("autopilot_completed", (event) => {
console.log(`Autopilot completed: ${JSON.stringify(event, null, 2)}`);
});
Bot.on("autopilot_stuck", (event) => {
console.log(`Autopilot stuck: ${JSON.stringify(event, null, 2)}`);
});
console.log("Script is running, waiting for autopilot events");
// Start autopilot
Bot.walkTo(203, 37, 93);
// Gracefully end test script in 10 seconds
setTimeout(() => process.exit(), 10_000);
/*
clear
07/12/2023 13:28:39
Script is running, waiting for autopilot events
07/12/2023 13:28:42
Autopilot completed: {
"name": "autopilot_completed",
"bot_slname": "DakotahRaine Resident",
"bot_uuid": "4f6b8999-14a0-4f50-882d-a764ee913daa",
"endPoint": {
"X": 203,
"Y": 37,
"Z": 93
},
"actualPoint": {
"X": 203.21898,
"Y": 36.799942,
"Z": 93
}
}
*/