A feature-rich Minecraft plugin that allows players to pick up and throw entities with advanced customization options.<\/p>\n
## \u2728 Features<\/p>\n
– \ud83c\udfaf **Pick up & throw** entities and players
\n– \ud83d\udcda **Unlimited stacking** – Stack entities on top of each other (Optional)
\n– \ud83c\udfa8 **Customizable pickup item** – Set any item (with NBT support) as pickup tool
\n– \ud83d\udeab **Entity filter** – Whitelist\/Blacklist system for entity types
\n– \ud83c\udfae **Two throw modes** – Throw one at a time or all at once
\n– \u26a1 **Two power modes** – Fixed velocity or charge-by-sneaking
\n– \ud83d\udcca **Two charge displays** – BossBar or ActionBar
\n– \ud83d\udd04 **Charge loop mode** – Precise timing with cycling progress
\n– \ud83c\udf0d **Multi-language** – Community-friendly locale system (zh-CN, en-UK, etc.)
\n– \ud83d\udd10 **Permission system** – Control who can use the plugin
\n– \ud83c\udf10 **Universal compatibility** – Works on Folia, Paper, Spigot, and Bukkit<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download the plugin jar
\n2. Place it in your server’s `plugins\/` folder
\n3. Restart the server
\n4. Configuration files will be auto-generated in `plugins\/PickAndThrow\/`<\/p>\n
## \ud83c\udfae How to Use<\/p>\n
### Basic Usage<\/p>\n
**Default mode** (empty hand):
\n1. Right-click entity \u2192 Pick up
\n2. Right-click another entity \u2192 Stack on top
\n3. Left-click \u2192 Throw<\/p>\n
**Charge mode**:
\n1. Right-click entity \u2192 Pick up
\n2. Hold Shift \u2192 Start charging (BossBar\/ActionBar shows progress)
\n3. While holding Shift, Left-click \u2192 Throw with current charge power
\n4. Release Shift and Left-click \u2192 Throw with minimum power<\/p>\n
### Custom Pickup Item (Optional)<\/p>\n
1. Hold any item
\n2. Use `\/pat sethand` \u2192 Set as pickup tool
\n3. Use `\/pat sethand` with empty hand \u2192 Clear (back to empty hand mode)<\/p>\n
## \ud83d\udcdd Commands<\/p>\n
All commands require `pickandthrow.admin` permission (default: OP)<\/p>\n
| Command | Description |
\n|———|————-|
\n| `\/pat` | Show plugin info and help |
\n| `\/pat reload` | Reload all configuration files |
\n| `\/pat sethand` | Set\/clear held item as pickup tool |<\/p>\n
## \ud83d\udd11 Permissions<\/p>\n
| Permission | Default | Description |
\n|————|———|————-|
\n| `pickandthrow.use` | `true` | Allows using pickup and throw features |
\n| `pickandthrow.admin` | `op` | Allows using admin commands |<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### Main Settings<\/p>\n
“`yaml
\n# Language (zh-CN, en-UK, zh-TW, ja-JP, etc.)
\nlanguage: zh-CN<\/p>\n
# Pickup tool (null = empty hand only)
\npickup-item: null<\/p>\n
# Max entities (-1 = unlimited)
\nmax-entities: -1<\/p>\n
# Entity filter mode
\nentity-filter-mode: blacklist
\nentity-filter-list:
\n – ENDER_DRAGON<\/p>\n
# Throw mode: “one” or “all”
\nthrow-mode: one<\/p>\n
# Pickup range (blocks)
\npickup-range: 4.5<\/p>\n
# Throw cooldown (ms)
\nthrow-cooldown: 300<\/p>\n
# Power mode: “fixed” or “charge”
\nthrow-power-mode: charge<\/p>\n
# Display type: “bossbar” or “actionbar”
\ncharge-display-type: bossbar<\/p>\n
# Charge loop (100% -> 0% -> 100%)
\ncharge-loop: false<\/p>\n
# BossBar colors
\nbossbar-colors:
\n low: RED # 0-33%
\n medium: YELLOW # 33-66%
\n high: GREEN # 66-100%
\n“`<\/p>\n
### Entity Filter Examples<\/p>\n
**Blacklist** (prevent picking up bosses):
\n“`yaml
\nentity-filter-mode: blacklist
\nentity-filter-list:
\n – ENDER_DRAGON
\n – WITHER
\n – WARDEN
\n“`<\/p>\n
**Whitelist** (only allow farm animals):
\n“`yaml
\nentity-filter-mode: whitelist
\nentity-filter-list:
\n – COW
\n – SHEEP
\n – PIG
\n – CHICKEN
\n“`<\/p>\n
### Language System<\/p>\n
**Built-in:**
\n– `zh-CN.yml` – Simplified Chinese
\n– `en-UK.yml` – English (UK)<\/p>\n
**Create custom:**
\n1. Copy `zh-CN.yml` or `en-UK.yml`
\n2. Rename (e.g., `ja-JP.yml`, `fr-FR.yml`)
\n3. Translate messages
\n4. Set `language: ja-JP` in config
\n5. Auto-fallback to `en-UK` if not found<\/p>\n
Community translations are welcome!<\/p>\n
## \ud83d\udd27 Building from Source<\/p>\n
Requires Maven 3.8+ and Java 17+<\/p>\n
“`bash
\nmvn clean package
\n“`<\/p>\n
Output: `target\/PickAndThrow-1.0.0.jar`<\/p>\n
## \ud83d\udcd6 Technical Details<\/p>\n
– **Throw direction**: Follows exact player look direction
\n– **Charge display**: Updates every tick
\n – BossBar: Configurable colors
\n – ActionBar: Rainbow gradient with 30 bars
\n– **Smart raycast**: Handles large entity hitboxes
\n– **Cooldown system**: Prevents double-trigger issues
\n– **NBT matching**: Full ItemStack comparison
\n– **Server detection**: Auto-detects Folia and uses appropriate scheduler API<\/p>\n
## \ud83d\udcc4 License<\/p>\n
This project is licensed under the GNU General Public License v3.0 – see the [LICENSE](LICENSE) file for details.<\/p>\n","protected":false},"excerpt":{"rendered":"
A feature-rich Minecraft plugin that allows players to pick up and throw entities with advanced customization options.<\/p>\n","protected":false},"featured_media":121103,"template":"","meta":{"_minecraft_slug":"pick-and-throw","_minecraft_project_id":"LiZAvWZb","_minecraft_author":"Mokzern","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":119,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pick-and-throw.zip","_minecraft_size_bytes":58146,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:16:54.975365Z","_minecraft_date_created":"2025-10-22T21:40:48.976018Z","_minecraft_date_modified":"2025-11-24T16:50:06.474665Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pick-and-throw","_minecraft_icon_attachment_id":121103,"_minecraft_imported_at":"2026-06-07T02:57:37+00:00","_minecraft_import_hash":"0326a1d7c4366eba90f1e0c256e050b3","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,125,89,866,127,867,129,869,92],"mod_loader":[130,131,132,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-121102","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-spigot","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-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