playbooks

home / skills / bdambrosio / cognitive_workbench / mc-open

mc-open skill

/src/world-tools/minecraft/mc-open

This skill opens block-based Minecraft UIs such as crafting tables, chests, and furnaces, returning success or failure.

npx playbooks add skill bdambrosio/cognitive_workbench --skill mc-open

Review the files below or copy the command above to add this skill to your agents.

Files (2)
Skill.md
1.4 KB
---
name: mc-open
type: python
description: "Open block-based UI (crafting table, chest, furnace). Returns success/failure"
---

# Minecraft Open Tool

Opens block-based UI interfaces like crafting tables, chests, and furnaces. Returns success/failure status.

## Purpose

UI interaction for crafting, storage access, and furnace operations. Opens interactive interfaces from specific block types.

## Input

- Position: `dx`, `dy`, `dz` (world-relative offsets from agent, floats, all required)
  - See coordinate system documentation in jill-minecraft.yaml for details
- `value`: Ignored

## Output

Returns uniform_return format with:
- `value`: Text summary (success/failure message)
- `data`: Structured data dict (machine-readable). Key fields:
  - `success`: Boolean
  - `ui_type`: String (e.g., `"crafting_table"`, `"chest"`, `"furnace"`)

## Behavior & Performance

- Opens UI interface from block at specified position
- Fails if block does not have openable UI
- UI remains open until closed with `mc-close`

## Guidelines

- Use `mc-observe` to identify openable blocks
- Common openable blocks: crafting_table, chest, furnace, dispenser
- Must be within reach of block
- Use `mc-close` to close opened UI

## Usage Examples

Open block directly south:
```json
{"type":"mc-open","dx":0,"dy":0,"dz":1,"out":"$open"}
```

Open block directly east:
```json
{"type":"mc-open","dx":1,"dy":0,"dz":0,"out":"$open"}
```

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.

FAQ

What inputs does the skill require?

It requires dx, dy, dz offsets from the agent; the value field is ignored.

What does the skill return?

It returns a structured object with value (text) and data containing success (boolean) and ui_type (string).

What happens if the target block has no UI?

The skill fails and returns success=false with a message indicating the block is not openable.