Minecraft Observe Entities Tool

Enumerates all visible entities (mobs, players, items, etc.) within observation radius. Provides structured summary with pose, entity counts by category and type, nearest entities, and distance-sorted lists.

Purpose

Visible entity observation for awareness of mobs, players, and items. Returns both human-readable SUMMARY text and machine-readable structured data.

Input

• •radius: Optional integer observation radius (default: 7, max: 7)
• •entities_radius: Optional integer observation radius (default: 7, max: 7). If both provided, entities_radius takes precedence.
• •value: Ignored

Output

Returns uniform_return format with:

• •value: Multi-line SUMMARY text (human-readable, ≤ 1024 chars)
• •data: Structured observation dict (machine-readable). Key fields:
  • •success: Boolean
  • •pose: {x, y, z, yaw, pitch} (floats)
  • •entities: {total: int, by_category: {string: int}, types: {string: int}, nearest: {string: float}, by_distance: [dict], nearby: [dict]}
    • •Each entry in entities.nearby includes: name, type, position, dx, dy, dz, distance (items may include item_name, item_count)
  • •conf: "high" | "med" | "low"
  • •note: String (human-readable summary)

Behavior & Performance

• •Enumerates visible entities within radius, filtered by view cone (yaw ±60°, pitch -60..+90) and line-of-sight
• •Radius limits: Default 7 blocks, maximum 7 blocks
• •Confidence levels: high (complete, fast), med (complete but slow/many entities), low (incomplete observation)
• •Entity categorization: Groups entities by category (mob, player, item, other)

Guidelines

• •Use mc-observe-items for item-only observation (this tool reports all entity types)
• •Use mc-observe-blocks for block observation (this tool only reports entities)
• •entities.by_category provides quick overview of entity types present
• •entities.nearest shows closest entity of each type
• •conf=low indicates incomplete observation - may need retry or larger radius
• •Raw exhaustive data stored in data.entities.nearby for detailed analysis

Usage Examples

Standard observation:

{"type":"mc-observe-entities","out":"$entities"}

With custom radius:

{"type":"mc-observe-entities","radius":7,"out":"$entities"}