AuctionHouse 是一款免费的 Minecraft Spigot 插件，它允许玩家通过 /ah 命令访问拍卖行，从而出售物品。该插件具有全新的代码，仅在外观和感觉上与已停止维护的 AuctionHouse 插件资源相似。

🎉 特性

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

🧰 命令

• /ah reload - 重新加载 auctionhouse 配置
• /ah - 打开拍卖行
• /ah show [player] - 为玩家打开拍卖行（仅限控制台）
• /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.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 中设置的最大值。

⚙️ 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 中给出的数字匹配。

# Channel links from game to Discord
# syntax is Channels: {"in-game channel name": "numerical channel ID from Discord", "another in-game channel name": "another numerical channel ID from Discord"}
# The first channel pair specified in this config option will be the "main" channel, used for sending player joins/quits/deaths/achievements/etc
#
Channels: {"global": "123456789012345678", "auctionhouse": "123456789012345678"}

🐛 已知问题

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

📦 依赖项

• Vault (version 1.7.1+)
• 一个合适的经济插件
• 一个合适的权限插件

📜 服务条款

该插件按原样提供。

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

⚠️ 免责声明

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