MythicMarriage 结婚系统

📝 插件介绍
MythicMarriage是一款全GUI操作的Minecraft结婚插件，为服务器玩家提供了一套完整的结婚系统。玩家可以通过该插件向其他玩家求婚、举办婚礼、设置婚礼地点、发放红包，以及在必要时申请离婚。插件界面友好，操作简单，为服务器增添了丰富的社交互动元素。

✨ 主要功能
- 💕 求婚系统：玩家可以向其他在线玩家发起求婚请求
- 💍 结婚戒指：求婚需要特定的结婚戒指物品
- 🎮 全GUI操作：所有功能通过直观的GUI界面完成
- 💰 婚礼红包：结婚时可设置红包金额，所有玩家均可领取
- 🎆 婚礼特效：结婚成功时全服显示标题和烟花效果
- 📍 婚礼地点：可设置婚礼地点，领取红包的玩家会被传送到该位置
- 📊 婚姻状态：提供PAPI变量显示玩家的婚姻状态
- 📝 离婚系统：支持申请离婚，有冷却期保护机制

🔑 命令列表
| 命令 | 描述 | 权限 |
|------|------|------|
| `/jh` | 打开结婚系统主界面 | mythicmarriage.use |
| `/jh bind` | 将手持物品绑定为结婚戒指 | mythicmarriage.admin |
| `/jh reload` | 重新加载插件配置 | mythicmarriage.admin |

> 主命令 `/jh` 可以使用别名 `/marriage` 或 `/marry`

🔑 权限节点
| 权限 | 描述 | 默认 |
|------|------|------|
| `mythicmarriage.use` | 允许使用结婚系统 | true |
| `mythicmarriage.admin` | 允许使用管理员命令 | op |

📋 PlaceholderAPI 变量
| 变量 | 描述 |
|------|------|
| `%mythicmarriage_partner%` | 显示玩家伴侣的名字 |
| `%mythicmarriage_status%` | 显示玩家的婚姻状态 |
| `%mythicmarriage_marriage_date%` | 显示结婚日期 |

🔧 使用方法

求婚流程
1. 玩家输入 `/jh` 打开结婚系统主界面
2. 点击"玩家列表"按钮查看所有在线且未婚的玩家
3. 点击目标玩家头像发起求婚(需持有结婚戒指)
4. 对方玩家收到求婚通知，可在GUI中右键接受求婚

婚礼设置
1. 双方玩家均可在结婚前进行婚礼设置
2. 点击"婚礼设置"按钮进入设置界面
3. 设置婚礼地点：点击"设置婚礼地点"按钮，将当前位置设为婚礼地点
4. 设置红包金额：点击"设置红包金额"按钮，输入整数金额作为婚礼红包

举行婚礼
1. 双方完成设置后，点击"开始婚礼"按钮
2. 系统会向全服发送结婚通知，并在所有玩家头顶播放烟花
3. 系统会在聊天框中发送红包领取链接，其他玩家点击可领取红包
4. 领取红包的玩家会被传送到设定的婚礼地点

离婚流程
1. 已婚玩家可在主界面点击"离婚"按钮申请离婚
2. 系统会记录离婚申请时间，7天后离婚生效
3. 离婚生效后，双方玩家的婚姻状态将被解除

📝 配置文件
插件包含三个主要配置文件：

config.yml - 基础设置
- 功能开关：可单独开启或关闭各项功能
- 结婚设置：求婚冷却时间、离婚冷却时间、结婚戒指设置
- GUI设置：各界面标题、大小、按钮位置、材质和文本
- 音效设置：各操作的音效配置

messages.yml - 消息设置
- 前缀设置：插件消息前缀
- 命令相关消息：权限提示、重载提示等
- 结婚相关消息：求婚、接受、拒绝等提示
- 结婚成功消息：标题、副标题和广播内容
- 离婚相关消息：申请、取消、成功等提示
- 红包相关消息：设置、领取提示等
- 地点相关消息：设置、传送提示等

data.yml - 数据存储
- 存储所有玩家的婚姻数据
- 包括伴侣信息、结婚日期、离婚申请等

🔄 依赖插件
- 必需: PlaceholderAPI (提供变量支持)
- 必需: Vault (经济系统支持)

💻 技术信息
- 支持版本: 1.20.1+
- API版本: 1.20
- 使用Java 17开发

🛠️ 管理员功能
1. 绑定结婚戒指：管理员可以手持任意物品，使用 `/jh bind` 命令将其设置为结婚戒指
2. 重载配置：使用 `/jh reload` 命令可以重新加载所有配置文件
3. 通过config.yml可以自定义GUI界面的所有元素，包括标题、材质、名称和描述

---
感谢您选择 MythicMarriage 结婚系统插件！如有任何问题或建议，请随时联系我们。