Block & Mob Drops
AutoPickup doesn't change how drops are generated. It watches for item entities as they spawn and works out which player caused them. If it finds one, the item goes into that player's inventory instead of staying on the ground.
How a drop is matched to a player
- A player breaks a block. AutoPickup records the block position, the block ID and the player. Breaks cancelled by another plugin (a claim or protection plugin) are never recorded. See Protection Plugins.
- A player kills a mob. When an NPC dies from a player's hit, AutoPickup records the death
position and the killer. This only happens if the killer has auto-pickup on, and isn't in
creative while
disable-in-creativeis on. - An item spawns. AutoPickup looks for a recorded break or death:
- first at the item's exact block position,
- then the nearest one within
pickup-radiusblocks, - then, with Tree Detection on, the nearest tree break within
tree-pickup-radiusblocks.
- Records expire after
entry-expiry-msmilliseconds (default5000). An item that spawns later than that stays on the ground.
When an item is picked up
An item that matched a player is picked up only if all of these are true:
autopickup.enabledistrue.- The player is online and in the same world as the item.
- The player's own toggle is on (new players start with
default-enabled). - The player isn't explicitly denied
autopickup.toggle. - The player isn't in creative mode, when
disable-in-creativeistrue. - The item passes the Item Filters.
Item entities that are interactable, props, already being picked up, or marked "prevent pickup" are never touched.
Where items go
Items are added to the player's inventory hotbar first, then the rest of the inventory. The normal pickup animation plays, and the player gets a pickup notification.
If the inventory can't fit the whole stack, AutoPickup takes what fits and leaves the rest on the ground, where it can be picked up the usual way. A full inventory leaves the item untouched.
Pickup delay
pickup-delay-ticks (default 0) waits before checking an item, at 20 ticks per second. Leave it
at 0 for instant pickup. A short delay can help when another plugin needs to see the dropped
item first.
Settings
| Key | Default | What it does |
|---|---|---|
autopickup.enabled |
true |
Master switch for every pickup |
autopickup.default-enabled |
true |
Toggle state for players who never ran /autopickup |
autopickup.pickup-radius |
5 |
How far (in blocks) an item can spawn from the break or death |
autopickup.entry-expiry-ms |
5000 |
How long a break or death is remembered |
autopickup.disable-in-creative |
true |
Skip players in creative mode |
autopickup.pickup-delay-ticks |
0 |
Wait before checking a new item |
All of them are covered in Main Configuration.