AuctionHouse-Legacy - 经典拍卖行插件

AuctionHouse-Legacy 是一款允许玩家通过拍卖行自由交易物品的插件。它采用全新代码编写，界面风格与已停更的旧版 AuctionHouse 相似，为服务器提供了一个功能丰富且可高度自定义的交易平台。

💡版本与下载

• AuctionHouse-Legacy 2.2.3 (支持 1.9.4, 1.10.2, 1.11.2, 1.12.2)
• 其他版本下载：

- [1.18.2 版本](https://www.spigotmc.org/resources/auctionhouse.61836/download?version=458753)

- [1.17.1 版本](https://www.spigotmc.org/resources/auctionhouse-1-17-1.100767/)

- [1.13.2-1.16.5 版本](https://www.spigotmc.org/resources/auctionhouse-classic.100766/)

- [1.8.8 版本](https://www.spigotmc.org/resources/auctionhouse-retro.69278/)

🎮核心功能

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

🔧命令列表

• /ah reload - 重载插件配置。
• /ah - 打开拍卖行。
• /ah <player> - 为指定玩家打开拍卖行（仅控制台）。
• /ah menu - 以菜单模式打开拍卖行。
• /ah menu <player> - 为指定玩家以菜单模式打开拍卖行（仅控制台）。
• /ah search <filter> - 查看符合搜索筛选条件的物品。
• /ah help - 显示所有命令的帮助信息。
• /ah sell <price> - 出售手中持有的物品。
• /ah list <price> [count] - 以服务器名义上架物品。
• /ah ulist <price> [count] - 以服务器名义上架可无限次购买的物品。
• /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 <user> set auctions <value>`

- `/pex group <group> set auctions <value>`

• LuckPerms:

- `/lp user <user> meta set auctions <value>`

- `/lp group <group> meta set auctions <value>`

• GroupManager:

- `/manuaddv <user> auctions <value>`

- `/mangaddv <group> auctions <value>`

⭐配置与集成

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.5+)
• 一个兼容的经济插件
• 一个兼容的权限插件

🔧服务条款与免责声明

• 本插件按“原样”提供，不提供任何形式的担保。
• 请通过发起私聊对话来报告所有问题。在讨论区发帖可能会被忽略。
• 免责声明：本插件仅支持 Spigot 1.9.4, 1.10.2, 1.11.2 和 1.12.2 版本。在其他非目标版本的 Spigot 上使用可能导致功能异常。