原创 工具 DreamItemLibrary - 一款 Minecraft 物品管理插件，从配置文件加载预设物品 [1.12.2] 1.0.0

[MD] ## 📖 插件简介 **DreamItemLibrary** 是一款**基于配置文件**的 Minecraft 物品库管理插件。 与游戏内存储物品的插件不同，本插件**通过 YAML 配置文件定义物品**，所有物品数据都以文本形式存储，方便进行： - ✅ **版本控制** - 配置文件可提交至 Git，追踪每次修改 - ✅ **多服务器同步** - 复制配置文件即可同步物品到其他服务器 - ✅ **批量编辑** - 使用文本编辑器快速修改大量物品 - ✅ **预设物品** - 适合管理固定的活动奖励、VIP 道具等 > 💡 **适用场景**: 如果你的物品是**预先设计好的固定物品**（如活动奖励、VIP装备、特殊武器），本插件是最佳选择！ > > ~~如果你需要在**游戏内动态创建和存储物品**，请关注我的另一款插件。~~ --- ## ✨ 核心特性 - **📝 配置文件驱动** - 所有物品通过 YAML 文件定义，支持热重载，修改即时生效 - **📂 分类管理** - 支持子文件夹分类存放，如 `武器/`、`防具/`、`活动奖励/` - **🎨 高度自定义** - 支持名称、Lore、附魔、不可破坏等属性 - **️ 可视化菜单** - 游戏内 GUI 菜单浏览和获取物品 - **⚡ 轻量高效** - 无数据库依赖，纯文件存储 - **🌈 颜色支持** - 全面支持 Minecraft 颜色代码 --- ## 📋 环境要求 | 项目 | 要求 | |------|------| | 服务端 | Spigot/Paper 1.12.x | | Java | Java 8+ | | 权限 | 需要 OP 权限执行命令 | --- ## 🚀 安装方法 1. 下载插件 JAR 文件 2. 将 JAR 文件放入服务器的 `plugins` 文件夹 3. 重启服务器或使用插件管理器加载 4. 首次启动会自动生成配置文件和示例物品配置 --- ## 📚 使用教程 ### 命令列表 | 命令 | 别名 | 说明 | |------|------|------| | `/dreamitemlibrary list` | `/dil list` | 查看已加载的物品列表 | | `/dreamitemlibrary menu` | `/dil menu` | 打开物品库可视化菜单 | | `/dreamitemlibrary give <玩家> <物品ID> [数量]` | `/dil give` | 给予指定玩家物品 | | `/dreamitemlibrary reload` | `/dil reload` | 重载配置文件（修改配置后执行） | > 💡 **提示**: 命令别名包括 `/dreamitemlibrary`、`/ditemlibrary`、`/dil` --- ### 📝 物品配置教程 #### 配置文件位置示例 物品配置文件存放在 `plugins/DreamItemLibrary/Items/` 目录下： ``` plugins/DreamItemLibrary/ ├── config.yml # 主配置文件 └── Items/ # 物品配置目录 ├── 武器.yml # 直接放在 Items 目录 ├── 防具.yml └── 活动物品/ # 子文件夹分类管理 ├── 新年活动.yml └── 周年庆.yml ``` > 📌 **提示**: 你可以创建任意数量的子文件夹来分类管理物品配置！ #### 配置格式说明 ```yaml # 物品唯一标识符（用于 /dil give 命令） exampleItem: # 物品材质ID（支持数字ID或英文ID） ID: DIAMOND_SWORD # 物品数据值（用于区分同类型物品的不同变种） data: 0 # 物品显示名称（支持颜色代码 &） Name: "&b神秘之剑" # 物品描述（支持多行） Lore: - "&7这是一个示例物品。" - "&a带有颜色的描述。" - "&e右键点击释放技能" # 是否设为不可破坏（true/false） IsNoBreak: true # 附魔配置（可选） ench: DAMAGE_ALL: 5 # 锋利 V FIRE_ASPECT: 2 # 火焰附加 II DURABILITY: 3 # 耐久 III ``` #### 配置项详解 | 配置项 | 类型 | 必填 | 说明 | |--------|------|------|------| | `ID` | String | ✅ | 物品材质，支持数字ID或英文ID（如 `DIAMOND_SWORD`） | | `data` | Integer | ❌ | 物品数据值，默认为 0 | | `Name` | String | ❌ | 物品显示名称，支持颜色代码 | | `Lore` | List | ❌ | 物品描述，支持多行和颜色代码 | | `IsNoBreak` | Boolean | ❌ | 是否不可破坏，默认 false | | `ench` | Section | ❌ | 附魔配置，格式为 `附魔类型: 等级` | --- ### 🎮 配置示例 #### 示例 1: 创建一把神器 ```yaml godSword: ID: DIAMOND_SWORD Name: "&c&l弑神之剑" Lore: - "&6━━━━━━━━━━━━━━━━━━" - "&e传说中由神明锻造的武器" - "&e拥有毁灭一切的力量" - "&6━━━━━━━━━━━━━━━━━━" - "" - "&c攻击力: &f+999" - "&c持有者: &f天选之人" IsNoBreak: true ench: DAMAGE_ALL: 10 FIRE_ASPECT: 5 KNOCKBACK: 3 ``` #### 示例 2: 创建活动奖励礼包 ```yaml christmasGift: ID: CHEST Name: "&a&l圣诞礼包" Lore: - "&7━━━━━━━━━━━━━━━━━━" - "&f圣诞快乐！" - "&7打开获得神秘奖励" - "&7━━━━━━━━━━━━━━━━━━" - "" - "&e有效期: &f永久" ``` #### 示例 3: 创建特殊工具 ```yaml superPickaxe: ID: DIAMOND_PICKAXE Name: "&b&l矿工之魂" Lore: - "&7蕴含大地之力的镐子" - "&7挖掘速度提升 200%" IsNoBreak: true ench: DIG_SPEED: 10 LOOT_BONUS_BLOCKS: 5 DURABILITY: 5 ``` --- ### 📋 常用附魔类型 | 附魔名称 | 中文名称 | 适用物品 | |----------|----------|----------| | `DAMAGE_ALL` | 锋利 | 剑 | | `DAMAGE_UNDEAD` | 亡灵杀手 | 剑 | | `DAMAGE_ARTHROPODS` | 节肢杀手 | 剑 | | `FIRE_ASPECT` | 火焰附加 | 剑 | | `KNOCKBACK` | 击退 | 剑 | | `PROTECTION_ENVIRONMENTAL` | 保护 | 盔甲 | | `PROTECTION_FIRE` | 火焰保护 | 盔甲 | | `PROTECTION_PROJECTILE` | 弹射物保护 | 盔甲 | | `DURABILITY` | 耐久 | 所有物品 | | `DIG_SPEED` | 效率 | 工具 | | `LOOT_BONUS_BLOCKS` | 时运 | 工具 | | `ARROW_DAMAGE` | 力量 | 弓 | | `ARROW_FIRE` | 火矢 | 弓 | | `ARROW_KNOCKBACK` | 冲击 | 弓 | --- ## 📁 配置文件 ### config.yml ```yaml # 插件消息前缀 # 支持颜色代码，使用 & 符号 pluginTitle: "§b物品系统 §7§l>>> §f" ``` --- ## ❓ 常见问题 ### Q: 修改配置后如何生效？ A: 执行 `/dil reload` 命令即可热重载，无需重启服务器。 ### Q: 物品配置不生效怎么办？ A: 1. 检查 YAML 格式是否正确（注意缩进，使用空格而非 Tab） 2. 检查物品 ID 是否有效 3. 查看控制台是否有错误提示 4. 执行 `/dil reload` 重载配置 ### Q: 如何获取物品的材质 ID？ A: 可以使用游戏内 F3+H 开启高级提示，或参考 Minecraft Wiki 的物品列表。 ### Q: 支持哪些颜色代码？ A: 支持所有 Minecraft 颜色代码： - `&0-9` 基础颜色 - `&a-f` 扩展颜色 - `&k` 随机字符 - `&l` 粗体 - `&m` 删除线 - `&n` 下划线 - `&o` 斜体 - `&r` 重置 --- ## 📞 联系方式 - **作者**: SPINK - **QQ**: 1011115423 - **交流群**: 1104439995 --- ## 📜 更新日志 ### v1.0.0 - 首次发布 - 支持通过配置文件定义物品 - 支持子文件夹分类管理 - 支持可视化菜单 - 支持命令给予物品 - 支持配置热重载 --- **感谢使用 DreamItemLibrary！如果觉得好用，请给个好评 ⭐** [/MD]