mc_nearby_entities
Retrieves nearby entities including mobs, items, and players, with positions and equipment summaries. Optionally renders item icons for held or displayed items.
Instructions
Get nearby entities in the world (mobs, items, projectiles, players, etc.). Returns id, type (Mojang class name), position, distance, and a primaryEquipment summary (held item / framed item / displayed item) where applicable.
Prefer this over iterating entities via mc_execute — no script round-trip, and the summary shape is already curated. (If you do script it, batch the loop in sync { } .) Use mc_entity_details to drill into a specific entity by id.
Set includeIcons=true to also receive a top-level icons map keyed by itemId ({base64Png, width, height, spriteName}) for every primaryEquipment item — lets you see what entities are holding/displaying without per-entity mc_get_entity_item_texture calls. Deduplicated across entities.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max entries returned. Default 100. | |
| range | No | Search radius in blocks. Default 64. | |
| includeIcons | No | Render each unique primaryEquipment item's icon. Default false. |