home / skills / bdambrosio / cognitive_workbench / mc-drop

mc-drop skill

safe

This skill drops items from inventory into the world as item entities, enabling world modification and easy item sharing.

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

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

Files (2)

Skill.md

1.5 KB

---
name: mc-drop
type: python
description: "Drop items from inventory into the world as entities - embodied manipulation. Returns dropped items"
---

# Minecraft Drop Tool

Drops items from inventory into the world as item entities. Embodied manipulation that physically places items in the world.

## Purpose

Item dropping for inventory management, item sharing, and world modification. Creates item entities in the world that can be picked up by the bot or other players.

## Input

- `value`: Item name to drop (preferred)
- `item`: Item name to drop (alternative to value)
- `count`: Integer (optional, default: all)
- `scatter`: Boolean (optional, default: false)

## Output

Returns uniform_return format with:
- `value`: Text summary of dropped items
- `data`: Structured data dict (machine-readable). Key fields:
  - `success`: Boolean
  - `dropped`: Array of `{item: string, count: int}`

## Behavior & Performance

- Drops items as entities in the world
- Default behavior drops all items of specified type
- Scatter option spreads items when dropping multiple

## Guidelines

- Use `mc-inventory` first to check available items
- Item name must match exactly
- Dropped items become entities that can be picked up
- Use `mc-observe` and inspect `entities.by_category.item` / `entities.nearby` to see dropped items

## Usage Examples

Drop one item:
```json
{"type":"mc-drop","item":"stone","count":1,"out":"$drop"}
```

Drop all items of type:
```json
{"type":"mc-drop","value":"dirt","out":"$drop_all"}
```

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}

FAQ

What happens if the item name is wrong?

The skill will not drop anything; check inventory names exactly before calling the skill.

If I don't set count, how many are dropped?

By default the skill drops all items of the specified type found in the agent's inventory.