征服拍卖行

征服拍卖行

Conquest Auction House 是一款全面的 Hytale 服务端模组，它引入了一个完全由玩家驱动的经济系统。玩家可以通过直观的自定义用户界面买卖物品，为您的服务器创建一个充满活力的市场。

生活质量

征服拍卖行预览查看大图
核心功能

1. 拍卖行系统
- **持久化上架** - 所有拍卖上架信息保存至 JSON，服务器重启不会丢失
- **物品预览** - 带有数量指示器的可视化物品图标
- **卖家信息** - 每条上架信息显示卖家用户名及信誉徽章
- **定价系统** - 可配置最大价格上限的灵活定价
- **元数据支持** - 保留物品耐久度、附魔及自定义数据
- **智能筛选** - 按物品名称、卖家搜索或通过收藏夹筛选
- **双视图模式** - 在列表视图（每页6件物品）和网格视图（每页12件物品）间切换
- **价格情报** - 实时价格对比提示，显示与市场均价相比的百分比

2. 钱包与经济系统
- **玩家独立钱包** - 每位玩家拥有独立的持久化金币余额
- **自动交易** - 购买时即时转移金币
- **余额持久化** - 钱包数据以 JSON 格式保存
- **玩家间转账** - 直接向其他玩家发送金币
- **管理员控制** - 从任意玩家钱包增加/移除金币
- **溢出保护** - 存款时防止整数溢出

3. 市场情报面板
- **实时市场统计** - 实时显示：
  - 活跃上架数量
  - 已处理销售总数
  - 总交易量（金币）
- **价格历史追踪** - 自动计算每种物品类型的平均价格
- **市场趋势** - 针对高于/低于市场均价的物品提供可视化指示

4. 通知系统
- **实时提醒** - 5种通知类型：
  - **销售** - 当您的物品售出时
  - **购买** - 当您购买物品时
  - **提醒** - 收藏物品的价格提醒
  - **过期** - 当您的上架过期时
  - **付款** - 当您收到金币时
- **通知中心** - 显示未读通知的徽章计数器
- **智能存储** - 自动清理（每位玩家最多50条通知）
- **持久化数据** - 保存在 `notifications.json`

5. 卖家信誉系统
- **自动徽章系统** - 基于总销售额的6个信誉等级：
  - 🔲 **[新手上路]** - 1-9笔销售（灰色）
  - 🟨 **[活跃]** - 10-49笔销售（黄色）
  - 🟩 **[经验丰富]** - 50-99笔销售（绿色）
  - 🔷 **[值得信赖]** - 100-499笔销售（青色）
  - 🟪 **[大师]** - 500-999笔销售（紫色）
  - 🟨 **[传奇]** - 1000+笔销售（金色）
- **卖家数据追踪** - 总销售笔数和总收入
- **持久化数据** - 保存在 `seller_stats.json`

6. 领取箱系统
- **安全物品存储** - 从购买或取消上架获得的物品被安全存放
- **持久化存储** - 服务器重启后数据保留
- **徽章计数器** - 直观显示待领取物品数量
- **快速访问** - 从主界面一键领取
- **背包保护** - 背包满时物品安全存储

7. 交易历史
- **完整记录** - 追踪所有购买和销售
- **详细记录** - 物品、价格、买家、卖家、时间戳
- **玩家专属视图** - 仅查看自己的交易
- **持久化存储** - 保存在 `transactions.json`

8. 收藏系统
- **书签物品** - 标记物品以便快速筛选
- **快速过滤** - 一键仅查看收藏物品
- **价格提醒** - 收藏物品上架时获通知
- **持久化数据** - 保存在 `favorites.json`

自定义用户界面

五个专用 UI 页面

**1. 拍卖浏览**
- 市场统计栏（活跃/销售/成交量）
- 快捷操作栏（刷新、收藏、领取、通知、视图切换）
- 分页物品展示（基于视图模式每页6或12件）
- 实时余额显示
- 物品和卖家的搜索功能
- 排序选项（最新、价格从低到高、价格从高到低）
- 根据所有权上下文显示购买/取消按钮
- 价格比较提示
- 卖家信誉徽章


命令
玩家命令
| 命令 | 描述 | 权限 |
|---------|-------------|------------|
| `/hdv` | 打开拍卖行浏览器 | 默认 |
| `/hdv collect` | 从领取箱领取所有物品 | 默认 |
| `/auction` | `/hdv` 的别名 | 默认 |
| `/auctionhouse` | `/hdv` 的别名 | 默认 |
| `/balance` | 查看您的金币余额 | 默认 |
| `/pay <玩家名> <金额>` | 向其他玩家发送金币 | 默认 |

### 管理员命令
| 命令 | 描述 | 权限 |
|---------|-------------|------------|
| `/coins add <玩家名> <金额>` | 向玩家的钱包增加金币 | OP |
| `/coins remove <玩家名> <金额>` | 从玩家的钱包移除金币 | OP |
| `/coins set <玩家名> <金额>` | 设置玩家的金币余额 | OP |

## 数据持久化

所有数据以 JSON 格式存储在：
`C:\Users\[用户名]\AppData\Roaming\Hytale\UserData\Mods\`

**数据文件：**
- `auctions.json` - 活跃的拍卖上架信息
- `wallets.json` - 玩家金币余额
- `transactions.json` - 交易历史
- `collection_box.json` - 未领取物品
- `favorites.json` - 玩家收藏物品
- `seller_stats.json` - 卖家信誉数据
- `price_history.json` - 市场价格平均值
- `notifications.json` - 玩家通知
- `config.json` - 插件配置

## 配置

`config.json` 中的默认设置：
```json
{
  "maxListingPrice": 1000000,
  "maxActiveListings": 10,
  "listingDuration": 604800,
  "listingFee": 10
}
```

**配置选项：**
- `maxListingPrice` - 每次上架的最高价格（默认：1,000,000 金币）
- `maxActiveListings` - 每位玩家的最大上架数量（默认：10）
- `listingDuration` - 上架持续时间（秒）（默认：604,800 秒 = 7 天）
- `listingFee` - 创建上架的费用（默认：10 金币）