Simple AutoPickup

Minecraft 版本： 1.21.9 1.21.10 1.21.11

平台： neoforge

标签： game-mechanics mobs utility

AutoPickup

AutoPickup is a highly configurable server-side 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, FallingTree, Panda's Falling Trees and more

⚙️ Configuration

AutoPickup 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)

🖥️ Configuration Menu (Client)

You can configure your personal preferences via the menu. Use Mod Menu for a easy access on Fabric.
Otherwise, use /autopickup gui

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.

📜 Commands (Server Admin)

Server operators (OP Level 2+) can manage global defaults and player overrides using /autopickup.

Menu Access

Global Configuration

Client Control Allowances

These commands determine whether players can override server defaults with their client settings.

Per-Player Overrides

Force specific settings for individual players (overrides both server defaults and client preferences).

Use default to remove a specific override while keeping others.

📂 Configuration Files

Server Config: config/AutoPickup/global_config.json

{
  "autoPickup": true,
  "autoPickupBlocks": true,
  "autoPickupBlockXp": true,
  "autoPickupMobLoot": false,
  "autoPickupMobXp": false,
  "autoPickupSplitMobLoot": false,
  "autoPickupSplitMobXp": false,
  "allowMaster": true,
  "allowBlocks": true,
  "allowBlockXp": true,
  "allowMobLoot": true,
  "allowMobXp": true,
  "allowSplitMobLoot": true,
  "allowSplitMobXp": true
}

Client Config: config/AutoPickup/client_default.toml (or per-server profiles in presets/)

# AutoPickup Client Configuration
master = true
blocks = true
blockXp = true
mobLoot = false
mobXp = false
splitMobLoot = false
splitMobXp = false

Player Overrides: config/AutoPickup/player_overrides.json

{
  "player-uuid-here": {
    "overrideMaster": true,
    "overrideBlocks": null,
    ...
  }
}

Optional But Recommended Client Dependencies

• Mod Menu - Access config screen in-game
• YetAnotherConfigLib (YACL) - Required for YACL config GUI (Vanilla GUI fallback)

✅ Compatibility

AutoPickup hooks into core Minecraft mechanics and works seamlessly with most mods out of the box.

🔧 Explicitly Supported Mods

📋 Technical Details

AutoPickup intercepts drops at these injection points:

• Block.dropStacks() - Primary block drop handling
• ServerWorld.spawnEntity() - Item entity spawning and falling block entity tracking (FallingTree)
• LivingEntity.dropLoot() - Mob loot generation
• Block.dropExperience() - Block XP orbs
• LivingEntity.dropExperience() - Mob XP orbs
• ServerPlayerGameMode.useItemOn() - Right-click harvesting (sweet berries, jukebox disc ejection, crops via the RightClickHarvest mod, etc.)
• ItemFrame.hurt() - Items removed from item frames by left-clicking

This broad compatibility means most mods work automatically without explicit support.

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

dependencies {
    compileOnly(files("libs/autopickup-platform-x.x.x.jar"))
}

Using the API

import com.lukarbonite.autopickup.AutoPickupApi;

public class QuestRewards {

    public void giveReward(Player player, List<ItemStack> items, int xp) {
        if (!isModLoaded("autopickup")) {
            // Fallback: manual drops
            items.forEach(stack -> player.dropItem(stack, false));
            player.addExperience(xp);
            return;
        }

        // AutoPickup handles:
        // - Inventory insertion
        // - Traveler's Backpack routing
        // - Config checks (Master, Blocks, etc.)
        List<ItemStack> remaining = AutoPickupApi.tryPickup(player, items);

        // Drop items that didn't fit
        remaining.forEach(stack -> player.dropItem(stack, false));

        // AutoPickup handles:
        // - Mending calculations
        // - Config checks
        AutoPickupApi.tryPickupBlockExperience(player, xp);
    }

    // For mob-related rewards
    public void giveMobReward(Player player, List<ItemStack> loot, int xp) {
        List<ItemStack> remaining = AutoPickupApi.tryPickupFromMob(player, loot);
        remaining.forEach(stack -> player.dropItem(stack, false));

        AutoPickupApi.tryPickupMobExperience(player, xp);
    }
}

API Methods

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 file for full details.