build_torus
Generate donuts, rings, circular fountains, or arena seating in Minecraft Bedrock Edition by defining center coordinates, major and minor radii, and optional axis alignment. Supports hollow or solid structures using specified block materials.
Instructions
Build TORUS: donut, ring, circular fountain, arena seating, portal. Requires: centerX,centerY,centerZ,majorRadius,minorRadius. Optional: axis
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | Build action to perform | build |
| axis | No | Torus axis (normal to the plane): x (YZ-plane torus), y (XZ-plane torus), z (XY-plane torus) | y |
| centerX | Yes | Center X coordinate | |
| centerY | Yes | Center Y coordinate | |
| centerZ | Yes | Center Z coordinate | |
| hollow | No | Make it hollow (true) for ring shell only, or solid (false) for full torus structure | |
| majorRadius | Yes | Outer ring size (how big the overall donut is). Small ring=8, Medium ring=15, Large ring=30. This determines the donut hole size | |
| material | No | Block type to build with (e.g. stone for foundations, glass for decorative rings, water for fountains) | minecraft:stone |
| minorRadius | Yes | Tube thickness (how thick the donut ring is). Thin tube=2, Medium tube=4, Thick tube=8. Must be smaller than majorRadius |
Implementation Reference
- The execute method containing the core logic for the 'build_torus' tool: validates inputs, computes torus block positions, checks limits, and executes optimized building via Socket-BE API.
async execute(args: { action?: string; centerX: number; centerY: number; centerZ: number; majorRadius: number; minorRadius: number; material?: string; hollow?: boolean; axis?: 'x' | 'y' | 'z'; }): Promise<ToolCallResult> { try { // Socket-BE API接続確認 if (!this.world) { return { success: false, message: "World not available. Ensure Minecraft is connected." }; } // 引数の基本検証 if (!args || typeof args !== 'object') { return this.createErrorResponse('Invalid arguments provided'); } if (!this.validateArgs(args)) { return this.createErrorResponse('Missing required arguments: centerX, centerY, centerZ, majorRadius, minorRadius'); } const { action = 'build', centerX, centerY, centerZ, majorRadius, minorRadius, material = 'minecraft:stone', hollow = false, axis = 'y' } = args; // actionパラメータをサポート（現在は build のみ） if (action !== 'build') { return this.createErrorResponse(`Unknown action: ${action}. Only 'build' is supported.`); } // 座標の整数化 const center = { x: this.normalizeCoordinate(centerX), y: this.normalizeCoordinate(centerY), z: this.normalizeCoordinate(centerZ) }; const majorRadiusInt = Math.round(majorRadius); const minorRadiusInt = Math.round(minorRadius); // パラメータ検証 if (majorRadiusInt < 3 || majorRadiusInt > 50) { return this.createErrorResponse('Major radius must be between 3 and 50'); } if (minorRadiusInt < 1 || minorRadiusInt > 20) { return this.createErrorResponse('Minor radius must be between 1 and 20'); } if (minorRadiusInt >= majorRadiusInt) { return this.createErrorResponse('Minor radius must be smaller than major radius'); } // 座標範囲の検証 const totalRadius = majorRadiusInt + minorRadiusInt; const minX = center.x - totalRadius; const maxX = center.x + totalRadius; const minY = center.y - minorRadiusInt; const maxY = center.y + minorRadiusInt; const minZ = center.z - totalRadius; const maxZ = center.z + totalRadius; if (!this.validateCoordinates(minX, minY, minZ) || !this.validateCoordinates(maxX, maxY, maxZ)) { return this.createErrorResponse('Torus extends beyond valid coordinates'); } // ブロックIDの正規化 const blockId = this.normalizeBlockId(material); const commands: string[] = []; let blocksPlaced = 0; // 座標変換ヘルパー関数 const transformCoordinates = (localX: number, localY: number, localZ: number): {x: number, y: number, z: number} => { switch (axis) { case 'x': // X軸トーラス: YZ平面でドーナツ、X軸が法線 return { x: center.x + localY, // Y(tube height) → X (axis direction) y: center.y + localX, // X(major radius) → Y z: center.z + localZ // Z(major radius) → Z }; case 'z': // Z軸トーラス: XY平面でドーナツ、Z軸が法線 return { x: center.x + localX, // X(major radius) → X y: center.y + localZ, // Z(major radius) → Y z: center.z + localY // Y(tube height) → Z (axis direction) }; case 'y': default: // Y軸トーラス（デフォルト）: XZ平面でドーナツ、Y軸が法線 return { x: center.x + localX, // X(major radius) → X y: center.y + localY, // Y(tube height) → Y (axis direction) z: center.z + localZ // Z(major radius) → Z }; } }; // トーラスの座標を計算 const positions = calculateTorusPositions(center, majorRadiusInt, minorRadiusInt, hollow); // ブロック数制限チェック if (positions.length > BUILD_LIMITS.TORUS) { return this.createErrorResponse(`Too many blocks to place (maximum ${BUILD_LIMITS.TORUS.toLocaleString()})`); } try { // 最適化されたビルド実行 const result = await executeBuildWithOptimization( this.world, positions, blockId, { type: 'torus', center: center, majorRadius: majorRadiusInt, minorRadius: minorRadiusInt, material: blockId, hollow: hollow, axis: axis, apiUsed: 'Socket-BE' } ); if (!result.success) { return this.createErrorResponse(result.message); } return { success: true, message: result.message, data: result.data }; } catch (buildError) { return this.createErrorResponse(`Building error: ${buildError instanceof Error ? buildError.message : String(buildError)}`); } } catch (error) { return this.createErrorResponse( `Error building torus: ${error instanceof Error ? error.message : String(error)}` ); } } - Input schema defining parameters for the build_torus tool, including required center coordinates, radii, and optional material, hollow, axis.
readonly inputSchema: InputSchema = { type: 'object', properties: { action: { type: 'string', description: 'Build action to perform', enum: ['build'], default: 'build' }, centerX: { type: 'number', description: 'Center X coordinate' }, centerY: { type: 'number', description: 'Center Y coordinate' }, centerZ: { type: 'number', description: 'Center Z coordinate' }, majorRadius: { type: 'number', description: 'Outer ring size (how big the overall donut is). Small ring=8, Medium ring=15, Large ring=30. This determines the donut hole size', minimum: 3, maximum: 50 }, minorRadius: { type: 'number', description: 'Tube thickness (how thick the donut ring is). Thin tube=2, Medium tube=4, Thick tube=8. Must be smaller than majorRadius', minimum: 1, maximum: 20 }, material: { type: 'string', description: 'Block type to build with (e.g. stone for foundations, glass for decorative rings, water for fountains)', default: 'minecraft:stone' }, hollow: { type: 'boolean', description: 'Make it hollow (true) for ring shell only, or solid (false) for full torus structure', default: false }, axis: { type: 'string', description: 'Torus axis (normal to the plane): x (YZ-plane torus), y (XZ-plane torus), z (XY-plane torus)', enum: ['x', 'y', 'z'], default: 'y' } }, required: ['centerX', 'centerY', 'centerZ', 'majorRadius', 'minorRadius'] }; - src/server.ts:368-368 (registration)Instantiation of BuildTorusTool added to the tools array for MCP registration.
new BuildTorusTool(), // ✅ 修正完了 - src/server.ts:18-18 (registration)Import statement for BuildTorusTool class.
import { BuildTorusTool } from "./tools/advanced/building/build-torus"; - Class definition with tool name 'build_torus'.
export class BuildTorusTool extends BaseTool { readonly name = 'build_torus';