ItemEdit - 物品快速编辑管理

ItemEdit 是一款功能强大的物品编辑与管理插件，它通过一系列直观的命令，让服务器管理员和创造服玩家能够轻松、快速地自定义游戏内的任何物品，从修改基础属性到添加复杂的特殊效果。

💡核心命令

插件提供了三条主要命令，分别对应不同的使用场景

/itemedit (/ie)

用于直接编辑手中物品的属性。

• 修改物品的名称与描述（Lore），支持复制粘贴功能。
• 设置物品为无法破坏。
• 自定义药水颜色（支持超过65,000种颜色）并隐藏药水效果，制作“秘密药水”。
• 为物品添加隐藏附魔，使其发光。
• 调整物品的属性，如护甲值、最大生命值、伤害等。
• 通过简易的GUI编辑烟花火箭效果。
• 包含超过20个子命令，用于深度定制物品。

/serveritem (/si)

设计用于从服务器控制台与玩家交互，管理服务器级别的自定义物品。

• 给予、出售、购买或收回玩家物品。
• 非常适合与箱子插件、礼包插件等配合使用，通过命令发放定制物品。
• 可用于建立服务器商店或奖励系统。

/itemstorage (/is)

为创造服玩家设计，提供个人物品存储空间。

• 允许玩家保存、查看、更新和取回自己定制的物品。

✨主要功能

• 全面的物品编辑：修改名称、描述、数量、耐久、附魔、材质等。
• 高级视觉效果：自定义药水与皮革盔甲颜色、烟花效果、旗帜图案。
• 状态控制：设置物品无法破坏、隐藏所有属性标签。
• 物品存储系统：提供个人(/itemstorage)与服务器(/serveritem)两级存储方案。
• 经济集成：直接通过命令向玩家出售或购买已保存的物品。
• 卓越的兼容性：支持 Vault (经济)、ShopGuiPlus、PlaceholderAPI 和 MythicMobs。
• 开发者API：提供完整的API供其他插件开发者调用。
• 用户体验优化：命令支持Tab补全，帮助信息支持悬停查看详情与点击快速建议。
• 开源免费：插件完全开源且免费使用。

🔧进阶定制

如需更深度的物品定制（例如让物品触发命令、为穿戴的盔甲附加药水效果等），可以搭配使用插件的扩展组件 ItemTag。

❓教程与权限

视频教程

• 英文教程 (v2.10): [链接]
• 西班牙语教程 (v3.0.5, 由 Ajneb97 制作): [链接]

权限节点概览 (v3.0.12)

插件权限结构清晰，主要分为三大类命令权限及其子权限。默认情况下，所有主要权限均授予OP玩家。

• itemedit.admin：授予插件所有功能的完全访问权限。
• itemedit.creativeuser：授予创意模式玩家使用 /itemedit 和 /itemstorage 的完全权限。
• **itemedit.bypass.***：用于绕过各种限制（如敏感词检查、重命名类型限制等）。

每条命令（/itemedit, /serveritem, /itemstorage）都有对应的通配符权限（如 itemedit.itemedit.*）以及更细粒度的子命令权限（如 itemedit.itemedit.rename）。详细的权限树可在插件文档或配置中查看。

🎮开发者API

ItemEdit 提供了易于集成的API，供其他插件开发者调用其物品存储与编辑功能。

添加依赖

在你的插件 plugin.yml 中声明依赖：

depend: [ItemEdit]

Maven

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>

<dependency>
    <groupId>com.github.emanondev</groupId>
    <artifactId>ItemEdit</artifactId>
    <version>2.18</version>
</dependency>

Gradle

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    implementation 'com.github.emanondev:ItemEdit:2.18'
}

基础用法

通过以下方式获取并操作物品存储接口

public void yourMethodName() {
    PlayerStorage playerStorage = ItemEdit.get().getPlayerStorage();
    ServerStorage serverStorage = ItemEdit.get().getServerStorage();
    // 进行你的操作
}

⭐支持开发者

如果您喜欢这个插件，可以通过以下方式支持开发

• 为插件页面点个 赞 或留下 正面评价。
• 使用赞助商 CTRL Servers 的服务时，在首月订单中使用优惠码 emanon 可享受 85折 优惠。这也能让开发者获得一小笔佣金，且您无需支付额外费用。

保持开发者的创作动力！

您可以在以下链接找到完整文档

https://github.com/emanondev/ItemEdit/wiki

💡语言支持

本插件会自动根据客户端语言选择显示语言（仅支持 1.12 以上版本的服务器）。

目前默认配置的语言种类有限，欢迎协助完善翻译！

如何贡献翻译

• 您可以将修正后的语言文件发送给插件作者。
• 或直接在 GitHub 上编辑对应文件：

https://github.com/emanondev/ItemEdit/tree/master/src/main/resources/languages