
你的玩家真正会使用的拍卖行
DonutAuctionHouse 是一款适用于 Paper、Folia 和 Purpur 的免费开源拍卖行,支持 Minecraft 1.20.1 至 26.3。玩家打开 /ah 即可获得一个整洁的 45 格市场界面。他们可以通过名称、附魔或卖家进行搜索,只需几次点击即可通过 /ah sell 2.5k 出售物品,或者将稀有物品设置为带有竞价功能的真实拍卖。当物品售出时,卖家会立即收到通知,即使他们正在其他服务器或处于离线状态。物品永远不会掉落在地上。每一次购买、出价和赎回都是数据库层面的声明,确保只有一个服务器的一个玩家能赢得该物品。
2.0 "The Market Update" 新增了带竞价的拍卖、销售税和上架费、价格洞察、销售通知、收藏功能、Discord Webhook、PlaceholderAPI、开发者 API 以及员工工具。每个版本都会在所有支持的 Paper 和 Folia 版本上使用真实客户端进行测试。




- 搜索所有内容:物品名称、描述、附魔(如
sharpness)、卖家名称以及潜影盒内的物品。必须完全匹配每一个词。
- 排序方式包括最近上架、即将结束、最低价格、最高价格或 每件单价。堆叠物品会显示其单件价格,因此可以将一组的 64 个与单个进行比较。
- 筛选类别(方块、工具、食物、战斗、药水、书籍、材料、实用道具)和类型:立即购买或拍卖。
- 单一卖家的商店,使用
/ah view <player>(或直接使用 /ah <player>)。
- 潜影盒预览:右键点击潜影盒以在购买前查看内部物品。
- 物品名称会根据每位玩家的语言进行显示。


- 手持物品并运行
/ah sell 2500。2.5k、1.2m、3b 和 1,250 同样有效。
- 出售菜单将以你设定的价格打开。点击它输入确切金额,或使用 +/- 键(Shift+点击可进行更大步长的调整)。
- 选择持续时间(6 小时到一周,可配置),并选择 立即购买 或 拍卖。
- 查看 价格洞察(近期成交价)和 费用与收益(税费、手续费、实际所得),然后确认。
快速出售(/ah fastsell)会跳过菜单,直接列出并一次性使用你上次的持续时间。


-
使用 /ah auction <起拍价> 开始一次拍卖,或将售卖菜单切换为拍卖。
-
竞价菜单提供最低下一次出价、+10%、+25% 或自定义输入金额。新出价必须比当前出价高出至少 5% 或 1(可配置),取两者中较大值。
-
托管交易:竞拍者出价时,其资金会被暂时冻结。若有人出更高价格将其击败,资金将立即退还并通知该竞拍者。
-
反狙击:在拍卖最后 30 秒内的出价会延长拍卖时间,从而防止最后一秒的狙击行为。
-
仅结算一次:拍卖结束后,出价最高者获胜并支付款项(扣除税费)。此操作仅执行一次,即使多个服务器共享同一个 MySQL 数据库也是如此;若支付过程中断,将在下次启动时继续完成。
-
如果获胜者在线且物品能够放入背包,则立即获得该物品;否则,物品将暂存于 /ah collect 中等待领取。


- 出售菜单会显示过去 7 天内每件物品的平均、范围和最近成交价,以及当前在售的最便宜报价。
/ah price 命令会对您当前手持的物品显示相同的信息,包括整组物品的总价值。
- 这些统计数据同样可以作为 PlaceholderAPI 占位符用于记分板和全息图:
%donutauction_average_DIAMOND%、%donutauction_lowest_DIAMOND% 等。
- 内置且免费。其他拍卖插件将价格历史作为付费附加组件出售。


- 已售出:当有人购买您的物品时,立即发送聊天消息、音效以及“ITEM SOLD”标题,并显示买家、价格和税费。
- 您离开期间:在您离线期间的销售记录会在您上线时汇总,并显示总收入。
- 被超越出价、中标、过期以及由工作人员移除的通知。
- 跨服务器生效:无论您在哪个服务器上,都会收到相关通知。
- 可选的新上架广播(最低价格和冷却时间可配置)。


