Performance Guide
AutoPickup is light by design: it only does work when a block breaks, a mob dies, or an item spawns. The settings below decide how accurate and how forgiving it is.
How it keeps the cost down
- Recent breaks and mob deaths sit in an in-memory cache that expires entries on its own after
entry-expiry-msand never holds more than 10,000 entries. - Every player's toggle is loaded into memory at startup, so most pickups never touch the database. Toggle saves run in the background.
- Each item entity is only handled once, even under heavy load from mob farms or mass tree felling.
Tuning the radius
pickup-radius (default 5) is the main trade-off:
| Smaller radius | Larger radius |
|---|---|
| Fewer wrong matches between players mining side by side | Catches drops that bounce or scatter further |
| Better near claim borders | Better for mobs that fling loot |
| May miss scattered drops | May collect items the player didn't cause |
When several breaks are in range, the nearest one wins, so two players mining a few blocks apart usually still get their own drops.
Keep tree-pickup-radius larger than pickup-radius, or tree detection does nothing. The
default 15 covers large trees; lower it if your trees are small.
Tuning the timing
entry-expiry-ms (default 5000) is how long a break or death can claim drops.
- Drops normally spawn almost instantly, so a short window is enough for blocks.
- Mob loot and tree drops can take a moment longer, which is why the default is a few seconds.
- A long window raises the chance that an unrelated item (one a player throws, say) lands near an old break and gets collected.
This setting needs a restart to change.
pickup-delay-ticks adds a wait before each item is checked. It doesn't save any work, so leave
it at 0 unless another plugin needs to see the dropped item first. The wait must still fit
inside entry-expiry-ms.
Notifications
On a busy server, TITLE as the pickup style puts a banner on screen for every single item.
NOTIFICATION (default) or NONE are kinder for fast mining. See
Notifications.
Database
SQLite is plenty for one server. Only move to MySQL or MariaDB when several servers share toggles. See Database Setup.