# **PickUp Mod**<\/p>\n
## **Primary Purpose**<\/p>\n
A plugin that allows fully customizable pickup behavior for both players and mobs, completely rewriting and replacing Minecraft’s vanilla item pickup logic. It supports customizing pickup range, item merging, pickup delay, and more\u2014delivering better performance than the vanilla system while being fully compatible with Folia’s multi-threaded architecture.<\/p>\n
## **Key Controls**<\/p>\n
– **`\/up` or `\/pickup`**: Main command for all pickup management functions ## **Advanced Controls** ## **Features** ## **Advanced Features** ## **Performance & Optimization** ## **Key Advantages**<\/p>\n – \u2705 **Dual-Mode System**: Choose between player-driven or item-driven pickup (or both) ## **Important Notes**<\/p>\n – **Requires Paper\/Folia**: Does not work with Spigot or CraftBukkit ## **Installation**<\/p>\n 1. Ensure you’re running **Paper 1.17+** or **Folia 1.19.4+** ## **Quick Start Commands**<\/p>\n “`bash ## Server Reload Principle & External Script Explanation<\/p>\n ### Why Not Use Bukkit’s `\/reload`? ### How It Works \u2705 The entire process is **free of memory leaks** and **class loading conflicts**, suitable for production environments.<\/p>\n ### Windows Startup Script Example (`start.bat`)<\/p>\n “`bat echo [%date% %time%] \u6b63\u5728\u542f\u52a8\u670d\u52a1\u5668… echo [%date% %time%] \u670d\u52a1\u5668\u5df2\u5173\u95ed\u3002<\/p>\n if exist restart.flag ( echo. ### \ud83d\udc27 For Linux \/ macOS Users?<\/p>\n Simply write an equivalent shell script (`start.sh`) with the same logic:<\/p>\n “`bash ## **License**<\/p>\n This project is licensed under the GPL-3.0 License – see the LICENSE file for details.<\/p>\n","protected":false},"excerpt":{"rendered":" A custom pickup plugin compatible with both Paper and Folia server cores.<\/p>\n","protected":false},"featured_media":121117,"template":"","meta":{"_minecraft_slug":"pick-up","_minecraft_project_id":"5a7kxCx7","_minecraft_author":"TaXiaoQi","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":132,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pick-up.zip","_minecraft_size_bytes":247191,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T18:59:49.523534Z","_minecraft_date_created":"2025-12-14T00:55:31.748077Z","_minecraft_date_modified":"2026-01-21T03:30:24.606602Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pick-up","_minecraft_icon_attachment_id":121117,"_minecraft_imported_at":"2026-06-07T02:58:35+00:00","_minecraft_import_hash":"efd2c0c8b82fc19f0ed43267bef90827","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,90,127,129,92],"mod_loader":[130,131,132,134],"minecraft_version":[110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-121116","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-spigot","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","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"],"yoast_head":"\n
\n– **`\/up true`**: Enable pickup functionality (disables vanilla pickup)
\n– **`\/up false`**: Disable pickup functionality (restores vanilla mechanics)
\n– **`\/up status`**: View plugin status and current configuration
\n– **`\/up set
\n– **`\/up reload`**: Reload configuration from disk<\/p>\n
\n– **`\/mc restart`**: Restart the Minecraft server (requires an external startup script)<\/p>\n
\n– **Player-Driven Mode**: Players automatically pick up nearby items when moving (configurable range and interval)
\n– **Item-Driven Mode**: Items actively seek nearby players\/mobs (smart scheduling with delay management)
\n– **Item Merging**: Automatically merges nearby identical items (configurable range)
\n– **Offhand Support**: Dropped items can be actively picked up into the offhand (enable in config).
\n– **Auto Equipment**: Mobs automatically equip better armor\/weapons<\/p>\n
\n– **Death Logging**: Enhanced death messages with coordinates (toggleable)
\n– **Server Restart**: Restart the Minecraft server using an external script (see Server Reload Principle & External Script Explanation).<\/p>\n
\n– **Folia Multi-Threading**: Full support for Folia’s region-based threading model
\n– **Spatial Indexing**: Efficient item lookup system using chunk-based indexing
\n– **Smart Scheduling**: Configurable tick intervals for optimal performance
\n– **Memory Management**: Automatic cleanup of invalid items and references<\/p>\n
\n– \u2705 **Folia-Ready**: Full multi-threading support for high-performance servers
\n– \u2705 **Non-Intrusive**: Disables vanilla pickup only when active, fully restorable
\n– \u2705 **Real-Time Configuration**: All settings adjustable via commands
\n– \u2705 **Smart Item Management**: Automatic merging, cleanup, and optimization
\n– \u2705 **High Compatibility**: Works with Paper 1.17+ and Folia 1.19.4+<\/p>\n
\n– **Permission Required**: `pickup.admin` permission for all commands (default: OP)
\n– **Configuration**: All settings in `config.yml`, hot-reload with `\/up reload`<\/p>\n
\n2. Place `PickUp.jar` in your `plugins\/` folder
\n3. Restart your server
\n4. Use `\/up status` to verify installation
\n5. Configure settings via `\/up set` or edit `config.yml`<\/p>\n
\n\/up help # Show all commands
\n\/up true # Enable smart pickup
\n\/up set pickup.range 2.5 # Set pickup range to 2.5 blocks
\n\/up set mode.player-driven true # Enable player-driven mode
\n\/up reload # Apply configuration changes
\n“`<\/p>\n
\nBukkit\/Spigot’s native `\/reload` command carries a significant risk of memory leaks and is no longer recommended by the official teams. To ensure long-term server stability, the PickUp plugin employs a “soft shutdown + external restart” mechanism for safe reloading.<\/p>\n
\n1. A player executes `\/mc restart`
\n2. The plugin performs the following actions:
\n – Stops all event listeners
\n – Cleans up temporary in-memory data
\n – Creates a restart.flag<\/code> marker file in the plugin directory
\n – Calls Bukkit.shutdown()<\/code> to gracefully shut down the server
\n3. The **external startup script** detects the existence of restart.flag<\/code> \u2192 automatically restarts the server
\n4. After restart, the plugin loads normally, configuration takes effect, with no leftover state<\/p>\n
\n@echo off
\nchcp 936 >nul
\ntitle Minecraft\u670d\u52a1\u5668
\ncd \/d “%~dp0”<\/p>\n
\njava -Xmx2G -Xms1G -Dfile.encoding=GBK -jar folia-1.21.11-9.jar nogui<\/p>\n
\n del restart.flag
\n echo [%date% %time%] \u68c0\u6d4b\u5230\u91cd\u542f\u8bf7\u6c42\uff0c5\u79d2\u540e\u91cd\u65b0\u542f\u52a8…
\n timeout \/t 5 >nul
\n goto restart
\n)<\/p>\n
\necho \u672a\u68c0\u6d4b\u5230\u91cd\u542f\u8bf7\u6c42\uff0c5\u79d2\u540e\u81ea\u52a8\u9000\u51fa…
\ntimeout \/t 5 >nul
\n“`
\n> \ud83d\udcdd **Usage Instructions**:
\n> – Save this script as `start.bat` in the same directory as your `paper-*.jar`
\n> – **Always start the server by double-clicking `start.bat`**
\n> – After executing `\/mc reload`, the server will automatically restart and apply new configuration<\/p>\n
\n#!\/bin\/bash
\nwhile true; do
\n java -Xmx1G -Xms1G -jar paper-1.21.10-115.jar nogui
\n if [ -f “restart.flag” ]; then
\n rm -f restart.flag
\n echo “Restart request detected, restarting in 5 seconds…”
\n sleep 5
\n else
\n echo “Normal exit.”
\n break
\n fi
\ndone
\n“`<\/p>\n