
玩家早已熟悉的订单板,现已安全无忧
DonutOrders 是一款免费、开源的购买订单插件,适用于 Paper、Folia 和 Purpur,支持 Minecraft 1.20.1 至 26.3。
玩家发布他们想要的物品及每件物品的报酬,资金会立即被锁定。任何人都可以打开
/orders,放入物品并当场获得报酬,或者通过一条命令将所有物品出售给出价最高的订单。
买家会收到通知,随时可领取,也可以提高价格、添加物品或取消订单以退款。
每一笔交付、取消和过期都涉及数据库更新,且只有在一台服务器上的一次点击才能胜出。资金仅在更新完成后才会转移。
2.0 "The Supply Update" 是一次全面的重构。它新增了 SMP 订单板排序、/orders sell、潜影盒交付、价格洞察、订单编辑、服务器订单、跨服务器通知、Discord 集成、PlaceholderAPI 支持以及开发者 API。每个版本都在所有受支持的 Paper 和 Folia 版本上经过真实客户端测试。




- 四种玩家预期的排序方式:单件物品金额、最新发布、最多交付、最高支付。“即将到期”为第五种。
- 九大分类:方块、工具、食物、战斗、药水、书籍、材料、实用工具和刷怪笼。
- 搜索:按物品、附魔(如
mending)或玩家搜索:/orders diamond。
- 仅显示我能交付的订单:一键隐藏所有你没有对应物品的订单。
- 每个订单均显示买家、单价、进度条、剩余需求、已支付金额及剩余时间。
- 物品和附魔名称会根据每位玩家的偏好语言显示。


- 点击一个订单。交付菜单仅接受该订单所需的物品;错误的物品会在槽位中被拒绝。
- 放入物品,或点击从背包中添加。交付按钮会显示扣税后的收入。
- 点击交付即可立即获得报酬。订单不需要的物品会自动退回。
在订单板上Shift+点击订单可直接从背包交付而无需打开任何界面。潜影盒会自动打开:订单取走所需物品,其余物品仍留在盒中返回。


/orders sell 将手中的物品出售给出价最高的订单。/orders sell all 将出售所有有订单需求的物品。
- 确认界面会显示多少物品分配给多少个订单、价值多少、税费及最终所得。
- 订单板也提供出售给订单按钮。
- 对于服务器所有者:其他插件可通过 API 将
/sell 路由到订单系统中,确保玩家始终获得服务器内的最优价格。


- 物品选择器:列出服务器中的所有物品,按分类或搜索筛选,优先展示畅销品。
- 附魔书:选择附魔类型和等级。列表来自服务器数据,因此新加入的和数据包附魔也会包含在内。
- 订购手中物品:药水、山羊角、自定义物品等带有变体的物品均可订购。仅精确匹配的物品才算数。
- 数量按钮或手动输入数字;手动输入价格(支持
2.5k、1m 和 3b);时长可选 1 小时至 30 天(可配置,更高权限可延长)。
- 确认按钮会显示为卖家锁定的金额、手续费及之后的余额。
- 或直接跳过菜单:
/order create diamond 640 95 7d。


- 新建订单菜单会显示近期交付的平均价、价格区间和最新成交价,以及交付量。
- 还会显示开放需求:有多少订单需要该物品以及订单板上的最高报价。
- 超越竞价将你的价格设为略高于最佳订单;使用平均值则将其设为市场均价。
- 当你的价格远高于平均值时(三倍及以上,可配置),会出现警告。顶部薄弱的订单无法欺骗你的玩家。
/orders price 会告诉你手中物品的售价。PlaceholderAPI 同样支持:
%donutorders_best_DIAMOND%、%donutorders_average_DIAMOND%。


/order 列出你的订单,显示可领取的物品以及仍被冻结的资金。
- Collect(领取)单个订单,或 Collect all(全部领取)。物品仅以能完整放入背包的堆叠数量发放;剩余部分暂存等待。
- Change an order(修改订单):添加物品、提高或降低价格、增加时间。差价会即时扣款或退款。无需重新开始即可超越竞争对手。
- Cancel(取消)可立即退还所有冻结资金。已送达的物品仍可领取。
- Mailbox(邮箱):存放无法放入你背包的物品。History(历史):记录你完成的订单、交付记录和累计总额。


