mc-inventory_skill

Overview

This skill inspects a Minecraft player's inventory and equipped items in a read-only, epistemic way. It returns both a human-readable multi-line inventory text and a machine-readable structured object describing every slot and what is equipped. Use it to quickly learn current item state without modifying anything.

How this skill works

When invoked, it queries the current inventory and produces a uniform_return containing a textual listing and a structured dict. The structured output includes success, an array of slots with slot index, item name, and count, plus an equipped object with hand and offhand. Empty slots are explicitly represented as null or empty strings so callers can plan deterministically.

When to use it

• Before planning actions that depend on items (equip, craft, drop, use).
• When you need a fast snapshot of all inventory slots and counts.
• To verify what is currently in the main hand and offhand.
• Before automated item management or sorting routines.
• When debugging inventory-related agent decisions or scripts.

Best practices

• Treat the output as read-only and do not assume inventory changes after retrieval.
• Check equipped.hand and equipped.offhand first for immediate held items.
• Handle empty slots explicitly (item null or empty string) in your logic.
• Use the slot index values for precise item transfers or targeted operations.
• Re-query the skill after any action that might change inventory to avoid stale data.

Example use cases

• Confirming you have the right tools and weapons before entering combat.
• Creating a craft plan by listing available materials and their counts.
• Automated systems deciding whether to pick up or discard items based on current inventory.
• Verifying that a specific item is equipped in the main hand before performing an action.
• Inventory auditing for bots that must maintain minimum supplies (food, torches, blocks).