| 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:
{"type":"mc-open","dx":0,"dy":0,"dz":1,"out":"$open"}
Open block directly east:
{"type":"mc-open","dx":1,"dy":0,"dz":0,"out":"$open"}