Skip to content

Home

Jump to bottom
liuye edited this page Nov 7, 2026 · 3 revisions

MobInteract Wiki

简体中文 | English

Gives humanoid mobs the ability to mine blocks, build their own path toward targets they could never reach, and pick up blocks and pickaxes off the ground.

MobInteract Folia

What this is

Vanilla mobs detour around terrain they cannot cross — and when no detour exists, they just stand there. MobInteract adds two abilities to humanoid mobs such as zombies, skeletons and vindicators:

  • Mining — with a pickaxe in hand, break the block in its way, the block above its head, or the block under its target's or its own feet.
  • Building — take blocks from the stock it was given at spawn to build stairs, pillar up or bridge across, reaching a target on a ledge or across a ravine.

Plus one convenience feature:

  • Pickup — walk to dropped items; blocks go into the stock, pickaxes into the main hand.

These are just two extra higher-priority behaviours layered on top of the vanilla AI. Vanilla pathfinding is not replaced: targeting, jumping and detouring keep working, and villagers and wandering traders are not taken over by default.

Three steps

  1. Download MobInteract-x.y.z.jar from Releases, drop it into plugins/ and restart.
  2. In game run /mobinteract status for a summary; aim at a zombie and run /mobinteract inspect to see what it is thinking right now.
  3. To tune the feel, edit the yml files in plugins/MobInteract/ and run /mobinteract reload.

A mob only mines if it carries a pickaxe (10% of mobs are born with one by default; see equip.yml). Want every mob to dig? Set the spawn-equipment chance to 1.0.

Documentation

Page What you will find
Installation, Upgrade and Removal Where to put the jar, how to verify it works, upgrading, cleanup on removal
Mining The five trigger rules, reach, break-time formula and conversion table, tool requirements, every mining.yml key
Building Paths (Placement) When it builds, what stairs / pillar / bridge do, anti-spam rules, placement.* and entry format
Block Backpack and Item Pickup How the stock is rolled, how counts are split, what is picked up and what is not
Birth Equipment, Messages and Player Targeting Nested equip.yml probabilities, message.yml placeholders and colours, targeting.yml
Commands, Permissions and Behaviour Overview Command details and permission nodes, mob / world filters, Folia notes, BlockLocker coexistence
FAQ and Known Limitations Debugging "it won't move / mine / build / pick up", and the "looks broken but isn't" cases
Changelog What changed in each version and which setting to touch when upgrading

Chinese documentation starts at 简体中文首页.

Compatibility

Item Details
Server Paper / Purpur / Canvas / Folia, 1.21.8 – 26.x
JDK 25 or newer
Dependencies None. BlockLocker is a soft dependency: only when present does the plugin skip its protected containers and doors
Client Nothing to install

Links

← Back to the repository

MobInteract · QQ 群 995974858 · Repository · Releases · Issues · English | 简体中文

MobInteract

English (default)

简体中文

Clone this wiki locally