Simple Items Perms [1.21.8 - 1.21.10] icon

Simple Items Perms [1.21.8 - 1.21.10] -----

SimpleItemsPerms is a powerful and intuitive plugin that allows you to assign specific permissions

Download Now
87.9 KB .jar



banner2.png
SimpleItemsPerms
The Ultimate Permission System for Minecraft Items

[​IMG] [​IMG] [​IMG]
​

____________________________________________________​

✨ OVERVIEW​

SimpleItemsPerms is a powerful and intuitive plugin that allows you to assign specific permissions to individual items in your Minecraft server. Perfect for creating exclusive VIP kits, premium items, or special rewards that only certain players can use!

Perfect for:​
  • VIP/MVIP/Elite exclusive items
  • Donor rewards and perks
  • Special event items
  • Rank-specific equipment
  • Custom kit systems
  • Economy shops with premium items
____________________________________________________

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 with privacy standards

____________________________________________________

SCREENSHOTS​

sipgui.png
listgui.png
____________________________________________________

COMMANDS​

Command Description Permission
/sip gui Open the GUI to assign permissions to items simpleitemsperms.admin
/sip give <p> <perm> Give the item in hand with permission to a player simpleitemsperms.admin
/sip remove Remove permission from item in hand simpleitemsperms.admin
/sip check Check if item in hand has a permission simpleitemsperms.admin
/sip list Open the GUI to browse all registered items simpleitemsperms.admin
/sip reload Reload the configuration and language files simpleitemsperms.admin
/sip info Display plugin information and commands simpleitemsperms.admin

Command Aliases: /simpleitemsperms, /itemsperms​

____________________________________________________

PERMISSIONS​

Permission Nodes:

  • simpleitemsperms.admin
    Access to all plugin commands and features
    Default: OP only
  • simpleitemsperms.<custom>
    Permission required to use items assigned with <custom>
    Default: False (must be granted manually)

Permission Examples:
Code (Text):

# Grant a player access to VIP items
/lp user PlayerName permission set simpleitemsperms.vip true

# Grant a group access to Elite items
/lp group elite permission set simpleitemsperms.elite true

# Multiple permission levels
simpleitemsperms.vip       - Basic VIP items
simpleitemsperms.mvip      - More VIP items
simpleitemsperms.elite     - Elite exclusive items
simpleitemsperms.admin     - Admin-only items
 
____________________________________________________

⚙️ CONFIGURATION​

Code (Text):

                       SimpleItemsPerms - Configuration              
                      Developed with ❤ by AlessioGTAII                  

# Language / Lingua
# Supported languages: en_US (English), it_IT (Italiano)
# Change this to switch the plugin language
language: "en_US"

# Message prefix
prefix: "&8[&6SimpleItemsPerms&8]&r"

# GUI Configuration
gui:
  title: "&6Assign Permission to Items"
  size: 54  # Must be multiple of 9 (9, 18, 27, 36, 45, 54)
 
  # Confirm button
  confirm-button:
    slot: 49
    material: LIME_CONCRETE
    name: "&a&lCONFIRM"
    lore:
      - "&7Click to confirm"
      - "&7permission assignment"
 
  # Cancel button
  cancel-button:
    slot: 53
    material: RED_CONCRETE
    name: "&c&lCANCEL"
    lore:
      - "&7Click to cancel"
      - "&7and close the GUI"

# Lore Configuration
lore:
  # Lore text is now defined in language files:
  # - lang/messages_en_US.yml: lore-no-permission
  # - lang/messages_it_IT.yml: lore-no-permission
 
  # Hide lore for players who HAVE the permission
  hide-for-permitted-players: true
 
  # Lore position (start or end)
  position: "end"  # Options: "start", "end"

# Events to block for players without permission
blocked-events:
  use-item: true              # Right/left click
  equip-armor: true           # Equipping armor
  consume: true               # Eating/drinking potions
  drop: false                 # Dropping the item (ALLOWED - to get rid of it!)
  pickup: true                # Picking up the item (BLOCKED)
  move-inventory: true        # Moving in inventory
  break-block: true           # Breaking blocks
  place-block: true           # Placing blocks
  attack: true                # Attacking entities
  shoot-bow: true             # Shooting with bow

# Sound played when an action is blocked
block-sound:
  enabled: true
  sound: "ENTITY_VILLAGER_NO"  # Vanilla Minecraft sound
  volume: 1.0
  pitch: 1.0

# Debug system
debug: false
 

Language Files:

Language files are located in plugins/SimpleItemsPerms/lang/
  • messages_en_US.yml - English translations
  • messages_it_IT.yml - Italian translations
Want to add your language? Copy an existing file, translate it, and send it to us!

____________________________________________________

HOW TO USE​

Method 1: Using the GUI (Recommended)

1. Run command: /sip gui
2. Place items you want to restrict in the GUI
3. Click the green CONFIRM button
4. Type the permission name in chat (e.g., vip)
5. Done! Items now require permission simpleitemsperms.vip

Method 2: Using Commands

1. Hold the item in your hand
2. Run: /sip give <player> <permission>
3. The item will be given to the player with the permission requirement

Pro Tips:
  • Use descriptive permission names like vip, mvip, elite
  • Group related items with the same permission
  • Set hide-for-permitted-players: true to hide lore from players who can use the item
  • Use /sip list to manage all your restricted items
  • Check /sip check to verify item permissions

