Auctions - 优雅拍卖插件

Auctions 是一个 Bukkit/Spigot 插件，允许服务器上的玩家上架物品进行拍卖，其他玩家可以出价竞拍。该插件利用 fanciful 库提供物品信息提示，避免聊天栏被冗长的文本信息刷屏。

💡核心特性

• 完全可自定义的语言文件，支持本地化。
• Herochat 频道集成，可将拍卖消息定向到特定聊天频道。
• 物品悬浮提示，在消息中展示物品详情。
• 动作栏广播，在屏幕上方显示当前拍卖信息。
• 高度可配置的拍卖设置，包括起拍价、加价幅度、队列大小限制等。
• 拍卖防诈骗与防狙击，设有新拍卖间隔时间和高级防狙击机制。
• 密封拍卖模式，支持隐藏出价。
• 自定义格式，可缩短时间显示和货币数字（例如 100K 代替 100,000）。
• 丰富的限制选项，可按需限制特定世界、命令、物品类型等。
• 极少的依赖，仅需 Vault 以支持经济系统。
• 强大的 API，方便开发者轻松添加自定义功能。

🎮命令与权限

主要命令

• /auction start <数量> <价格> [加价幅度] [一口价] - 开始一场拍卖。
• /auction info - 查看当前拍卖信息。
• /auction bid <金额> - 对拍卖出价。
• /auction end - 结束当前拍卖。
• /auction cancel - 取消你的拍卖。
• /auction impound - 没收当前拍卖的物品。
• /auction ignore - 忽略所有插件消息。
• /auction spam - 仅忽略频繁的提示消息。
• /auction queue - 查看所有排队中的拍卖。
• /auction toggle - 切换插件的启用/禁用状态。
• /auction reload - 重载插件配置文件。

权限节点

以下为部分关键权限，完整列表请参考插件文档。

通用操作权限

• auctions.command.start - 允许开始拍卖。
• auctions.command.bid - 允许对拍卖出价。
• auctions.command.cancel - 允许取消自己的拍卖。
• auctions.command.end - 允许结束自己的拍卖。
• auctions.command.reload - 允许重载配置文件。

绕过限制权限

• auctions.bypass.general.disabledworld - 允许在禁用世界中开始、出价和传送。
• auctions.bypass.general.creative - 允许在创造模式下开始拍卖。
• auctions.bypass.general.damageditems - 允许拍卖受损物品。
• auctions.bypass.start.maxprice - 绕过起拍价上限限制。
• auctions.bypass.cancel.otherauctions - 允许取消其他玩家的拍卖。

🔧配置详解

配置文件 (config.yml) 结构清晰，主要分为以下几个部分：

集成设置 (`integration`)

• Herochat：可设置是否启用及指定接收拍卖消息的频道。

聊天设置 (`chatSettings`)

• 群组 (groups)：定义哪些玩家群组接收消息（如 global 向所有在线玩家广播）。
• 处理器 (handler)：消息发送方式，可选 TEXT（聊天栏）或 ACTION_BAR（动作栏）。

拍卖设置 (`auctionSettings`)

此部分控制拍卖的核心规则。

费用与时间

• startFee：开始拍卖的手续费，默认为 0。
• taxPercent：获胜金额的税收百分比，默认为 0。
• startTime：拍卖持续时间（秒），默认为 30。
• delayBetween：拍卖结束到下一个拍卖开始之间的延迟（秒），默认为 5。

价格与出价

• defaultBidIncrement：默认加价幅度，默认为 50。
• minimumBidIncrement / maximumBidIncrement：允许的最小/最大加价幅度。
• minimumStartPrice / maximumStartPrice：允许的最小/最大起拍价。
• maximumAutowinAmount：允许的最大一口价金额。
• canBidAutomatically：是否允许使用无参数的 /bid 命令自动加价。

物品与行为限制

• canAuctionNamedItems：是否允许拍卖已命名的物品。
• canAuctionDamagedItems：是否允许拍卖受损物品。
• canAuctionInCreative：是否允许在创造模式下拍卖。
• auctionQueueLimit：拍卖队列的最大容量，默认为 3。
• mustCancelBefore：在拍卖结束前多少秒内不允许取消，默认为 15。

防狙击 (antiSnipe)

• enable：是否启用防狙击。
• timeThreshold：触发防狙击的剩余时间阈值（秒）。
• maxPerAuction：单场拍卖最多可触发防狙击的次数。
• addSeconds：每次触发后为拍卖增加的时间（秒）。

密封拍卖 (sealedAuctions)

• enabled：是否启用密封拍卖。
• maxBidsPerPlayer：每位玩家在密封拍卖中最多可出价的次数。
• concealTopBidder：是否在消息中隐藏最高出价者和出价金额。

通用设置 (`general`)

• shortenedTimeFormat：是否使用缩短的时间格式（如 5m, 5s）。
• truncatedNumberFormat：是否截断货币数字（如 1K）。
• useItemDisplayName：是否在消息中使用物品的自定义显示名称。
• disabledWorlds：禁用插件功能的世界列表。
• blockedMaterials：禁止拍卖的物品材料列表。
• blockedLore：物品描述中禁止包含的文字列表。
• blockedCommands：在特定情况下（如正在拍卖时）禁止玩家使用的命令列表。
• broadcastTimes：在拍卖剩余特定秒数时广播提醒。

消息自定义 (`messages`)

所有插件发送的消息均可在此完全自定义，并支持丰富的占位符。

拍卖相关消息 (auctionFormattable)

可用的占位符包括

• [itemName] - 物品名称
• [itemamount] - 物品数量
• [time] - 剩余时间
• [ownername] - 拍卖所有者
• [topbiddername] - 最高出价者
• [topbid] - 当前最高出价
• [autowin] - 一口价金额
• [winnings] - 税后所得金额

错误消息 (error)

当玩家操作失败（如权限不足、参数错误）时发送的消息。

其他消息

包括帮助菜单、状态提示等。

❓常见问题

如何安装此插件？

• 确保服务器已安装 Vault 及一个兼容的经济插件（如 EssentialsX）。
• 将 Auctions.jar 放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据需要编辑生成的 plugins/Auctions/config.yml 文件。

密封拍卖是如何工作的？

• 启用后，出价者的出价金额对他人保密。
• 每位玩家在单场密封拍卖中的出价次数受限（可配置）。
• 拍卖结束时，出价最高者获胜。

如何防止拍卖诈骗或恶意行为？

插件内置了多种保护机制

• 防诈骗延迟：通过 delayBetween 设置拍卖间隔。
• 防狙击：在最后几秒出价会自动延长拍卖时间。
• 物品限制：可禁止拍卖特定材料、带有特定描述的物品。
• 命令限制：可禁止拍卖者或出价者在特定状态下使用某些命令。
• 世界限制：可在指定世界完全禁用拍卖功能。

消息可以完全汉化吗？

可以。插件支持完全的语言自定义，您只需在 config.yml 的 messages 部分将所有英文消息翻译为中文即可。