SimpleItemsPerms
Minecraft 物品的终极权限系统
? 插件功能说明
SimpleItemsPerms 允许您为 Minecraft 服务器中的单个物品分配特定的权限。当您给某个物品设置权限要求时,只有拥有该权限的玩家才能使用它——其他玩家将被阻止操作,并显示可自定义的提示信息。
示例: 创建一把需要 simpleitemsperms.vip 权限的钻石剑。没有 VIP 等级的玩家无法使用它进行攻击、装备它,甚至无法拾取它。非常适合用于独家捐赠者奖励!
? 为什么下载此插件?
特别适合以下类型的服务器:
- VIP/捐赠者特权 - 将独家物品提供给付费支持者
- 等级进阶 - 将强力物品锁定在等级要求之后
- 自定义战利品包 - 创建仅限精英会员、高级会员或管理员使用的战利品包物品
- 经济商店 - 出售需要特殊权限的高级物品
- 活动奖励 - 提供仅活动获奖者才能使用的特殊物品
核心优势:
- ⚡ 易于使用 - 直观的图形用户界面,无需复杂命令
- ? 完全翻译 - 包含英文和意大利文,支持添加自己的语言
- ? 持久化 - 权限在服务器重启和世界更改后保持不变
- ? 高度可配置 - 配置每条消息、声音和行为
- ? 专业化 - 物品注册表、统计追踪和管理工具
⚠️ 下载前的重要信息
需求:
- ✅ 仅服务端插件 - 不在客户端工作,必须安装在服务器上
- ✅ 需要权限插件 - 您需要 LuckPerms、PermissionsEx 或类似插件
- ✅ Minecraft 1.21+ - 兼容 Spigot、Paper、Purpur、Pufferfish
- ✅ Java 21+ - 现代 Minecraft 版本所需
局限性:
- ⚠️ 放置的方块会丢失权限 - 当您放置一个方块时,Minecraft 会移除所有 NBT 数据(这会影响所有插件,而不仅仅是我们的)。权限对于武器、盔甲、工具、食物和药水完美生效。
工作原理:
- 权限存储在物品 NBT 数据中(PersistentDataContainer)
- 插件在 8 种以上不同事件上检查权限(使用、装备、消耗等)
- 没有权限的玩家会在物品上看到可自定义的lore(描述)消息
- 管理员可以通过简单的 GUI 管理所有已注册的物品
? 主要功能
? 高级权限系统
- 物品特定权限 - 为任何物品分配唯一权限
- 自动权限检查 - 没有权限的玩家无法使用受限物品
- 视觉反馈 - 自定义 lore 显示权限状态
- 动态 Lore - 对拥有权限的玩家隐藏权限 lore
- 持久存储 - 权限存储在物品 NBT 数据中( survive 服务器重启)
? 直观 GUI 系统
- 易用界面 - 通过精美的 GUI 分配权限
- 拖放操作 - 只需将物品放入 GUI 即可分配权限
- 视觉确认 - 绿色确认按钮和红色取消按钮
- 完全可配置 - 配置 GUI 大小、材质和颜色
- 实时更新 - 立即查看更改
? 多语言支持
- 双语系统 - 完整的英文和意大利文翻译
- 语言文件 - 轻松翻译为任何语言
- 动态切换 - 使用
/sip reload 更改语言
- 完全翻译 - GUI、命令、消息和 lore
- 无硬编码字符串 - 所有内容均可翻译
? 物品注册表与管理
- 全局物品注册表 - 追踪所有带有权限的物品
- 详细信息 - 查看物品详情、创建者和使用统计
- 浏览界面 - 分页列表显示所有已注册物品
- 物品详情 GUI - 查看附魔、lore 和元数据
- 轻松删除 - 一键从注册表中移除物品
?️ 全面的事件阻止
- 使用物品 - 阻止右键/左键使用
- 装备盔甲 - 防止穿戴受限盔甲
- 消耗物品 - 阻止进食/饮水
- 丢弃/拾取 - 控制物品转移
- 移动物品栏 - 防止物品栏操作
- 破坏/放置方块 - 控制方块交互
- 攻击实体 - 限制战斗使用
- 射击投射物 - 阻止弓/弩使用
⚙️ 高级配置
- 自定义 Lore - 定义权限拒绝消息
- Lore 位置 - 选择开始或结束位置
- 音效 - 当操作被阻止时的自定义声音
- 事件开关 - 启用/禁用特定事件检查
- 调试模式 - 详细的日志记录用于故障排除
? bStats 集成
- 匿名统计 - 帮助改进插件
- 自定义图表 - 追踪带有权限的物品总数
- 嵌入式系统 - 不会与其他插件冲突
- 注重隐私 - 完全符合隐私标准
? 命令
| 命令 |
描述 |
权限 |
/sip gui |
打开 GUI 以分配物品权限 |
simpleitemsperms.admin |
/sip give <player> <permission> |
将手中持有权限的物品给予玩家 |
simpleitemsperms.admin |
/sip remove |
移除手中物品的权限 |
simpleitemsperms.admin |
/sip check |
检查手中物品是否拥有权限 |
simpleitemsperms.admin |
/sip list |
打开 GUI 浏览所有已注册物品 |
simpleitemsperms.admin |
/sip reload |
重新加载配置文件和语言文件 |
simpleitemsperms.admin |
/sip info |
显示插件信息和命令 |
simpleitemsperms.admin |
命令别名: /simpleitemsperms, /itemsperms
? 权限
| 权限节点 |
描述 |
默认值 |
simpleitemsperms.admin |
访问所有插件命令和功能 |
仅限 OP |
simpleitemsperms.<custom> |
使用分配了 <custom> 权限的物品所需的权限 |
False |
? 权限示例
# 授予玩家 VIP 物品的访问权限
/lp user PlayerName permission set simpleitemsperms.vip true
# 授予精英组 Elite 物品的访问权限
/lp group elite permission set simpleitemsperms.elite true
# 多级权限设置
simpleitemsperms.vip - 基础 VIP 物品
simpleitemsperms.mvip - 更多 VIP 物品
simpleitemsperms.elite - 精英专属物品
simpleitemsperms.admin - 仅限管理员的物品
? 使用方法
方法 1:使用 GUI(推荐)
- 运行命令:
/sip gui
- 将你想要限制的物品放入 GUI 中
- 点击绿色的 CONFIRM 按钮
- 在聊天栏输入权限名称(例如
vip)
- 完成!现在这些物品需要
simpleitemsperms.vip 权限才能使用
方法 2:使用命令
- 手持要配置的物品
- 运行:
/sip give <player> <permission>
- 该物品将被赋予给指定玩家,并附带权限要求
? 进阶技巧
- 使用描述性的权限名称,如
vip、mvip、elite
- 将相关物品归为同一权限组
- 设置
hide-for-permitted-players: true 以隐藏拥有权限玩家看到的物品 Lore
- 使用
/sip list 管理所有受限物品
- 检查
/sip check 以验证物品权限
⚙️ 配置
点击查看 config.yml
# ╔═══════════════════════════════════════════════════════════════╗
# ║ SimpleItemsPerms - 配置文件 ║
# ║ Developed with ❤ by AlessioGTAII ║
# ╚═══════════════════════════════════════════════════════════════╝
# 语言 / Lingua
# 支持的语言:en_US (English), it_IT (Italiano)
language: "en_US"
# 消息前缀
prefix: "&8[&6SimpleItemsPerms&8]&r"
# GUI 配置
gui:
title: "&6Assign Permission to Items"
size: 54
confirm-button:
slot: 49
material: LIME_CONCRETE
name: "&a&lCONFIRM"
lore:
- "&7Click to confirm"
- "&7permission assignment"
cancel-button:
slot: 53
material: RED_CONCRETE
name: "&c&lCANCEL"
lore:
- "&7Click to cancel"
- "&7and close the GUI"
# Lore 配置
lore:
hide-for-permitted-players: true
position: "end"
# 阻止无权限玩家执行的事件
blocked-events:
use-item: true
equip-armor: true
consume: true
drop: false
pickup: true
move-inventory: true
break-block: true
place-block: true
attack: true
shoot-bow: true
# 当动作被阻止时播放的音效
block-sound:
enabled: true
sound: "ENTITY_VILLAGER_NO"
volume: 1.0
pitch: 1.0
# 调试系统
debug: false
? 语言文件
语言文件位于 plugins/SimpleItemsPerms/lang/ 目录下:
- messages_en_US.yml - 英文翻译
- messages_it_IT.yml - 意大利语翻译
想添加你的语言吗?复制现有文件,进行翻译,然后发送给我们!
❓ 常见问题
如何创建仅限 VIP 使用的物品?
- 运行
/sip gui
- 将你的 VIP 物品放入 GUI
- 点击确认并输入
vip
- 给予你的 VIP 玩家权限:
simpleitemsperms.vip
- 只有拥有此权限的玩家才能使用这些物品!
如果无权限的玩家尝试使用受限物品会发生什么?
该动作将被阻止,玩家会收到一条消息,说明他们需要相应的权限。同时会播放一个音效(可配置),以提供清晰的反馈。
我可以将此插件与 LuckPerms/PermissionsEx 一起使用吗?
可以!SimpleItemsPerms 兼容任何实现了 Bukkit/Spigot 权限系统的权限插件。
这能与其他插件的自定义物品配合使用吗?
可以!SimpleItemsPerms 兼容:
- 原版 Minecraft 物品
- ItemsAdder、Oraxen 等插件的自定义物品
- 具有自定义名称/Lore 的物品
- 附魔物品
- 带有自定义 NBT 数据的物品
如果我更改了语言,现有的物品会更新吗?
不会。Lore 是在你创建物品时保存的。只有新物品会使用新的语言。但是,权限始终有效,不受 Lore 语言的影响。
权限在服务端重启后还会保留吗?
是的!权限存储在物品的 NBT 数据中,并将在以下情况下保留:
- 服务端重启
- 插件重载
- 世界切换
- 玩家之间的物品交易
关于可放置的方块怎么办?
当你放置方块时,Minecraft 会移除所有的 NBT 数据。这是影响所有插件的正常行为。
适合用于: 武器、盔甲、工具、食物、药水
不推荐用于: 可放置的方块
? 兼容性
✅ 已测试且兼容:
- Minecraft: 1.21, 1.21.1, 1.21.3+
- 服务端: Spigot, Paper, Purpur, Pufferfish
- Java: 21+
- 权限插件: LuckPerms, PermissionsEx, GroupManager
- 自定义物品: ItemsAdder, Oraxen, MMOItems
- Kit 插件: EssentialsX, KitsPvP, AdvancedKits
⚠️ 已知问题:
? 安装
? 安装步骤:
- 下载 SimpleItemsPerms-1.1.0.jar
- 将其放入你的
plugins/ 文件夹
- 重启服务器
- 配置
plugins/SimpleItemsPerms/config.yml(可选)
- 使用
/sip gui 开始使用!
⚠️ 要求:
- Minecraft 1.21+ 服务端(Spigot/Paper)
- Java 21 或更高版本
- 权限插件(推荐使用 LuckPerms)
? 许可证
本插件基于 MIT License 发布。
Developed with ❤️ by AlessioGTAII
SimpleItemsPerms v1.1.1 - © 2025
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:
- Permissions are stored in item NBT data (PersistentDataContainer)
- The plugin checks permissions on 8+ different events (use, equip, consume, etc.)
- Players without permission see a customizable lore message on the item
- 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 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
# 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)
- Run command:
/sip gui
- Place items you want to restrict in the GUI
- Click the green CONFIRM button
- Type the permission name in chat (e.g.,
vip)
- Done! Items now require permission
simpleitemsperms.vip
Method 2: Using Commands
- Hold the item in your hand
- Run:
/sip give <player> <permission>
- 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
Click to view config.yml
# ╔═══════════════════════════════════════════════════════════════╗
# ║ SimpleItemsPerms - Configuration ║
# ║ Developed with ❤ by AlessioGTAII ║
# ╚═══════════════════════════════════════════════════════════════╝
# Language / Lingua
# Supported languages: en_US (English), it_IT (Italiano)
language: "en_US"
# Message prefix
prefix: "&8[&6SimpleItemsPerms&8]&r"
# GUI Configuration
gui:
title: "&6Assign Permission to Items"
size: 54
confirm-button:
slot: 49
material: LIME_CONCRETE
name: "&a&lCONFIRM"
lore:
- "&7Click to confirm"
- "&7permission assignment"
cancel-button:
slot: 53
material: RED_CONCRETE
name: "&c&lCANCEL"
lore:
- "&7Click to cancel"
- "&7and close the GUI"
# Lore Configuration
lore:
hide-for-permitted-players: true
position: "end"
# Events to block for players without permission
blocked-events:
use-item: true
equip-armor: true
consume: true
drop: false
pickup: true
move-inventory: true
break-block: true
place-block: true
attack: true
shoot-bow: true
# Sound played when an action is blocked
block-sound:
enabled: true
sound: "ENTITY_VILLAGER_NO"
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!
❓ FAQ
How do I create VIP-only items?
- Run
/sip gui
- Place your VIP items in the GUI
- Click confirm and type
vip
- Give your VIP players the permission:
simpleitemsperms.vip
- Only players with this permission can use those items!
What happens if a player without permission tries to use a restricted item?
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.
Can I use this with LuckPerms/PermissionsEx?
Yes! SimpleItemsPerms works with any permission plugin that implements the Bukkit/Spigot permission system.
Does this work with custom items from other plugins?
Yes! SimpleItemsPerms works with:
- Vanilla Minecraft items
- Custom items from ItemsAdder, Oraxen, etc.
- Items with custom names/lore
- Enchanted items
- Items with custom NBT data
If I change the language, do existing items update?
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.
Do permissions persist after server restarts?
Yes! Permissions are stored in the item's NBT data and will survive:
- Server restarts
- Plugin reloads
- World changes
- Item trades between players
What about placeable blocks?
When you place a block, Minecraft removes all NBT data. This is normal behavior affecting all plugins.
Perfect for: Weapons, armor, tools, food, potions
Not recommended for: Placeable blocks
? Compatibility
✅ Tested & Compatible:
- Minecraft: 1.21, 1.21.1, 1.21.3+
- Server: Spigot, Paper, Purpur, Pufferfish
- Java: 21+
- Permissions: LuckPerms, PermissionsEx, GroupManager
- Custom Items: ItemsAdder, Oraxen, MMOItems
- Kits: EssentialsX, KitsPvP, AdvancedKits
⚠️ Known Issues:
? Installation
? Installation Steps:
- Download SimpleItemsPerms-1.1.0.jar
- Place in your
plugins/ folder
- Restart your server
- Configure
plugins/SimpleItemsPerms/config.yml (optional)
- 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.
Developed with ❤️ by AlessioGTAII
SimpleItemsPerms v1.1.1 - © 2025
评论 0
登录后参与评分
还没有评论,来抢沙发吧