AuctionHouse - 拍卖行插件

AuctionHouse 是一款允许玩家通过 /ah 指令访问拍卖行并上架物品进行交易的插件。它采用全新代码编写，虽然界面风格与已停更的旧版 AuctionHouse 相似，但功能更丰富、更稳定。

💡核心特性

• 完全免费
• 玩家可在拍卖行出售物品
• 服务器可上架物品（一次性或无限次购买）
• 支持按物品名称、类型、描述、附魔或卖家进行搜索筛选
• 支持按时间或价格排序
• 查看自己正在出售的物品
• 取消自己的拍卖
• 领取已取消或过期的物品
• 未领取的物品可掉落至玩家脚下
• 自动清理被遗弃的物品
• 显示并清除近期售出的物品
• 鼠标悬停可查看剩余时间与附魔信息
• 收取固定和/或基于百分比的上架手续费（带确认菜单）
• 对每笔交易按比例征税，并设有上限
• 设置最低与最高售价
• 可根据名称、类型、描述、附魔、耐久度和不可破坏标志限制物品
• 可通过指定描述或附魔来限制通配符物品/方块（可禁止出售灵魂绑定或诅咒物品）
• 使用 regex:<表达式> 通过正则表达式限制物品名称
• 基于 custom_model_data 限制物品
• 可选的后退/退出按钮可执行命令以返回其他菜单
• 点击特定告示牌打开拍卖行
• 点击特定命名的方块实体（如箱子、潜影盒、发射器、投掷器、漏斗、熔炉、附魔台、酿造台）打开拍卖行
• 点击自定义命名的实体打开拍卖行
• 支持控制台命令，便于与自定义菜单及 NPC 插件集成
• 国际化支持
• 可自定义消息、按钮材质与音效
• 支持使用 hdb:<ID> 将 HeadDatabase 头颅作为按钮
• 支持使用 texture:<base64数据> 将自定义头颅纹理作为按钮
• 支持使用玩家头颅作为“玩家上架物品”按钮 (auctionhouse player_head)
• 所有交易记录均写入独立的日志文件
• 向所有玩家公告新上架物品
• Discord 集成
• 重写 NBT 中的字符串 UUID（卖家 -> 买家）
• 多世界支持，支持简单的世界分组
• 设置上架冷却时间
• 支持 Minecraft 1.20.4

视频演示

感谢 server.pro 的 Viktor 制作的视频！

🎮指令列表

• /ah reload - 重载插件配置
• /ah - 打开拍卖行
• /ah show [玩家名] - 为指定玩家打开拍卖行（仅控制台）
• /ah menu [玩家名] - 为指定玩家打开带返回按钮的拍卖行（仅控制台）
• /ah search <筛选词> - 查看匹配筛选条件的物品
• /ah help - 显示所有指令的帮助
• /ah sell <价格> - 出售手持物品
• /ah list <价格> [数量] - 以服务器名义上架物品（一次性）
• /ah ulist <价格> [数量] - 以服务器名义上架物品（无限购买）
• /ah selling - 查看自己正在出售的物品
• /ah sold - 查看自己近期售出的物品
• /ah expired - 查看待领取的过期物品
• /ah cancel - 取消自己的所有拍卖
• /ah return - 领取所有已取消/过期的物品

✨权限节点

• auctionhouse.reload - 允许重载插件
• auctionhouse.use - 允许使用 /ah 指令（默认：true）
• auctionhouse.menu - 允许使用 /ah menu 指令
• auctionhouse.search - 允许使用 /ah search 指令（默认：true）
• auctionhouse.help - 允许使用 /ah help 指令（默认：true）
• auctionhouse.sell - 允许使用 /ah sell 指令（默认：true）
• auctionhouse.list - 允许使用 /ah list 指令
• auctionhouse.ulist - 允许使用 /ah ulist 指令
• auctionhouse.selling - 允许使用 /ah selling 指令（默认：true）
• auctionhouse.sold - 允许使用 /ah sold 指令（默认：true）
• auctionhouse.show - 允许使用 /ah show 指令
• auctionhouse.expired - 允许使用 /ah expired 指令（默认：true）
• auctionhouse.cancel - 允许使用 /ah cancel 指令（默认：true）
• auctionhouse.return - 允许使用 /ah return 指令（默认：true）
• auctionhouse.cancel.others - 允许取消他人的拍卖
• auctionhouse.trigger.block - 允许通过方块触发打开菜单
• auctionhouse.trigger.entity - 允许通过实体触发打开菜单
• auctionhouse.trigger.sign - 允许通过告示牌触发打开菜单
• auctionhouse.auctions.# - 设置玩家最大上架数量

注意：插件将取 config.yml 中的设置值、权限节点值以及元数据值这三者中的最大值作为最终限制。

🔧元数据 (Meta)

• auctions - 设置玩家可上架拍卖的数量

如何使用元数据

你需要一个支持设置和移除元数据的权限插件，例如 PermissionsEx 或 LuckPerms。

PermissionsEx:

/pex user <用户名> set auctions <数量>
/pex group <组名> set auctions <数量>

LuckPerms:

/lp user <用户名> meta set auctions <数量>
/lp group <组名> meta set auctions <数量>

GroupManager:

/manuaddv <用户名> auctions <数量>
/mangaddv <组名> auctions <数量>

⭐配置摘要

主要配置选项包括

• locale：语言区域设置
• auction.listingPrice / listingRate：上架固定费用/百分比费用
• auction.minSellPrice / maxSellPrice：最低/最高售价
• auction.salesTax：销售税率
• auction.defaultMaxListings：默认最大上架数
• auction.sortOrder：排序方式 (oldest, newest, highest_price, lowest_price)
• restricted_items：受限物品列表（可按物品ID、名称、描述、附魔等详细配置）
• buttons：自定义各类按钮的材质
• triggers：设置触发拍卖行的告示牌文本、方块或实体名称
• commands.exit：退出拍卖行时执行的命令

（完整配置请查看插件生成的 config.yml 文件）

❓DiscordSRV 集成

当前插件支持 DiscordSRV 1.25.1 集成。请确保你拥有最新版本的 DiscordSRV。

配置步骤：

• 在 AuctionHouse 的 config.yml 中，设置 discord: true。
• 设置 discord_channel: 'auctionhouse'，其中 auctionhouse 是你在 DiscordSRV 配置中定义的游戏内频道名称。
• 在 DiscordSRV 的 config.yml 的 Channels: 部分，添加一个条目，将游戏内频道名映射到 Discord 的数字频道ID。例如：

Channels: {"global": "123456789012345678", "auctionhouse": "123456789012345678"}

💡已知问题

• 不支持拖放物品操作
• 不支持外部数据库，使用 SQLite
• 用户需自行提供本地化翻译文件
• 并非所有权限插件都支持按用户设置最大上架数，可能需要额外配置

✨依赖

• Vault (版本 1.7.1+)
• 一个兼容的经济插件
• 一个兼容的权限插件

🔧服务条款与免责声明

• 本插件按“原样”提供，不提供任何形式的担保。
• 请通过发起对话来报告所有问题。在讨论区发帖可能会被忽略，因为目前的讨论量较大。
• 免责声明：本插件目前仅支持 Spigot 1.20.4 版本。用于其他版本可能导致功能异常。

对于旧版本，请查看发布历史记录。