Simple Items Perms

# SimpleItemsPerms (https://img.shields.io/badge/Version-1.1.1-brightgreen)](https://modrinth.com/plugin/simpleitemsperms) (https://img.shields.io/badge/Minecraft-1.21+-blue)](https://modrinth.com/plugin/simpleitemsperms) **The Ultimate Permission System for Minecraft Items** --- ## 📖 What This Plugin Does **SimpleItemsPerms** allows you to assign specific permissions to individual items in your Minecraft server. When you give an item a permission requirement, only players with that permission can use it - everyone else will be blocked with a customizable message. **Example:** Create a Diamond Sword that requires `simpleitemsperms.vip` permission. Players without VIP rank cannot attack with it, equip it, or even pick it up. Perfect for exclusive donor rewards! --- ## 🎯 Why Download This Plugin? **Perfect for servers with:** - **VIP/Donor Perks** - Give exclusive items to paying supporters - **Rank Progression** - Lock powerful items behind rank requirements - **Custom Kits** - Create Elite, MVIP, or Admin-only kit items - **Economy Shops** - Sell premium items that require special permissions - **Event Rewards** - Give special items that only event winners can use **Key advantages:** - ⚡ **Easy to use** - Intuitive GUI, no complex commands - 🌍 **Fully translated** - English and Italian included, add your own language - 🔒 **Persistent** - Permissions survive server restarts and world changes - 🎨 **Customizable** - Configure every message, sound, and behavior - 📊 **Professional** - Item registry, statistics tracking, and management tools --- ## ⚠️ Important Information Before Downloading **Requirements:** - ✅ **Server-side only plugin** - Does NOT work on client, must be installed on server - ✅ **Permission plugin required** - You need LuckPerms, PermissionsEx, or similar - ✅ **Minecraft 1.21+** - Compatible with Spigot, Paper, Purpur, Pufferfish - ✅ **Java 21+** - Required for modern Minecraft versions **Limitations:** - ⚠️ **Placed blocks lose permissions** - When you place a block, Minecraft removes all NBT data (this affects ALL plugins, not just ours). Permissions work perfectly for weapons, armor, tools, food, and potions. **How it works:** 1. Permissions are stored in item NBT data (PersistentDataContainer) 2. The plugin checks permissions on 8+ different events (use, equip, consume, etc.) 3. Players without permission see a customizable lore message on the item 4. Admins can manage all registered items through an easy GUI --- ## 🌟 Key Features **🔐 Advanced Permission System** - **Item-Specific Permissions** - Assign unique permissions to any item - **Automatic Permission Checks** - Players without permission cannot use restricted items - **Visual Feedback** - Custom lore shows permission status - **Dynamic Lore** - Hide permission lore from players who have the permission - **Persistent Storage** - Permissions stored in item NBT data (survives server restarts) **🎨 Intuitive GUI System** - **Easy-to-Use Interface** - Assign permissions through a beautiful GUI - **Drag & Drop** - Simply place items in the GUI to assign permissions - **Visual Confirmation** - Green confirm and red cancel buttons - **Fully Customizable** - Configure GUI size, materials, and colors - **Real-Time Updates** - See changes immediately **🌍 Multi-Language Support** - **Bilingual System** - Full English and Italian translations - **Language Files** - Easy to translate to any language - **Dynamic Switching** - Change language with `/sip reload` - **Fully Translated** - GUI, commands, messages, and lore - **No Hardcoded Strings** - Everything is translatable **📊 Item Registry & Management** - **Global Item Registry** - Track all items with permissions - **Detailed Information** - View item details, creator, and usage statistics - **Browse Interface** - Paginated list of all registered items - **Item Details GUI** - See enchantments, lore, and metadata - **Easy Deletion** - Remove items from registry with one click **🛡️ Comprehensive Event Blocking** - **Use Items** - Block right/left click usage - **Equip Armor** - Prevent wearing restricted armor - **Consume Items** - Block eating/drinking - **Drop/Pickup** - Control item transfer - **Move Inventory** - Prevent inventory manipulation - **Break/Place Blocks** - Control block interactions - **Attack Entities** - Restrict combat usage - **Shoot Projectiles** - Block bow/crossbow usage **⚙️ Advanced Configuration** - **Customizable Lore** - Define permission denial message - **Lore Position** - Choose start or end position - **Sound Effects** - Custom sounds when actions are blocked - **Event Toggle** - Enable/disable specific event checks - **Debug Mode** - Detailed logging for troubleshooting **📈 bStats Integration** - **Anonymous Statistics** - Help improve the plugin - **Custom Charts** - Track total items with permissions - **Embedded System** - No conflicts with other plugins - **Privacy Focused** - Fully compliant w