# 🏪 Best Auction - 完整的拍卖行系统
## 目的
Best Auction 为 Minecraft Paper/Spigot 服务器提供一个全面的拍卖行系统，让玩家可以通过直观的市场界面安全地买卖物品。该插件专为国际化和日本社区设计，提供企业级功能，同时具有用户友好的设计。
## 核心功能
### 🎯 拍卖系统
- **物品上架**: 玩家可以设置起始价格和可选的买断价格来上架物品。
- **竞价系统**: 实时竞价，并提供自动竞拍超标通知。
- **即时买断**: 快速购买选项，实现即时交易。
- **拍卖管理**: 轻松取消上架和修改竞价。
### 📬 邮件系统
- **自动交付**: 赢得的物品和退款会自动发送到玩家的邮箱中。
- **安全存储**: 物品安全地存储在邮箱中，直到玩家取回。
- **交易历史**: 清晰追踪所有与拍卖相关的交付记录。
### 🔍 高级搜索和过滤
- **类别浏览**: 按物品类型（武器、盔甲、工具等）分类。
- **关键词搜索**: 快速找到特定物品。
- **实时更新**: 实时拍卖状态和倒计时器。
### 🌐 多语言支持
- **完整日语支持**: 完整的日语 UI 和消息。
- **英语支持**: 标准英语界面。
- **自动检测**: 基于客户端的语言检测。
- **管理员可配置**: 服务器范围内的语言设置。
### 💰 经济系统集成
- **Vault 兼容**: 与现有经济插件无缝集成。
- **灵活的货币**: 支持任何 Vault 兼容的经济系统。
- **智能格式**: K/M/B 格式表示大数字（1.5K, 2.3M 等）。
- **可配置费用**: 可自定义的发布费用和拍卖时长。
## 技术特性
### 🛡️ 企业级可靠性
- **数据库优先设计**: 使用 SQLite 后端以保证数据完整性。
- **错误处理**: 全面的回退系统。
- **异步处理**: 非阻塞操作以实现流畅的性能。
- **事务安全**: 原子操作可防止数据丢失。
### ⚙️ 高度可配置
- **拍卖时长**: 可自定义的拍卖周期（基于小时）。
- **费用结构**: 可调整的发布费用和百分比。
- **日期格式**: 可自定义的日期显示格式。
- **调试模式**: 开发工具以用于测试环境。
### 🎨 用户体验
- **直观的 GUI**: 熟悉 Minecraft 物品栏界面。
- **实时反馈**: 实时倒计时器和状态更新。
- **详细信息**: 清晰显示价格、竞价和剩余时间。
- **移动友好**: 与移动 Minecraft 客户端无缝兼容。
## 工作原理
1. **上架物品**: 拿着物品并使用 `/ah sell [buyout]` 上架物品。
2. **浏览**: 使用 `/ah` 打开拍卖行并浏览类别或搜索。
3. **竞价**: 点击物品以查看详情，并通过聊天命令进行竞价。
4. **赢得**: 物品将在赢得时自动交付到邮箱。
5. **管理**: 通过“我的竞价”界面查看和修改您的活跃竞价。
## 目标用户
- **生存服务器**: 非常适合基于经济的生存社区。
- **角色扮演服务器**: 添加现实的市场功能。
- **国际服务器**: 特别有利于拥有日本玩家的服务器。
- **大型社区**: 可很好地扩展以适应拥有数百名玩家的服务器。
## 要求
- **Minecraft**: 1.20.1 或更高版本
- **服务器**: Paper, Spigot 或 Bukkit
- **Java**: 版本 17 或更高版本
- **依赖项**: Vault (推荐) + 经济插件 (EssentialsX 等)
## 快速设置
1. 下载并把 JAR 放在 `plugins/` 文件夹中
2. 重启服务器
3. 根据需要配置 `plugins/best_auction/config.yml`
4. 玩家可以立即开始使用 `/ah` 命令
## 为什么选择 Best Auction？
- **生产就绪**: 使用现代 Kotlin 构建，具有可靠性和性能。
- **日语优先设计**: 真正的国际化，而不仅仅是翻译。
- **广泛的文档**: 包含完整的设置和用户指南。
- **积极开发**: 定期更新和社区支持。
- **开源**: 透明的开发，并与 GitHub 集成
非常适合希望拥有专业、可靠的拍卖系统，该系统可以与现有的服务器基础设施无缝集成并为英语和日语社区提供卓越用户体验的服务器管理员。
---
**🔗 链接**: [GitHub 仓库](https://github.com/0x48lab/best_auction) |
[GitHub Pages](https://0x48lab.github.io/best_auction/) |
[文档](https://github.com/0x48lab/best_auction/blob/main/PLUGIN_DOCUMENTATION.md) |
[问题](https://github.com/0x48lab/best_auction/issues)