## 简介

NpcShop是一个功能强大的Minecraft商店插件，提供与Citizens2插件联动的NPC商店功能。玩家可以与NPC互动打开商店GUI，购买管理员设置的商品。支持多种货币类型，界面美观，操作简单直观。

**版本要求**: Spigot/Paper 1.21.4+

## 主要特点

✅ **完整的物品数据保留** - 上架物品的所有属性、附魔、Lore等完全保留
✅ **多种货币支持** - 支持Vault和PlayerPoints两种经济系统
✅ **美观的GUI界面** - 使用现代化设计的GUI，支持自定义样式
✅ **完整的权限系统** - 细粒度权限控制，可设置管理员和普通用户权限
✅ **多页面显示** - 自动分页显示商品，无商品数量限制
✅ **商店类型系统** - 支持普通商店和礼包商店两种类型
✅ **物品名称自动翻译** - 自动翻译物品名称为中文，提升用户体验
✅ **实时数据保存** - 使用SQLite数据库，确保数据安全性和一致性



## 安装说明

1. 下载插件: [点击下载](插入下载链接)
2. 将NpcShop.jar放入服务器的plugins文件夹
3. 安装必要依赖:

- [ SagaLib]
- [ Citizens2]
- [ Vault]
- [ PlayerPoints]
4. 重启服务器
5. 配置插件，根据需要修改config.yml

## 使用方法

### 创建商店

1. 创建一个Citizens NPC
2. 选择该NPC: `/ns select <NPC ID>`
3. 创建商店: `/ns create <商店名称> [shop/gift]`
- shop: 普通商店，可添加单个物品销售
- gift: 礼包商店，可将多个物品打包销售

### 添加商品

**普通商店**:
1. 选择商店NPC: `/ns select <NPC ID>`
2. 手持要添加的物品
3. 添加商品: `/ns add <价格> <货币类型>`
- 货币类型: 1(Vault金币) 或 2(PlayerPoints点券)

**礼包商店**:
1. 选择商店NPC: `/ns select <NPC ID>`
2. 创建礼包: `/ns gift create <材质> <显示名称> <价格> <货币类型>`
3. 手持要添加的物品
4. 添加到礼包: `/ns gift add`

### 使用商店

玩家只需右键点击NPC即可打开商店界面:
- 在普通商店中点击商品直接购买
- 在礼包商店中可先查看礼包内容，确认后购买整个礼包

## 命令列表
## 权限节点

## 配置文件

### config.yml 主要配置项

### 商店样式

插件提供了多种预设商店样式，可以通过`/ns style <样式名称>`设置:

- default: 默认样式
- dark: 暗色主题
- light: 亮色主题
- colorful: 彩色主题

## 特色功能

1. **礼包商店系统**:
- 将多个物品打包为一个礼包
- 玩家可以查看礼包内容后决定是否购买
- 管理员可以轻松管理礼包内容

2. **商品管理功能**:
- 显示商品ID，方便管理员编辑和移除
- 右键删除礼包或礼包内物品
- 支持单价和总价显示

3. **操作优化**:
- 冷却系统防止误操作和刷单
- 物品名称自动翻译
- 命令自动补全功能
- 智能错误处理和提示

## 常见问题

**Q: 如何让不同NPC显示不同的商店?**
A: 每个NPC可以绑定不同的商店，使用`/ns select <NPC ID>`选择不同的NPC，然后创建商店即可。

**Q: 如何删除商店?**
A: 目前需要删除NPC来删除商店，或直接编辑数据库文件。

**Q: 支持哪些版本的Minecraft?**
A: 目前插件支持Spigot/Paper 1.21.4及以上版本。

## 支持与反馈

如有问题或建议，请通过以下方式联系:

- 在Spigot论坛帖子下留言
- 提交GitHub Issue

---
**源代码**: [ GitHub]