- Delivered(已交付):显示谁交付了多少,以及你的进度。繁忙时每个订单只发送一行通知,而不是五十行。支持聊天栏、动作栏或两者同时显示。
- Order filled(订单已完成):触发标题提示和音效。
- While you were away(你离开期间):在你加入服务器时汇总显示交付情况、已完成的订单和退款信息。
- Across servers(跨服务器):买家会在其所在的任何服务器上收到通知。
- New orders(新订单)会通过可点击的 [Deliver](交付)按钮进行公告(最低价值和冷却时间可配置)。
/order alerts 可为希望保持安静的玩家屏蔽警报和公告。


| 设置项 |
功能说明 |
economy.creation-fee |
创建订单时的固定费用及/或百分比费用,设有上限,取消时可退款,并拥有豁免权限。 |
economy.seller-tax |
每笔 payout 中抽取的部分分成。通过权限层级降低税率(例如 donutorders.tax.vip: 2.5);deposit-to 可将费用和税款支付到服务器账户。 |
orders.price-limits |
按材质或书籍设定的每件物品的最低和最高价格(例如 DIAMOND: {min: 50})。此外还限制数量和总价值上限。 |
limits |
每位玩家的开放订单数量:默认值(18)、donutorders.limit.<n> 权限,以及 LuckPerms 组别。 |
durations |
玩家可选的时长选项、最大时长,以及通过权限获得的更长最大时长。 |
matching |
重命名、佩戴、附魔或自定义物品是否计入普通订单,以及书籍如何匹配。 |
blacklist / whitelist |
材质(支持通配符如 *_SPAWN_EGG)、名称、lore、模型数据和插件数据。 |
restrictions |
禁用的世界和游戏模式、创建冷却时间,以及供管理员使用的冻结开关。 |
费用和税费默认关闭,需手动开启。每条规则都配有供管理员 bypass(绕过)的权限。


- One winner per action(每项操作只有一个赢家)。交付、取消、过期、编辑和领取均为条件性数据库更新。双击、延迟或多个服务器同时操作无法导致订单超额、重复付款或重复退款。
- Tested, not promised(经测试验证,非空口承诺)。两个服务器上的卖家在同一时刻向同一订单出售物品。系统精确交付了所需数量,精确收取了相应款项,其余物品退回。
- Money follows the database(资金跟随数据库)。冻结资金由关闭订单的同一更新释放,因此退款只会发生一次。
- Items in transit are tracked(在途物品全程追踪):直到物品交付或退回,即使玩家下线、死亡或服务器停止运行也会持续追踪。
- Folia-safe(兼容 Folia):库存仅在玩家所属线程上更改。
- Upgrade-proof(升级无忧):物品以 Paper 的版本化格式存储,因此订单可随 Minecraft 版本更新而保留。
- Matching that cannot be gamed(无法作弊的匹配机制):“超级钻石”永远不会被当作普通钻石出售,满的潜影盒也永远不会被当作空的出售。


- Discord webhooks:新订单、交付、完成、取消和过期的订单,以及可疑交付。可选择事件类型和最低价值阈值。
- PlaceholderAPI:
| 占位符 |
值 |
%donutorders_active%, %donutorders_limit%, %donutorders_slots_left% |
你的开放订单数量和限额 |
%donutorders_collect% |
等待你领取的物品 |
%donutorders_delivered%, %donutorders_earned% |
你交付的物品和你获得的收益 |
%donutorders_received%, %donutorders_spent% |
你接收的物品和你支付的金额 |
%donutorders_market_active%, %donutorders_market_value% |
整个市场板 |
%donutorders_best_<ITEM>%, _average_<ITEM>%, _demand_<ITEM>%, _orders_<ITEM>% |
每种物品的价格和需求量 |
- Developer API:
DonutOrdersApi 用于读取订单和最佳价格,并将物品售出到订单中(销售路由)。它还用于创建服务器订单。事件包括:可取消的 pre-create(预创建)和 pre-deliver(预交付),以及 created(已创建)、delivered(已交付)和 closed(已关闭)。
- Server orders(服务器订单):使用
/orderadmin server wheat unlimited 3 7d 可增加由服务器付费的需求,适用于活动和物品回收场景。
- 支持 Vault 和 VaultUnlocked 经济系统、LuckPerms 组别、MySQL 或 MariaDB(可选 Redis),以及 bStats。


