MobGrab Documentation
Complete reference for MobGrab v1.4.0
Overview
MobGrab lets players pick up mobs by shift + right-clicking them. The mob turns into a player head item with full data preserved — health, equipment, trades, name, variant, everything. Right-click a block to place the mob back down exactly as it was.
85+ Mobs
Every mob in 1.21 supported with custom head textures.
Full Data
Trades, profession, level, equipment, enchants — all preserved.
Region Protection
Respects WorldGuard, PlotSquared, and GriefPrevention.
Bedrock Support
Form-based GUI for Bedrock players via Floodgate.
How to Use
Picking Up
Sneak + Right-click a mob to pick it up. It becomes a player head item in your inventory with the mob's face, stats, and data shown in the lore.
If your inventory is full, the item drops at your feet.
Placing Down
Hold the mob item and right-click any block to place the mob back down. All data is restored — trades, health, name, equipment, everything.
Permissions
Bundle Permissions
Grant entire categories of mobs at once.
| Permission | Description | Default |
|---|---|---|
| mobgrab.pickup.* | Pick up all mobs (includes all bundles) | false |
| mobgrab.pickup.passive | All passive mobs (cows, sheep, horses, etc.) | false |
| mobgrab.pickup.hostile | All hostile mobs (zombies, skeletons, etc.) | false |
| mobgrab.pickup.villager | Villagers and zombie villagers | false |
| mobgrab.pickup.utility | Iron golems, snow golems, copper golems | false |
| mobgrab.pickup.boss | Warden, Wither, Ender Dragon | false |
Individual Mob Permissions
Every mob has its own permission node: mobgrab.pickup.<mob>
For example: mobgrab.pickup.cow, mobgrab.pickup.villager, mobgrab.pickup.creeper
The mob name matches the Bukkit EntityType in lowercase. All individual permissions are listed in plugin.yml and are discoverable in LuckPerms.
Core Permissions
| Permission | Description | Default |
|---|---|---|
| mobgrab.place | Place mob items back down | false |
| mobgrab.admin | Access /mobgrab commands and GUI | op |
| mobgrab.bypass.protection | Ignore region protection checks | op |
Commands
| Command | Description | Permission |
|---|---|---|
| /mobgrab gui | Opens the mob toggle GUI to enable/disable mobs | mobgrab.admin |
| /mobgrab reload | Reloads the config file | mobgrab.admin |
Configuration
All settings are in plugins/MobGrab/config.yml.
Sound Effects
| Key | Default | Description |
|---|---|---|
| pickup-sound | ENTITY_CHICKEN_EGG | Sound when picking up a mob |
| pickup-sound-volume | 0.8 | Volume (0.0 – 1.0) |
| pickup-sound-pitch | 1.4 | Pitch (0.5 – 2.0) |
| place-sound | ENTITY_ENDERMAN_TELEPORT | Sound when placing a mob |
| place-sound-volume | 0.6 | Volume |
| place-sound-pitch | 1.2 | Pitch |
Particle Effects
| Key | Default | Description |
|---|---|---|
| pickup-particles | SMOKE | Particle type on pickup |
| pickup-particle-count | 15 | Number of particles |
| place-particles | HAPPY_VILLAGER | Particle type on place |
| place-particle-count | 20 | Number of particles |
Mechanics
| Key | Default | Description |
|---|---|---|
| cooldown-seconds | 1 | Cooldown between pickups per player |
| blacklist-mode | false | false = whitelist (only listed mobs), true = blacklist (all except listed) |
Mob Toggles
Under enabled-mobs:, each mob type can be set to true or false.
In whitelist mode (default), only mobs set to true can be picked up. In blacklist mode, all mobs can be picked up unless set to false.
Mobs can also be toggled in-game via /mobgrab gui.
Mob Info Display
When a mob is picked up, the item shows detailed info in its lore. What's displayed depends on the mob type:
| Info | Shown On |
|---|---|
| Health | All living entities |
| Custom name | Named mobs |
| Owner | Tamed pets (wolves, cats, parrots, etc.) |
| Baby | Any ageable mob that isn't adult |
| Sitting | Tamed pets that are sitting |
| Profession, Level, Trades | Villagers |
| Color, Style | Horses |
| Type, Collar | Cats, Wolves |
| Wool Color, Sheared | Sheep |
| Variant | Axolotls, Frogs, Mooshrooms |
| Color | Parrots, Llamas, Shulkers |
| Type | Foxes, Rabbits |
| Personality | Pandas |
| Nectar, Stung, Angry | Bees |
| Screaming, Horns | Goats |
| Charged | Creepers |
| Size | Slimes, Magma Cubes, Phantoms |
| Pattern, Body Color | Tropical Fish |
| Puff State | Pufferfish |
| Shivering | Striders |
| Weathering State | Copper Golems |
| Equipment & Enchants | Any mob with armor or held items |
Villager Trades
Villager items display a full trade list with icons:
- Each trade shows ingredients and result with item icons
- Multi-ingredient trades display a + between inputs
- Enchanted book trades show the enchantment name directly as the result
- Exhausted trades (no uses left) appear with strikethrough
Compatibility
All integrations are soft dependencies — MobGrab works fine without any of them installed.
Region Protection
Mobs can only be picked up or placed where the player has build permission. Supports:
- WorldGuard — checks the BUILD flag
- PlotSquared — checks plot ownership and membership
- GriefPrevention — checks claim build access
Use mobgrab.bypass.protection to skip these checks.
RoseStacker
When picking up a mob from a RoseStacker stack, only one mob is removed from the stack instead of the whole group.
Floodgate / Geyser
Bedrock players automatically get a form-based GUI for /mobgrab gui instead of the chest inventory.
ClickVillagers Migration
MobGrab can place villager items created by ClickVillagers. Players can right-click to place their old ClickVillagers items normally. When they pick the villager up again, it becomes a MobGrab item going forward.