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

  1. 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.
  2. 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-creative is on.
  3. 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-radius blocks,
    • then, with Tree Detection on, the nearest tree break within tree-pickup-radius blocks.
  4. Records expire after entry-expiry-ms milliseconds (default 5000). 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.enabled is true.
  • 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-creative is true.
  • 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.