PlayerAuctions
PlayerAuctions 是一款面向 PaperMC 服务器的现代化且功能丰富的拍卖行插件。它提供了一个强大、直观且可扩展的平台,让玩家能够安全地买卖物品,并完全兼容基于 Vault 的经济系统与 PlaceholderAPI。

✨ 概览
PlayerAuctions 为玩家提供了一个强大、直观且可扩展的平台,用于安全地买卖物品。该插件完全集成了基于 Vault 的经济系统以及最新的 Paper 1.21 API,为您的服务器带来高品质的市场交易体验。
v3.1.0 更新亮点:
- 邮箱集成:取消的拍卖和已售物品的收益将安全路由至玩家的个人邮箱,彻底解决背包管理难题!
- 云命令框架 (CCF):提供极高可靠性、零延迟的命令体验,并具备智能 Tab 补全功能。
- 冒险风格 MiniMessage:支持 100% 原生 MiniMessage GUI 物品格式化,包括十六进制颜色、渐变色以及自动去除斜体。
- 严格适配 Paper 1.21:放弃对旧版本的支持,以实现最大性能并消除冗余代码。
? 核心功能
? 邮箱系统(新增)
再也不用担心玩家背包已满时物品掉落的问题!
- 取消挂单恢复:取消正在进行的拍卖后,物品会安全存入邮箱。
- 收益入账通知:物品售出后,向卖家邮箱发送“收益通知”。领取该通知即可存入 Vault 货币——相当于提供令人满意的交易回执。
- 过期保护:物品在可配置的时间后(默认:30 天)自动过期。
? 全局广播通知
- 保持经济活跃!当物品上架和成交时进行广播。
- 可点击链接:直接在聊天中点击“查看拍卖”。
- 可配置范围:支持广播至 GLOBAL(全局)、WORLD(当前世界)或 NONE(无)。
? 高品质 GUI 界面
- 原生 MiniMessage 支持:完全支持十六进制 RGB 颜色和渐变效果,应用于边框、标题和格式设置。
- 智能分类筛选:快速在方块、工具、武器等类别之间切换。
- 动态排序:支持按价格(升序/降序)、剩余时间和新上架进行排序。
- 搜索引擎:内置强大的游戏内搜索功能,用于过滤活跃物品。
?️ 安全交易
- 原子锁定:使用乐观数据库锁防止重复购买漏洞(竞态条件)。
- 持久化 JSON 存储:轻量级、并发安全的平面文件存储,写入时自动备份。
⌨️ 命令与权限
命令别名:
/ah、/auction、/auctionhouse
| 命令 | 描述 | 权限 | 默认值 |
|---|---|---|---|
/ah |
打开主拍卖行 GUI | playerauctions.use |
true |
/ah sell <price> [buy_now] [time] |
将手中的物品上架至拍卖行 | playerauctions.sell |
true |
/ah myauctions |
查看和管理您当前的挂售列表 | playerauctions.use |
true |
/ah mailbox |
打开邮箱领取金钱和物品 | playerauctions.use |
true |
/ah search <keyword> |
搜索特定物品 | playerauctions.search |
true |
/ah categories |
按预设分类浏览物品 | playerauctions.categories |
true |
/ah history [player] |
查看您(或他人)的交易历史 | playerauctions.history(.others) |
true (op) |
/ah notify <on/off> |
切换个人拍卖通知 | playerauctions.notify |
true |
/ah reload |
重载配置文件 | playerauctions.reload |
op |
管理员权限
playerauctions.admin- 授予所有管理命令及绕过限制。
? 配置指南
PlayerAuctions 高度模块化。请检查您的 config.yml 以自定义体验:
auction:
max-auctions-per-player: 5
tax-percentage: 5.0 # 从所有成功交易中扣除 5%
broadcast:
enabled: true
on-listing: true
on-purchase: true
range: GLOBAL # GLOBAL, WORLD, NONE
mailbox:
enabled: true
retention-days: 30 # 邮箱物品自动过期的天数
? 占位符 (PlaceholderAPI)
将统计数据集成到您的计分板或标签页列表中!
%playerauctions_total_auctions%- 追踪全局活跃的拍卖数量。%playerauctions_player_listings%- 追踪当前查看者的活跃挂售数量。
? 安装
- 确保您的服务器运行的是 Paper 1.21+。
- 安装 Vault 和经济插件(例如 EssentialsX)。
- 将
PlayerAuctions-3.1.0.jar放入plugins/文件夹。 - 重启服务器。
- (可选) 使用标准的
<color>MiniMessage 语法修改config.yml和messages.yml!
? 支持与问题反馈
由 MinekartaStudio 开发。
发现错误或需要支持?请通过我们的 GitHub 仓库的问题标签或 Discord 服务器联系我们。
PlayerAuctions
PlayerAuctions is a modern and feature-rich auction house plugin for PaperMC servers. It provides a robust, intuitive, and scalable platform for players to buy and sell items, fully integrated with Vault-based economies and PlaceholderAPI.

