Intentional Pickup

A simple mod that makes mobs only pickup items that are intentionally dropped by players.

About The Project

Intentional Pickup is a small and lightweight mod for Fabric and NeoForge that changes mobs to only pickup items that are dropped by players and optionally only items included in the whitelist or not included in the blacklist. This change should reduce lag by preventing mass build-up of mobs in caves in long term worlds and servers. If running on a server the mod is only required on the server side and is not required to be on the client.

Configuring The Whitelist/Blacklist

Intentional Pickup uses item tags for its whitelist and blacklist, by default both lists are empty meaning mobs will pickup any item dropped by a player.

To add items to either the whitelist or blacklist you will need to create pickup_whitelist.json and/or pickup_blacklist.json file(s) in a datapack at data/intentional_pickup/tags/item/.

If you are unfamiliar will item tags you can follow this example from the Minecraft wiki#Basic_block_tag). Simply replace the minecraft:X entries with whatever items you want to allow or disallow.

It is also recommended to keep replace set to false or do not include it at all to ensure compatibility with other mods or datapacks that may add to these lists.

Run

1. Download intentional_pickup-<loader>-x.x.x+mc26.2.jar from one of the places at the top of this README.
2. Copy the downloaded jar file to your mods folder.

Getting Started With Development

To get a local copy up and running, follow these simple steps.

Prerequisites

Ensure you have the following installed on your machine:

• Java Development Kit (JDK): Version 25 or higher.
  • Download JDK
• Gradle: Version 9.2 or higher.
  • Install Gradle
• Minecraft: Version 26.2

Build

1. Clone the repository

git clone https://codeberg.org/VoxelBill/intentional-pickup.git

2. Navigate to the project directory

cd intentional-pickup

3. Build the project with Gradle

./gradlew clean build

You can find the built mod at intentional-pickup/<loader>/build/libs/intentional_pickup-<loader>-x.x.x+mc26.2.jar.

Play Bedrock Edition?

Intentional Pickup has a Minecraft: Bedrock Edition addon equivalent. You can visit its repo here.