Simple Items Perms

SimpleItemsPerms

Version

Minecraft

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?

Event Rewards - Event Rewards - Give exclusive items to paying supporters - Event Rewards - Lock powerful items behind rank requirements - Event Rewards - Create Elite, MVIP, or Admin-only kit items - Event Rewards - Sell premium items that require special permissions - Event Rewards - Give special items that only event winners can use

Professional - ⚡ Professional - Intuitive GUI, no complex commands - 🌍 Professional - English and Italian included, add your own language - 🔒 Professional - Permissions survive server restarts and world changes - 🎨 Professional - Configure every message, sound, and behavior - 📊 Professional - Item registry, statistics tracking, and management tools

---

⚠️ Important Information Before Downloading

Java 21+ - ✅ Java 21+ - Does NOT work on client, must be installed on server - ✅ Java 21+ - You need LuckPerms, PermissionsEx, or similar - ✅ Java 21+ - Compatible with Spigot, Paper, Purpur, Pufferfish - ✅ Java 21+ - Required for modern Minecraft versions

Placed blocks lose permissions - ⚠️ 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

Persistent Storage - Persistent Storage - Assign unique permissions to any item - Persistent Storage - Players without permission cannot use restricted items - Persistent Storage - Custom lore shows permission status - Persistent Storage - Hide permission lore from players who have the permission - Persistent Storage - Permissions stored in item NBT data (survives server restarts)

Real-Time Updates - Real-Time Updates - Assign permissions through a beautiful GUI - Real-Time Updates - Simply place items in the GUI to assign permissions - Real-Time Updates - Green confirm and red cancel buttons - Real-Time Updates - Configure GUI size, materials, and colors - Real-Time Updates - See changes immediately

No Hardcoded Strings - No Hardcoded Strings - Full English and Italian translations - No Hardcoded Strings - Easy to translate to any language - No Hardcoded Strings - Change language with `/sip reload` - No Hardcoded Strings - GUI, commands, messages, and lore - No Hardcoded Strings - Everything is translatable

Easy Deletion - Easy Deletion - Track all items with permissions - Easy Deletion - View item details, creator, and usage statistics - Easy Deletion - Paginated list of all registered items - Easy Deletion - See enchantments, lore, and metadata - Easy Deletion - Remove items from registry with one click

Shoot Projectiles - Shoot Projectiles - Block right/left click usage - Shoot Projectiles - Prevent wearing restricted armor - Shoot Projectiles - Block eating/drinking - Shoot Projectiles - Control item transfer - Shoot Projectiles - Prevent inventory manipulation - Shoot Projectiles - Control block interactions - Shoot Projectiles - Restrict combat usage - Shoot Projectiles - Block bow/crossbow usage

Debug Mode - Debug Mode - Define permission denial message - Debug Mode - Choose start or end position - Debug Mode - Custom sounds when actions are blocked - Debug Mode - Enable/disable specific event checks - Debug Mode - Detailed logging for troubleshooting

Privacy Focused - Privacy Focused - Help improve the plugin - Privacy Focused - Track total items with permissions - Privacy Focused - No conflicts with other plugins - Privacy Focused - Fully compliant with privacy standards

---

📋 Commands

| Command | Description | Permission | |---------|-------------|------------| | `/sip gui` | Open the GUI to assign permissions to items | `simpleitemsperms.admin` | | `/sip give <player> <permission>` | Give the item in your hand with a permission to a player | `simpleitemsperms.admin` | | `/sip remove` | Remove the permission from the item in your hand | `simpleitemsperms.admin` | | `/sip check` | Check if the item in your 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 Node | Description | Default | |----------------|-------------|---------| | `simpleitemsperms.admin` | Access to all plugin commands and features | OP only | | `simpleitemsperms.<custom>` | Permission required to use items assigned with `<custom>` | False |

📝 Permission Examples

```yaml

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 ```

---

🎓 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

---

⚙️ Configuration

🌍 Language Files

Language files are located in `plugins/SimpleItemsPerms/lang/` - messages_it_IT.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!

---

❓ FAQ

---

🔧 Compatibility

Kits: - Kits: 1.21, 1.21.1, 1.21.3+ - Kits: Spigot, Paper, Purpur, Pufferfish - Kits: 21+ - Kits: LuckPerms, PermissionsEx, GroupManager - Kits: ItemsAdder, Oraxen, MMOItems - Kits: EssentialsX, KitsPvP, AdvancedKits

⚠️ Known Issues: - None currently reported!

---

💾 Installation

📥 Installation Steps:

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

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

---

📝 License

This plugin is released under the MIT License.

---

<div align="center">

Developed with ❤️ by AlessioGTAII

SimpleItemsPerms v1.1.1 - © 2025

</div>