原创 工具 娱乐 KazeMysteryGift - 自定义神秘礼物奖励插件 1.0

# KazeMysteryGift - 神秘礼物方块奖励插件
**作者:** Kazemar_sama
**QQ:** 1518554438 (需要定制插件/定制软件/Web等请联系QQ)
**支持版本:** Minecraft 1.18 - 1.21.11
**版权所有:Kazemar_sama**
视频示例：---
## 功能概述
KazeMysteryGift 是一个功能完善的神秘礼物奖励插件，允许管理员在任意世界的方块或实体上设置右键奖励。
### 核心功能
- **方块/实体奖励** - 在任何方块或实体 (NPC/盔甲架等) 上设置右键领取奖励
- **次数与时间限制** - 可设置每人最大领取次数、冷却时间、活动起止时间
- **分组奖励系统** - 奖励按组管理，每组可包含多个物品/命令奖励
- **额外奖励** - 集齐某组全部奖励后自动发放额外奖励
- **礼物动画** - 领取奖励后展示礼物头颅旋转上升 + 彩色烟花爆炸特效
- **自定义头颅纹理** - 支持自定义礼物头颅纹理，内置11种预设
- **GUI管理** - 所有内容均可通过直观的GUI界面编辑
- **配置热重载** - 修改配置文件后使用 `/mg reload` 即时生效
- **数据安全** - 已有配置文件不会被覆盖
---
| 命令 | 说明 | 权限 |
|------|------|------|
| `/mg gui` | 打开管理GUI界面 | `mysterygift.admin` |
| `/mg create [ID]` | 创建新礼物目标 (方块/实体) | `mysterygift.admin` |
| `/mg delete <ID>` | 删除礼物目标 | `mysterygift.admin` |
| `/mg list` | 列出所有礼物目标 | `mysterygift.admin` |
| `/mg edit <ID>` | 编辑礼物目标 | `mysterygift.admin` |
| `/mg reload` | 重载配置文件 | `mysterygift.reload` |
| `/mg help` | 显示帮助信息 | `mysterygift.admin` |
> 命令别名: `/mysterygift`, `/mg`, `/mgift`
---
## 权限
| 权限节点 | 说明 | 默认 |
|----------|------|------|
| `mysterygift.admin` | 管理员权限 | OP |
| `mysterygift.use` | 右键领取奖励 | 所有人 |
| `mysterygift.reload` | 重载配置 | OP |
---
## 配置文件说明
### config.yml - 主配置
- **prefix** - 消息前缀 (支持颜色代码，修改后 `/mg reload` 即时生效)
- **animation** - 动画设置 (开关/上升高度/持续时间/旋转速度/烟花颜色)
- **gift-head-texture** - 礼物头颅纹理 (Base64格式，内置11种预设可选)
- **storage** - 数据存储设置 (自动保存间隔)
- **defaults** - 新建礼物目标的默认值
- **messages** - 所有消息文本，支持颜色代码和 `{prefix}` 占位符
### 自定义头颅纹理
`config.yml` 中提供了 11 种预设纹理，包括:
| 编号 | 名称 | 说明 |
|------|------|------|
| 1 | 红色礼物盒 | 默认纹理，红色蝴蝶结 |
| 2 | 绿色礼物盒 | 绿色包装 |
| 3 | 蓝色礼物盒 | 蓝色丝带 |
| 4 | 紫色礼物盒 | 紫色华丽 |
| 5 | 金色宝箱 | 金色宝藏箱子 |
| 6 | 钻石宝箱 | 钻石装饰 |
| 7 | 彩虹礼物盒 | 彩色条纹 |
| 8 | 圣诞礼物盒 | 圣诞节主题 |
| 9 | 神秘箱子 | 问号神秘箱 |
| 10 | 星星礼物盒 | 星星装饰 |
| 11 | 爱心礼物盒 | 爱心主题 |
将预设列表中的 Base64 字符串复制到 `gift-head-texture` 字段即可使用。
也可从 [minecraft-heads.com](https://minecraft-heads.com/) 获取更多纹理。
### giftblocks.yml - 礼物数据
自动生成，存储所有礼物目标的位置/实体信息、次数、冷却等。
### rewardgroups.yml - 奖励组数据
自动生成，存储所有奖励组及其包含的奖励信息。
### playerdata/ - 玩家数据
按UUID存储每个玩家的领取记录。
---
## GUI使用指南
### 主菜单 (`/mg gui`)
- **礼物方块管理** - 查看/创建/删除礼物目标
- **奖励组管理** - 查看/创建/删除奖励组
- **重载配置** - 一键重载所有配置
### 创建礼物目标
1. 使用 `/mg create [ID]` 或在GUI中点击创建
2. 右键点击**方块**或**实体** (NPC/盔甲架等) 设置目标
3. 方块目标：玩家右键该方块触发奖励
4. 实体目标：玩家右键该实体触发奖励
### 礼物方块编辑
- **目标位置** - 点击重新选择方块/实体目标
- **最大次数** - 左键+1/右键-1，Shift+左键+10/Shift+右键-10
- **冷却时间** - 左键+10秒/右键-10秒，Shift+左键+60秒/Shift+右键-60秒
- **奖励组** - 绑定/解绑奖励组
- **时间设置** - 左键设置时间，右键清除
### 奖励组编辑
- **显示名称** - 点击后在聊天栏输入新名称
- **奖励列表** - 查看所有奖励，右键删除
- **额外奖励** - 手持物品左键设置，右键清除
- **添加奖励** - 手持物品左键添加物品奖励，右键添加命令奖励
---
## 奖励类型
### 物品奖励
手持物品在GUI中点击即可添加，支持所有Minecraft物品（含自定义NBT）。
### 命令奖励
在聊天栏输入命令（不含/），支持 `{player}` 占位符替换为玩家名。
示例: `give {player} diamond 64`
---
## 动画特效
玩家领取奖励后会触发动画:
1. 在玩家面前生成一个礼物头颅 (可自定义纹理)
2. 头颅旋转上升半格
3. 伴随末地烛光粒子
4. 到达顶部后彩色烟花粒子爆炸
5. 播放烟花音效
所有动画参数均可在 `config.yml` 中调整。
---
## 更新日志
### v1.0 (2026-02-06)
- 初始发布
- 支持方块和实体右键奖励
- 分组奖励系统 + 额外奖励
- 礼物头颅旋转动画 + 烟花特效
- 自定义头颅纹理 (11种预设)
- GUI管理界面
- 配置热重载
- 玩家数据持久化