- 物品仅以能完整装入的堆叠数量交付。库存已满时进行的购买、离线期间赢得的拍卖、已过期或被工作人员移除的条目会暂存在
/ah collect 中。不会有物品掉落在地上。
- 一键领取(Collect All):一次点击即可领取所有能放入的物品。
- 右键点击已过期的条目可以以相同价格重新上架,左键点击则将其收回。
- “Your Items”页面显示你的在售条目、上限以及已售出和已购买的数量。


| 设置项 |
功能说明 |
economy.sales-tax |
从卖家收益中扣除一定比例的税费。权限层级可降低税率(例如 donutauction.tax.vip: 2.5),并通过 deposit-to 将税费支付到服务器账户。 |
economy.listing-fee |
上架时收取的固定费用或百分比费用,设有上限,并受 donutauction.fee.exempt 权限豁免影响。 |
auction.price-limits |
单个物品的最低和最高价格限制,例如 DIAMOND: {min: 50}。 |
auction-limits |
根据权限控制的每个玩家的上架数量(如 donutauction.limit.25、.unlimited)。 |
blacklist |
禁止出售的材料、名称或描述中的特定文本、自定义模型数据以及插件数据键。 |
restrictions |
禁用的世界和受限的游戏模式(默认禁用创造模式和旁观者模式),以及上架冷却时间。 |
在启用之前,税费和手续费均处于关闭状态。每条规则都配有供工作人员使用的绕过权限。


- 每次操作仅有一个获胜者。购买、出价、结束拍卖、取消、收回和领取等操作均以条件数据库更新开始,确保只有一个服务器的一个玩家能获胜。双击、延迟或多服务器同时操作无法导致同一物品被卖出或返还两次。
- 物品始终有归属:它可能在手中、待售中、市场上或收藏中。它绝不会出现在两个地方,也绝不会掉落在地上。
- 兼容 Folia:物品栏更改仅在玩家所属线程上进行。
- 版本升级无忧:物品使用 Paper 的版本化格式存储,并通过 Mojang 的数据修复器处理,因此上架记录可随 Minecraft 版本更新而保留。无法读取的物品会被隔离并报告;它不会阻碍其他正常流程。
- 单一市场,多服务器支持:MySQL 共享上架数据,Redis(可选)使更新即时生效。


- Discord Webhook:新上架、售出、出价、中标和过期事件会以嵌入消息形式发送,包含物品、数量、附魔、价格和卖家头像。可选择触发的事件类型及最低价格阈值。
- PlaceholderAPI:
| 占位符 |
值含义 |
%donutauction_active%, %donutauction_limit%, %donutauction_slots_left% |
当前上架数量和上限 |
%donutauction_collect% |
等待在 /ah collect 中领取的物品 |
%donutauction_sold%, %donutauction_earned% |
已售出物品数量和获得金额(税后) |
%donutauction_bought%, %donutauction_spent% |
已购买物品数量和花费金额 |
%donutauction_total_listings%, %donutauction_total_auctions% |
整个市场的总上架数和总拍卖数 |
%donutauction_average_<ITEM>%, _lowest_<ITEM>%, _sales_<ITEM>%, _listed_<ITEM>% |
按物品分类的价格洞察数据 |
- 开发者 API:
DonutAuctionApi 提供列出、读取和创建上架记录的功能(可用于箱子、NPC 商店、奖励系统等)。附带可取消的前置上架、前置购买和前置出价事件,以及上架、购买、出价、中标、结束和取消等事件。
- 支持 Vault 和 VaultUnlocked 经济系统、DonutCore 显示名称以及 bStats 统计。


- Shift+右键点击任意上架条目即可将其移除。物品将返回卖家的收藏中,任何持有的出价将被退款,卖家会收到通知。
/ah admin view <player>:查看某玩家的上架记录,点击可移除。
/ah admin remove <id>、/ah admin info(存储信息、活跃上架、无法读取的行)和 /ah admin purge <days>(清理旧历史记录)。
/ah open <player> [browse|items|history|search <text>]:从控制台、NPC 或菜单插件为指定玩家打开菜单。
- 每日交易日志保存在
plugins/DonutAuctionHouse/logs/ 中,记录每一次上架、售出、出价、中标、取消和收回操作。


