MobInteract
English | 简体中文
赋予人形生物挖掘方块、构建自身路径(楼梯 / 搭柱上升 / 搭桥)以抵达它们原本无法到达的目标,以及从地上拾取方块和镐子的能力。
安装后,那些曾经站在栅栏后面、凝视深渊或在玩家搭起的柱子上踱步的僵尸、骷髅或卫道士将不再袖手旁观:它们会打破阻挡的方块,从携带的库存中取出圆石,搭建台阶向上攀登,搭桥跨越障碍,并捡起散落在地上的镐子和方块。
| 能力 |
作用 |
要求 |
| Mining (挖掘) |
破坏前方的方块、头顶上方的方块,或脚下/目标下方的方块 |
主手持有镐子,存在可挖掘的方块,且在可触及范围内 |
| Building (建造) |
从虚拟库存中取出方块来建造楼梯 / 搭柱上升 / 搭桥 / 向下阶梯 |
生成时获得了库存,剩余电荷充足,且有目标 |
| Pickup (拾取) |
走向掉落的物品:方块进入库存,镐子放入主手 |
默认开启 |
这不是通用的生物 AI,也不会替换原版寻路逻辑:它仅在此基础上添加了两个高优先级的行为,因此原版的锁定目标、跳跃和绕路功能仍照常工作。村民、流浪商人和其他友好生物默认不会被接管。
Compatibility (兼容性)
| Item (项目) |
Details (详情) |
| Server (服务端) |
Paper / Purpur / Canvas / Folia,1.21.8 – 26.x |
| One jar for all (单文件兼容所有版本) |
基于最旧的支持版本编译;较新的服务端接受较旧的 api-version,反之则不行——因此提供了一个适用于 1.21.8 和 26.x 的单文件 |
| Minimum version (最低版本) |
1.21.8(旧版服务端缺乏本插件所依赖的寻路/调度能力) |
| Soft dependency (软依赖) |
BlockLocker(如果已安装,受保护的箱子、门和陷阱门会自动跳过;非必需) |
| Not required (无需额外需求) |
客户端模组、资源包、额外依赖项 |
Download and install (下载与安装)
- 从 Releases 获取最新的
MobInteract-x.y.z.jar。
- 将其放入服务端的
plugins/ 文件夹并重启。
- 首次启动时,会在
plugins/MobInteract/ 目录下创建五个配置文件:mining.yml、placement.yml、equip.yml、targeting.yml、message.yml —— 均带有注释说明。
- 在游戏中运行
/mobinteract status 查看配置摘要,然后对准一只僵尸运行 /mobinteract inspect 以查看它当前的思考状态。
要升级,只需替换 jar 文件并重启即可——你的配置文件永远不会被覆盖,且你在旧版本中编辑的值具有优先级。详情请参阅 Installation, Upgrade and Removal。
Commands (命令)
命令为 /mobinteract,别名为 /mi,权限节点为 mobinteract.admin(默认仅限 OP)。
| Command (命令) |
Purpose (用途) |
/mobinteract status |
配置摘要:生物/世界过滤条件、挖掘参数、建造限制、装备几率、已知生物、临时方块、保护插件状态 |
/mobinteract inspect |
你当前注视的生物的实时状态:冷却时间、本次追逐中使用的放置次数、手中的镐子、库存内容、最后一次动作(当生物“就是不动”时首先检查此项) |
/mobinteract reload |
热重载所有配置文件,而不会中断正在进行的挖掘或建造动作 |
Configuration at a glance (配置概览)
五个文件,各司其职;运行 /mobinteract reload 即可立即生效:
| File (文件) |
What it controls (控制内容) |
mining.yml |
挖掘:哪些方块可挖掘、挖掘速度、范围、排除列表 |
placement.yml |
建造和拾取:放置什么、频率、方块持续时间、库存内容、拾取内容 |
equip.yml |
出生装备门槛:多大比例的生灵出生时持有镐子/拥有库存 |
targeting.yml |
玩家锁定:附近有玩家时切换至最近的玩家 |
message.yml |
发送给玩家的所有消息:颜色、措辞、多行显示 |
每个键值、默认值和调整建议均位于 Wiki 中,每个主题对应一个页面:
| Wiki 页面 |
内容 |
| 安装、升级与移除 |
jar 文件放置位置、验证是否生效的方法、升级步骤、移除时插件清理的内容 |
| 挖掘 |
五种触发规则、挖掘范围、破坏时间公式与换算表、工具与镐子、所有 mining.yml 键值说明 |
| 建造路径 |
何时进行建造、如何选取楼梯 / 柱子 / 桥梁、防刷屏规则、placement.* 及条目格式 |
| 方块背包与物品拾取 |
库存如何滚动更新、数量如何拆分、哪些物品会被拾取以及哪些不会 |
| 出生装备、消息提示与玩家锁定 |
嵌套的 equip.yml 概率配置、message.yml 占位符、targeting.yml 目标锁定逻辑 |
| 命令、权限与行为概览 |
命令详情、实体 / 世界过滤器、Folia 注意事项、BlockLocker 共存方案 |
| 常见问题与已知限制 |
如何调试“不移动 / 不挖掘 / 不建造 / 不拾取”的问题,以及“看似损坏实则正常”的情况 |
| 更新日志 |
各版本变更内容及升级时需调整的设置项 |
常见误解
- “为什么它不挖矿?” — 手中没有镐子(默认情况下必须持有),该方块位于安全黑名单中(如基岩、屏障、方块实体等),或者距离超出了挖掘范围。
- “为什么它只是站在那里不动?” — 没有库存、建造次数已用完、仍处于冷却状态,或被世界 / 实体白名单与黑名单过滤;使用
/mobinteract inspect 可以查看具体原因。
- “为什么桥还在 / 已经消失了?” — 默认情况下,放置的方块会在 15 秒后消失;如果实体站在上面,计时器会重置。将其设置为 0 可永久保留。
- “为什么它不追我?” — 原版寻路机制不会穿过它看不到的墙壁去挖掘,除非启用了“挖掘面前的方块”或它正在主动追击(
targeting.yml 可使其锁定附近的玩家)。
- “为什么村民什么都不做?” — 友好型实体默认不会被接管;这是功能特性,而非漏洞。
更多故障排除方法请参阅 常见问题与已知限制。
许可协议
Apache License 2.0 © 2026 LiuyeStudio · 作者 @nukebean
只要保留版权声明和许可声明,即可免费使用、修改和重新分发,包括商业用途。
MobInteract
English | 简体中文
Gives humanoid mobs the ability to mine blocks, build their own path (stairs / pillar up / bridge) toward targets they could never reach, and pick up blocks and pickaxes off the ground.
Once installed, the zombie, skeleton or vindicator that used to stand behind a fence, stare across a ravine, or pace under a player on a pillar will take matters into its own hands: break the blocking block, pull cobblestone out of its carried stock, stack a step up, bridge across, and grab pickaxes and blocks lying around.
| Ability |
What it does |
Requirement |
| Mining |
Breaks the block in its way, the block above its head, or the block under its feet / under its target |
A pickaxe in the main hand, a mineable block, within reach |
| Building |
Takes blocks from its virtual stock to build stairs / pillar up / bridge / step down |
Was given a stock at spawn, charges left, has a target |
| Pickup |
Walks to dropped items: blocks go into the stock, pickaxes into the main hand |
On by default |
This is not a general-purpose mob AI and it does not replace vanilla pathfinding: it only adds two higher-priority behaviours on top, so vanilla targeting, jumping and detouring still work as usual. Villagers, wandering traders and other friendly mobs are not taken over by default.
Compatibility
| Item |
Details |
| Server |
Paper / Purpur / Canvas / Folia, 1.21.8 – 26.x |
| One jar for all |
Built against the oldest supported version; newer servers accept the older api-version, the reverse is not true — hence a single jar for 1.21.8 and 26.x alike |
| Minimum version |
1.21.8 (older servers lack the pathfinding / scheduling capabilities this plugin relies on) |
| Soft dependency |
BlockLocker (if present, protected chests, doors and trapdoors are skipped automatically; not required) |
| Not required |
Client mods, resource packs, extra dependencies |
Download and install
- Grab the latest
MobInteract-x.y.z.jar from Releases.
- Drop it into your server's
plugins/ folder and restart.
- On first start it creates five configuration files in
plugins/MobInteract/: mining.yml, placement.yml, equip.yml, targeting.yml, message.yml — all with comments.
- In game, run
/mobinteract status for a configuration summary, then aim at a zombie and run /mobinteract inspect to see what it is currently thinking.
To upgrade, just replace the jar and restart — your configuration files are never overwritten, and values you edited in an older version win. See Installation, Upgrade and Removal for the details.
Commands
The command is /mobinteract, alias /mi, permission node mobinteract.admin (OP only by default).
| Command |
Purpose |
/mobinteract status |
Configuration summary: mob / world filters, mining parameters, build limits, equipment chance, known mobs, temporary blocks, protection-plugin status |
/mobinteract inspect |
Live state of the mob you are looking at: cooldown, placements used in this chase, pickaxe in hand, stock contents, last action (the first thing to check when a mob "just won't move") |
/mobinteract reload |
Hot-reloads every configuration file without interrupting an ongoing mining or building action |
Configuration at a glance
Five files, one job each; run /mobinteract reload and the change takes effect immediately:
| File |
What it controls |
mining.yml |
Mining: which blocks are mineable, how slow, how far, which are excluded |
placement.yml |
Building and pickup: what gets placed, how often, how long blocks last, what the stock contains, what gets picked up |
equip.yml |
The spawn-equipment gate: what fraction of mobs are born with a pickaxe / with a stock |
targeting.yml |
Player targeting: switch to the nearest player when one is around |
message.yml |
Every message sent to players: colours, wording, multiple lines |
Every key, default value and tuning advice lives in the wiki, one page per topic:
| Wiki page |
Contents |
| Installation, Upgrade and Removal |
Where to put the jar, how to verify it works, upgrading, what the plugin cleans up on removal |
| Mining |
The five trigger rules, reach, break-time formula and conversion table, tools and pickaxes, every mining.yml key |
| Building Paths |
When it builds, how it chooses stairs / pillar / bridge, the 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, targeting.yml |
| Commands, Permissions and Behaviour Overview |
Command details, mob / world filters, Folia notes, BlockLocker coexistence |
| FAQ and Known Limitations |
How to debug "it won't move / mine / build / pick up", plus the "looks broken but isn't" cases |
| Changelog |
What changed in each version and which setting to touch when upgrading |
Common misunderstandings
- "Why isn't it mining?" — No pickaxe in hand (one is required by default), the block is on the safety blacklist (bedrock, barriers, block entities…), or it is simply out of reach.
- "Why is it just standing there?" — No stock, placements used up, still cooling down, or filtered out by the world / mob allow- and deny-lists;
/mobinteract inspect tells you which.
- "Why is the bridge still there / gone already?" — Placed blocks vanish after 15 seconds by default; a mob standing on top re-arms the timer. Set it to 0 to keep them forever.
- "Why doesn't it chase me?" — Vanilla pathfinding will not dig through a wall it cannot see you behind, unless you enable "mine the block in front" or it is actively chasing (
targeting.yml can make it fixate on a nearby player).
- "Why do villagers do nothing?" — Friendly mobs are not taken over by default; that is a feature, not a bug.
More troubleshooting in FAQ and Known Limitations.
License
Apache License 2.0 © 2026 LiuyeStudio · Author @nukebean
Free to use, modify and redistribute, including commercially, as long as the copyright and license notice are kept.
评论 0
登录后参与评分
还没有评论,来抢沙发吧