____________________________________________________

❓ FREQUENTLY ASKED QUESTIONS​

1. Run /sip gui
2. Place your VIP items in the GUI
3. Click confirm and type vip
4. Give your VIP players the permission: simpleitemsperms.vip
5. Only players with this permission can use those items!

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. The specific events blocked depend on your configuration (use, equip, consume, etc.).

Yes! SimpleItemsPerms works with any permission plugin that implements the Bukkit/Spigot permission system. This includes LuckPerms, PermissionsEx, GroupManager, and more.

Yes! SimpleItemsPerms works with any item, including:
  • Vanilla Minecraft items
  • Custom items from other plugins
  • Items with custom names/lore
  • Enchanted items
  • Items with custom NBT data

No. The lore is saved in the item when you create it. Only new items will have lore in the new language. However, the permission always works regardless of the lore language.

To update existing items:
1. Remove the permission: /sip remove
2. Reassign the permission with the new language active

Yes! Permissions are stored in the item's NBT data using Minecraft's PersistentDataContainer system. They will survive:
  • Server restarts
  • Plugin reloads
  • World changes
  • Item trades between players

When you place a block, Minecraft removes all NBT data from that block. This is normal Minecraft behavior and affects all plugins. When you break the block, you'll get a vanilla item without the permission.

SimpleItemsPerms is perfect for: Weapons, armor, tools, food, potions, etc.
Not recommended for: Placeable blocks (they lose data when placed)

Yes! The message is defined in the language files ( lang/messages_XX_XX.yml) under the key lore-no-permission. You can edit it to say whatever you want!

In config.yml, under the blocked-events section, set any event to false to disable that check. For example:
Code (Text):

blocked-events:
  use-item: true      # Keep blocking use
  drop: false         # Allow dropping (so players can get rid of items)
  pickup: true        # Block pickup
 

No! SimpleItemsPerms is extremely lightweight:
  • Efficient NBT data storage
  • Optimized event listeners
  • No database queries for permission checks
  • Minimal memory footprint
  • Async operations where possible

____________________________________________________

COMPATIBILITY​

✅ Tested & Compatible:
  • Minecraft Versions: 1.21, 1.21.1, 1.21.3+ (API 1.21+)
  • Server Software: Spigot, Paper, Purpur, Pufferfish
  • Java Versions: Java 21+
  • Permission Plugins: LuckPerms, PermissionsEx, GroupManager, zPermissions
  • Economy Plugins: Vault, PlayerPoints, Essentials Economy
  • Custom Item Plugins: ItemsAdder, Oraxen, CustomItems, MMOItems
  • Kit Plugins: EssentialsX, KitsPvP, AdvancedKits

⚠️ Known Incompatibilities:
  • None currently reported!

____________________________________________________

DOWNLOAD & INSTALLATION​

Installation Steps:

1. Download SimpleItemsPerms-1.1.0.jar
2. Place the file in your plugins/ folder
3. Restart your server
4. Configure plugins/SimpleItemsPerms/config.yml (optional)
5. Done! Use /sip gui to get started

⚠️ Requirements:
  • Minecraft 1.21+ server (Spigot/Paper)
  • Java 21 or higher
  • Permission plugin (LuckPerms recommended)

____________________________________________________

CHANGELOG​

✨ New Features:
  • Complete multi-language system (English + Italian)
  • bStats integration with custom charts
  • Fully translated GUI system
  • Translated chat messages and prompts
  • Dynamic language switching with /sip reload
  • Item registry and management system
  • Item details GUI with statistics

Improvements:
  • ✅ Fixed items without ItemMeta (vanilla pickaxes, etc.)
  • ✅ Global item registry for tracking
  • ✅ Embedded bStats (zero conflicts with other plugins)
  • ✅ Automatic language file extraction
  • ✅ Zero hardcoded strings
  • ✅ Improved permission system

Bug Fixes:
  • ✅ Items without metadata now work correctly
  • ✅ bStats conflicts resolved
  • ✅ Language files auto-create on startup
  • ✅ GUI buttons now properly translated
  • ✅ Lore text now translates with language changes

  • Initial plugin release
  • Basic permission system
  • GUI for assigning permissions
  • ⚙️ Configuration system
  • Basic commands

____________________________________________________

SUPPORT & LINKS​

Need Help?
  • Discord: Join our Discord server
  • Email: Contact developer
  • Bug Reports: Use the "Issues" section on this page
  • Feature Requests: Post in the discussion section
  • ⭐ Reviews: Leave a review if you enjoy the plugin!

Useful Links:
  • Wiki/Documentation: Coming soon!
  • Source Code: Available on request

____________________________________________________

❤️ SUPPORT THE DEVELOPER​

SimpleItemsPerms is 100% free and will always be! If you enjoy this plugin, consider:

  • ⭐ Leaving a 5-star review
  • Sharing feedback and suggestions
  • Reporting bugs to help improve the plugin
  • Contributing translations
  • ☕ Buying the developer a coffee❤️

Every bit of support helps continue development! Thank you! ❤️

____________________________________________________

Developed with ❤️ by AlessioGTAII

SimpleItemsPerms v1.1.0 - © 2025

[​IMG] [​IMG]
​
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 13
First Release: Nov 22, 2025
Last Update: Nov 23, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings