# Auto Pickup for Fabric ![Fabric](https://img.shields.io/badge/modloader-fabric-blue?style=for-the-badge)![Minecraft](https://img.shields.io/badge/minecraft-1.20%20--%201.21.11-green?style=for-the-badge)![License](https://img.shields.io/badge/license-AGPL%203.0-lightgrey?style=for-the-badge) **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. --- ## ✨ Features ### Core Functionality - **🎒 Seamless Collection:** Items from broken blocks and mob kills are instantly added to your inventory - **⭐ Smart Experience Handling:** Experience is cached and applied after a short delay, ensuring tools take durability damage *before* Mending activates - **🚀 Lag-Free:** Prevents item and experience orb entities from spawning, reducing server load - **📦 Overflow Protection:** If your inventory is full, items safely drop at your feet - **🔧 Granular Control:** Toggle individual features independently via commands or config GUI ### Advanced Features - **👥 Mob Loot Splitting:** Share mob drops and XP with nearby players who participated in the kill - **🎮 Per-Player Permissions:** Server admins can override settings for specific players - **💾 Client Profiles:** Automatic per-server/world configuration profiles for seamless server switching - **🔌 Extensive Mod Compatibility:** Works automatically with VeinMiner, TreeHarvester, Traveler's Backpack, and more ![One-Block Mining](https://github.com/Lukarbonite/AutoPickup/raw/1.21.9-11/assets/ONE_BLOCK.gif) --- ## ⚙️ Configuration Auto Pickup uses a flexible three-tier permission system: 1. **Server Defaults** - Global fallback settings 2. **Admin Overrides** - Per-player forced settings (highest priority) 3. **Client Preferences** - Individual player choices (only if server allows) ### 🖥️ Mod Menu Integration (Client) If you have **Mod Menu** and **YetAnotherConfigLib (YACL)** installed, you can configure your personal preferences via the Mods menu. **Settings available:** - Master Toggle - Block Item Pickup - Block Experience Pickup - Mob Loot Pickup - Mob Experience Pickup - Split Mob Loot (share drops with nearby attackers) - Split Mob XP (share experience with nearby attackers) > **Note:** Your client settings only apply if the server admin has enabled the corresponding "Allow" setting for that feature. ![YACL Menu](https://github.com/Lukarbonite/AutoPickup/raw/1.21.9-11/assets/YACL_MENU.gif) --- ### 📜 Commands (Server Admin) Server operators (OP Level 2+) can manage global defaults and player overrides using `/autopickup`. #### Global Configuration | Command | Description | Default | |:--------|:------------|:--------| | `/autopickup` | Display current configuration status | - | | `/autopickup master ` | Master toggle - disables mod entirely if false | `true` | | `/autopickup blocks ` | Auto-pickup items from broken blocks | `true` | | `/autopickup blockxp ` | Auto-pickup experience from broken blocks | `true` | | `/autopickup mobloot ` | Auto-pickup loot from killed mobs | `false` | | `/autopickup mobxp ` | Auto-pickup experience from killed mobs | `false` | | `/autopickup splitmobloot ` | Share mob loot among nearby attackers | `false` | | `/autopickup splitmobxp ` | Share mob XP among nearby attackers | `false` | #### Client Control Allowances These commands determine whether players can override server defaults with their client settings. | Command | Description | Default | |:--------|:------------|:--------| | `/autopickup allow master ` | Allow clients to toggle master switch | `false` | | `/autopickup allow blocks ` | Allow clients to toggle block item pickup | `false` | | `/autopickup allow blockxp ` | Allow clients to toggle block XP pickup | `false` | | `/autopickup allow mobloot ` | Allow clients to toggle mob loot pickup | `false` | | `/autopickup allow mobxp ` | Allow clients to toggle mob XP pickup | `false` | | `/autopickup allow splitmobloot ` | Allow clients to toggle mob loot splitting | `false` | | `/autopickup allow splitmobxp ` | Allow clients to toggle mob XP splitting | `false` | #### Per-Player Overrides Force specific settings for individual players (overrides both server defaults and client preferences). | Command | Description | |:--------|:------------| | `/autopickup override master ` | Override player's master toggle | | `/autopickup override blocks ` | Override player's block pickup | | `/autopickup override blockxp ` | Override player's block XP | | `/autopickup override mobloot ` | Override player's mob loot | | `/autopickup override mobxp ` | Override player's mob XP | | `/autopickup override splitmobloot ` | Override player's loot splitting | | `/autopickup override splitmobxp ` | Override player's XP splitting | | `/autopickup override clear` | Remove all overrides for a player | > Use `default` to remove a specific override while keeping others. --- ### 📂 Configuration Files **Server Config:** `config/AutoPickup/global_config.json` ```json { "autoPickup": true, "autoPickupBlocks": true, "autoPickupBlockXp": true, "autoPickupMobLoot": false, "autoPickupMobXp": false, "autoPickupSplitMobLoot": false, "autoPickupSplitMobXp": false, "allowMaster": false, "allowBlocks": false, "allowBlockXp": false, "allowMobLoot": false, "allowMobXp": false, "allowSplitMobLoot": false, "allowSplitMobXp": false } ``` **Client Config:** `config/AutoPickup/client_default.toml` (or per-server profiles in `presets/`) ```toml # AutoPickup Client Configuration master = true blocks = true blockXp = true mobLoot = false mobXp = false splitMobLoot = false splitMobXp = false ``` **Player Overrides:** `config/AutoPickup/player_overrides.json` ```json { "player-uuid-here": { "overrideMaster": true, "overrideBlocks": null, ... } } ``` --- ## 📦 Installation ### Client & Server 1. Install [Fabric Loader](https://fabricmc.net/use/) 2. Download [Fabric API](https://modrinth.com/mod/fabric-api) and place in `mods/` 3. Download **Auto Pickup** from the [releases page](https://github.com/yourusername/auto-pickup/releases) 4. Place `auto-pickup-x.x.x.jar` in your `mods/` folder ### Optional But Recommended Client Dependencies - **Mod Menu** - Access config screen in-game - **YetAnotherConfigLib (YACL)** - Required for config GUI (fallback notice shown if missing) --- ## ✅ Compatibility Auto Pickup hooks into core Minecraft mechanics and works seamlessly with most mods out of the box. ### 🔧 Explicitly Supported Mods | Mod | Status | Notes | |:----|:------:|:------| | **VeinMiner** | ✅ Full | All vein blocks picked up instantly with XP | | **TreeHarvester** | ✅ Full | Logs/leaves collected; saplings auto-replanted if enabled | | **Traveler's Backpack** | ✅ Full | Items route to backpack filter first (1.21.9+ with Auto Pickup upgrade) | | **General Block Breakers** | ✅ Compatible | Any mod using vanilla break hooks | ### 📋 Technical Details Auto Pickup intercepts drops at these injection points: - `Block.dropStacks()` - Primary block drop handling - `ServerWorld.spawnEntity()` - Item entity spawning - `LivingEntity.dropLoot()` - Mob loot generation - `Block.dropExperience()` - Block XP orbs - `LivingEntity.dropExperience()` - Mob XP orbs This broad compatibility means **most mods work automatically** without explicit support. ![MultiBlock Mining](https://github.com/Lukarbonite/AutoPickup/raw/1.21.9-11/assets/MULTI_BLOCK.gif) --- ## 🎮 Mob Loot Splitting When **Split Mob Loot** or **Split Mob XP** is enabled, rewards from mob kills are shared among participants: ### How It Works 1. **Damage Tracking:** The mod tracks the last 10 unique players who damaged each mob 2. **Eligibility Check:** On mob death, only players who: - Are online and not spectating - Have **Master** enabled - Have the specific **Mob Pickup** feature enabled - Have the specific **Split** feature enabled - Are in the same world as the killer 3. **Distribution:** - Items are split evenly; the killer receives any remainder - Experience is split evenly; the killer receives any remainder - Items that don't fit in inventories are dropped at the mob's location ### Example Player A (killer), B, and C all damaged a zombie. Settings: - **Player A:** Master ✅, Mob Loot ✅, Split Mob Loot ✅ - **Player B:** Master ✅, Mob Loot ✅, Split Mob Loot ✅ - **Player C:** Master ✅, Mob Loot ✅, Split Mob Loot ❌ **Result:** Only A and B receive split loot. Player C gets nothing because they disabled splitting. --- ## 👩‍💻 Developer API ### Adding as a Dependency **Gradle:** ```groovy dependencies { modCompileOnly files("libs/auto-pickup-x.x.x.jar") } ``` ### Using the API ```java import com.lukarbonite.autopickup.AutoPickupApi; import net.fabricmc.loader.api.FabricLoader; public class QuestRewards { public void giveReward(PlayerEntity player, List items, int xp) { if (!FabricLoader.getInstance().isModLoaded("auto-pickup")) { // Fallback: manual drops items.forEach(stack -> player.dropItem(stack, false)); player.addExperience(xp); return; } // Auto Pickup handles: // - Inventory insertion // - Traveler's Backpack routing // - Config checks (Master, Blocks, etc.) List remaining = AutoPickupApi.tryPickup(player, items); // Drop items that didn't fit remaining.forEach(stack -> player.dropItem(stack, false)); // Auto Pickup handles: // - Mending calculations // - Config checks AutoPickupApi.tryPickupBlockExperience(player, xp); } // For mob-related rewards public void giveMobReward(PlayerEntity player, List loot, int xp) { List remaining = AutoPickupApi.tryPickupFromMob(player, loot); remaining.forEach(stack -> player.dropItem(stack, false)); AutoPickupApi.tryPickupMobExperience(player, xp); } } ``` ### API Methods | Method | Description | |:-------|:------------| | `tryPickup(PlayerEntity, List)` | Pickup items from blocks (respects Master + Blocks settings) | | `tryPickupFromMob(PlayerEntity, List)` | Pickup items from mobs (respects Master + MobLoot settings) | | `tryPickupBlockExperience(PlayerEntity, int)` | Give block XP (respects Master + BlockXP settings) | | `tryPickupMobExperience(PlayerEntity, int)` | Give mob XP (respects Master + MobXP settings) | | `isMasterEnabled(PlayerEntity)` | Check if auto-pickup is enabled for player | | `isBlocksEnabled(PlayerEntity)` | Check block item pickup setting | | `isBlockXpEnabled(PlayerEntity)` | Check block XP pickup setting | | `isMobLootEnabled(PlayerEntity)` | Check mob loot pickup setting | | `isMobXpEnabled(PlayerEntity)` | Check mob XP pickup setting | > **Note:** All `try*` methods return lists of items that could not be picked up (full inventory). --- ## 📜 License This project is licensed under the **GNU Affero General Public License v3.0** (AGPL-3.0). You are free to: - ✅ Use in modpacks - ✅ Modify for personal use - ✅ Distribute modified versions (must also be AGPL-3.0) See the [LICENSE](LICENSE) file for full details.

Lukarbonite

Simple AutoPickup