InstantPickUp

> **⚠️ Compatibility Note:** 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 (https://discord.gg/A7WVnYj3BP). # ✨ 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 * **⚡️ Instant Collection (Item & XP):** All items and experience orbs (XP) are transferred directly into the player's inventory. * **Fishing:** Catch fish directly to your inventory without them flying around. Supports **Mending** enchantment. * **Shearing:** Wool appears instantly in your inventory. * **📦 Auto-Compress:** 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 Drop Physics:** Uses advanced heuristics to reliably attribute and collect drops: * **Realistic TNT:** Features a **"Vaporization"** 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). * **Falling Columns:** 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). * **✨ Enhanced UX & Anti-Spam:** * **Combo Counter:** A built-in **Combo Counter** 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. * **⚙️ Full Player Customization:** Every player has full control over their experience: * **Toggle/State:** Enable or disable AutoPickUp (`/ip`). * **Auto-Compress:** Toggle compression on/off (`/ip compress`). * **Warning Sound:** Toggle the **Inventory Full warning sound** (`/ip sound`). * **Notification Type:** 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. * **TNT Settings:** Toggle between `realistic-drops` (distance-based) or standard vanilla yield. * **Blacklist:** Configurable list of materials (e.g., `COBBLESTONE`) that are ignored during collection. * **Restrictions:** 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 | | --- | --- | --- | --- | | **--- PLAYER ---** | | | | | `/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 | | **--- ADMIN ---** | | | | | `/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.