- 在订单板上Shift+右键任意订单即可取消。买家会收到退款,并得知取消原因。
/orderadmin view <player> 和 history <player>:查看某玩家的订单和历史记录。
/orderadmin cancel <id> [reason]、info(存储、待处理订单、数据库总计)、purge <days>。
- 冻结市场以进行维护或经济重置,之后可解冻。
- 同一连接下的玩家间出现可疑交付时,会向工作人员和 Discord 发出警报,或直接拦截。
plugins/DonutOrders/logs/ 中的每日交易日志记录了每一笔订单的创建、交付、编辑、领取和退款。


- 替换 jar 包并重启服务器。待处理的订单会保留其持有的资金,而 1.x 暂存箱中等待的物品变为可领取状态。
- 那些资金从未退款的过期 1.x 订单将自动获得一次退款。
- 你的限制、权限组限制、过期时间、税费、广播、数据库配置和项目列表会自动迁移至新的
config.yml。旧文件保留在 legacy-1.x/ 目录中,1.x 的数据表保持不变。

config.yml 包含完整注释:存储与同步、价格与限制、时长、费用与税费、匹配、交付、规则、洞察、通知、广播、菜单、音效、Discord。更新时会自动添加新设置项,且保留你原有的配置值。
messages.yml 包含了玩家看到的所有文字,包括菜单文本。支持使用 MiniMessage、& 代码或 &#RRGGBB 十六进制颜色码,并可自由混用。菜单标题和按钮可选小大写字母,如同大型 SMP 服务器那样。玩家生成的文本无法添加颜色或点击事件。
- 可在
menus.buttons 下更改任何按钮的物品和资源包模型。
/orderadmin reload 无需重启即可应用所有更改。


| 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 in 2.0: they lack Paper's API. The plugin says so and disables itself. |
- 需要安装 Vault 或 VaultUnlocked 以及一个经济插件(如 EssentialsX、CMI 等)。
- 可选依赖:PlaceholderAPI、LuckPerms、MySQL 或 MariaDB,以及 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。真实客户端会在每个版本上执行创建、交付、出售、领取、取消和过期订单的操作。
- 第二组测试在两个服务器上共用同一个 MySQL 数据库。

| Command |
What it does |
Permission |
/orders (/market) |
The order board |
donutorders.use |
/orders <search> |
Orders for an item, enchantment or player |
donutorders.use |
/orders sell [all] |
Sell to the best orders |
donutorders.sell |
/orders price |
What the held item sells for |
donutorders.use |
/orders view <player> |
A player's open orders |
donutorders.use |
/order |
Your orders: collect, change, cancel |
donutorders.use |
/order new |
Create an order from the item picker |
donutorders.create |
/order create <item|hand> <amount> <price> [time] |
Create without menus |
donutorders.create |
/order collect, mailbox, history, alerts, cancel <id> |
Shortcuts |
donutorders.use |
/orderadmin view|history|cancel|server|purge|info|freeze|reload |
Staff tools |
donutorders.admin |
限制使用 donutorders.limit.<n>(或 .unlimited)。创建当前手持物品的精确订单需要 donutorders.create.exact 权限。
1.x 的权限节点和 %donutorders_order_limit% 占位符仍兼容可用。

