Auctioneer : Auction House Plugin - Auctioneer：拍卖行插件

本插件现已兼容 MC 1.8 至 1.12 版本，并转为免费。您可以在原插件页面查看更新历史和详细文档。

💡核心特性

• 即时购买：提供便捷的购买体验。
• 拍卖行系统：支持物品上架与拍卖。
• 完全可定制的分类：内置 8 个可自定义的分类。
• 自动分类过滤：通过过滤器自动管理物品归属。
• 搜索与排序：支持物品搜索和结果排序。
• 上架过期时间：可设置上架物品的过期时间。
• 上架费用：支持设置固定或百分比形式的上架费。
• 购买确认：所有上架物品购买前需确认。
• 完整物品数据保留：保留物品名称、附魔、描述（Lore）、NBT 标签等所有数据。
• 管理员模式：提供特殊管理功能（点击此处了解更多）。
• 黑名单系统：可限制特定物品或玩家（点击此处了解更多）。
• 支持 CrackShot 插件：可识别 CrackShot 武器。
• 更多功能：持续更新与优化。

如有任何疑问、功能请求或错误报告，请通过 Discussions 板块或私信联系作者。

✨依赖项

运行本插件必须安装以下前置插件

• MenuBuilder API (作者：inventivetalent)
• Vault (作者：Sleaker on Bukkit)

✨过滤器详解

过滤器允许您自动管理物品应归属于哪个分类。您可以为分类创建一系列规则来筛选物品。

基础语法

使用 add 标签添加物品，使用 remove 标签移除物品。配合 match（匹配）和 dontmatch（不匹配）来定义条件。

一个基础的过滤器格式如下

- add:match:item:DIAMOND_SWORD

此过滤器将显示所有钻石剑的上架物品。

组合条件示例

您可以组合多个条件进行精细筛选。例如，筛选价格在 10 到 50 之间的钻石剑：

filters:
- add:match:item:DIAMOND_SWORD
- remove:dontmatch:price:lessthan:50
- remove:dontmatch:price:morethan:10

注意：过滤器的顺序至关重要，错误的顺序可能导致预期外的结果。

添加多种物品

若要同时显示钻石剑和木剑，可以这样设置

filters:
- add:match:item:DIAMOND_SWORD
- remove:dontmatch:price:lessthan:50
- remove:dontmatch:price:morethan:10
- add:match:item:WOOD_SWORD

显示所有物品

使用以下过滤器可显示所有物品

filters:
- add:match:item:ALL

高级过滤类型

过滤器支持多种条件类型，非常适合 RPG 服务器：

• item:{material}：按物品材质筛选（如 INK_SACK），使用 ALL 匹配所有物品。
• bukkitNameContains:{material}：按材质名称包含的字符串筛选（如 STAIRS）。
• enchantment:{enchantments}：按附魔类型筛选（如 ARROW_DAMAGE）。
• metadata:{number}：按物品元数据（损伤值）筛选。
• customNameContains:{string}：按自定义名称包含的字符串筛选（不区分大小写）。若名称包含空格，需用单引号包裹整行，例如：- 'add:match:customNameContains:Royal Bow'。
• player:uuid:{Player FULL UUID}：按玩家完整 UUID 筛选。
• player:name:{Player Username}：按玩家用户名筛选。
• price:lessthan:{integer}：筛选价格低于指定值。
• price:morethan:{integer}：筛选价格高于指定值。
• price:equal:{integer}：筛选价格等于指定值。
• loreContains:{string}：按描述（Lore）包含的字符串筛选（不区分大小写）。若字符串包含空格，需用单引号包裹整行，例如：- 'remove:match:loreContains:Royal Bow'。
• crackShotWeapon:{Weapon Name}：按 CrackShot 武器名称筛选（区分大小写），使用 ALL 匹配所有武器。

操作符类型

您可以使用以下四种组合来添加或移除物品

• add:match:{type}
• add:dontmatch:{type}
• remove:match:{type}
• remove:dontmatch:{type}

**重要提示**

• 在应用自定义过滤器前，请务必备份配置文件并充分测试。
• 语法错误将导致配置重置。
• 如果过滤器导致分类中出现重复物品，重复项将被自动移除。