✨ Overview
PlayerAuctions provides a robust, intuitive, and scalable platform for players to buy and sell items securely. Fully integrated with Vault-based economies and the latest Paper 1.21 API, PlayerAuctions brings a premium marketplace experience to your server.
What's new in v3.1.0?
- Mailbox Integration: Canceled auctions and sold item revenues are securely routed to the player's personal mailbox, solving inventory management issues!
- Cloud Command Framework (CCF): Extremely reliable, zero-latency commands with intelligent Tab Completions.
- Adventure MiniMessage: 100% native MiniMessage GUI item formatting including Hex, Gradients, and auto-italic removal.
- Strictly Paper 1.21: Dropped legacy version support for maximum performance and zero bloat.
? Core Features
? Mailbox System (NEW)
No more dropped items when a player's inventory is full!
- Canceled Listing Recovery: Canceling an active auction routes the item safely into the Mailbox.
- Revenue Deposit Receipts: Sold items send a "Revenue Notification" to the seller's Mailbox. Claiming it deposits the Vault money—acting as a satisfying transaction receipt.
- Expiration Protection: Items automatically expire after a configurable duration (default: 30 days).
? Global Broadcast Notifications
- Keep the economy active! Broadcasts when items are listed and bought.
- Clickable Links: Click "View Auction" right in chat.
- Configurable Range: Broadcast to GLOBAL, WORLD, or NONE.
? Premium GUI Interface
- Native MiniMessage: Fully supports Hex RGB colors and gradients for borders, titles, and formats.
- Smart Category Filtering: Quickly jump between categories like Blocks, Tools, Weapons, etc.
- Dynamic Sorting: Sort auctions by Price (Ascending/Descending), Time Left, and Newest.
- Search Engine: In-game robust search to filter active items.
?️ Secure Transactions
- Atomic Locking: Prevents duplicate purchase exploits (race conditions) using optimistic database locking.
- Persistent JSON Storage: Lightweight, concurrent-safe flat-file storage with auto-backups on writes.
⌨️ Commands & Permissions
Command Aliases:
/ah,/auction,/auctionhouse
| Command | Description | Permission | Default |
|---|---|---|---|
/ah |
Opens the main Auction House GUI | playerauctions.use |
true |
/ah sell <price> [buy_now] [time] |
List the item in your hand on the AH | playerauctions.sell |
true |
/ah myauctions |
View and manage your current listings | playerauctions.use |
true |
/ah mailbox |
Open your Mailbox to claim money and items | playerauctions.use |
true |
/ah search <keyword> |
Search for a specific item | playerauctions.search |
true |
/ah categories |
Browse items by predefined categories | playerauctions.categories |
true |
/ah history [player] |
View your (or others') transaction history | playerauctions.history(.others) |
true (op) |
/ah notify <on/off> |
Toggle personal auction notifications | playerauctions.notify |
true |
/ah reload |
Reload configuration files | playerauctions.reload |
op |
Admin Permissions
playerauctions.admin- Grants all administrative commands and bypasses.
? Configuration Guide
PlayerAuctions is highly modular. Check your config.yml to customize the experience:
auction:
max-auctions-per-player: 5
tax-percentage: 5.0 # Removes 5% from all successful sales
broadcast:
enabled: true
on-listing: true
on-purchase: true
range: GLOBAL # GLOBAL, WORLD, NONE
mailbox:
enabled: true
retention-days: 30 # Days before Mailbox items auto-expire
? Placeholders (PlaceholderAPI)
Integrate statistics into your scoreboard or tablist!
%playerauctions_total_auctions%- Tracks globally active auctions.%playerauctions_player_listings%- Tracks the viewer's active listing count.
? Installation
- Ensure your server is running Paper 1.21+.
- Install Vault and an economy provider (e.g., EssentialsX).
- Drop
PlayerAuctions-3.1.0.jarinto yourplugins/folder. - Restart the server.
- (Optional) Modify
config.ymlandmessages.ymlusing standard<color>MiniMessage syntax!
? Support & Issues
Developed by MinekartaStudio. Found a bug or need support? Please reach out via our GitHub repository issues tab or our Discord server.
下载 PlayerAuctions
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerAuctions
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerAuctions
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerAuctions
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerAuctions
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerAuctions
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerAuctions
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerAuctions
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerAuctions
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerAuctions
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
3.1.0 版本(2026年2月25日)
新增
- 拍卖与邮箱集成:物品和收入现在通过邮箱系统进行安全路由!
- 取消拍卖:取消拍卖时,不再将退回的物品强制掉落在地上或占用背包空间,而是立即将物品发送至邮箱进行异步领取。
- 拍卖售出:当物品被购买后,收入将以独立的金钱通知形式发送给卖家的邮箱,而非直接出现在玩家的余额中。在邮箱中领取该金钱通知后,余额会无缝存入,同时作为交易已读的确认回执。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