AuctionHouse-1.17.1 - AuctionHouse拍卖行插件

AuctionHouse 是一款允许玩家通过 /ah 命令访问拍卖行并上架物品进行交易的插件。此插件为全新编写，仅在外观和体验上与已停止更新的原 AuctionHouse 插件相似。

💡下载链接

• 1.18.2 版本: 点击下载
• 1.13.2 - 1.16.5 版本: 点击下载
• 1.9.4 - 1.12.2 版本: 点击下载
• 1.8.8 版本: 点击下载

当前文档版本: AuctionHouse 3.0.5 (适用于 1.17.1)

🎮核心功能

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

🔧命令列表

• /ah reload - 重载插件配置。
• /ah - 打开拍卖行。
• /ah <玩家名> - 为指定玩家打开拍卖行（仅控制台）。
• /ah menu - 以菜单模式打开拍卖行。
• /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.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 <数值>

❓配置与集成

主要配置

配置文件 config.yml 结构清晰，允许你自定义语言、经济系统、费用、税率、持续时间、物品限制、按钮、音效、触发器等。请确保在修改后使用 /ah reload 重载配置。

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"}

请确保数字 ID 与你的 Discord 频道实际 ID 一致。

💡已知问题与限制

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

🔧依赖要求

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

✨注意事项

• 请通过发起私聊对话报告所有问题。在讨论区发帖可能会被忽略，因为目前的讨论量较大。
• 免责声明：此插件目前支持 Spigot 1.13.2+ 版本。如果用于非预期版本，功能可能会失效。