3@#

📦 xPickup

A simple yet powerful plugin to automatically pick up items!

🔥 Partner 10% discount on your purchases on Website

💡 Why xPickup? ✅ Easy to use & configure ✅ Automatic pickup from blocks & mobs ✅ Fully customizable (sounds, particles, worlds, and more) ✅ Free & open source ✅ Performance optimized ✅ Supports Spigot, Paper & forks (1.13+)

💬 Say goodbye to the tedious task of collecting items forever and enhance the gameplay experience on your server!

💡 Got ideas? Suggest them on Discord or GitHub, and we might add them in the next release!

✨ Features 🔧 Fully Customizable: Adjust sounds, particles, messages, and more to your liking. 🌐 Per-World Control: Enable the plugin only where you want with a whitelist or blacklist system. ✨ Visual & Sound Effects: Add configurable particles and sounds on item pickup for better immersion. 🔔 Smart Notifications: Alert players with customizable chat, actionbar, or title messages when their inventory is full. 🎮 Per-Player Toggle: Allows each player to decide whether to use auto-pickup. 🚀 Lightweight & Performance-Focused: It won't affect your server's performance.

🔐 Commands

/xpickup toggle – Toggles automatic pickup for yourself.
/xpickup reload – Reloads the plugin's configuration. Requires the xpickup.admin permission.

⚙️ Installation & Usage 📥 Drop the .jar into your /plugins folder. 🔁 Restart the server. 🛠️ No extra setup required to get started! Everything works out-of-the-box. 🗣️ Customize every detail, from active worlds to pickup sounds, in the config.yml file. ✅ Done! Items will go straight into the player's inventory.

⚙️ Config.yml ⚙️

#
#   ▐▄• ▄  ▄▄▄·▪   ▄▄· ▄ •▄ ▄• ▄▌ ▄▄▄·
#    █▌█▌▪▐█ ▄███ ▐█ ▌▪█▌▄▌▪█▪██▌▐█ ▄█  
#   ·██·  ██▀·▐█·██ ▄▄▐▀▀▄·█▌▐█▌ ██▀·  Made by xPlugins
#  ▪▐█·█▌▐█▪·•▐█▌▐███▌▐█.█▌▐█▄█▌▐█▪·•  and 777 Studios 
#  •▀▀ ▀▀.▀   ▀▀▀·▀▀▀ ·▀  ▀ ▀▀▀ .▀
# If you liked the plugin, leave us a heart on Modrinth : )

# Compatible with HEX, & and Legacy colors.
# Wiki: https://xplugins.willfry.dev/xPickup

update: true

# World control.
worlds-control:
  enabled: true

  # Operation mode (only works if 'enabled' is true):
  # "WHITELIST": The plugin will only work in the worlds listed in 'list'.
  # "BLACKLIST": The plugin will work in all worlds EXCEPT those in the 'list'.
  mode: "WHITELIST"
  
  # List of world names (case sensitive).
  list:
    - "world"
    - "world_nether"
    - "world_the_end"

# Should players have auto-pickup enabled by default when joining?
auto-pickup-on-by-default: true

# Sound settings when picking up an item.
# Sound list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
pickup-sound:
  enabled: true
  sound: "ENTITY_ITEM_PICKUP"
  volume: 1.0
  pitch: 1.5

# Particle settings when picking up an item.
# Particle list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
pickup-particles:
  enabled: true
  particle: "CRIT"
  count: 8

# Message settings when inventory is full.
inventory-full-message:
  chat: true
  actionbar: true
  title:
    enabled: true
    # You can use color codes like &c, &l, and also &#RRGGBB for HEX.
    title: "&#FF5555&lInventory Full!"
    subtitle: "&#AAAAAASome items dropped on the ground."
    # Times in ticks (20 ticks = 1 second)
    fade-in: 10
    stay: 40
    fade-out: 10
#      __              
#   /\ \ \_____      __
#  /  \/ / _ \ \ /\ / /
# / /\  /  __/\ V  V / 
# \_\ \/ \___| \_/\_/   New feature.                  
# Vault integration to charge per picked-up item
vault:
  # Set to 'true' to enable charging per item.
  enabled: false
  # Cost per individual item picked up.
  # If set to 0.0, it will be free but Vault will still be required.
  cost-per-item: 0.01

📥 Messanges 📥

#                                                   
#  /\/\   ___  ___ ___  __ _ _ __   __ _  ___  ___ 
# /    \ / _ \/ __/ __|/ _` | '_ \ / _` |/ _ \/ __|
#/ /\/\ \  __/\__ \__ \ (_| | | | | (_| |  __/\__ \
#\/    \/\___||___/___/\__,_|_| |_|\__, |\___||___/
#                                  |___/.yml
# Please leave a review of our work :)
#
# This file now uses Bukkit/Spigot color codes.
# Quick guide:
# - Colors: &c (red), &a (green), &6 (gold), etc.
# - Styles: &l (bold), &o (italic), &n (underline), &m (strikethrough)
# - HEX Colors (for 1.16+): &#FF5555
# - The plugin includes compatibility for HEX in older versions (1.13-1.15)

prefix: "&#FFEBB5xPickup &8» &r"

no-permission: "&c ❌ You don't have permission to run this command."
player-only: "&c ⚠️ This command can only be used by in-game players."
reload: "&a ✔ The xPickup configuration has been successfully reloaded!"
inventory-full: "&e ⚠️ Your inventory is full, you can't pick up more items!"
pickup-toggled-on: "&a ✔ Hey! You have enabled auto-pickup."
pickup-toggled-off: "&c ✘ Hey! You have disabled auto-pickup."
update-available: "&aA new version of xPickup is available! &e[Click here to download]"

help-message:
  - "&8&m----------------------------------------------------"
  - ""
  - "&#FFEBB5 🔥 xPickup Commands 🔥"
  - ""
  - "&#FCD05C /xpickup toggle &8⇀ &fEnable or disable auto-pickup."
  - "&#FCD05C /xpickup reload &8⇀ &fReload the plugin configuration &8(Admin)."
  - "&#FCD05C /xpickup help &8⇀ &fShow this help panel."
  - ""
  - "&8&m----------------------------------------------------"

🛣️ Roadmap ✅ Per-player toggle command. -> ADDED ✅ Advanced per-world control. -> ADDED ✅ Customizable sounds & particles. -> ADDED ✅ Inventory-full messages. -> ADDED ⭐ Item filtering (whitelist/blacklist). 🧩 PlaceholderAPI support.

public void myMethod(Player player) {
    // First, we get the instance of the xPickup plugin
    XPickup xpickupPlugin = XPickup.getInstance();

    // It is VERY important to check if the plugin is enabled to avoid errors
    if (xpickupPlugin != null) {
        
        // From the instance, we get the API
        XPickupAPI api = xpickupPlugin.getApi();

        // Now you can use the API methods!
        
        // Example 1: Check if a player has auto-pickup enabled
        boolean enabled = api.isAutoPickupEnabled(player);
        if (enabled) {
            player.sendMessage("Your xPickup auto-pickup is enabled.");
        }

        // Example 2: Disable auto-pickup for a player
        api.setAutoPickup(player, false);
        player.sendMessage("We have temporarily disabled your auto-pickup.");

    } else {
        // The xPickup plugin is not installed or is disabled on the server
        player.sendMessage("xPickup is not available on this server.");
    }
}

777Studios x LunarNodes.net