# ChestShop - Paper 1.21.5 的专业商店系统
**🚀 最先进、功能最完整的 ChestShop 插件，适用于现代 Minecraft 服务器！**
通过这款专业级的商店系统，为您的服务器经济注入活力，它将易用性与企业级功能相结合。这款插件专为 Paper 1.21.5 从零开始构建，提供卓越的性能、全面的保护和无与伦比的灵活性。
---
## 🌟 **主要亮点**
✨ **零学习曲线** - 简单箱子 + 牌子 = 即时商店
🛡️ **军用级保护** - 抵御所有形式的破坏
📊 **高级分析** - 跟踪每笔交易、利润和趋势
🎯 **管理员利器** - 包含专业的管理工具
🌍 **多世界支持** - 在所有维度中无缝运行
⚡ **闪电般的速度** - 针对高性能服务器进行优化
---
## 🏪 **核心商店功能**
### **轻松创建商店**
```
/chestshop create DIAMOND 1 100 90
```
- **一键设置** - 只需放置箱子 + 牌子，运行命令
- **灵活交易** - 仅限购买、仅限出售或两者兼有
- **智能检测** - 自动链接附近的箱子和牌子
- **动态定价** - 随时更新价格，无需重新创建
### **高级商店类型**
- 💰 **交易站** - 完整的买/卖功能
- 🏪 **零售商店** - 向玩家出售物品
- 📦 **收集中心** - 向玩家购买资源
- 🔄 **物品兑换商店** - 革新性的直接物品交换（无需金钱！）
### **🆕 革新的物品交易系统**
**生存服务器的变革者！**
```
/chestshop item create DIAMOND 1 OAK_LOG 16
```
- 🚀 **无需经济** - 纯粹的物品交换
- 💎 **自定义兑换率** - 1 钻石 = 16 橡木原木，由您决定！
- 🎯 **非常适合生存** - 复杂的货币之外的天然交易
- 🔄 **独特的商店牌子** - 用于物品交易的特殊格式
- 📦 **相同的保护** - 所有安全功能适用于物品商店
---
## 🔒 **坚不可摧的保护系统**
**您的商店将完全安全，免受以下影响：**
- ❌ 破坏和未经授权的破坏
- ❌ 漏斗/发射器物品盗窃
- ❌ 爆炸伤害（TNT、苦力怕）
- ❌ 活塞位移攻击
- ❌ 附近危险方块放置
**高级安全功能：**
- 🔐 可配置的仅限所有者访问箱子
- 🛡️ 基于半径的防护区域
- ⚡ 实时威胁检测
- 🎯 细粒度的权限系统
---
## 📊 **专业的分析仪表盘**
### **玩家统计**
跟踪重要数据：
- 💰 总收入和支出
- 📈 交易历史和趋势
- 🏪 商店绩效指标
- 📦 库存水平和警报
- 💎 最赚钱的物品
### **服务器经济**
- 📊 全局商店统计
- 🎯 热门物品分析
- 👥 表现最佳的玩家
- 💹 经济活动趋势
- 📈 服务器范围内的利润分析
---
## 🔍 **智能搜索系统**
**找到您需要的东西：**
```bash
/chestshop search item DIAMOND # 查找钻石商店
/chestshop search owner Steve # 查找 Steve 的商店
/chestshop search price 50 100 buy # 查找购买价格在 50-100 之间的商店
```
- 🎯 **智能过滤** - 仅显示活跃的、有库存的商店
- 📍 **距离排序** - 最近的商店优先
- 💰 **价格比较** - 立即找到最优惠的价格
- ⚡ **快速结果** - 优化的搜索算法
---
## 🎯 **管理员管理套件**
### **维护工具**
- 🔧 **维护模式** - 更新期间禁用所有商店
- 💾 **备份系统** - 时间戳 JSON 备份
- 🧹 **自动清理** - 移除损坏/无效的商店
- 🔄 **热重载** - 重启无需更新配置文件
### **玩家管理**
- 👥 **批量操作** - 删除玩家的所有商店
- 📊 **数据重置** - 清除玩家统计
- 🎯 **性能监控** - 跟踪商店健康状况
- 📈 **使用分析** - 服务器经济洞察
---
## 🎨 **视觉卓越**
### **全息显示** *(可选)*
- ✨ **悬浮物品** - 商店上方的 3D 物品预览
- 📋 **信息文本** - 所有者和价格显示
- 🎨 **状态指示器** - 活跃/非活跃/缺货状态
- ⚙️ **完全可定制** - 颜色、格式、定位
### **智能牌子**
- 🔄 **自动更新** - 实时库存和状态
- 🎨 **颜色编码** - 视觉状态指示器
- 📊 **丰富的信息** - 价格、库存、所有者详细信息
- 🎯 **专业的格式** - 简洁、可读的布局
---
## ⚙️ **广泛的配置**
**每个方面都可以自定义：**
```yaml
# 商店限制 & 成本
max-shops-per-player: 10
creation-cost: 100.0
# 价格控制
price-limits:
min-buy-price: 0.01
max-buy-price: 1000000.0
# 保护设置
protection:
radius: 1
explosion-protection: true
hopper-protection: true
# 经济功能
transaction-fee: 0.0
shop-tax: 0.0
```
**完整的本地化支持：**
- 🌍 轻松翻译成任何语言
- 📝 每条消息都可以自定义
- 🎨 颜色和格式控制
---
## 🚀 **性能与兼容性**
### **技术卓越**
- ⚡ **线程安全** - 并发操作支持
- 🔄 **异步友好** - 非阻塞操作
- 💾 **内存高效** - 优化的数据结构
- 📊 **自动保存** - 可配置的间隔防止数据丢失
### **现代集成**
- 💰 **Vault 经济** - 通用经济支持
- 🌍 **多世界** - 在所有维度中工作
- 📦 **Paper 1.21.5** - 最新 Minecraft 功能
- ☕ **Java 21+** - 现代性能优势
---
## 📋 **快速入门指南**
### **安装 (2 分钟)**
1. 安装 Paper 1.21.5+ 服务器
2. 安装 Vault + 经济插件（推荐 EssentialsX）
3. 将 ChestShop.jar 放入 plugins 文件夹
4. 重启服务器 - 完成！✅
### **创建您的第一个商店 (30 秒)**
1. 在您想要放置商店的位置放置一个箱子
2. 在箱子旁边放置一个牌子
3. 看向箱子并输入：`/chestshop create DIAMOND 1 100 90`
4. 您的商店准备就绪！🎉
---
## 📖 **完整的命令参考**
### **玩家命令**
- `/chestshop create -
[sell]` - 创建传统商店
- `/chestshop item create ` - 创建物品交易商店
- `/chestshop item convert ` - 转换为物品交易
- `/chestshop info` - 商店信息
- `/chestshop list` - 列出您的商店
- `/chestshop toggle` - 启用/禁用商店
- `/chestshop price ` - 更新价格
- `/chestshop refill [amount]` - 补充商店库存
- `/chestshop search ` - 查找商店
- `/chestshop stats` - 查看您的统计信息
### **管理员命令**
- `/chestshop admin backup` - 创建数据备份
- `/chestshop admin maintenance` - 切换维护模式
- `/chestshop admin cleanup` - 清理商店
- `/chestshop admin stats` - 服务器统计
- `/chestshop admin removeall ` - 删除玩家的商店
- `/chestshop reload` - 重新加载配置文件
**命令别名：** `/cs`, `/shop`, `/cshop`
---
## 🎯 **权限系统**
### **玩家权限** *(默认：true)*
```yaml
chestshop.use # 基本插件使用
chestshop.create # 创建商店
chestshop.remove # 移除自己的商店
chestshop.info # 查看商店信息
chestshop.search # 搜索商店
chestshop.stats # 查看统计信息
```
### **管理员权限**
```yaml
chestshop.admin.* # 所有管理员功能
chestshop.admin.backup # 创建备份
chestshop.admin.maintenance # 切换维护
chestshop.admin.cleanup # 清理商店
chestshop.list.others # 列出其他人的商店
chestshop.stats.others # 查看其他人的统计信息
```
---
## 💡 **使用示例**
### **钻石交易站**
```bash
/chestshop create DIAMOND 1 120 100
```
*玩家以 120 购买，以 100 出售 - 完美的利润率！*
### **资源收集中心**
```bash
/chestshop create COBBLESTONE 64 15 0
```
*向玩家购买碎石 - 非常适合生成商店！*
### **独家的稀有物品商店**
```bash
/chestshop create NETHERITE_INGOT 1 0 500
```
*仅限出售的商店，用于稀有物品 - 控制经济！*
### **🆕 物品交易商店（无需金钱！）**
```bash
/chestshop item create DIAMOND 1 OAK_LOG 16
```
*用 1 钻石兑换 16 橡木原木 - 非常适合生存服务器！*
---
## 🛡️ **为什么选择这款 ChestShop?**
### **vs. 其他商店插件**
✅ **更多功能** - 高级搜索，统计数据，全息图
✅ **更好的保护** - 军用级安全系统
✅ **卓越的性能** - 线程安全，异步友好
✅ **专业的管理员工具** - 维护模式，备份，分析
✅ **现代代码库** - Paper 1.21.5 优化，Java 21+
✅ **完整的本地化** - 包含德语，易于翻译
### **企业级功能**
- 📊 **商业智能** - 全面的分析仪表盘
- 🔧 **DevOps 就绪** - 备份/还原，维护模式
- 🎯 **可扩展架构** - 轻松处理数千家商店
- 🛡️ **安全第一** - 抵御所有攻击向量
- 📈 **性能监控** - 内置的健康检查和指标
---
## 🔧 **系统要求**
**服务器要求：**
- Paper 1.21.5 或更高版本
- Java 21+（以获得最佳性能）
- Vault 插件
- 经济插件（推荐 EssentialsX）
**性能影响：**
- 💾 **RAM 使用量：** < 50MB（典型服务器）
- ⚡ **CPU 影响：** 最小（< 1% 在现代硬件上）
- 💿 **存储：** 效率高的数据文件，自动压缩
- 🌐 **网络：** 零额外的网络开销
---
## 📞 **支持与更新**
### **您将获得**
- ✅ **免费更新** - 保持与最新 Minecraft 版本同步
- ✅ **错误修复** - 快速响应任何问题
- ✅ **功能请求** - 社区驱动的开发
- ✅ **文档** - 全面的指南和示例
- ✅ **德语支持** - 原生德语语言支持
---
## 🚀 **立即下载**
**最新版本：** 1.0.0
**兼容：** Paper 1.21.5+
**许可证：** 免费使用，需注明出处
**⚡ 今天就开始构建您梦想的经济！**
*由 Flori 为 Minecraft 社区开发❤️*
---
## 🎯 **标签**
**#ChestShop #经济 #商店 #交易 #Paper #Minecraft #专业**