真的免费吗?
是的,全部功能免费:订单板、向订单出售物品、潜影盒交付、价格洞察、编辑、服务器订单、Webhook、PlaceholderAPI、跨服务器支持和 API。源代码托管在 GitHub 上,采用 Apache-2.0 许可证。
我从 1.x 升级,会丢失任何东西吗?
不会。待处理的订单、持有的资金、暂存物品以及你的设置都会迁移过来,旧文件也会保留。像任何更新一样,请先备份你的数据库。
它能在 Spigot 上运行吗?
从 2.0 开始不再支持。DonutOrders 使用了 Paper 的 API(Adventure 文本、区域调度器)。Spigot 可以无缝替换为 Paper,Purpur 和其他 Paper 分支也能正常工作。
玩家能利用它刷物品或金钱吗?
每一次交付、取消、过期、编辑和领取都是条件性的数据库更新,且只有一个动作能成功。资金只有在操作完成后才会转移。运输中的物品会被追踪,直到交付或退回,绝不会掉落在地上。如果你发现了漏洞,请私下报告(详见 GitHub 上的 SECURITY.md)。
如何防止有人将改名或自定义物品当作真品出售?
普通订单默认拒绝接受改名、磨损或自定义物品(自定义模型数据、插件数据、lore),每项均可单独配置。精确订单则比对整个物品,或自定义物品插件的 ID。
如何在一组服务器之间共享同一个订单板?
在每个服务器上设置 storage.type: MYSQL 并指向同一个数据库。可选地启用 sync.redis 以实现即时同步更新。买家会在他们所在的服务器上收到配送通知。
我的 /sell 插件可以将物品出售给订单吗?
可以。DonutOrdersApi#sellToOrders 会将物品出售给出价最高的订单,并将剩余未售出的物品返还给你。bestPrice 会显示订单愿意支付的价格。
文档在哪里?
README ·
发行说明 ·
问题反馈















DonutOrders 采用 Apache-2.0 许可证授权。本作品中使用的 Outfit 和 Inter 字体遵循 SIL Open Font License 1.1 授权。截图均为在运行该插件的 Paper 服务器上运行的原版 Minecraft 客户端的原始捕获画面。DonutOrders 是一个独立项目,与 Mojang、Microsoft 或任何为其提供灵感的服务端无关。

The order board your players already know, made safe
DonutOrders is free, open-source buy orders for Paper, Folia and Purpur, from Minecraft 1.20.1 to 26.3.
A player posts what they want and what they pay for each item, and the money is held right away. Anyone can open
/orders, drop the items in and get paid on the spot, or sell everything into the best orders with one command. The
buyer is told, collects whenever they like, and can raise the price, add items or cancel for a refund.
Every delivery, cancel and expiry is a database update that only one click, on one server, can win. Money moves only
after it does.
2.0 "The Supply Update" is a full rebuild. It adds the SMP board sorts, /orders sell, shulker delivery, price
insight, order editing, server orders, cross-server notifications, Discord, PlaceholderAPI and a developer API. Each
release is tested on every supported Paper and Folia version with real clients.




- The four sorts players expect: Money Per Item, Recently Listed, Most Delivered, Most Paid. Ending Soon is a
fifth.
- Nine categories: blocks, tools, food, combat, potions, books, ingredients, utilities and spawners.
- Search by item, enchantment (
mending) or player: /orders diamond.
- Only what I can deliver: one click hides every order you have nothing for.
- Each order shows the buyer, the price each, a progress bar, what is still wanted, what has been paid out and the
time left.
- Item and enchantment names appear in each player's own language.


- Click an order. The delivery menu only takes items the order accepts; wrong items are refused at the slot.
- Drop items in, or click Add from inventory. The Deliver button shows what you will receive, after tax.
- Click Deliver and you are paid at once. Anything the order did not need comes straight back.
Shift-click an order on the board to deliver from your inventory without opening anything. Shulker boxes are
opened for you: the order takes what it wants, and the box comes back with the rest still inside.


/orders sell sells the item in your hand to the best-paying orders. /orders sell all sells everything any order
wants.
- A confirmation shows how many items go to how many orders, what they are worth, the tax and what you get.
- The board has a Sell to orders button too.
- For server owners: other plugins can route
/sell into orders through the API, so players always get the best
price on the server.


- The item picker lists every item your server has, by category or search, with your best sellers first.
- Enchanted books: pick the enchantment and level. The list comes from the server, so new and data-pack
enchantments are there.
- Order the item in your hand: potions, goat horns, custom items, anything with variants. Only that exact item
counts.
- Amount buttons or a typed number; a typed price (
2.5k, 1m and 3b work); a duration from 1 hour to 30 days
(configurable, longer by permission).
- The confirm button shows what is held for sellers, the fee and your balance afterwards.
- Or skip the menus:
/order create diamond 640 95 7d.


