# Auto Pickup<\/p>\n
<\/p>\n
**Auto Pickup** is a highly configurable server-side Fabric mod that automates the collection of items and experience orbs. It features session tracking, a multi-tier permission system, and extensive mod compatibility to ensure drops are attributed to the correct players, even when using high-speed mining mods or engaging in group combat.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### Core Functionality
\n– **\ud83c\udf92 Seamless Collection:** Items from broken blocks and mob kills are instantly added to your inventory
\n– **\u2b50 Smart Experience Handling:** Experience is cached and applied after a short delay, ensuring tools take durability damage *before* Mending activates
\n– **\ud83d\ude80 Lag-Free:** Prevents item and experience orb entities from spawning, reducing server load
\n– **\ud83d\udce6 Overflow Protection:** If your inventory is full, items safely drop at your feet
\n– **\ud83d\udd27 Granular Control:** Toggle individual features independently via commands or config GUI<\/p>\n
### Advanced Features
\n– **\ud83d\udc65 Mob Loot Splitting:** Share mob drops and XP with nearby players who participated in the kill
\n– **\ud83c\udfae Per-Player Permissions:** Server admins can override settings for specific players
\n– **\ud83d\udcbe Client Profiles:** Automatic per-server\/world configuration profiles for seamless server switching
\n– **\ud83d\udd0c Extensive Mod Compatibility:** Works automatically with VeinMiner, TreeHarvester, Traveler’s Backpack, and more<\/p>\n
<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
Auto Pickup uses a flexible three-tier permission system:<\/p>\n
1. **Server Defaults** – Global fallback settings
\n2. **Admin Overrides** – Per-player forced settings (highest priority)
\n3. **Client Preferences** – Individual player choices (only if server allows)<\/p>\n
### \ud83d\udda5\ufe0f Configuration Menu (Client)<\/p>\n
You can configure your personal preferences via the menu. Use **Mod Menu** for a easy access on Fabric.
\nOtherwise, use \/autopickup gui<\/p>\n
**Settings available:**
\n– Master Toggle
\n– Block Item Pickup
\n– Block Experience Pickup
\n– Mob Loot Pickup
\n– Mob Experience Pickup
\n– Split Mob Loot (share drops with nearby attackers)
\n– Split Mob XP (share experience with nearby attackers)<\/p>\n
> **Note:** Your client settings only apply if the server admin has enabled the corresponding “Allow” setting for that feature.<\/p>\n
<\/p>\n
—<\/p>\n
### \ud83d\udcdc Commands (Server Admin)<\/p>\n
Server operators (OP Level 2+) can manage global defaults and player overrides using `\/autopickup`.<\/p>\n
#### Menu Access<\/p>\n
| Command | Description |
\n|:——————|:—————————————–|
\n| `\/autopickup gui` | Access to configuration menu via command |<\/p>\n
#### Global Configuration<\/p>\n
| Command | Description | Default | #### Client Control Allowances<\/p>\n These commands determine whether players can override server defaults with their client settings.<\/p>\n | Command | Description | Default | #### Per-Player Overrides<\/p>\n Force specific settings for individual players (overrides both server defaults and client preferences).<\/p>\n | Command | Description | > Use `default` to remove a specific override while keeping others.<\/p>\n —<\/p>\n ### \ud83d\udcc2 Configuration Files<\/p>\n **Server Config:** `config\/AutoPickup\/global_config.json`<\/p>\n “`json **Client Config:** `config\/AutoPickup\/client_default.toml` (or per-server profiles in `presets\/`)<\/p>\n “`toml **Player Overrides:** `config\/AutoPickup\/player_overrides.json`<\/p>\n “`json ### Optional But Recommended Client Dependencies<\/p>\n – **Mod Menu** – Access config screen in-game —<\/p>\n ## \u2705 Compatibility<\/p>\n Auto Pickup hooks into core Minecraft mechanics and works seamlessly with most mods out of the box.<\/p>\n ### \ud83d\udd27 Explicitly Supported Mods<\/p>\n | Mod | Status | Notes | ### \ud83d\udccb Technical Details<\/p>\n Auto Pickup intercepts drops at these injection points:<\/p>\n – `Block.dropStacks()` – Primary block drop handling This broad compatibility means **most mods work automatically** without explicit support.<\/p>\n <\/p>\n —<\/p>\n ## \ud83c\udfae Mob Loot Splitting<\/p>\n When **Split Mob Loot** or **Split Mob XP** is enabled, rewards from mob kills are shared among participants:<\/p>\n ### How It Works<\/p>\n 1. **Damage Tracking:** The mod tracks the last 10 unique players who damaged each mob ### Example<\/p>\n Player A (killer), B, and C all damaged a zombie. Settings:<\/p>\n – **Player A:** Master \u2705, Mob Loot \u2705, Split Mob Loot \u2705 **Result:** Only A and B receive split loot. Player C gets nothing because they disabled splitting.<\/p>\n —<\/p>\n ## \ud83d\udc69\u200d\ud83d\udcbb Developer API<\/p>\n ### Adding as a Dependency<\/p>\n **Gradle:**<\/p>\n “`groovy ### Using the API<\/p>\n “`java public class QuestRewards {<\/p>\n public void giveReward(Player player, List \/\/ Auto Pickup handles: \/\/ Drop items that didn’t fit \/\/ Auto Pickup handles: \/\/ For mob-related rewards AutoPickupApi.tryPickupMobExperience(player, xp); ### API Methods<\/p>\n | Method | Description | > **Note:** All `try*` methods return lists of items that could not be picked up (full inventory).<\/p>\n —<\/p>\n ## \ud83d\udcdc License<\/p>\n This project is licensed under the **GNU Affero General Public License v3.0** (AGPL-3.0).<\/p>\n You are free to: See the [LICENSE](LICENSE) file for full details.<\/p>\n","protected":false},"excerpt":{"rendered":" Instantly collect items from mined blocks directly into your inventory with the AutoPickup mod. Mob loot & more configurable!<\/p>\n","protected":false},"featured_media":139866,"template":"","meta":{"_minecraft_slug":"simple-autopickup","_minecraft_project_id":"ycs4OjaI","_minecraft_author":"Lukarbonite","_minecraft_license":"LicenseRef-AGPL-3.0-only","_minecraft_downloads":18901,"_minecraft_follows":46,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simple-autopickup.zip","_minecraft_size_bytes":5030643,"_minecraft_version_count":47,"_minecraft_updated_at":"2026-05-16T12:39:56.852567Z","_minecraft_date_created":"2025-05-31T22:44:54.397275Z","_minecraft_date_modified":"2026-05-15T20:54:01.537756Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simple-autopickup","_minecraft_icon_attachment_id":139866,"_minecraft_imported_at":"2026-06-08T07:03:19+00:00","_minecraft_import_hash":"30c37a08c62ae401ef49ba48260c9ac6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,89,137,158,90,91,92],"mod_loader":[99,106,160],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-139865","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-mobs","mod_category-neoforge","mod_category-optimization","mod_category-storage","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|:——–|:———————————————–|:——–|
\n| `\/autopickup` | Display current configuration status | – |
\n| `\/autopickup master
\n| `\/autopickup blocks
\n| `\/autopickup blockxp
\n| `\/autopickup mobloot
\n| `\/autopickup mobxp
\n| `\/autopickup splitmobloot
\n| `\/autopickup splitmobxp
\n|:——–|:————|:——–|
\n| `\/autopickup allow master
\n| `\/autopickup allow blocks
\n| `\/autopickup allow blockxp
\n| `\/autopickup allow mobloot
\n| `\/autopickup allow mobxp
\n| `\/autopickup allow splitmobloot
\n| `\/autopickup allow splitmobxp
\n|:——–|:————|
\n| `\/autopickup override
\n| `\/autopickup override
\n| `\/autopickup override
\n| `\/autopickup override
\n| `\/autopickup override
\n| `\/autopickup override
\n| `\/autopickup override
\n| `\/autopickup override
\n{
\n “autoPickup”: true,
\n “autoPickupBlocks”: true,
\n “autoPickupBlockXp”: true,
\n “autoPickupMobLoot”: false,
\n “autoPickupMobXp”: false,
\n “autoPickupSplitMobLoot”: false,
\n “autoPickupSplitMobXp”: false,
\n “allowMaster”: true,
\n “allowBlocks”: true,
\n “allowBlockXp”: true,
\n “allowMobLoot”: true,
\n “allowMobXp”: true,
\n “allowSplitMobLoot”: true,
\n “allowSplitMobXp”: true
\n}
\n“`<\/p>\n
\n# AutoPickup Client Configuration
\nmaster = true
\nblocks = true
\nblockXp = true
\nmobLoot = false
\nmobXp = false
\nsplitMobLoot = false
\nsplitMobXp = false
\n“`<\/p>\n
\n{
\n “player-uuid-here”: {
\n “overrideMaster”: true,
\n “overrideBlocks”: null,
\n …
\n }
\n}
\n“`<\/p>\n
\n– **YetAnotherConfigLib (YACL)** – Required for config GUI (Vanilla GUI fallback)<\/p>\n
\n|:—-|:———–:|:——|
\n| **VeinMiner** | Fabric Only | All vein blocks picked up instantly with XP |
\n| **TreeHarvester** | Full | Logs\/leaves collected; saplings auto-replanted if enabled |
\n| **Traveler’s Backpack** | Full | Items route to backpack filter first (1.21.9+ with Auto Pickup upgrade) |
\n| **General Block Breakers** | Compatible | Any mod using vanilla break hooks |<\/p>\n
\n– `ServerWorld.spawnEntity()` – Item entity spawning
\n– `LivingEntity.dropLoot()` – Mob loot generation
\n– `Block.dropExperience()` – Block XP orbs
\n– `LivingEntity.dropExperience()` – Mob XP orbs<\/p>\n
\n2. **Eligibility Check:** On mob death, only players who:
\n – Are online and not spectating
\n – Have **Master** enabled
\n – Have the specific **Mob Pickup** feature enabled
\n – Have the specific **Split** feature enabled
\n – Are in the same world as the killer
\n3. **Distribution:**
\n – Items are split evenly; the killer receives any remainder
\n – Experience is split evenly; the killer receives any remainder
\n – Items that don’t fit in inventories are dropped at the mob’s location<\/p>\n
\n– **Player B:** Master \u2705, Mob Loot \u2705, Split Mob Loot \u2705
\n– **Player C:** Master \u2705, Mob Loot \u2705, Split Mob Loot \u274c<\/p>\n
\ndependencies {
\n compileOnly(files(“libs\/autopickup-platform-x.x.x.jar”))
\n}
\n“`<\/p>\n
\nimport com.lukarbonite.autopickup.AutoPickupApi;<\/p>\n
\n if (!isModLoaded(“autopickup”)) {
\n \/\/ Fallback: manual drops
\n items.forEach(stack -> player.dropItem(stack, false));
\n player.addExperience(xp);
\n return;
\n }<\/p>\n
\n \/\/ – Inventory insertion
\n \/\/ – Traveler’s Backpack routing
\n \/\/ – Config checks (Master, Blocks, etc.)
\n List
\n remaining.forEach(stack -> player.dropItem(stack, false));<\/p>\n
\n \/\/ – Mending calculations
\n \/\/ – Config checks
\n AutoPickupApi.tryPickupBlockExperience(player, xp);
\n }<\/p>\n
\n public void giveMobReward(Player player, List
\n List
\n remaining.forEach(stack -> player.dropItem(stack, false));<\/p>\n
\n }
\n}
\n“`<\/p>\n
\n|:——-|:————————————————————-|
\n| `tryPickup(PlayerEntity, List
\n| `tryPickupFromMob(PlayerEntity, List
\n| `tryPickupBlockExperience(PlayerEntity, int)` | Give block XP (respects Master + BlockXP settings) |
\n| `tryPickupMobExperience(PlayerEntity, int)` | Give mob XP (respects Master + MobXP settings) |
\n| `isMasterEnabled(PlayerEntity)` | Check if autopickup is enabled for player |
\n| `isBlocksEnabled(PlayerEntity)` | Check block item pickup setting |
\n| `isBlockXpEnabled(PlayerEntity)` | Check block XP pickup setting |
\n| `isMobLootEnabled(PlayerEntity)` | Check mob loot pickup setting |
\n| `isMobXpEnabled(PlayerEntity)` | Check mob XP pickup setting |<\/p>\n
\n– \u2705 Use in modpacks
\n– \u2705 Modify for personal use
\n– \u2705 Distribute modified versions (must also be AGPL-3.0)<\/p>\n