config.yml:配置持续时间、价格、竞价机制、税费与手续费、通知、广播、规则、音效、Discord 集成、存储与同步方式。更新插件时会自动添加新设置项,同时保留你原有的配置值。
messages.yml:玩家看到的所有文字,包括菜单标题和按钮文本。可使用 MiniMessage(如 <gradient:#ff6fae:#ffc24b>)、& 代码或 &#RRGGBB 十六进制颜色码,并可自由混合使用。玩家自定义的名称始终以纯文本形式插入,因此无法添加颜色或点击事件。
/ah reload 可在不重启服务器的情况下应用上述两项配置更改。


| 服务器 |
Minecraft |
Java |
备注 |
| Paper, Purpur, other Paper forks |
1.20.1 – 1.20.4 |
17+ |
|
| Paper, Purpur, other Paper forks |
1.20.5 – 1.21.11 |
21+ |
|
| Paper, Purpur, other Paper forks |
26.1 – 26.3 |
25+ |
|
| Folia |
1.20.4 – 26.3 |
同上 |
区域线程安全 |
| Spigot, Bukkit |
— |
— |
不受支持:它们缺乏 Paper 的 API。插件会自行声明并禁用自身。 |
- 需要 Vault 或 VaultUnlocked 以及一个经济插件(EssentialsX、CMI 等)。
- 可选:PlaceholderAPI、DonutCore、MySQL 和 Redis。
- 每个版本一个 jar 文件。仅安装在服务器上;玩家无需安装模组。
- 每次发布都会在真实的 Paper 1.20.1、1.20.4、1.20.6、1.21.1、1.21.4、1.21.8、1.21.11、26.1.2、26.2 和 26.3 服务器,以及 Folia 1.20.4、1.21.4、1.21.11 和 26.3 服务器上运行自动化矩阵测试,涉及真实客户端进行列表查看、购买、竞价和获胜。

| 命令 |
功能 |
权限 |
/ah |
打开拍卖行 |
donutauction.use |
/ah sell <price> [auction] |
出售手持物品 |
donutauction.sell |
/ah auction <starting bid> |
将手持物品进行拍卖 |
donutauction.sell.auction |
/ah search <text> |
按名称、附魔或卖家搜索 |
donutauction.use |
/ah view <player> |
查看某卖家的所有上架物品 |
donutauction.use |
/ah price |
查看手持物品的近期价格 |
donutauction.use |
/ah collect |
查看你的上架物品和待领取物品 |
donutauction.use |
/ah history [sold] |
查看你的购买和销售记录 |
donutauction.use |
/ah limit |
查看你的上架数量限制 |
donutauction.use |
/ah fastbuy, /ah fastsell |
跳过确认菜单 |
donutauction.fastbuy, .fastsell |
/ah open <player> [menu] |
为某玩家打开菜单 |
donutauction.admin.open |
/ah admin view|remove|info|purge |
工作人员工具 |
donutauction.admin |
/ah reload |
重新加载配置和消息 |
donutauction.admin |
1.x 版本的 donutcore.auction.* 权限仍然有效。

它真的免费吗?
是的,全部免费:拍卖、税费、价格洞察、Webhook、PlaceholderAPI、跨服务器支持和 API。源代码在 GitHub 上,采用 Apache-2.0 许可证。
我从 1.x 升级,会丢失任何东西吗?
不会。替换 jar 文件并重启即可。你的上架物品、历史记录、配置值和消息都会保留,并且会添加新设置。像任何更新一样,请先备份数据库。
它在 Spigot 上能工作吗?
不能。DonutAuctionHouse 使用 Paper 的 API(Adventure 文本、区域调度器)。Paper 是 Spigot 的直接替代品,Purpur 和其他 Paper 分支也能正常工作。
玩家能用它复制物品吗?
每一次购买、竞价、拍卖结束、取消和取回都是条件性的数据库更新,且只有一个操作能胜出。物品只作为完整堆叠移动(只要空间足够),因此不会出现可以拾取两次的掉落物。如果你发现了漏洞,请私下报告(参见 GitHub 上的 SECURITY.md)。
我如何在多个服务器之间共享同一个市场?
在所有服务器上设置 storage.type: MYSQL 并使用相同的数据库。可选择启用 sync.redis 以实现即时同步。销售通知会跟随玩家到他们所在的任何服务器。
我可以只为部分玩家收取税费吗?
可以。为所有人设置 economy.sales-tax.percent,然后在 economy.sales-tax.permissions 下添加层级,例如 donutauction.tax.vip: 2.5。适用最低匹配的层级。
我能阻止人们出售某些物品吗?
使用 blacklist(材料、名称、描述、自定义模型数据、插件数据键)和 auction.price-limits 来设置每件物品的价格下限和上限。
文档在哪里?
README · Release notes · Issues

















DonutAuctionHouse 采用 Apache-2.0 许可证授权。本宣传素材中使用的 Outfit 和 Inter 字体遵循 SIL Open Font License 1.1 许可协议。截图均为未经编辑的 vanilla Minecraft 客户端在运行该插件的 Paper 服务器上的实时画面。DonutAuctionHouse 是一个独立项目,与 Mojang、Microsoft 或任何为其提供灵感的服务器均无隶属关系。

The auction house your players will actually use
DonutAuctionHouse is a free, open-source auction house for Paper, Folia and Purpur, from Minecraft 1.20.1 to 26.3. Players open /ah and get a clean 45-slot market. They can search it by name, enchantment or seller, sell anything in a few clicks with /ah sell 2.5k, or put rare items up for a real auction with bids. Sellers are told the moment something sells, even while they are on another server or offline. Nothing is ever dropped on the ground. Every purchase, bid and reclaim is a database claim that only one player, on one server, can win.
2.0 "The Market Update" adds auctions with bids, sales tax and listing fees, price insight, sale notifications, the collection, Discord webhooks, PlaceholderAPI, a developer API and staff tools. Each release is tested on every supported Paper and Folia version with real clients.




- Search everything: item names, lore, enchantments (
sharpness), seller names and the contents of shulker boxes. Every word must match.
- Sort by Recently Listed, Ending Soon, Lowest Price, Highest Price or Lowest Price Each. Stacks show their price per item, so a stack of 64 can be compared with a single.
- Filter by category (blocks, tools, food, combat, potions, books, ingredients, utilities) and by type: Buy It Now or auctions.
- One seller's shop with
/ah view <player> (or just /ah <player>).
- Shulker preview: right-click a shulker box to see what is inside before you buy.
- Item names are shown in each player's own language.


- Hold the item and run
/ah sell 2500. 2.5k, 1.2m, 3b and 1,250 work too.
- The sell menu opens with your price. Click it to type an exact amount, or use +/- (shift-click for bigger steps).
- Pick a duration (6 hours to a week, configurable) and Buy It Now or Auction.
- Check Price Insight (what it sold for lately) and Fees & Earnings (tax, fee, what you receive), then confirm.
Fast sell (/ah fastsell) skips the menu and lists at once with your last duration.


- Start one with
/ah auction <starting bid>, or switch the sell menu to Auction.
- The bid menu offers the minimum next bid, +10%, +25% or a typed amount. A new bid must beat the current one by 5% or 1, whichever is more (configurable).
- Escrow: a bid is taken from the bidder when they place it. If someone outbids them, it is refunded instantly and they are told.
- Anti-snipe: a bid in the final 30 seconds extends the auction, so last-second sniping does not work.
- Settled once: when the auction ends, the highest bidder wins and the seller is paid (minus tax). This happens exactly once, even with several servers sharing MySQL, and an interrupted payout is completed on the next start.
- The winner gets the item straight away if they are online and it fits; otherwise it waits in
/ah collect.


- The sell menu shows the average, range and last sale price per item for the last 7 days, and the cheapest listing on sale right now.
/ah price shows the same for whatever you hold, including what your whole stack is worth.
- The same figures are available as PlaceholderAPI placeholders for scoreboards and holograms:
%donutauction_average_DIAMOND%, %donutauction_lowest_DIAMOND% and more.
- Built in and free. Other auction plugins sell price history as a paid add-on.


- Sold: a chat message, a sound and an ITEM SOLD title the moment someone buys your item, with the buyer, the price and the tax.
- While you were away: sales made while you were offline are summarised when you join, with the total earned.
- Outbid, won, expired and removed by staff notices.
- Works across servers: you are told on whichever server you are on.
- Optional chat broadcasts for new listings (minimum price and cooldown configurable).


- Items are handed over only as whole stacks that fit. A purchase made with a full inventory, an auction won while offline, an expired listing or one removed by staff waits in
/ah collect. Nothing is dropped on the ground.
- Collect All takes everything that fits in one click.
- Right-click an expired listing to relist it at the same price, or left-click to take it back.
- Your Items shows your active listings, your limit, and how much you have sold and bought.


| Setting |
What it does |
economy.sales-tax |
A percentage taken from the seller's proceeds. Permission tiers lower it (donutauction.tax.vip: 2.5), and deposit-to pays it to a server account. |
economy.listing-fee |
A flat fee and/or a percentage when listing, with a cap and donutauction.fee.exempt. |
auction.price-limits |
Minimum and maximum price per single item, for example DIAMOND: {min: 50}. |
auction-limits |
Listings per player by permission (donutauction.limit.25, .unlimited). |
blacklist |
Materials, text in names or lore, custom model data and plugin data keys that can never be sold. |
restrictions |
Disabled worlds and blocked game modes (creative and spectator by default), plus a listing cooldown. |
Tax and fees are off until you enable them. Every rule has a bypass permission for staff.


- One winner per action. Buying, bidding, ending an auction, cancelling, reclaiming and collecting each start with a conditional database update that only one player on one server can win. Double clicks, lag and two servers at once cannot sell or return an item twice.
- The item is always somewhere: in a hand, in a pending sale, on the market or in a collection. It is never in two places, and never on the ground.
- Folia-safe: inventories only change on the player's own thread.
- Upgrade-proof: items are stored in Paper's versioned format and run through Mojang's data fixers, so listings survive Minecraft updates. An item that cannot be read is set aside and reported; it never blocks the rest.
- One market, many servers: MySQL shares listings and Redis (optional) makes updates instant.


- Discord webhooks: new listings, sales, bids, wins and expiries as embeds with the item, amount, enchantments, price and the seller's head. Pick the events and a minimum price.
- PlaceholderAPI:
| Placeholder |
Value |
%donutauction_active%, %donutauction_limit%, %donutauction_slots_left% |
Your listings and limit |
%donutauction_collect% |
Items waiting in /ah collect |
%donutauction_sold%, %donutauction_earned% |
Items sold and money earned (after tax) |
%donutauction_bought%, %donutauction_spent% |
Items bought and money spent |
%donutauction_total_listings%, %donutauction_total_auctions% |
The whole market |
%donutauction_average_<ITEM>%, _lowest_<ITEM>%, _sales_<ITEM>%, _listed_<ITEM>% |
Price insight per item |
- Developer API:
DonutAuctionApi lists, reads and creates listings (crates, NPC shops, rewards). It comes with cancellable pre-list, pre-purchase and pre-bid events, plus listed, purchased, bid, won, ended and cancelled events.
- Vault and VaultUnlocked economies, DonutCore display names, and bStats.


- Shift-right-click any listing to remove it. The item goes back to the seller's collection, any held bid is refunded, and the seller is told.
/ah admin view <player>: a player's listings, click to remove.
/ah admin remove <id>, /ah admin info (storage, active listings, unreadable rows) and /ah admin purge <days> (old history).
/ah open <player> [browse|items|history|search <text>] opens a menu for a player, from the console, an NPC or a menu plugin.
- A daily transaction log in
plugins/DonutAuctionHouse/logs/ records every listing, sale, bid, win, cancel and reclaim.


config.yml: durations, prices, bidding, tax and fees, notifications, broadcasts, rules, sounds, Discord, storage and sync. New settings are added automatically when you update; your values are kept.
messages.yml: every word players see, including menu titles and buttons. Use MiniMessage (<gradient:#ff6fae:#ffc24b>), & codes or &#RRGGBB hex, mixed freely. Player-made names are always inserted as plain text, so they can never add colors or click events.
/ah reload applies both without a restart.


| Server |
Minecraft |
Java |
Notes |
| Paper, Purpur, other Paper forks |
1.20.1 – 1.20.4 |
17+ |
|
| Paper, Purpur, other Paper forks |
1.20.5 – 1.21.11 |
21+ |
|
| Paper, Purpur, other Paper forks |
26.1 – 26.3 |
25+ |
|
| Folia |
1.20.4 – 26.3 |
as above |
Region-thread safe |
| Spigot, Bukkit |
— |
— |
Not supported: they lack Paper's API. The plugin says so and disables itself. |
- Needs Vault or VaultUnlocked and an economy plugin (EssentialsX, CMI, and others).
- Optional: PlaceholderAPI, DonutCore, MySQL and Redis.
- One jar for every version. Install it on the server only; players need no mods.
- Each release runs an automated matrix on real Paper 1.20.1, 1.20.4, 1.20.6, 1.21.1, 1.21.4, 1.21.8, 1.21.11, 26.1.2, 26.2 and 26.3 servers and Folia 1.20.4, 1.21.4, 1.21.11 and 26.3, with real clients listing, buying, bidding and winning.

| Command |
What it does |
Permission |
/ah |
Open the auction house |
donutauction.use |
/ah sell <price> [auction] |
Sell the held item |
donutauction.sell |
/ah auction <starting bid> |
Auction the held item |
donutauction.sell.auction |
/ah search <text> |
Search by name, enchantment or seller |
donutauction.use |
/ah view <player> |
One seller's listings |
donutauction.use |
/ah price |
Recent prices of the held item |
donutauction.use |
/ah collect |
Your listings and items to collect |
donutauction.use |
/ah history [sold] |
Your purchases and sales |
donutauction.use |
/ah limit |
Your listing limit |
donutauction.use |
/ah fastbuy, /ah fastsell |
Skip the confirmation menus |
donutauction.fastbuy, .fastsell |
/ah open <player> [menu] |
Open a menu for a player |
donutauction.admin.open |
/ah admin view|remove|info|purge |
Staff tools |
donutauction.admin |
/ah reload |
Reload config and messages |
donutauction.admin |
The 1.x donutcore.auction.* permissions keep working.

Is it really free?
Yes, all of it: auctions, tax, price insight, webhooks, PlaceholderAPI, cross-server and the API. The source is on GitHub under Apache-2.0.
I'm updating from 1.x. Will I lose anything?
No. Replace the jar and restart. Your listings, history, config values and messages are kept, and new settings are added. Back up your database first, as with any update.
Does it work on Spigot?
No. DonutAuctionHouse uses Paper's API (Adventure text, region schedulers). Paper is a drop-in replacement for Spigot, and Purpur and other Paper forks work too.
Can players dupe items with it?
Every purchase, bid, auction end, cancel and reclaim is a conditional database update that only one action can win. Items only move as whole stacks that fit, so nothing is dropped where it could be picked up twice. If you ever find a way, please report it privately (see SECURITY.md on GitHub).
How do I share one market between servers?
Set storage.type: MYSQL on every server with the same database. Optionally enable sync.redis for instant updates. Sales notifications follow the player to whichever server they are on.
Can I charge tax only to some players?
Yes. Set economy.sales-tax.percent for everyone and add tiers under economy.sales-tax.permissions, for example donutauction.tax.vip: 2.5. The lowest matching tier applies.
Can I stop people selling certain items?
Use blacklist (materials, names, lore, custom model data, plugin data keys) and auction.price-limits for price floors and ceilings per item.
Where are the docs?
README · Release notes · Issues

















DonutAuctionHouse is licensed under Apache-2.0. The Outfit and Inter fonts used in this artwork are licensed under the SIL Open Font License 1.1. Screenshots are unedited captures of the vanilla Minecraft client on a Paper server running the plugin. DonutAuctionHouse is an independent project and is not affiliated with Mojang, Microsoft or any server it takes inspiration from.
评论 0
登录后参与评分
还没有评论,来抢沙发吧