- The new-order menu shows the average, range and last price recent deliveries got, and how much was
delivered.
- It also shows open demand: how many orders want the item and the best price on the board.
- Outbid sets your price just above the best order; Use the average sets it to the market.
- A warning appears when your price is far above the average (three times, configurable). Thin top orders cannot
fool your players.
/orders price tells you what the item in your hand sells for. PlaceholderAPI has it too:
%donutorders_best_DIAMOND%, %donutorders_average_DIAMOND%.


/order lists your orders with what is ready to collect and the money still held.
- Collect one order, or Collect all. Items are only handed over as whole stacks that fit; the rest waits.
- Change an order: add items, raise or lower the price, add time. The difference is charged or refunded on the
spot. Outbid the competition without starting over.
- Cancel for an instant refund of the money still held. Delivered items stay ready to collect.
- Mailbox: anything that did not fit in your inventory. History: your finished orders, your deliveries and
your lifetime totals.


- Delivered: who delivered how many, and your progress. A busy order sends one line, not fifty. Chat, action
bar or both.
- Order filled: a title and a sound.
- While you were away: deliveries, filled orders and refunds, summarised when you join.
- Across servers: buyers are told on whichever server they are on.
- New orders are announced with a clickable [Deliver] button (minimum value and cooldown configurable).
/order alerts mutes alerts and announcements for players who want quiet.


| Setting |
What it does |
economy.creation-fee |
A flat fee and/or a percentage when creating an order, with a cap, a refund on cancel and an exempt permission. |
economy.seller-tax |
A share of every payout. Permission tiers lower it (donutorders.tax.vip: 2.5); deposit-to pays fees and tax to a server account. |
orders.price-limits |
Minimum and maximum price per item, by material or book (DIAMOND: {min: 50}). Plus caps on amount and total value. |
limits |
Open orders per player: a default (18), donutorders.limit.<n>, and LuckPerms groups. |
durations |
The choices players get, a maximum, and longer maximums by permission. |
matching |
Whether renamed, worn, enchanted or custom items count for plain orders, and how books match. |
blacklist / whitelist |
Materials (with wildcards like *_SPAWN_EGG), names, lore, model data and plugin data. |
restrictions |
Disabled worlds and game modes, a creation cooldown, and a freeze switch for staff. |
Fees and tax are off until you turn them on. Every rule has a bypass permission for staff.


- One winner per action. Deliveries, cancels, expiries, edits and collections are conditional database updates.
Double clicks, lag and two servers at once cannot overfill an order, pay twice or refund twice.
- Tested, not promised. Two sellers on two servers sold into the same order at the same moment. Exactly what
it wanted was delivered, exactly that was paid, and the rest went back.
- Money follows the database. The held money is released by the same update that closes the order, so a refund
happens exactly once.
- Items in transit are tracked until they are delivered or handed back, through logouts, deaths and server
stops.
- Folia-safe: inventories only change on the player's own thread.
- Upgrade-proof: items are stored in Paper's versioned format, so orders survive Minecraft updates.
- Matching that cannot be gamed: a custom "Super Diamond" is never sold as a diamond, and a full shulker box is
never sold as an empty one.


- Discord webhooks: new orders, deliveries, filled, cancelled and expired orders, and suspicious deliveries.
Pick the events and a minimum value.
- PlaceholderAPI:
| Placeholder |
Value |
%donutorders_active%, %donutorders_limit%, %donutorders_slots_left% |
Your open orders and limit |
%donutorders_collect% |
Items waiting for you |
%donutorders_delivered%, %donutorders_earned% |
Items you delivered and what you earned |
%donutorders_received%, %donutorders_spent% |
Items you received and what you paid |
%donutorders_market_active%, %donutorders_market_value% |
The whole board |
%donutorders_best_<ITEM>%, _average_<ITEM>%, _demand_<ITEM>%, _orders_<ITEM>% |
Prices and demand per item |
- Developer API:
DonutOrdersApi reads orders and best prices, and sells items into orders (sell routing).
It also creates server orders. Events: cancellable pre-create and pre-deliver, plus created, delivered and closed.
- Server orders:
/orderadmin server wheat unlimited 3 7d adds demand paid by the server, for events and item
sinks.
- Vault and VaultUnlocked economies, LuckPerms groups, MySQL or MariaDB with optional Redis, and bStats.


