mc-observe-items_skill

Overview

This skill detects visible dropped item entities around the player within a configurable radius (default and maximum 7 blocks). It produces both a concise human-readable SUMMARY and a structured data object detailing pose, item counts, distances, and pickup affordances. Use it to plan collection, manage nearby loot, or feed automated agents with precise item data.

How this skill works

The tool scans for item entities within the observation radius, then filters results by a forward view cone (yaw ±60°, pitch -60° to +90°) and line-of-sight so only visible items are reported. It returns a structured payload that includes the observer pose, total counts grouped by item type, nearest items, a by-distance list, and pickup-range categories. Confidence flags indicate completeness and performance trade-offs.

When to use it

• When you need to know which dropped items are currently visible and reachable
• Before moving or pathing to collect loot to prioritize nearest or pickable items
• To populate automation agents with precise item entity data for decision making
• When auditing nearby item counts and types without scanning blocks
• To detect missing items or verify that expected drops are present

Best practices

• Keep radius at or below 7 (default) because the tool enforces a 7-block maximum
• Retry observation if conf is 'low' to improve completeness or move closer and re-run
• Combine with block-scanning tools when you need chest or container contents (this tool only reports entities)
• Use the structured data.items.nearby for programmatic analysis and sorting by distance
• Prefer short, frequent observations (conf='high') when many items are present to avoid slow scans

Example use cases

• Scan a mob farm floor to collect and prioritize high-value drops (e.g., diamonds, enchanted gear)
• Automate a collection bot by feeding it nearest-item coordinates and pickup affordances
• Verify that a chest-emptying routine left no dropped items in a work area
• Quickly list and count visible item types after large-scale block breaks or explosions
• Filter and report only immediately pickable items for on-foot looting runs