Pickup Filter

Decide what ends up in your inventory. Pick the items you never want to collect and leave them on the ground - or turn it around and collect only the items you chose, ignoring everything else.

Both directions are the same list read two ways:

• Blacklist - everything is picked up except the items on the list. Add rotten_flesh and gunpowder, walk over a zombie or creeper drop, and the loot stays on the ground.
• Whitelist - nothing is picked up except the items on the list. Put ores and diamonds on it before a mining trip and the cobblestone stays where it is.

One button on the settings screen switches between them, and each saved profile remembers its own mode.

Profiles

The item list is a profile, and you can keep as many as you need (up to 32). They live in a sidebar on the left of the settings screen - click one to switch to it, immediately.

• Each profile stores its own items and its own mode, so a "mob junk" blacklist and a "mining trip" whitelist sit side by side.
• Every row is marked B or W, so you can tell a whitelist from a blacklist without switching to it first.
• New, Rename and Delete sit above the list. Deleting asks for confirmation, and the last remaining profile cannot be deleted.

An empty whitelist filters nothing at all, rather than blocking the entire game - a profile you have not filled in yet quietly leaves your pickups alone, and the screen tells you so.

Read this first: what "filtered" actually means

Item pickup is decided by the server, not by your client. That is a Minecraft fact, not a shortcoming of this mod, and it means you get one of two behaviours depending on where you are playing.

Singleplayer and LAN worlds - genuinely never picked up

The "server" is running inside your own game, so the mod reaches it. The pickup is cancelled before vanilla touches your inventory:

• no inventory insertion
• no pickup sound
• no take-item animation
• the item stays exactly where it dropped

No blip, no flicker, nothing to clean up. Change the list, the mode or the profile and it takes effect on the very next step - no restart, no relog.

Dedicated servers - picked up, then instantly thrown back out

On a real server the mod is not running on the machine making the decision. The server hands you the item no matter what. So the fallback does the only honest thing available: it drops the filtered stack straight back out, using the exact packets vanilla sends when you press Q.

You will see the item briefly enter your inventory, a normal drop animation, and the item on the ground next to you. Nothing about it is a cheat - the server receives an ordinary drop and the vanilla drop-spam throttle is respected. But it is not the same as never picking it up, and no client-side mod can do better than this.

The mod tells you this in chat the first time it happens each session. You can switch the fallback off entirely with the Auto-drop on servers checkbox.

Loop protection on the server path: one stack per tick, a 60-tick cooldown per item type, nothing ejected while a screen is open or while you are carrying a stack on the cursor, and armour and offhand slots are never touched.

Features

• Blacklist or whitelist, switchable per profile.
• Profiles in a sidebar, with new / rename / delete and one-click switching.
• Whole item registry. Not just blocks - rotten flesh, gunpowder, arrows, spawn eggs, everything.
• Creative-inventory-style picker. 9 columns, 6 rows, mouse wheel and a draggable scrollbar.
• Live search by display name or registry id. rotten, flesh, and minecraft:rotten_flesh all find the same item.
• Creative tab browsing if you would rather look than type.
• Showcase grid of the active profile's items. Left-click to remove.
• Master on/off toggle and a two-step "Clear all".
• Mod Menu support (optional).
• Config stored as readable JSON with registry ids, never numeric ids.

Controls

The keybind "Open Pickup Filter" is under its own Pickup Filter category in Controls and is unbound by default - pick your own key. Pressing it again while the settings screen is open closes it, so it works as one toggle.

Config

config/pickupfilter.json:

{
  "enabled": true,
  "autoDropOnServers": true,
  "ejectDelayTicks": 5,
  "activeProfile": 0,
  "profiles": [
    {
      "name": "Mob junk",
      "mode": "blacklist",
      "items": [
        "minecraft:rotten_flesh",
        "minecraft:gunpowder"
      ]
    },
    {
      "name": "Mining trip",
      "mode": "whitelist",
      "items": [
        "minecraft:diamond",
        "minecraft:raw_iron"
      ]
    }
  ]
}

Unknown ids from an older config are skipped with a log warning, not crashed on. A config from 1.1.0 or earlier is migrated into a single blacklist profile named "Default" the first time it is loaded, with nothing lost.

Requirements

• Fabric Loader 0.19.3+
• Fabric API
• Mod Menu - optional