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:

  • Ore matches Ore_Copper_Shale and every other ID containing ore.
  • Ingredient_ matches every ingredient item.
  • Ore_Copper matches only copper ore blocks.

Short entries can match more than you expect, because the match is anywhere in the ID.

Settings

yaml
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:

yaml
autopickup:
  whitelist-enabled: true
  blacklist-enabled: false
  whitelist:
    - "Ore"

Everything except containers and furniture:

yaml
autopickup:
  whitelist-enabled: false
  blacklist-enabled: true
  blacklist:
    - "Container"
    - "Furniture"

Apply changes with /autopickup reload.