Donut Orders

插件

· 作者 NAIZO

一个由玩家驱动的购买订单市场。

0 本站下载 0 关注 更新于 3 周前

最新 2.0.0 · 26.3 · Folia / Paper

一键开服(送7天)

DonutOrders 2.0: The Supply Update

玩家早已熟悉的订单板,现已安全无忧

DonutOrders 是一款免费、开源的购买订单插件,适用于 Paper、Folia 和 Purpur,支持 Minecraft 1.20.1 至 26.3。

玩家发布他们想要的物品及每件物品的报酬,资金会立即被锁定。任何人都可以打开 /orders,放入物品并当场获得报酬,或者通过一条命令将所有物品出售给出价最高的订单。 买家会收到通知,随时可领取,也可以提高价格、添加物品或取消订单以退款。

每一笔交付、取消和过期都涉及数据库更新,且只有在一台服务器上的一次点击才能胜出。资金仅在更新完成后才会转移。

2.0 "The Supply Update" 是一次全面的重构。它新增了 SMP 订单板排序、/orders sell、潜影盒交付、价格洞察、订单编辑、服务器订单、跨服务器通知、Discord 集成、PlaceholderAPI 支持以及开发者 API。每个版本都在所有受支持的 Paper 和 Folia 版本上经过真实客户端测试。

Delivering ender pearls, including a shulker box full of them

divider

The Board

Every order in one place

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

Delivering

Deliver in two clicks

  1. 点击一个订单。交付菜单仅接受该订单所需的物品;错误的物品会在槽位中被拒绝。
  2. 放入物品,或点击从背包中添加。交付按钮会显示扣税后的收入。
  3. 点击交付即可立即获得报酬。订单不需要的物品会自动退回。

在订单板上Shift+点击订单可直接从背包交付而无需打开任何界面。潜影盒会自动打开:订单取走所需物品,其余物品仍留在盒中返回。

Selling

Sell everything in one command

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

New Orders

Order anything

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

Price Insight

Know what to pay

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

Your Orders

Nothing is ever lost

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

Notifications

Never miss a delivery

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

Economy & Rules

Your economy, your rules

设置项 功能说明
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(绕过)的权限。

Built to Be Safe

Dupe-safe by design

  • 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(无法作弊的匹配机制):“超级钻石”永远不会被当作普通钻石出售,满的潜影盒也永远不会被当作空的出售。

Integrations

Plays well with others

  • 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。

Staff Tools

Moderate the board

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

Upgrading from 1.x

Upgrade in place

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

Configuration

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

Compatibility

Tested on every version

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 数据库。

Commands & Permissions

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% 占位符仍兼容可用。

Questions

真的免费吗? 是的,全部功能免费:订单板、向订单出售物品、潜影盒交付、价格洞察、编辑、服务器订单、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 或任何为其提供灵感的服务端无关。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源