✨安装指南

• 环境准备：确保服务器运行在 Java 8 或更高版本上。
• 安装经济插件：安装任何 Vault 支持的经济插件（如 EssentialsX、CMI）。
• 放置插件：将下载的 Auctioneer.jar 文件放入服务器的 plugins/ 文件夹。
• 重启服务器：完全停止服务器，然后重新启动。
• 开始使用：启动后，插件将自动生成配置文件。如有问题，请在发布评论前先到 Discussions 板块寻求帮助。

🎮命令与权限

命令 /auctionhouse 和 /ah 可互换使用。

基础命令

• /ah 或 /auctionhouse
• 权限：mcauctionhouse.house
• 功能：打开拍卖行主菜单（默认显示分类）。
• /ah sell
• 权限：mcauctionhouse.sell
• 功能：通过聊天提示询问玩家上架手中物品的价格。
• /ah sell {价格}
• 权限：mcauctionhouse.sell
• 功能：直接以指定价格上架玩家手中的物品。
• /ah search {查询词}
• 权限：mcauctionhouse.search
• 功能：打开拍卖行并显示与查询词相关的搜索结果。
• /ah [玩家名]
• 权限：mcauctionhouse.house.others
• 功能：为指定玩家打开拍卖行主菜单。

高级命令

• /ah page {页码}
• 权限：mcauctionhouse.house
• 功能：显示所有在售物品的指定页码。
• /ah page {页码} {查询词}
• 权限：mcauctionhouse.house
• 功能：显示按查询词排序后的在售物品指定页码。

管理员权限

• mcauctionhouse.admin
• 功能：允许玩家在拍卖行界面中看到管理员功能（如“玩家上架物品”和“管理员模式”按钮）。

🔧配置技巧

• 若将 defaultToAllItemsInsteadOfCategories 设置为 true，并将所有分类的 enableCategory 设置为 false，则 /ah 命令将默认显示“所有报价”页面，并将“返回分类”按钮替换为“您的上架物品”按钮。
• seeOwnOffers 设置允许玩家在分类中看到自己的上架物品（默认为 false，即玩家只能在“我的报价”页面查看自己的物品）。

💡重要注意事项

• 在 config.yml 配置文件中，切勿将任何物品材质（Material）设置为 AIR！
• 配置中如需使用单引号 '，请使用两个单引号 '' 表示，否则配置文件可能会被清空。
• 如需使用颜色代码（如 &e），请将整段文字用单引号包裹，例如：'&e你好！'。
• 大多数数值可设置为 -1 以表示无限制。
• 编辑过滤器前请务必备份配置文件。

⭐默认配置摘要

# Auctioneer by Klemms, 2017
# 配置版本: 1.0
language: ENGLISH
hoursUntilRefund: 24 # 上架物品多少小时后过期退款
keepSoldOrExpiredOfferInLogsHours: 24 # 购买或过期记录保留时长（小时）
minimumPrice: -1.0 # 最低上架价格（-1为无限制）
maximumPrice: -1.0 # 最高上架价格（-1为无限制）
moneyListingFee: 0.0 # 上架固定费用
percentListingFee: 0.0 # 售出后收取的百分比费用（1.2 表示 1.2%）
defaultToAllItemsInsteadOfCategories: false # 是否默认打开“所有物品”页面
backgroundMaterial: STAINED_GLASS_PANE # 菜单背景材质
backgroundMaterialMetadata: 7 # 背景材质颜色（7为浅色边框）
seeOwnOffers: false # 是否允许在分类中看到自己的物品
preventSurvivalModeSales: false # 是否禁止生存模式玩家上架
preventAdventureModeSales: false # 是否禁止冒险模式玩家上架
preventCreativeAndSpectatorSales: true # 是否禁止创造和观察者模式玩家上架
maximumConcurrentPlayerAuctions: -1 # 玩家同时上架的最大数量（-1为无限制）

# 可自定义的分类（此处仅展示分类1示例，插件共包含8个分类）
categories:
  category1:
    enableCategory: true
    name: '&7分类 1'
    lore:
    - '&7所有物品'
    material: BRICK
    amount: 1
    data: 0
    filters:
    - add:match:item:ALL