home / skills / bdambrosio / cognitive_workbench / mc-pickup

mc-pickup skill

safe

This skill automates Minecraft item collection by moving toward nearby items so they auto-pick into inventory and can be verified.

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

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

Files (1)

Skill.md

1.5 KB

---
name: mc-pickup
type: instruction
description: "How to collect items from the world into inventory - automatic pickup when close enough."
---

# Minecraft Pickup Instruction

## How Item Collection Works

In Minecraft, items are **automatically collected** into your inventory when you move close enough to them. There is no separate "pickup" action.

## Canonical Sequence

After digging a block or dropping an item:

1. **mc-dig** - Break a block (if you wish to 'pickup' a block rather than an item already in the environment) - (drops appear in world)
2. **mc-move** - Move slightly forward/sideways towards the dropped item (small nudge, ~0.5-1 block)
3. **mc-inventory** - Verify the item appears in inventory

## Important Notes

- **No explicit pickup call needed** - Items automatically enter inventory when within ~1.5 blocks
- **equip is NOT for picking up** - `mc-equip` only holds items already in your inventory. It does not pull items from the world.
- **Movement is required** - You must move close to the dropped item for automatic collection
- **Verify with mc-inventory** - Always check inventory after moving to confirm collection

## Example Workflow

```json
{"type":"mc-dig","forward":1,"up":0,"right":0,"out":"$dig"}
{"type":"mc-move","forward":true,"duration":0.5,"out":"$nudge"}
{"type":"mc-inventory","out":"$inv"}
{"type":"mc-equip","item":"stone","slot":"hand","out":"$equip"} - if you wish to use or place the item
```

Note: `mc-equip` comes AFTER the item is already in inventory (from the automatic pickup).

Overview

This skill explains how to collect items from the Minecraft world into your inventory by using automatic pickup behavior. It clarifies the required sequence of actions and where movement and inventory checks fit into the flow. The goal is to ensure reliable pickup without attempting unsupported explicit pickup commands.

How this skill works

The skill inspects the typical sequence: cause an item to be in the world (for example by digging or dropping), move the agent close enough, and then verify the inventory. Minecraft automatically transfers items into inventory when the agent comes within roughly 1–1.5 blocks. There is no separate pickup command; equip only operates on items already present in inventory.

When to use it

After breaking a block to collect its drops
When another entity or command drops items nearby
Before attempting to equip or place an item that should be collected first
When automating item collection in scripts or task sequences

Best practices

Always perform a small movement nudge toward the dropped item (about 0.5–1 block) to trigger pickup
Follow movement with an inventory check to confirm the item was collected
Do not attempt to use an equip action to pull items from the world; equip only works on inventory items
Design sequences so digging/dropping happens before movement and inventory verification
Allow a short duration for movement when working with physics or latency-sensitive environments

Example use cases

Collect stone drops after mining: dig → nudge forward → check inventory → equip if needed
Pick up dropped loot after combat: move into pile area → verify inventory additions
Automate collection in farming loops: trigger crop drop → move through row → confirm collected items
Combine with storage automation: pick up nearby items then transfer to chest or container via inventory actions

FAQ

Do I need a separate pickup command?

No. Minecraft automatically picks up items when you move close enough; there is no separate pickup action to call.

Can I use equip to grab items from the ground?

No. Equip only works on items already in your inventory. Move into pickup range first, then equip if you need the item in hand.