Pickup Pets
Pickup pets are NPC companions that follow the player and automatically pick up dropped items.
How It Works
- Summon: Right-click a Pet Egg or use
/kspet summon <type> - Follow: The pet NPC follows the player using Seek BodyMotion
- Detect: Items within detect range (15 blocks from player) are targeted
- Pickup: When the pet reaches the item, it's added to the player's inventory
- Filter: Only items matching the pickup filter are targeted
All Pickup Pets (26)
Uncommon
| Pet | Entity |
|---|---|
| Bunny | Bunny |
| Parrot | Parrot |
| Frog (Green) | Frog_Green |
| Squirrel | Squirrel |
| Bat | Bat |
| Crab | Crab |
| Duck | Duck |
| Gecko | Gecko |
| Meerkat | Meerkat |
| Bluebird | Bluebird |
| Lizard (Sand) | Lizard_Sand |
| Trork | Trork |
| Wolf | Wolf |
Rare
| Pet | Entity |
|---|---|
| Fox | Fox |
| Cat | Cat |
| Owl (Snow) | Owl_Snow |
| Archaeopteryx | Archaeopteryx |
| Cactee | Cactee |
| Hatworm | Hatworm |
| Penguin | Penguin |
| Skrill Chick | Skrill_Chick |
| Ferab Cub | Ferab_Cub |
| Fen Stalker | Fen_Stalker |
Epic
| Pet | Entity |
|---|---|
| Yeti | Yeti |
| Dragon (Frost) | Dragon_Frost |
Legendary
| Pet | Entity |
|---|---|
| Dragon | Dragon |
Leveling
Pets gain XP from multiple sources:
| Source | Default XP | Description |
|---|---|---|
| Mob Kill | 25 | Owner kills a mob |
| Block Break | 2 | Owner breaks a block |
| Crafting | 10 | Owner crafts an item |
| Item Pickup | 2 | Pet picks up an item |
| Passive | 1/min | While pet is active |
XP per level scales with xpScaleFactor:
XP needed = baseXpPerLevel * (xpScaleFactor ^ (level - 1))
Stat Buffs
Each pet has randomly rolled stats based on rarity. All pets draw from a shared pool of 11 stats. Active stats provide buffs to the player:
| Stat | Display | Effect |
|---|---|---|
damage_bonus | DMG | Percentage damage bonus |
crit_chance | Crit | Critical hit chance |
armor_bonus | Armor | Damage reduction percentage |
max_health | HP | Flat bonus maximum health |
speed_bonus | Speed | Movement speed bonus |
pickup_radius | Range | Increased item pickup range |
xp_bonus | XP | Pet XP gain bonus |
loot_luck | Luck | Loot luck bonus |
stamina_regen | Stamina Regen | Stamina regeneration rate |
mana_regen | Mana Regen | Mana regeneration rate |
thorns | Thorns | Damage reflected to attackers |
life_steal | Life Steal | Health restored on damage dealt |
The same stat type can appear up to 3 times on a single pet, stacking additively.
Pickup Filter
The filter controls which items the pet picks up.
Modes
- Blacklist (default): Pet picks up everything EXCEPT listed items
- Whitelist: Pet picks up ONLY listed items
Rule Types
| Type | Example | Description |
|---|---|---|
name | Dirt | Exact item name match |
property | weapon | Item property category (weapon, armor, tool, consumable, ore, resource) |
Presets
Quick-apply common filter configurations:
- No Junk: Blocks Dirt, Sand, Stone, Gravel, Cobblestone, Mud
- Valuables: Only valuable/rare items
- Ores Only: Only ore items
- Pick All: No filter — picks up everything
Smart Pickup
- Only dropped items are targeted (not placed furniture/flowers)
- Items must have a
DespawnComponent(lifetime timer) to be eligible canPickUp()check ensures only actual drops are collected- Items go to Storage first (not Hotbar) to avoid inventory animation
Pet Eggs
Pet Eggs are tradeable items with embedded metadata:
- Item ID: Configured per pet type (e.g.,
Pet_Egg_Wolf) - Metadata: BsonDocument with instance ID, pet type, stats, level, XP
- Right-click: Spawns or dismisses the pet
- Trade: Eggs can be traded between players — pet data travels with the item
tip
Use /kspetadmin give <player> <type> to create eggs for any registered pet type.