ItemGuard
PluginLicenseRef-All-Rights-Reserved

ItemGuard

ItemGuard is a lightweight plugin that restricts specific item actions like holding, crafting, or using banned items across worlds. With full config control and PlaceholderAPI support, it’s perfect for maintaining gameplay balance and preventing exploits.

357
Downloads
2
Followers
9 months ago
Updated
📦
2
Versions

📖About ItemGuard

🛡️ ItemGuard
Block and control banned items—cleanly, per world, per action.

📌 What It Does
ItemGuard is a lightweight, configuration-based plugin that lets you ban specific items from being:

Held in hand
Picked up
Dropped
Crafted
Right-clicked or used (e.g., placing blocks)

You define what items to block, what actions to block them from, and in which worlds. All done via a single, simple config.yml.

🎯 Why Use It?
Perfect for:

Adventure maps
Hardcore survival servers
Creative/limited build worlds
Preventing exploits from custom or modded items

ItemGuard gives you fine control without bloat or GUI clutter. Players see clear messages when they attempt a banned action, and you can optionally kick rule-breakers or grant bypass permissions.

⚙️ Key Features
✅ Configurable item bans (per item, action, and world)

💬 Custom messages with PlaceholderAPI support
🔁 /itemguard reload command to apply changes without restart
🔒 Bypass permission: itemguard.bypass
🛠️ Admin permission: itemguard.admin
⚡ No Vault or economy system required

📥 Requirements & Compatibility
Minecraft 1.21.4+
Java 17+

(Optional) PlaceholderAPI for message placeholders

No other dependencies

📁 Example Config
ban-list:

  • item: TNT
    actions: [HOLD, CRAFT]
    worlds: [world, world_nether]
    message: "&c%player_name%, TNT is banned here!"

  • item: BEDROCK
    actions: [PICKUP, DROP]
    worlds: ["*"]
    message: "&6This item is restricted everywhere."

settings:
use-placeholders: true
kick-on-violation: false
kick-message: "&4You were kicked for using a banned item."