- Shift-right-click any order on the board to cancel it. The buyer gets the money back and is told why.
/orderadmin view <player> and history <player>: a player's orders and history.
/orderadmin cancel <id> [reason], info (storage, open orders, database totals), purge <days>.
- Freeze the market for maintenance or an economy reset, then unfreeze it.
- Suspicious deliveries between players on one connection alert staff and Discord, or are blocked.
- A daily transaction log in
plugins/DonutOrders/logs/ records every order, delivery, edit, collection and
refund.


- Replace the jar and restart. Open orders keep their held money, and items waiting in 1.x stashes become
collectable.
- Expired 1.x orders whose money was never refunded are refunded once.
- Your limits, rank limits, expiry, tax, broadcast, database and item list are carried into the new
config.yml.
The old files are kept in legacy-1.x/, and the 1.x tables are left untouched.

config.yml is fully commented: storage and sync, prices and limits, durations, fees and tax, matching, delivery,
rules, insight, notifications, broadcasts, menus, sounds, Discord. New settings are added automatically when you
update; your values are kept.
messages.yml has every word players see, menus included. Use MiniMessage, & codes or &#RRGGBB hex, mixed
freely. Optional small caps in menu titles and buttons, as on the big SMP servers. Player-made text can never add
colors or click events.
- Change any button's item and resource-pack model under
menus.buttons.
/orderadmin reload applies everything 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 in 2.0: 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, LuckPerms, MySQL or MariaDB, 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 servers: 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, and Folia 1.20.4, 1.21.4, 1.21.11 and 26.3. Real clients create, deliver, sell,
collect, cancel and expire orders on each.
- A second test runs two servers on one MySQL database.

| Command |
What it does |
Permission |
/orders (/market) |
The order board |
donutorders.use |
/orders <search> |
Orders for an item, enchantment or player |
donutorders.use |
/orders sell [all] |
Sell to the best orders |
donutorders.sell |
/orders price |
What the held item sells for |
donutorders.use |
/orders view <player> |
A player's open orders |
donutorders.use |
/order |
Your orders: collect, change, cancel |
donutorders.use |
/order new |
Create an order from the item picker |
donutorders.create |
/order create <item|hand> <amount> <price> [time] |
Create without menus |
donutorders.create |
/order collect, mailbox, history, alerts, cancel <id> |
Shortcuts |
donutorders.use |
/orderadmin view|history|cancel|server|purge|info|freeze|reload |
Staff tools |
donutorders.admin |
Limits use donutorders.limit.<n> (or .unlimited). Ordering the exact held item needs donutorders.create.exact.
The 1.x permissions and %donutorders_order_limit% keep working.

Is it really free?
Yes, all of it: the board, selling into orders, shulker delivery, price insight, editing, server orders, 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. Open orders, held money, stashed items and your settings are carried over, and the old files are kept. Back up
your database first, as with any update.
Does it work on Spigot?
Not since 2.0. DonutOrders 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 or money with it?
Every delivery, cancel, expiry, edit and collection is a conditional database update that only one action can win.
Money moves only after it. Items in transit are tracked until they are delivered or handed back, and nothing is ever
dropped on the ground. If you ever find a way, please report it privately (see SECURITY.md on GitHub).
What stops someone selling a renamed or custom item as the real thing?
Plain orders refuse renamed, worn and custom items (custom model data, plugin data, lore) by default, and each is a
setting. Exact orders compare the whole item, or a custom-item plugin's id.
How do I share one board between servers?
Set storage.type: MYSQL on every server with the same database. Optionally enable sync.redis for instant
updates. Buyers are told about deliveries on whichever server they are on.
Can my /sell plugin sell into orders?
Yes. DonutOrdersApi#sellToOrders sells items into the best orders and hands back what no order wanted.
bestPrice tells you what orders pay.
Where are the docs?
README ·
Release notes ·
Issues















DonutOrders 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. DonutOrders is an independent project and is not affiliated with Mojang, Microsoft or any server it takes
inspiration from.
评论 0
登录后参与评分
还没有评论,来抢沙发吧