# SimpleItemsPerms<\/p>\n
\n<\/p>\n
**The Ultimate Permission System for Minecraft Items**<\/p>\n
—<\/p>\n
## \ud83d\udcd6 What This Plugin Does<\/p>\n
**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.<\/p>\n
**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!<\/p>\n
—<\/p>\n
## \ud83c\udfaf Why Download This Plugin?<\/p>\n
**Perfect for servers with:**
\n– **VIP\/Donor Perks** – Give exclusive items to paying supporters
\n– **Rank Progression** – Lock powerful items behind rank requirements
\n– **Custom Kits** – Create Elite, MVIP, or Admin-only kit items
\n– **Economy Shops** – Sell premium items that require special permissions
\n– **Event Rewards** – Give special items that only event winners can use<\/p>\n
**Key advantages:**
\n– \u26a1 **Easy to use** – Intuitive GUI, no complex commands
\n– \ud83c\udf0d **Fully translated** – English and Italian included, add your own language
\n– \ud83d\udd12 **Persistent** – Permissions survive server restarts and world changes
\n– \ud83c\udfa8 **Customizable** – Configure every message, sound, and behavior
\n– \ud83d\udcca **Professional** – Item registry, statistics tracking, and management tools<\/p>\n
—<\/p>\n
## \u26a0\ufe0f Important Information Before Downloading<\/p>\n
**Requirements:**
\n– \u2705 **Server-side only plugin** – Does NOT work on client, must be installed on server
\n– \u2705 **Permission plugin required** – You need LuckPerms, PermissionsEx, or similar
\n– \u2705 **Minecraft 1.21+** – Compatible with Spigot, Paper, Purpur, Pufferfish
\n– \u2705 **Java 21+** – Required for modern Minecraft versions<\/p>\n
**Limitations:**
\n– \u26a0\ufe0f **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.<\/p>\n
**How it works:**
\n1. Permissions are stored in item NBT data (PersistentDataContainer)
\n2. The plugin checks permissions on 8+ different events (use, equip, consume, etc.)
\n3. Players without permission see a customizable lore message on the item
\n4. Admins can manage all registered items through an easy GUI<\/p>\n
—<\/p>\n
## \ud83c\udf1f Key Features<\/p>\n
**\ud83d\udd10 Advanced Permission System**
\n– **Item-Specific Permissions** – Assign unique permissions to any item
\n– **Automatic Permission Checks** – Players without permission cannot use restricted items
\n– **Visual Feedback** – Custom lore shows permission status
\n– **Dynamic Lore** – Hide permission lore from players who have the permission
\n– **Persistent Storage** – Permissions stored in item NBT data (survives server restarts)<\/p>\n
**\ud83c\udfa8 Intuitive GUI System**
\n– **Easy-to-Use Interface** – Assign permissions through a beautiful GUI
\n– **Drag & Drop** – Simply place items in the GUI to assign permissions
\n– **Visual Confirmation** – Green confirm and red cancel buttons
\n– **Fully Customizable** – Configure GUI size, materials, and colors
\n– **Real-Time Updates** – See changes immediately<\/p>\n
**\ud83c\udf0d Multi-Language Support**
\n– **Bilingual System** – Full English and Italian translations
\n– **Language Files** – Easy to translate to any language
\n– **Dynamic Switching** – Change language with `\/sip reload`
\n– **Fully Translated** – GUI, commands, messages, and lore
\n– **No Hardcoded Strings** – Everything is translatable<\/p>\n
**\ud83d\udcca Item Registry & Management**
\n– **Global Item Registry** – Track all items with permissions
\n– **Detailed Information** – View item details, creator, and usage statistics
\n– **Browse Interface** – Paginated list of all registered items
\n– **Item Details GUI** – See enchantments, lore, and metadata
\n– **Easy Deletion** – Remove items from registry with one click<\/p>\n
**\ud83d\udee1\ufe0f Comprehensive Event Blocking**
\n– **Use Items** – Block right\/left click usage
\n– **Equip Armor** – Prevent wearing restricted armor
\n– **Consume Items** – Block eating\/drinking
\n– **Drop\/Pickup** – Control item transfer
\n– **Move Inventory** – Prevent inventory manipulation
\n– **Break\/Place Blocks** – Control block interactions
\n– **Attack Entities** – Restrict combat usage
\n– **Shoot Projectiles** – Block bow\/crossbow usage<\/p>\n
**\u2699\ufe0f Advanced Configuration**
\n– **Customizable Lore** – Define permission denial message
\n– **Lore Position** – Choose start or end position
\n– **Sound Effects** – Custom sounds when actions are blocked
\n– **Event Toggle** – Enable\/disable specific event checks
\n– **Debug Mode** – Detailed logging for troubleshooting<\/p>\n
**\ud83d\udcc8 bStats Integration**
\n– **Anonymous Statistics** – Help improve the plugin
\n– **Custom Charts** – Track total items with permissions
\n– **Embedded System** – No conflicts with other plugins
\n– **Privacy Focused** – Fully compliant with privacy standards<\/p>\n
—<\/p>\n
## \ud83d\udccb Commands<\/p>\n
| Command | Description | Permission | **Command Aliases:** `\/simpleitemsperms`, `\/itemsperms`<\/p>\n —<\/p>\n ## \ud83d\udd11 Permissions<\/p>\n | Permission Node | Description | Default | ### \ud83d\udcdd Permission Examples<\/p>\n “`yaml # Grant a group access to Elite items # Multiple permission levels —<\/p>\n ## \ud83c\udf93 How to Use<\/p>\n **Method 1: Using the GUI (Recommended)**<\/p>\n 1. Run command: `\/sip gui` **Method 2: Using Commands**<\/p>\n 1. Hold the item in your hand **\ud83d\udca1 Pro Tips** —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n “`yaml # Language \/ Lingua # Message prefix # GUI Configuration confirm-button: cancel-button: # Lore Configuration # Events to block for players without permission # Sound played when an action is blocked # Debug system **\ud83c\udf0d Language Files**<\/p>\n Language files are located in `plugins\/SimpleItemsPerms\/lang\/` Want to add your language? Copy an existing file, translate it, and send it to us!<\/p>\n —<\/p>\n ## \u2753 FAQ<\/p>\n 1. Run `\/sip gui` The action will be blocked and the player will receive a message explaining they need the permission. A sound effect will play (configurable) to give clear feedback. Yes! SimpleItemsPerms works with any permission plugin that implements the Bukkit\/Spigot permission system. Yes! SimpleItemsPerms works with: No. The lore is saved when you create the item. Only **new items** will have the new language. However, **permissions always work** regardless of lore language. Yes! Permissions are stored in the item’s NBT data and will survive: When you place a block, Minecraft removes all NBT data. This is normal behavior affecting all plugins.<\/p>\n **Perfect for:** Weapons, armor, tools, food, potions —<\/p>\n ## \ud83d\udd27 Compatibility<\/p>\n **\u2705 Tested & Compatible:** **\u26a0\ufe0f Known Issues:** —<\/p>\n ## \ud83d\udcbe Installation<\/p>\n **\ud83d\udce5 Installation Steps:**<\/p>\n 1. Download **SimpleItemsPerms-1.1.0.jar** **\u26a0\ufe0f Requirements:** —<\/p>\n ## \ud83d\udcdd License<\/p>\n This plugin is released under the **MIT License**.<\/p>\n —<\/p>\n **Developed with \u2764\ufe0f by AlessioGTAII**<\/p>\n SimpleItemsPerms v1.1.1 – \u00a9 2025<\/p>\n  Simple Items Perms is a powerful and intuitive plugin that allows you to assign specific permissions<\/p>\n","protected":false},"featured_media":140246,"template":"","meta":{"_minecraft_slug":"simple-items-perms","_minecraft_project_id":"3gAPUvJY","_minecraft_author":"AlessioGTAII","_minecraft_license":"MIT","_minecraft_downloads":54,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simple-items-perms.zip","_minecraft_size_bytes":161723,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:57:58.798828Z","_minecraft_date_created":"2025-11-24T02:14:00.153659Z","_minecraft_date_modified":"2025-11-24T18:57:15.944921Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simple-items-perms","_minecraft_icon_attachment_id":140246,"_minecraft_imported_at":"2026-06-08T07:41:28+00:00","_minecraft_import_hash":"cd21e7199eca93722fa3aba66777c26e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,128,129,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-140245","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/sip gui` | Open the GUI to assign permissions to items | `simpleitemsperms.admin` |
\n| `\/sip give
\n| `\/sip remove` | Remove the permission from the item in your hand | `simpleitemsperms.admin` |
\n| `\/sip check` | Check if the item in your hand has a permission | `simpleitemsperms.admin` |
\n| `\/sip list` | Open the GUI to browse all registered items | `simpleitemsperms.admin` |
\n| `\/sip reload` | Reload the configuration and language files | `simpleitemsperms.admin` |
\n| `\/sip info` | Display plugin information and commands | `simpleitemsperms.admin` |<\/p>\n
\n|—————-|————-|———|
\n| `simpleitemsperms.admin` | Access to all plugin commands and features | OP only |
\n| `simpleitemsperms.
\n# Grant a player access to VIP items
\n\/lp user PlayerName permission set simpleitemsperms.vip true<\/p>\n
\n\/lp group elite permission set simpleitemsperms.elite true<\/p>\n
\nsimpleitemsperms.vip – Basic VIP items
\nsimpleitemsperms.mvip – More VIP items
\nsimpleitemsperms.elite – Elite exclusive items
\nsimpleitemsperms.admin – Admin-only items
\n“`<\/p>\n
\n2. Place items you want to restrict in the GUI
\n3. Click the green **CONFIRM** button
\n4. Type the permission name in chat (e.g., `vip`)
\n5. Done! Items now require permission `simpleitemsperms.vip`<\/p>\n
\n2. Run: `\/sip give
\n3. The item will be given to the player with the permission requirement<\/p>\n
\n– Use descriptive permission names like `vip`, `mvip`, `elite`
\n– Group related items with the same permission
\n– Set `hide-for-permitted-players: true` to hide lore from players who can use the item
\n– Use `\/sip list` to manage all your restricted items
\n– Check `\/sip check` to verify item permissions<\/p>\nClick to view config.yml<\/summary>\n
\n# \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
\n# \u2551 SimpleItemsPerms – Configuration \u2551
\n# \u2551 Developed with \u2764 by AlessioGTAII \u2551
\n# \u255a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255d<\/p>\n
\n# Supported languages: en_US (English), it_IT (Italiano)
\nlanguage: “en_US”<\/p>\n
\nprefix: “&8[&6SimpleItemsPerms&8]&r”<\/p>\n
\ngui:
\n title: “&6Assign Permission to Items”
\n size: 54<\/p>\n
\n slot: 49
\n material: LIME_CONCRETE
\n name: “&a&lCONFIRM”
\n lore:
\n – “&7Click to confirm”
\n – “&7permission assignment”<\/p>\n
\n slot: 53
\n material: RED_CONCRETE
\n name: “&c&lCANCEL”
\n lore:
\n – “&7Click to cancel”
\n – “&7and close the GUI”<\/p>\n
\nlore:
\n hide-for-permitted-players: true
\n position: “end”<\/p>\n
\nblocked-events:
\n use-item: true
\n equip-armor: true
\n consume: true
\n drop: false
\n pickup: true
\n move-inventory: true
\n break-block: true
\n place-block: true
\n attack: true
\n shoot-bow: true<\/p>\n
\nblock-sound:
\n enabled: true
\n sound: “ENTITY_VILLAGER_NO”
\n volume: 1.0
\n pitch: 1.0<\/p>\n
\ndebug: false
\n“`<\/p>\n<\/details>\n
\n– **messages_en_US.yml** – English translations
\n– **messages_it_IT.yml** – Italian translations<\/p>\nHow do I create VIP-only items?<\/summary>\n
\n2. Place your VIP items in the GUI
\n3. Click confirm and type `vip`
\n4. Give your VIP players the permission: `simpleitemsperms.vip`
\n5. Only players with this permission can use those items!
\n<\/details>\nWhat happens if a player without permission tries to use a restricted item?<\/summary>\n
\n<\/details>\nCan I use this with LuckPerms\/PermissionsEx?<\/summary>\n
\n<\/details>\nDoes this work with custom items from other plugins?<\/summary>\n
\n– Vanilla Minecraft items
\n– Custom items from ItemsAdder, Oraxen, etc.
\n– Items with custom names\/lore
\n– Enchanted items
\n– Items with custom NBT data
\n<\/details>\nIf I change the language, do existing items update?<\/summary>\n
\n<\/details>\nDo permissions persist after server restarts?<\/summary>\n
\n– Server restarts
\n– Plugin reloads
\n– World changes
\n– Item trades between players
\n<\/details>\nWhat about placeable blocks?<\/summary>\n
\n**Not recommended for:** Placeable blocks
\n<\/details>\n
\n– **Minecraft:** 1.21, 1.21.1, 1.21.3+
\n– **Server:** Spigot, Paper, Purpur, Pufferfish
\n– **Java:** 21+
\n– **Permissions:** LuckPerms, PermissionsEx, GroupManager
\n– **Custom Items:** ItemsAdder, Oraxen, MMOItems
\n– **Kits:** EssentialsX, KitsPvP, AdvancedKits<\/p>\n
\n– None currently reported!<\/p>\n
\n2. Place in your `plugins\/` folder
\n3. Restart your server
\n4. Configure `plugins\/SimpleItemsPerms\/config.yml` (optional)
\n5. Use `\/sip gui` to get started!<\/p>\n
\n– Minecraft 1.21+ server (Spigot\/Paper)
\n– Java 21 or higher
\n– Permission plugin (LuckPerms recommended)<\/p>\n
\n<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"