fly-to
Teleport a Minecraft character to specific coordinates by providing X, Y, and Z values for precise movement within the game world.
Instructions
Make the bot fly to a specific position
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | X coordinate | |
| y | Yes | Y coordinate | |
| z | Yes | Z coordinate |
Implementation Reference
- src/bot.ts:553-600 (handler)The complete inline handler for the 'fly-to' tool. Checks for creative mode, sets up a timed abortable flight using bot.creative.flyTo via a helper, handles errors and timeouts.
server.tool( "fly-to", "Make the bot fly to a specific position", { x: z.number().describe("X coordinate"), y: z.number().describe("Y coordinate"), z: z.number().describe("Z coordinate") }, async ({ x, y, z }): Promise<McpResponse> => { if (!bot.creative) { return createResponse("Creative mode is not available. Cannot fly."); } const currentPos = bot.entity.position; console.error(`Flying from (${Math.floor(currentPos.x)}, ${Math.floor(currentPos.y)}, ${Math.floor(currentPos.z)}) to (${Math.floor(x)}, ${Math.floor(y)}, ${Math.floor(z)})`); const controller = new AbortController(); const FLIGHT_TIMEOUT_MS = 20000; const timeoutId = setTimeout(() => { if (!controller.signal.aborted) { controller.abort(); } }, FLIGHT_TIMEOUT_MS); try { const destination = new Vec3(x, y, z); await createCancellableFlightOperation(bot, destination, controller); return createResponse(`Successfully flew to position (${x}, ${y}, ${z}).`); } catch (error) { if (controller.signal.aborted) { const currentPosAfterTimeout = bot.entity.position; return createErrorResponse( `Flight timed out after ${FLIGHT_TIMEOUT_MS/1000} seconds. The destination may be unreachable. ` + `Current position: (${Math.floor(currentPosAfterTimeout.x)}, ${Math.floor(currentPosAfterTimeout.y)}, ${Math.floor(currentPosAfterTimeout.z)})` ); } console.error('Flight error:', error); return createErrorResponse(error as Error); } finally { clearTimeout(timeoutId); bot.creative.stopFlying(); } } ); - src/bot.ts:556-560 (schema)Zod input schema defining the required x, y, z coordinates as numbers for the fly-to tool.
{ x: z.number().describe("X coordinate"), y: z.number().describe("Y coordinate"), z: z.number().describe("Z coordinate") }, - src/bot.ts:603-629 (helper)Helper function that wraps bot.creative.flyTo in a Promise with AbortController support for cancellable flight operations.
function createCancellableFlightOperation( bot: any, destination: Vec3, controller: AbortController ): Promise<boolean> { return new Promise((resolve, reject) => { let aborted = false; controller.signal.addEventListener('abort', () => { aborted = true; bot.creative.stopFlying(); reject(new Error("Flight operation cancelled")); }); bot.creative.flyTo(destination) .then(() => { if (!aborted) { resolve(true); } }) .catch((err: any) => { if (!aborted) { reject(err); } }); }); } - src/bot.ts:145-145 (registration)Registration call that invokes registerFlightTools, which defines and registers the fly-to tool.
registerFlightTools(server, bot);