mc-open_skill

Overview

This skill opens block-based UIs in a Minecraft world such as crafting tables, chests, and furnaces. It attempts to open the interface at a world-relative offset from the agent and returns a structured success/failure result. The UI stays open until explicitly closed with the close action.

How this skill works

Provide world-relative offsets (dx, dy, dz) from the agent to target a block. The skill checks the block at that position and, if it supports an openable UI, opens the interface and returns machine-readable status and a human-readable message. If the block is not openable or out of reach, the skill returns a failure result.

When to use it

• Open a crafting table to access the 3x3 crafting grid for recipes.
• Open chests or other storage blocks to move items between inventory and container.
• Open furnaces to start, monitor, or modify smelting operations.
• Open dispensers or similar blocks that expose a UI.
• Before performing automated inventory or crafting steps that require the UI to be active.

Best practices

• Use mc-observe first to verify the target block type and ensure it supports a UI.
• Supply precise dx, dy, dz offsets; incorrect offsets often cause a failure.
• Ensure the agent is within reach of the block; remote blocks will not open.
• Close the UI with mc-close when finished to free the agent for other actions.
• Handle failure responses by checking the returned data.success flag and ui_type.

Example use cases

• Open the crafting table directly south of the agent to craft a tool.
• Access the chest one block east to organize or retrieve stored items.
• Open the furnace above the agent to insert fuel and items to smelt.
• Confirm a block is a chest by attempting to open it and inspecting the response.