原创 付费 娱乐 NPC好感度系统2.0 0.1

插件介绍

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 插件！如有任何问题或建议，请随时联系我们。