# GlobalShop - Global Auction House Plugin

## Introduction
GlobalShop is a plugin that provides World of Warcraft style auction house functionality for Minecraft servers, supporting Spigot 1.21.4 version.

## Core Features

### Auction System
- **Item Listing Features**
- Players can list items via GUI or commands
- Support for setting starting price and buyout price
- Customizable auction duration (Left-click +1 minute, Right-click +1 hour, Shift+Left-click +10 minutes, Shift+Right-click +10 hours)
- Listing quantity limit functionality, configurable maximum listings per player
- Price digit limit feature, preventing excessively high-priced items

- **Purchase and Bidding System**
- Direct buyout purchase
- Bidding system
- Optimized bid increment system, supporting pre-increment buttons
- Automatic settlement when auctions end
- Comprehensive transaction record system, tracking buyers, sellers, transaction times and more

- **Item Collection System**
- Automatic handling of items for offline players or those with full inventories
- Secure item mailbox functionality
- Command to collect pending items

### Economy System
- **Dual Currency Support**
- Complete Vault economy integration
- PlayerPoints point integration (soft dependency, not mandatory)
- Option to choose currency type when listing
- Consistent currency type throughout the transaction process

- **Fee System**
- Configurable buyer/seller fees
- Independent fee settings for both currency types

### GUI System
- **Main Interface**
- Intuitive auction item display
- Complete pagination system, displaying 45 items per page
- Simplified operations: Left-click to bid, Right-click for instant buyout

- **My Auctions Interface**
- View currently listed items
- View sold auctions, displaying buyers and actual selling prices
- View expired auctions
- Display player's current listing count and maximum limit

- **Search System**
- Fuzzy item name search
- Support for item names with color codes
- Search history functionality
- Support for Chinese vanilla item name search (e.g., searching "redstone" finds all redstone-related items)

### Broadcast System
- **Multi-location Broadcasting**
- Chat box broadcasts
- Boss bar broadcasts
- Title broadcasts
- Subtitle broadcasts
- Action bar broadcasts

- **Multiple Event Broadcasting**
- Item listing broadcasts
- Successful bid broadcasts
- Buyout purchase broadcasts

- **Broadcast Optimizations**
- Interactive detailed item information in chat box
- Complete item information display on mouse hover (including all gradient color effects)
- Fully customizable broadcast messages

### Multi-language Support
- Complete support for 10 languages:
- Chinese, English, German, Russian, Spanish, French, Italian, Japanese, Portuguese
- Partial support for Arabic and Hindi
- All GUI texts and message prompts support multiple languages

### Administration Features
- **Admin Tools**
- Force delist functionality (admins can force delist any item, including their own)
- Configuration hot reload functionality
- Manual command to check expired items

## Command System
```
/auction help - Display help information
/auction open - Open the auction house interface
/auction sell <starting price> [buyout price] [currency type] - List item (1=money, 2=points)
/auction buy <item ID> - Purchase an item
/auction search <keyword> - Search for items
/auction my - View my auctions
/auction collect - Collect pending items
/auction reload - Reload configuration files (requires admin permission)
/auction close - Force close all auctions (admin only)
/auction checkexpired - Manually check expired items (admin only)
```

## Permission Nodes
```
globalshop.use - Basic usage permission
globalshop.sell - Listing permission
globalshop.buy - Purchase permission
globalshop.admin - Administrator permission
```

## Technical Features
- SQLite database storage, efficient and reliable
- Complete item serialization system, supporting all Minecraft item types
- Full compatibility with custom items (preserves all NBT data)
- Highly customizable configuration system

# GlobalShop - 全局拍卖行插件

## 简介
GlobalShop是一个为Minecraft服务器提供魔兽世界风格拍卖行功能的插件，支持Spigot 1.21.4版本。

## 核心功能

### 拍卖系统
- **物品上架功能**
- 玩家可通过GUI或命令上架物品
- 支持设置起拍价和一口价
- 自定义拍卖持续时间（左键+1分钟，右键+1小时，Shift+左键+10分钟，Shift+右键+10小时）
- 上架数量限制功能，基于配置可设置每位玩家最大上架数
- 价格位数限制功能，防止超高价格物品

- **购买与竞价系统**
- 一口价直接购买
- 竞价购买系统
- 竞价加价优化，支持预加价按钮
- 拍卖结束自动结算
- 完善的交易记录系统，记录买家、卖家、交易时间等信息

- **物品领取系统**
- 自动处理离线和背包已满玩家的物品
- 物品安全邮箱功能
- 命令领取待领取物品

### 经济系统
- **双货币支持**
- 完整Vault经济集成
- PlayerPoints点券集成（软依赖，不强制安装）
- 上架时可选择货币类型
- 交易过程保持货币类型一致

- **手续费系统**
- 可配置的买家/卖家手续费
- 两种货币各自独立的手续费设置

### GUI系统
- **主界面**
- 直观的拍卖物品展示
- 完整的分页系统，每页显示45个物品
- 简化的操作：左键竞价，右键一口价购买

- **我的拍卖界面**
- 查看当前上架物品
- 查看已售出拍卖、显示买家和实际成交价
- 查看已过期拍卖
- 显示玩家当前上架数量和最大上限

- **搜索系统**
- 物品名称模糊搜索
- 支持带颜色代码的物品名称搜索
- 搜索历史记录功能
- 支持中文原版物品名称搜索（如搜索"红石"可找到所有红石相关物品）

### 广播系统
- **多位置广播**
- 聊天框广播
- Boss栏广播
- 标题广播
- 副标题广播
- 动作栏广播

- **多事件广播**
- 物品上架广播
- 竞拍成功广播
- 一口价购买广播

- **广播优化**
- 聊天框中显示可交互的物品详细信息
- 鼠标悬停时显示完整物品信息（包括所有渐变色效果）
- 广播消息完全可自定义

### 多语言支持
- 完整支持10种语言:
- 中文、英语、德语、俄语、西班牙语、法语、意大利语、日语、葡萄牙语
- 部分支持阿拉伯语和印地语
- 所有GUI文本和消息提示均支持多语言

### 管理功能
- **管理员工具**
- 强制下架功能（管理员可强制下架任何物品，包括自己的）
- 配置热重载功能
- 手动检查过期物品命令

## 命令系统
```
/auction help - 显示帮助信息
/auction open - 打开拍卖行界面
/auction sell <起拍价> [一口价] [货币类型] - 上架物品 (1=金币, 2=点券)
/auction buy <物品ID> - 购买物品
/auction search <关键词> - 搜索物品
/auction my - 查看我的拍卖
/auction collect - 领取待领取物品
/auction reload - 重新加载配置文件（需要管理员权限）
/auction close - 强制关闭所有拍卖（仅管理员）
/auction checkexpired - 手动检查过期物品（仅管理员）
```

## 权限节点
```
globalshop.use - 基础使用权限
globalshop.sell - 上架权限
globalshop.buy - 购买权限
globalshop.admin - 管理员权限
```

## 技术特点
- SQLite数据库存储，高效可靠
- 完整物品序列化系统，支持所有Minecraft物品类型
- 完全兼容自定义物品（保留所有NBT数据）
- 高度自定义的配置系统