📦 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 [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]](https://discord.gg/jdWeSJbcKx)
  * **Source:** [[GitHub]](https://github.com/kuba-121/VoidItemControl)