InstantPickUp

> Minecraft 1.21.5 Purpur This plugin is built for Minecraft 1.21.5 Purpur. I tested it on Purpur 1.21.5 and Spigot 1.21.1. It should work on 1.21.1-1.21.5 Spigot/Purpur/Paper/Bukkit.

If you want to report a bug or suggest a new plugin, join my Discord server.

✨ InstantPickUp

Collect. Secure. Survive.

InstantPickUp completely changes the item collection mechanic, transferring items (and XP) directly into the player's inventory instantly. It uses advanced heuristics to reliably track the culprit of drops in complex situations and offers full, per-player control over notifications.

⚡️ Key Features

* Shearing: All items and experience orbs (XP) are transferred directly into the player's inventory. * Shearing: Catch fish directly to your inventory without them flying around. Supports Shearing: enchantment. * Shearing: Wool appears instantly in your inventory.

* Smart Containers: Automatically compresses 9 items into their block form upon pickup (e.g., 9 Diamonds ➝ 1 Diamond Block, 9 Coal ➝ 1 Coal Block). Saves inventory space instantly. * Smart Containers: Uses advanced heuristics to reliably attribute and collect drops: * Smart Containers: Features a Smart Containers: mechanic where blocks closer to the explosion center have a lower drop chance, while blocks at the edge are preserved. (Configurable: Realistic vs. Vanilla Yield). * Smart Containers: Collects entire stacks of sand/gravel/anvils breaking on non-solid blocks. * Smart Containers: Intelligent filtering allows you to pick up the Chest block itself while letting its contents drop naturally (if configured).

* Cooldown: * Cooldown: A built-in Cooldown: displays a running total of collected items (e.g., `+ 64 Stone`) on the Action Bar. * Cooldown: Inventory Full warning messages have a configurable cooldown (default 3s) to prevent chat spam.

* Language: Every player has full control over their experience: * Language: Enable or disable AutoPickUp (`/ip`). * Language: Toggle compression on/off (`/ip compress`). * Language: Toggle the Language: (`/ip sound`). * Language: Choose where to receive full inventory warnings (`/ip notify fulleq <chat/title/actionbar/none>`). * Language: Instant language switching (`/ip lang`).

---

🛡️ Admin Control & Configuration

All global settings are available in `config.yml` and can be changed dynamically.

* Global Restriction Mode Toggle between `realistic-drops` (distance-based) or standard vanilla yield. * Global Restriction Mode Configurable list of materials (e.g., `COBBLESTONE`) that are ignored during collection. * Global Restriction Mode The Global Restriction Mode (`/ip toggle`) forces a required permission check for all players.

---

🚀 InstantPickUp - Commands & Permissions

Main command: `/ip` (or `/instantpickup`, `/ap`, `/autopickup`)

| Command | Description | Permission | Default | | --- | --- | --- | --- | | Global Restriction Mode | | | | | `/ip` | Toggles your AutoPickUp status (ON/OFF). | `instantpickup.use` | ✅ Everyone | | `/ip compress <true/false>` | Toggles Auto-Compress mode. | `instantpickup.use` | ✅ Everyone | | `/ip status` | Displays the current state of all your settings. | `instantpickup.use` | ✅ Everyone | | `/ip sound` | Toggles the Inventory Full warning sound. | `instantpickup.use` | ✅ Everyone | | `/ip notify <fulleq/count> ...` | Manages display type (Full Inv) or state (Combo Counter). | `instantpickup.notification` | ✅ Everyone | | `/ip lang <pl/en>` | Change your personal interface language. | — | ✅ Everyone | | Global Restriction Mode | | | | | `/ip toggle` | Toggles the Global Restriction Mode. | `instantpickup.admin` | ❌ OP | | `/ip default <true/false>` | Set the default AP mode for new players. | `instantpickup.admin` | ❌ OP | | `/ip reload` | Reloads plugin configuration and languages. | `instantpickup.reload` | ❌ OP |

Special Permissions (Bypass):

| Permission | Description | Default | | --- | --- | --- | | `instantpickup.bypass.blacklist` | Allows player to collect items defined in the global blacklist. | ❌ False |

* Wildcard Permission: `instantpickup.*` (Grants full command access).

---

💾 Installation

1. Download the `.jar` file. 2. Place it in the `/plugins/` folder of your server (Spigot/Paper/Purpur 1.21.x). 3. Restart the server.

In the future, I will make veinminer and treecapitator work with this plugin.