Item Filters
By default AutoPickup collects every drop. The whitelist and blacklist narrow that down.
Modes
whitelist-enabled |
blacklist-enabled |
Result |
|---|---|---|
false |
false |
Everything is picked up (default) |
true |
false |
Only drops matching the whitelist are picked up |
false |
true |
Everything except drops matching the blacklist is picked up |
true |
true |
Whitelist wins; the blacklist is switched off on startup |
When both are on at startup, AutoPickup logs a warning, sets blacklist-enabled: false and saves
config.yml.
What gets matched
This is the part that trips people up: the ID that's checked depends on where the drop came from.
- Block breaks: the filter checks the ID of the block that was broken, not the item that dropped. Every drop from that block follows the block's result.
- Mob kills: the filter checks the item ID of each drop.
So a whitelist entry of Ore lets every ore block's drops through, and an entry of
Ingredient_Bone_Fragment lets that item through when a mob drops it.
Partial matching
Entries match when the ID contains them, ignoring case:
OrematchesOre_Copper_Shaleand every other ID containingore.Ingredient_matches every ingredient item.Ore_Coppermatches only copper ore blocks.
Short entries can match more than you expect, because the match is anywhere in the ID.
Settings
autopickup:
whitelist-enabled: false
blacklist-enabled: false
whitelist:
- "Ore_Copper_Shale"
- "Ingredient_Bone_Fragment"
blacklist:
- "Ingredient_Sac_Venom"
- "Ingredient_Fabric_Scrap_Linen"
The shipped entries are examples. Both lists are ignored until their -enabled key is true.
Examples
Only ores:
autopickup:
whitelist-enabled: true
blacklist-enabled: false
whitelist:
- "Ore"
Everything except containers and furniture:
autopickup:
whitelist-enabled: false
blacklist-enabled: true
blacklist:
- "Container"
- "Furniture"
Apply changes with /autopickup reload.