NPC好感度系统2.0

📝 插件介绍
NPCHaoGanDu2是一款为Minecraft服务器设计的NPC好感度系统插件，为服务器中的NPC添加了好感度属性和奖励机制。玩家可以通过与NPC互动来提升好感度，当好感度达到特定阈值时，可以获得相应的奖励和成就。该插件支持完整的PlaceholderAPI变量，可以轻松集成到服务器的其他系统中，为玩家提供更丰富的游戏体验。

✨ 主要功能
- 📊 好感度系统：每个NPC拥有独立的好感度值(0-100%)
- 🎁 奖励等级：设置20%、50%、80%、100%四个等级的奖励
- 🔄 每日刷新：所有奖励在系统时间8:00自动刷新
- 🏆 成就系统：达到特定好感度可解锁成就(只能领取一次)
- 💾 数据存储：支持MySQL和本地文件双重存储
- 📋 占位符支持：完整的PlaceholderAPI变量支持
- 🎆 特效系统：完成成就时触发烟花特效
- 🧪 经验奖励：好感度超过100%时转换为经验瓶

🔑 命令列表
| 命令 | 描述 | 权限 |
|------|------|------|
| `/npchgd create <npc> <lore>` | 创建新的NPC好感度数据 | npchgd.admin |
| `/npchgd <npc>` | 查看指定NPC的好感度信息 | npchgd.use |
| `/npchgd rewards <npc>` | 领取好感度奖励 | npchgd.use |
| `/npchgd achievements <npc>` | 领取成就奖励 | npchgd.use |
| `/npchgd add <player> <npc> <favor>` | 增加玩家的好感度 | npchgd.admin |
| `/npchgd reduce <player> <npc> <favor>` | 减少玩家的好感度 | npchgd.admin |
| `/npchgd reload` | 重载插件配置文件 | npchgd.admin |

🔑 权限节点
| 权限 | 描述 | 默认 |
|------|------|------|
| `npchgd.use` | 允许使用基本命令 | true |
| `npchgd.admin` | 允许使用管理员命令 | op |

📋 PlaceholderAPI 占位符
插件提供了丰富的PlaceholderAPI变量，以下是常用的一些占位符：

基础占位符:
- `%npchgd_maxfavor%` - 显示系统设置的最大好感度值
- `%npchgd_totalfavor%` - 显示玩家所有NPC的总好感度
- `%npchgd_npccount%` - 显示玩家有好感度的NPC数量
- `%npchgd_top_npc%` - 显示玩家好感度最高的NPC名称

NPC相关占位符:
- `%npchgd_favor_<NPC名称>%` - 显示玩家对指定NPC的好感度
- `%npchgd_level_<NPC名称>%` - 显示玩家对指定NPC的好感度等级
- `%npchgd_nextlevel_<NPC名称>%` - 显示下一个奖励等级
- `%npchgd_achievements_<NPC名称>%` - 显示已获得的成就数量

🔧 使用方法

创建NPC好感度数据
1. 管理员使用命令 `/npchgd create <NPC名称> <描述>` 创建新的NPC好感度数据
2. 系统会自动生成默认的奖励等级配置(20%、50%、80%、100%)
3. 可以在配置文件中进一步自定义NPC的奖励和成就

查看好感度信息
1. 玩家使用命令 `/npchgd <NPC名称>` 查看与特定NPC的好感度信息
2. 信息包括当前好感度、等级、可领取的奖励和成就

领取奖励
1. 当玩家好感度达到特定阈值(20%、50%、80%、100%)时，可以领取相应奖励
2. 使用命令 `/npchgd rewards <NPC名称>` 领取奖励
3. 奖励每天系统时间8:00会自动刷新，可以重新领取

完成成就
1. 当玩家好感度达到成就要求时，可以领取一次性成就奖励
2. 使用命令 `/npchgd achievements <NPC名称>` 领取成就奖励
3. 成就奖励只能领取一次，领取后会有特效和通知

管理好感度
1. 管理员可以使用 `/npchgd add <玩家> <NPC> <数值>` 增加玩家好感度
2. 管理员可以使用 `/npchgd reduce <玩家> <NPC> <数值>` 减少玩家好感度

📝 配置文件
插件包含多个配置文件：

config.yml - 基础设置
- 经验瓶数量配置：每点好感度增加的经验瓶数量
- 数据保存间隔：自动保存数据的时间间隔
- 好感度范围：最大和最小好感度值
- 特效设置：是否启用成就完成烟花效果

NPC文件夹 - NPC配置文件
- 每个NPC有独立的配置文件(如铁匠.yml)
- 包含NPC介绍、初始好感度、奖励设置
- 成就配置：不同好感度等级的成就和奖励

messages.yml - 消息配置
- 所有插件消息和提示的自定义配置
- 支持颜色代码和变量替换

🔄 依赖插件
- 必需: Paper 1.20.1+
- 可选: PlaceholderAPI (用于占位符支持)
- 可选: MySQL数据库 (用于数据存储)

💻 技术信息
- 支持版本: 1.20.1+
- API版本: 1.20
- 数据存储: 本地文件 + MySQL(可选)
- 使用Java 17开发

🛠️ 好感度等级划分
- 0-19%：陌生人
- 20-49%：学徒
- 50-79%：助手
- 80-99%：好友
- 100%+：挚友

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