📦 VoidItemControl | Advanced Item Management System

VoidItemControl is a professional, high-performance item interaction management system designed for modern Minecraft servers. It allows administrators to have full control over which items can be placed or dropped, supporting unique quest items, currencies, and special server artifacts.

🛠️ Key Features

• Action Restriction System – Precisely block PLACEMENT or DROP actions for specific items based on their material type.
• Metadata Sensitivity – The system recognizes items not just by material, but also by their Display Name and Lore, allowing for unique restricted items.
• Universal Compatibility – Designed to run smoothly on Spigot, Paper, Bukkit, and Folia engines from versions 1.8 to 1.21.x.
• Void Give System – Integrated /vic give command allows administrators to instantly grant players items defined in the config with all metadata preserved.
• Bypass Permissions – A flexible permission system allowing staff or specific player groups to ignore item restrictions.

---

💻 Installation & Setup

1. Download the .jar file.
2. Drop the file into your server's /plugins folder.
3. Restart your server to generate the configuration files.
4. Customize your restricted items list and system messages in config.yml.

---

📜〢 Configuration Example

############################################################
#                                                          #
#           VOIDITEMCONTROL - CREATED BY KUBA_121          #
#     A professional item interaction management system    #
#                                                          #
############################################################

############################################################
#                                                          #
#  PERMISSIONS:                                            #
#  - voiditemcontrol.admin: Access to /vic reload/give     #
#  - voiditemcontrol.bypass: Immune to item restrictions   #
#                                                          #
############################################################

# Should the plugin notify you about new updates?
update-check: true

# Define your restricted items here
restricted-items:
  # Unique identifier for the restriction (used in /vic give)
  bedrock_rule:
    # Material name (Bukkit name)
    material: "BEDROCK"
    # Optional: Block only if the item has this specific name
    display-name: "&b&lVOID BEDROCK"
    # Optional: Block only if the item has this lore
    lore:
      - "&7This item is controlled"
      - "&bby the void system."
    # Actions to block
    prevent-placement: true
    prevent-drop: true
    # Should the player be notified when an action is blocked?
    notify-player: true

  magic_block:
    material: "COMMAND_BLOCK"
    display-name: "&d&lMAGICAL COMMAND BLOCK"
    lore:
      - "&7This is a block"
    prevent-placement: true
    prevent-drop: false
    notify-player: true

messages:
  # The global prefix for all system messages
  prefix: "&b&lVoidControl &r&8»&7"
  
  # Sent when a player tries to place a restricted block
  placement-blocked: "%prefix% &7The &bvoid &7prevents you from placing this object."
  
  # Sent when a player tries to drop a restricted item
  drop-blocked: "%prefix% &7This item is &bbound to your soul &7and cannot be dropped."
  
  # Standard system notifications
  no-permission: "%prefix% You lack the &bvoid power &7to do this."
  reload-success: "%prefix% Configuration reloaded &bsuccessfully&7."
  
  # Structure for the /voiditemcontrol help command
  help-menu:
    - "&8&m--------&r &b&lVoidControl Help &8&m--------"
    - "&7/vic help &8- &fDisplays this menu"
    - "&7/vic give <player> <key> [amount] &8- &fGive item"
    - "&7/vic reload &8- &fReloads the configuration"
    - "&8&m----------------------------------------"

  usage-command: "%prefix% Usage: &b/vic &8<&7help&8|&7reload&8|&7give&8>"

---

🛡️ Support & Community

Join our Code Hub for technical support, bug reports, and updates.

• Discord: [Join Support Server]
• Source: [GitHub]