mAuction
快速、持久的玩家市场,提供受保护的 Vault 交易功能,适用于 Paper、Purpur 和 Folia。
mAuction 提供了一个清晰的库存市场、快速的物品搜索、持久的拍卖列表以及受保护的 Vault 交易。默认启用英文;可通过 language: ru_RU 选择俄语。
特性
- 使用
/ah 或 /auction 浏览市场,每页显示 45 条列表,支持手动刷新和四种排序模式。
- 使用
/ah search <name> 按物品材质、自定义显示名称和卖家名称进行搜索。
- 使用
/ah sell <price> 出售当前手持的物品组;接受简写价格格式,如 10k、2.5m 和 1b。
- 打开
/ah selling 管理个人发布的列表;点击自己的列表即可安全移除。
- 在专用 GUI 中确认购买,并使用
/ah collect 重试排队中的物品交付和卖家收益。
- 实时列表验证:已购买、已预留、已移除和已过期的条目在未关闭的每个菜单中均显示为灰色染料。
- 原子数据库预留防止两名买家同时购买同一列表,而数据库侧的限制可防止并行绕过列表数量限制。
- 记录提取、卖家收益和物品交付阶段,重启后不会静默重复不确定的外部操作。
- 版本控制的 H2 迁移、索引化的数据库侧搜索/分页、仅追加的事务审计以及安全的过期预留恢复。
- 登录时自动处理未售出物品的过期与回收。
- 可配置的列表数量限制、价格范围、冷却时间、序列化物品大小上限以及材质黑名单。
- 异步 H2 持久化以及 Folia 安全的玩家/库存调度。
- 包含英文和俄文的配置文件,可选的 bStats 指标统计以及管理员重载功能。
命令
| 命令 |
用途 |
/ah, /auction |
打开市场 |
/ah search <name> |
打开筛选后的列表 |
/ah sell <price> |
列出主手物品 |
/ah selling |
查看并移除你的列表 |
/ah collect |
重试排队的物品交付和卖家收益 |
/ah cancel <id> |
通过 ID 移除列表 |
/ah audit |
显示不确定的交易阶段(管理员) |
/ah reload |
重载配置和消息文件 |
要求
- Java 25
- Paper、Purpur 或 Folia 26.3
- Vault 及任意兼容 Vault 的经济插件
Vault 作为经济桥梁,因此 mAuction 可与任何暴露 Vault 经济接口的货币插件配合使用,包括那些可选支持 Vault 的接口。
快速开始
- 安装 Vault、一个经济插件以及
mAuction-1.2.1.jar。
- 启动服务器一次。
- 根据需要调整
plugins/mAuction/config.yml。
- 手持一件物品并运行
/ah sell 1000。
默认配置即可直接使用。设置 language: ru_RU 可使用俄语。
构建
运行 ./gradlew clean build。发布版 JAR 将写入 build/libs/mAuction-1.2.1.jar。
采用 MIT 许可证授权。
mAuction
Fast, persistent player marketplace with guarded Vault transactions for Paper, Purpur, and Folia.
mAuction provides a clear inventory marketplace, fast item search, durable listings, and guarded Vault transactions. English is enabled by default; Russian can be selected with language: ru_RU.
Features
- Browse with
/ah or /auction, 45 listings per page, manual refresh, and four sort modes.
- Search item materials, custom display names, and seller names with
/ah search <name>.
- Sell the held stack with
/ah sell <price>; compact prices such as 10k, 2.5m, and 1b are accepted.
- Open
/ah selling to manage personal listings; clicking your own listing removes it safely.
- Confirm purchases in a dedicated GUI and use
/ah collect to retry queued items and payouts.
- Live listing validation: bought, reserved, removed, and expired entries turn into gray dye in every open menu without closing it.
- Atomic database reservation prevents two buyers from purchasing the same listing, while database-side limits prevent parallel listing-limit bypasses.
- Journaled withdrawal, seller payout, and item-delivery stages survive restarts without silently repeating uncertain external operations.
- Versioned H2 migrations, indexed database-side search/pagination, append-only transaction audit, and safe stale-reservation recovery.
- Automatic expiration and recovery of unsold items on login.
- Configurable listing limits, price range, cooldown, serialized-item size cap, and material blacklist.
- Async H2 persistence and Folia-safe player/inventory scheduling.
- English and Russian message files, optional bStats metrics, and admin reload.
Commands
| Command |
Purpose |
/ah, /auction |
Open the marketplace |
/ah search <name> |
Open filtered listings |
/ah sell <price> |
List the stack in the main hand |
/ah selling |
View and remove your listings |
/ah collect |
Retry queued item delivery and seller payouts |
/ah cancel <id> |
Remove a listing by ID |
/ah audit |
Show uncertain transaction stages (admin) |
/ah reload |
Reload configuration and messages |
Requirements
- Java 25
- Paper, Purpur, or Folia 26.3
- Vault and any Vault-compatible economy provider
Vault acts as the economy bridge, so mAuction works with currency plugins that expose a Vault economy provider, including providers with optional Vault support.
Quick start
- Install Vault, an economy provider, and
mAuction-1.2.1.jar.
- Start the server once.
- Adjust
plugins/mAuction/config.yml if needed.
- Hold an item and run
/ah sell 1000.
The default configuration is ready to use. Set language: ru_RU for Russian.
Build
Run ./gradlew clean build. The release JAR is written to build/libs/mAuction-1.2.1.jar.
MIT licensed.
评论 0
登录后参与评分
还没有评论,来抢沙发吧