MobGrab Documentation
Complete reference for MobGrab v2.1.3
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.
All 90+ Mobs
Every living mob in 26.2 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 | op |
| mobgrab.admin | Access /mobgrab commands and GUI | op |
| mobgrab.update | Run /mobgrab update (downloads and installs the latest release) | op |
| mobgrab.bypass.protection | Ignore region protection checks | op |
Commands
| Command | Description | Permission |
|---|---|---|
| /mobgrab gui | Open the mob toggle GUI | mobgrab.admin |
| /mobgrab enable <mob> | Enable a mob for pickup | mobgrab.admin |
| /mobgrab disable <mob> | Disable a mob for pickup | mobgrab.admin |
| /mobgrab status | Show enabled count and current settings | mobgrab.admin |
| /mobgrab reload | Reload config and presets | mobgrab.admin |
| /mobgrab give <player|@s> <preset> | Give a preset mob item | mobgrab.admin |
| /mobgrab list | List available presets | mobgrab.admin |
| /mobgrab save <name> | Save the mob you're looking at as a preset | mobgrab.admin |
| /mobgrab delete <name> | Delete a preset | mobgrab.admin |
| /mobgrab update | Download and install the latest release jar | mobgrab.update |
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) |
| fireproof-items | true | Grabbed mob items survive fire & lava; can also be toggled live from the admin GUI |
| disabled-worlds | [] | Worlds where MobGrab is fully disabled (no pickup or placement), by world folder name |
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
Custom Presets
A preset is a saved mob you hand out as an item. Define them in plugins/MobGrab/presets.yml, then give them out.
Commands
- /mobgrab save <name> — save the mob you're looking at (works for any mob)
- /mobgrab give <player|@s> <preset> — give the preset item
- /mobgrab list — list presets · /mobgrab delete <name> — remove one
- /mobgrab reload — reload after editing the file
Hand-written villager preset
Best for custom trader villagers. Each top-level key is the preset name:
Fields
- type — entity type; defaults to VILLAGER
- profession — LIBRARIAN, ARMORER, WEAPONSMITH, TOOLSMITH, FARMER, CLERIC, FLETCHER, CARTOGRAPHER, BUTCHER, MASON, SHEPHERD, FISHERMAN, LEATHERWORKER, NITWIT, NONE
- villager-type — PLAINS, DESERT, JUNGLE, SAVANNA, SNOW, SWAMP, TAIGA
- trades — list of ingredient1 / optional ingredient2 / result / optional enchantments / max-uses
- equipment — optional helmet / chestplate / leggings / boots / main-hand / off-hand, each a material with optional enchantments
- Items are MATERIAL:AMOUNT (e.g. EMERALD:10); enchantments use lowercase ids (mending, sharpness)
Snapshot any mob
Look at any mob and run /mobgrab save <name>. It writes the exact mob to presets.yml as a snapshot — don't hand-edit the snbt:
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, plus a custom mob-grab region flag (set to deny to block pickups in a region)
- 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.