📥 安装与目录

环境要求

安装步骤

1. 将 AdventureMarket-1.2.0.jar 放入 plugins/
2. 确保 Vault 和经济插件已安装
3. 启动服务器自动生成配置
4. /market reload 热重载

目录结构

plugins/AdventureMarket/
├── Config.yml              # 主配置
├── GlobalMarket.yml        # 全球市场设置
├── Groups.yml              # 权限组
├── Categories.yml          # 商品分类
├── Mailbox.yml             # 邮箱
├── Merchant.yml            # 商家档案
├── ItemBlacklist.yml       # 物品黑名单
├── Messages.yml            # 消息文本
├── SignStore.yml            # 木牌商店
├── Alias.yml               # 命令别名
├── GUISettings/            # 13 个 GUI 配置
│   ├── GlobalMarketGUI.yml
│   ├── AuctionGUI.yml
│   ├── MailboxGUI.yml
│   └── ...
├── Permissions/            # 权限配置
│   ├── CommandPermissions.yml
│   ├── MerchandisePermissions.yml
│   ├── ProfilePermissions.yml
│   └── OtherPermissions.yml
└── Database.db             # SQLite 数据

💰 交易命令

主命令 /market（别名 /am、/adventuremarket）

主命令总览

出售 /market sell

/market sell <价格> [retail]

• 手持物品以指定价格上架
• 货币后缀：100G = Vault，50P = 点券，200S = 银币
• 附加 retail 自动计算零售单价
• 检查流程：黑名单 → 价格限制 → 数量上限 → 税款

购买 /market buy

/market buy <商品ID> [数量]

• 零售模式下可指定数量
• 物品进入背包，满则掉落或发邮箱

批量上架 /market sellinventory

/market sellinventory <单价>    (别名: /market batch)

• 打开批量上架 GUI，拖入物品后确认
• 以「单价 × 数量」逐个上架

🔨 拍卖系统

拍卖加时机制

在 GlobalMarket.yml 中配置 Auction-Automatic-Overtime：

Auction-Automatic-Overtime:
    Enabled: false
    Policies:
        'default':
            Limit: 3              # 最多加时次数
            Overtime: 30s         # 每次加时
            Conditions:
                Time-Remaining: 10s
                Bidding-Price: 100

📬 邮箱系统

🛒 商品与商店

商品管理 /merchandise

可修改属性

商家档案 /profile

商店 /store

分类与经济

🔧 管理员命令

⚙️ Config.yml

经济设置

Economy-Settings:
    Default-Currency-System: Vault     # Vault / PlayerPoints / Default
    Multiple-Currencies-System: false
    Multiple-Currencies-System-List:
        Vault: true
        PlayerPoints: true
        Default: true
    Multiple-Currencies-Symbols:
        Vault: 'G'       # /market sell 100G
        PlayerPoints: 'P'
        Default: 'S'
    Operators: []        # 运营者UUID（出售不打款）

模块开关

Module-Switches:
    GlobalMarket: true
    Mailbox: true
    Recorder: true
    Profile: true
    Money: true
    Custom-GUI: true
    Sign-Store: false

MySQL 存储

MySQL-Storage:
    Enabled: false
    Hostname: localhost
    Port: 3306
    Database: adventuremarket
    Tables:
        GlobalMarket: am_globalmarket
        Merchant: am_merchant
        Mailbox: am_mailbox
        Recorder: am_recorder
        MessageChannel: am_message_channel
    Auto-Refresh:
        Enabled: false
        GlobalMarket: 10.0   # 秒
        Merchant: 10.0

命令冷却

Commands-Cooldown:
    Enabled: true
    List:
    - 'market sell:3.0'
    - 'market buy:1.0'
    - 'auction start:3.0'
    - 'auction bid:1.0'
    - 'mailbox send:3.0'
    - 'money pay:3.0'

其他设置

📊 市场与分组配置

GlobalMarket.yml

交易细分

Transaction:
    Selling:
        Send-To-Mailbox: false
        Default-To-Retail-Mode: false
    Purchasing:
        Comparison-Products: true
    Auctions:
        Allow-Remove-After-Bidding: true

价格限制

Limitation-Of-Price:
    Enabled: false
    Selling:
        DIAMOND: 50-500     # 单价限制
    Purchasing:
        DIAMOND: 50-500

Groups.yml — 权限组

Categories.yml — 商品分类

匹配字段：Materials / Display-Name-Keywords / Lore-Keywords / Enchantments / Custom-Model-Data / Internal-Modules

📋 其他配置

Mailbox.yml

Merchant.yml

ItemBlacklist.yml

Enabled: false
Whitelist: false
Materials:
- COMMAND_BLOCK
- BEDROCK
Display-Name-Keywords:
- '已绑定'
Display-Lore-Keywords:
- '已绑定'

SignStore.yml — 木牌商店

Sign-Scripts:
    '[我的商店]':
        Permission:
            Default: false
            Permission: adventuremarket.signscript.create
        Sign-Text:
            Line-1: '&0&l[{storeName}&0&l]'
            Line-2: '&0&l点击打开'
        Commands:
        - 'am store view {player}'

Messages.yml

支持 &a 颜色、#RRGGBB HEX、<gradient:c1:c2> 渐变色。分类：General / Market / Auction / Mailbox / Merchant / Economy / Admin。

🖥️ GUI 系统

所有 GUI 位于 GUISettings/，YAML 格式（兼容 GMP）。

通用结构

Simplified-Chinese:
    GUI-Title: '&f标题'
    GUI-Size: 54
    Shopping-Buttons:
        Selling-Item:
            Affordable:
                Display-Item-Meta: true
                Lores: ['!lores!', '...']
            Location:
                Slots-Of-X: [1,2,3,4,5,6]
                Slots-Of-Y: [1,2,3,4,5]
    Custom-Buttons:
        '按钮名':
            Item: 'MAP'
            Commands: [...]

商品 Lore 变量

所有 GUI 列表

🔑 权限系统

权限配置位于 Permissions/，每个节点支持 Default 和 Allowed-Groups。

命令权限

商品权限

档案权限

其他权限

🔗 经济与联动

三货币系统

税率机制

• 上架时按权限组税率预扣
• 出售/收购/拍卖可设不同税率
• 运营者 UUID 出售不打款（系统商店）

数据库

双引擎：SQLite（默认）和 MySQL（HikariCP）。

PlaceholderAPI

标识符：%amarket_xxx%

插件联动

📝 更新日志

v1.2.0 最新

• NEW AdventureMail 联动 — 邮箱重定向
• NEW 批量上架 GUI — 拖入物品一键上架
• NEW 拍卖加时策略 — 竞价倒计时加时 + 广播
• NEW 跨服消息通道 (MySQL)
• NEW 运营者列表 — 系统商品不打款
• FIX 多货币模式符号识别问题