mc-drop_skill

Overview

This skill lets a Minecraft agent drop items from its inventory into the world as physical item entities. It supports dropping a specific count or all items of a given type and can scatter multiple items across nearby space. The skill returns a structured result indicating which items were dropped and whether the action succeeded.

How this skill works

The skill inspects the agent inventory and removes the requested items, spawning them as in-world item entities at the agent's location. You specify the item by exact name and an optional count; if no count is given, it drops all matching items. A scatter option spreads multiple drops to nearby positions to create distinct entities rather than a single stack.

When to use it

• Managing inventory by removing excess or unwanted stacks into the world
• Sharing items with other players or bots by creating pickupable item entities
• Testing or simulating world item physics and pickup behavior
• Creating visible item piles for decorated scenes or game mechanics
• Preparing items for other agents to collect or interact with

Best practices

• Run an inventory check (mc-inventory) first to confirm exact item names and counts
• Use exact item names; mismatches will prevent drops
• Specify count when you want to retain some items; otherwise all matching items are dropped
• Use scatter=true when dropping many items to avoid single stacked entities
• Observe spawned entities (mc-observe entities.by_category.item or entities.nearby) to verify results

Example use cases

• Drop a single piece of stone for testing pickup: {"type":"mc-drop","item":"stone","count":1}
• Empty all dirt from inventory into the world: {"type":"mc-drop","value":"dirt"}
• Share 10 apples with nearby players: {"type":"mc-drop","item":"apple","count":10}
• Scatter a stack of seeds across an area for collection: {"type":"mc-drop","item":"wheat_seeds","count":64,"scatter":true}