AuctionHouse 插件允许玩家通过 /ah 命令访问拍卖行，并在其中出售物品。本插件为全新代码，仅在外观和感觉上与已停止维护的 AuctionHouse 插件相似。

🏠 AuctionHouse

✨ 主要功能

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

🚀 命令

• /ah reload - 重新加载 AuctionHouse 配置
• /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 中设置的最大值。

🧰 Meta

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

要使用 Meta，您需要拥有一个兼容的权限插件，该插件支持设置和删除 Meta，例如 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>

⚙️ 配置

#
# AuctionHouse
#
config_version: 29
locale: en_us
decimal_format: "#,##0.00"
strict: false
economy: vault
chatHook: true
updateTicks: 20

auction:
  listingPrice: 0.00
  listingRate: 0.00
  listingCooldown: 0d0h0m0s
  listingDuration: 7d0h0m
  expiredDuration: 14d0h0m
  unclaimedDuration: 90d0h0m
  cleanupDuration: 0d24h0m
  soldDuration: 365d0h0m
  unclaimedCheckDuration: 0d0h5m
  unclaimedCheckOnWorldChange: true
  preventCreative: true
  preventSpectator: true
  minSellPrice: 0.00
  maxSellPrice: 100000.00
  salesTax: 0.00
  maxSalesTax: 100000.00
  allowDamagedItems: false
  defaultMaxListings: 5
  # oldest, newest, highest_price, lowest_price
  sortOrder: 'oldest'
  announce: false
  action_bar: true
  discord: false
  discord_channel: 'auctionhouse'
  multiworld: false
  groupWorlds: false
  replaceUUIDs: false
  replacePlayerNames: false
  dropAtFeet: false
  showSeconds: true
  spawnerInfo: true
  integerPrice: false
  showRepairCost: true

announce:
  chat:
    listings: true
    purchases: true
  action_bar:
    listings: false
    purchases: false

restricted_items:
  0:
    item: 'minecraft:bedrock'
  1:
    item: 'minecraft:barrier'
  2:
    item: 'minecraft:command_block'
  3:
    item: 'minecraft:structure_block'
  example:
    name: '\u00a7cVorpal Sword'
    item: 'minecraft:diamond_sword'
    lore:
      - 'Special Item'
      - 'Does not list in AuctionHouse'
    enchantments:
      - {ench: 'minecraft:sharpness', level: 10}
      - {ench: 'minecraft:unbreaking', level: 3}
      - {ench: 'minecraft:looting', level: 3}
      - {ench: 'minecraft:fire_aspect', level: 2}
    unbreakable: true
    custom_model_data: 1

mcmmo:
  lore:
    - 'mcMMO Ability Tool'
mcmmo_ability:
  persistent_data:
    'mcmmo:super_ability_boosted': 0

sounds:
  click: 'ui.button.click'
  fail: 'entity.villager.no'
  drop: 'entity.player.burp'
  sold: 'block.note_block.chime'

buttons:
  exit: 'minecraft:iron_door'
  back: 'minecraft:iron_door'
  previous: 'minecraft:paper'
  sort_listings: 'minecraft:sunflower'
  next: 'minecraft:paper'
  info: 'minecraft:book'
  howto: 'minecraft:emerald'
  return_all: 'minecraft:flower_pot'
  player_listings: 'minecraft:diamond'
  expired_listings: 'minecraft:poisonous_potato'
  sold_items: 'minecraft:gold_ingot'
  clear: 'minecraft:barrier'
  confirm: 'minecraft:lime_stained_glass_pane'
  cancel: 'minecraft:red_stained_glass_pane'

triggers:
  sign: '[AuctionHouse]'
  block_name: 'Auction House'
  entity_name: 'Auction House'

commands:
  exit: "msg %player% Exiting AuctionHouse"

log:
  listed: true
  sold: true
  cancelled: true
  returned: true
  dropped: true
  purged: true

anticheat:
  spam_check: true

disabled-worlds: []

📢 DiscordSRV 支持

本插件目前支持 DiscordSRV 1.25.1 集成。请确保您拥有最新的插件。要配置 DiscordSRV，您需要在 config.yml 中设置 discord: true，并设置 discord_channel: 'auctionhouse'，其中 auctionhouse 代表您将在 DiscordSRV 的 config.yml 中配置的游戏内频道名称。

通常，可以通过在 DiscordSRV 的 config.yml 的 Channels: 部分中添加一个额外的条目来实现，该条目使用与全局频道相同的数字频道。它可能看起来像以下内容，实际数字与 Discord 中给出的数字匹配。

# 从游戏到 Discord 的频道链接
# 语法是 Channels: {"游戏内频道名称": "来自 Discord 的数字频道 ID", "另一个游戏内频道名称": "另一个来自 Discord 的数字频道 ID"}
# 在此配置选项中指定的第一个频道对将是“主”频道，用于发送玩家加入/退出/死亡/成就等信息
#
Channels: {"global": "123456789012345678", "auctionhouse": "123456789012345678"}

🐛 已知问题

• 不支持物品的拖放。
• 没有外部数据库支持 - 它使用 SQLite。
• 用户应提供本地化翻译文件
• 并非所有权限插件都支持每个用户的最大列表数量，并且可能需要额外的配置

💡 依赖

• Vault (version 1.5+)
• 合适的经济插件
• 合适的权限插件

📜 服务条款

该插件按“原样”提供。

请通过发起对话报告所有问题。如果您在讨论论坛中发帖，可能会被忽略，因为我们现在收到的讨论越来越多。

⚠️ 免责声明

此插件当前支持 Spigot 版本 1.13.2+。如果与其他版本的 Spigot 一起使用，功能可能会中断。