?️ AuctionHouse
一款简洁且功能齐全、适用于 Paper 1.21.1 的拍卖行插件。
通过由 Vault 经济系统驱动的精美图形用户界面(GUI),上架物品、浏览列表、按名称搜索,并一键购买。
✨ 特性
-
完整的 GUI 拍卖行浏览器 — 分页显示,可刷新,始终与最新数据同步
-
一键购买 — 点击物品即可立即购买
-
手持出售 — /ah sell <价格> 可在数秒内将你手中的物品上架
-
批量出售 GUI — /ah sellgui 打开一个箱子界面,你可以将多个物品拖入并逐个设置价格
-
玩家商店 — /ah <玩家> 浏览特定玩家的物品列表
-
搜索 — /ah search <名称> 通过名称、类别或材质查找物品,支持自动补全
-
我的物品 — 查看并取消您自己的活跃商品列表;标题显示您的槽位使用情况(例如 3/5)
-
存储系统 — 商品在售出 2 天 后未售出将移至个人存储空间;未被领取的物品将在 7 天 后永久删除
-
实时“已售”指示器 — 如果在你查看商品时有人购买了该物品,该槽位会立即变为 灰色羊毛 方块并显示通知
-
出售通知 — 卖家在其物品被购买时会立即收到一条聊天消息
-
Vault 经济系统 — 完全兼容 Vault + EssentialsX(或任何兼容的经济插件)
-
可配置税费 — 可选的挂牌/出售百分比税费
-
每位玩家的挂牌上限 — 防止垃圾信息式的大量挂牌(默认:每位玩家 5 个)
-
完全可配置 — 每条消息、GUI 标题、时间限制、价格上限和货币符号均可在 config.yml 中编辑
-
自动创建文件夹 — 首次启动时,插件会自动创建其文件夹和配置文件
? 命令
| 命令 |
描述 |
/ah |
打开主拍卖行 |
/ah sell <价格> |
上架手中的物品 |
/ah sellgui |
打开批量出售界面 |
/ah search <查询> |
按名称搜索商品 |
/ah <玩家> |
浏览某玩家的挂售列表 |
? 权限
| 权限 |
默认值 |
描述 |
auctionhouse.use |
所有人 |
使用所有 /ah 命令 |
auctionhouse.admin |
OP |
管理员访问权限 |
⚙️ 配置 (config.yml)
settings:
expire-hours: 48 # 未售出物品存入仓库的时长(小时)
storage-hours: 168 # 仓库物品被删除的时长(小时)
max-listings-per-player: 5 # 每位玩家的最大活跃挂牌数
tax-percent: 5 # 销售税率(百分比,0 = 禁用)
currency-symbol: "$" # 显示符号
min-price: 1.0 # 最低挂牌价格
max-price: 0 # 最高挂牌价格(0 = 无限制)
所有消息和 GUI 标签均可编辑——详见首次启动时生成的完整 config.yml。
? 依赖项
- Paper 1.21.1+
- Vault
- 任何兼容 Vault 的经济插件(例如 EssentialsX)
? 安装
- 将
AuctionHouse.jar 放入你的 /plugins 文件夹中
- 确保已安装 Vault 和任意一个经济类插件
- 启动服务器 ——
plugins/AuctionHouse/ 文件夹与 config.yml 会自动生成
- 根据需要编辑
config.yml,然后运行 /reload 或重启服务器
为 Paper 1.21.1 ❤️ 打造
?️ AuctionHouse
A clean, fully-featured auction house plugin for Paper 1.21.1.
List items, browse listings, search by name, and buy with a single click — all through a polished GUI powered by Vault economy.
✨ Features
- Full GUI auction browser — paginated, refreshable, always up to date
- One-click purchasing — click an item to buy it instantly
- Sell from hand —
/ah sell <price> lists the item you're holding in seconds
- Bulk sell GUI —
/ah sellgui opens a chest where you drag in multiple items and set prices one by one
- Player storefronts —
/ah <player> to browse a specific player's listings
- Search —
/ah search <name> finds items by name, category, or material with tab-completion
- My Items — view and cancel your own active listings; title shows your slot usage (e.g.
3/5)
- Storage system — items unsold after 2 days move to a personal storage; unclaimed items are permanently deleted after 7 days
- Real-time "sold" indicator — if someone buys an item while you're looking at it, the slot instantly turns into a gray wool block with a notification
- Sale notifications — sellers receive a chat message the moment their item is purchased
- Vault economy — fully integrated with Vault + EssentialsX (or any compatible economy plugin)
- Configurable tax — optional listing/sale tax in percent
- Per-player listing limit — prevent spam listings (default: 5 per player)
- Fully configurable — every message, GUI title, time limit, price cap, and currency symbol is editable in
config.yml
- Auto folder creation — on first launch the plugin creates its folder and config automatically
? Commands
| Command |
Description |
/ah |
Open the main auction house |
/ah sell <price> |
List the item in your hand |
/ah sellgui |
Open the bulk-sell GUI |
/ah search <query> |
Search listings by name |
/ah <player> |
Browse a player's listings |
? Permissions
| Permission |
Default |
Description |
auctionhouse.use |
Everyone |
Use all /ah commands |
auctionhouse.admin |
OP |
Admin access |
⚙️ Configuration (config.yml)
settings:
expire-hours: 48 # Hours until unsold items move to storage
storage-hours: 168 # Hours until storage items are deleted
max-listings-per-player: 5 # Max active listings per player
tax-percent: 5 # Sale tax in percent (0 = disabled)
currency-symbol: "$" # Display symbol
min-price: 1.0 # Minimum listing price
max-price: 0 # Maximum listing price (0 = unlimited)
Every message and GUI label is also editable — see the full config.yml generated on first launch.
? Requirements
- Paper 1.21.1+
- Vault
- Any Vault-compatible economy plugin (e.g. EssentialsX)
? Installation
- Drop
AuctionHouse.jar into your /plugins folder
- Make sure Vault and an economy plugin are installed
- Start the server — the
plugins/AuctionHouse/ folder and config.yml are created automatically
- Edit
config.yml to your liking and run /reload or restart
Built with ❤️ for Paper 1.21.1
评论 0
登录后参与评分
还没有评论,来抢沙发吧