拍卖行
一款快速、基于图形界面的拍卖行插件,用于购买、出售和浏览物品——只需输入 /ah。
将手中的物品上架,通过分页菜单浏览其他玩家的挂售商品,按类别搜索或筛选,按价格或上架时间排序,查看当前正在出售的物品,并回顾完整的交易历史。无需放置告示牌或设置箱子——所有功能均由一个命令完成。
支持 Bukkit、Spigot、Paper 以及 Folia。
功能
-
手持出售 — 手持物品并输入 /ah sell <价格> 即可上架。支持 5k 和 2.5m 等价格后缀。
-
可选的上架确认 — 在物品离开你的手之前,会显示一个确认界面,展示价格、手续费和净收益(可切换开启/关闭)。
-
分页浏览菜单 — 每 60 秒自动刷新,以防止已售出或过期的上架信息滞留。
-
排序 — 最新优先、最旧优先、价格最低优先或价格最高优先。
-
按类别筛选 — 方块、工具、武器、盔甲、食物、药水、书籍,或其他所有内容。
-
搜索 — 搜索整个拍卖行,或仅搜索您自己的交易历史。
-
查看其他玩家的物品列表 — /ah view <player> 打开仅显示其物品的筛选视图。
-
潜影盒预览 — 右键点击已上架的潜影盒即可在购买前查看内部物品,而不会在列表中泄露内容。
-
My Items 菜单 — 查看你当前列出的所有物品,取消上架以收回物品,并直接进入你的历史记录。
-
交易记录 — 每位玩家的每笔买卖都会被记录,并累计显示其支出与收入总额。
-
每位玩家上架数量上限 — 默认限制活跃上架商品的数量,可通过权限节点按等级提升上限(详见下文)。
-
可配置拍卖手续费 — 从每笔交易中抽取一定比例的分成,或设为 0%,让卖家保留全部售价。
-
实时过期机制 — 上架商品在设定时长后(默认 7 天)自动过期,无论服务器在此期间是否在线。
-
安全的离线退回 — 若卖家离线期间商品过期,物品将被暂时保管,并在其下次登录时自动退还。
-
黑名单 — 禁止特定材料被上架。
-
完全自定义的菜单与消息 — 所有菜单布局、物品样式、颜色及提示信息均可通过 YAML 文件编辑,包括支持十六进制颜色代码。
-
多语言支持 — 提供独立的语言文件夹(包含英语和德语),可在配置文件中进行选择。
-
灵活的存储方式 — 支持 YAML(默认,人类可读)、SQLite 或 MySQL(用于在多个服务器间共享一个拍卖行)。来自 Auction 1.x 的旧数据会自动迁移。
-
Vault 经济系统支持 — 兼容任何与 Vault 挂钩的经济插件。
-
PlaceholderAPI 支持 — 在支持占位符的任何地方暴露实时拍卖数据(见下文)。
命令
| 命令 |
描述 |
/ah |
打开拍卖行 |
/ah sell <价格> |
上架你手中的物品 |
/ah search <文本> |
搜索所有商品列表 |
/ah view <玩家> |
查看特定玩家的挂售列表 |
/ah history [文本] |
查看(或搜索)你的交易历史 |
/ah mine |
查看你自己的活跃挂售列表 |
/ah reload |
重新加载配置文件和菜单 |
别名:/auction、/auctionhouse
权限
| 权限 |
默认值 |
描述 |
auction.use |
所有玩家 |
使用拍卖行 |
auction.mute |
false |
隐藏该玩家的“玩家上架物品”广播消息 |
auction.reload |
op |
重新加载配置和菜单 |
auction.listings.<number> |
— |
将该玩家的最大活跃上架数量提升至 <number>(仅允许高于配置中默认数量的数值;持有最高节点的玩家优先) |
PlaceholderAPI 占位符
需要 PlaceholderAPI 和 auction 扩展。
| 占位符 |
返回值 |
%auction_listings% |
当前活跃挂牌总数 |
%auction_highest% |
最高活跃挂牌价格(格式化) |
%auction_highest_raw% |
最高活跃挂牌价格(原始数值) |
%auction_lowest% |
最低活跃挂牌价格(格式化) |
%auction_lowest_raw% |
最低活跃挂牌价格(原始数值) |
%auction_mine% |
查看者玩家当前的挂牌数量 |
%auction_mine_value% |
查看者玩家所有挂牌的总价值(格式化) |
%auction_mine_value_raw% |
查看者玩家所有挂牌的总价值(原始数值) |
%auction_history% |
查看者玩家历史交易次数 |
%auction_returns% |
等待查看者玩家处理的待退货数量 |
依赖
- Vault(软依赖)— 任何经济功能正常运行所必需
- PlaceholderAPI(软依赖)— 仅在使用上述占位符时需要
Auction House
A fast, GUI-based auction house plugin for buying, selling, and browsing items — just type /ah.
List an item from your hand, browse everyone else's listings in a paginated menu, search or filter by category, sort by price or age, check what you're currently selling, and look back through your full trade history. No signs, no chests to set up — it all runs from one command.
Supports Bukkit, Spigot, Paper, and Folia.
Features
- In-hand selling — hold an item and type
/ah sell <price> to list it. Price suffixes like 5k and 2.5m are supported.
- Optional listing confirmation — a confirm screen shows the price, fee, and net payout before the item leaves your hand (togglable).
- Paginated browse menu — auto-refreshes every 60 seconds so sold or expired listings don't sit around.
- Sort — newest first, oldest first, cheapest first, or most expensive first.
- Filter by category — blocks, tools, weapons, armour, food, potions, books, or everything else.
- Search — search the whole auction house, or search just your own transaction history.
- View another player's listings —
/ah view <player> opens a filtered view of just their items.
- Shulker box preview — right-click a listed shulker box to see what's inside before buying, without giving away the contents in the listing itself.
- My Items menu — see everything you currently have listed, cancel a listing to get the item back, and jump straight to your history.
- Transaction history — every purchase and sale is logged per player, with a running total of what you've spent and what you've made.
- Per-player listing limits — a default cap on active listings, liftable per-rank via permission nodes (see below).
- Configurable auction fee — take a percentage cut from every sale, or leave it at 0% so sellers keep the full price.
- Real-time expiry — listings expire after a set duration (default 7 days) in real time, whether or not the server was online the whole time.
- Safe offline returns — if a listing expires while the seller is offline, the item is held and handed back automatically on their next join.
- Blacklist — block specific materials from ever being listed.
- Fully customizable menus and messages — every menu layout, item, color, and message is editable via YAML, including hex colors.
- Multi-language support — separate language folders (English and German included) selected from the config.
- Flexible storage — choose between YAML (default, human-readable), SQLite, or MySQL (for sharing one auction house across multiple servers). Old data from Auction 1.x is migrated automatically.
- Vault economy support — hooks into any Vault-compatible economy plugin.
- PlaceholderAPI support — expose live auction data anywhere placeholders are supported (see below).
Commands
| Command |
Description |
/ah |
Open the auction house |
/ah sell <price> |
List the item in your hand |
/ah search <text> |
Search all listings |
/ah view <player> |
View a specific player's listings |
/ah history [text] |
View (or search) your transaction history |
/ah mine |
View your own active listings |
/ah reload |
Reload the config and menus |
Aliases: /auction, /auctionhouse
Permissions
| Permission |
Default |
Description |
auction.use |
all players |
Use the auction house |
auction.mute |
false |
Hide "player listed an item" broadcasts for this player |
auction.reload |
op |
Reload the config and menus |
auction.listings.<number> |
— |
Raise this player's max active listings to <number> (only numbers above the configured default count; highest held node wins) |
PlaceholderAPI placeholders
Requires PlaceholderAPI and the auction expansion.
| Placeholder |
Returns |
%auction_listings% |
Total number of active listings |
%auction_highest% |
Highest active listing price, formatted |
%auction_highest_raw% |
Highest active listing price, raw number |
%auction_lowest% |
Lowest active listing price, formatted |
%auction_lowest_raw% |
Lowest active listing price, raw number |
%auction_mine% |
How many listings the viewing player currently has |
%auction_mine_value% |
Total value of the viewing player's listings, formatted |
%auction_mine_value_raw% |
Total value of the viewing player's listings, raw number |
%auction_history% |
Number of transactions in the viewing player's history |
%auction_returns% |
Number of pending returns waiting for the viewing player |
Dependencies
- Vault (soft-depend) — required for any economy features to function
- PlaceholderAPI (soft-depend) — required only if you want the placeholders above
评论 0
登录后参与评分
还没有评论,来抢沙发吧