Donut Auction

插件

· 作者 NAIZO

一款受 DonutSMP 启发的 Paper/Folia 服务器甜甜圈拍卖行插件。

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

最新 2.0.1 · 26.3 · Bukkit / Folia

一键开服(送7天)

DonutAuctionHouse 2.0: The Market Update

你的玩家真正会使用的拍卖行

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 版本上使用真实客户端进行测试。

Browsing and buying on the market

divider

The Market

The whole market in one menu

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

Selling

Sell in seconds

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

快速出售(/ah fastsell)会跳过菜单,直接列出并一次性使用你上次的持续时间。

拍卖行

真实的拍卖行,完美呈现

  • 使用 /ah auction <起拍价> 开始一次拍卖,或将售卖菜单切换为拍卖。

  • 竞价菜单提供最低下一次出价、+10%、+25% 或自定义输入金额。新出价必须比当前出价高出至少 5% 或 1(可配置),取两者中较大值。

  • 托管交易:竞拍者出价时,其资金会被暂时冻结。若有人出更高价格将其击败,资金将立即退还并通知该竞拍者。

  • 反狙击:在拍卖最后 30 秒内的出价会延长拍卖时间,从而防止最后一秒的狙击行为。

  • 仅结算一次:拍卖结束后,出价最高者获胜并支付款项(扣除税费)。此操作仅执行一次,即使多个服务器共享同一个 MySQL 数据库也是如此;若支付过程中断,将在下次启动时继续完成。

  • 如果获胜者在线且物品能够放入背包,则立即获得该物品;否则,物品将暂存于 /ah collect 中等待领取。

价格洞察

知道它的价值

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

通知

不错过任何交易

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

合集

Nothing is ever lost

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

Economy & Rules

Your economy, your rules

设置项 功能说明
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 禁用的世界和受限的游戏模式(默认禁用创造模式和旁观者模式),以及上架冷却时间。

在启用之前,税费和手续费均处于关闭状态。每条规则都配有供工作人员使用的绕过权限。

Built to Be Safe

Dupe-safe by design

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

Integrations

Plays well with others

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

Staff Tools

Moderate the market

  • 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/ 中,记录每一次上架、售出、出价、中标、取消和收回操作。

Configuration

Make it yours

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

Compatibility

Tested on every version

服务器 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 服务器上运行自动化矩阵测试,涉及真实客户端进行列表查看、购买、竞价和获胜。

Commands & Permissions

命令 功能 权限
/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.* 权限仍然有效。

Questions

它真的免费吗? 是的,全部免费:拍卖、税费、价格洞察、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

Gallery

市场界面,显示上架物品的附魔、价格、卖家和剩余时间

带有实时竞价的拍卖

购买前预览潜影盒内容

五种排序方式

分类和上架类型过滤器

确认购买,并显示购买后的余额

竞价菜单

已出价:资金由托管方保管,若有人出更高价则退款给你

售价菜单中的价格洞察

上架前的费用和收益预览

我的物品:已过期的上架物品,可取回或重新上架

你的交易汇总

物品售出瞬间

手持物品的拍卖行价格查询

交易历史

管理员视图:右键点击以移除上架商品


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

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源