OrderX
一个面向 Paper 1.21.x 的生产级市场插件,实现了玩家驱动的买卖订单系统,具备自动订单匹配、基于托管账户的交易安全保障、Vault 经济系统集成、SQLite/MySQL 数据持久化以及完整的 Bukkit 库存 GUI。
订单会自动且持续地进行匹配。玩家之间不直接交易:资金和物品在订单成交前由托管账户持有,从而确保即使在并发访问的情况下也不会出现物品或金钱复制。
功能特性
- 买卖订单:支持可配置的有效时长(最长 30 天,外加“永久”选项)
- 自动订单匹配——买单以最低卖价成交,卖单以最高买价成交;价格相同时优先匹配最早创建的订单;支持部分成交
- 托管账户记账——资金和物品在订单成交前由托管账户持有
- 严格序列化——所有订单变更均在单线程订单引擎上执行(杜绝重复成交)
- 手续费——可配置的买入/挂牌费(创建时收取)和卖出税(成交时收取)
- Vault 经济集成(必需)及 PlaceholderAPI 支持
- SQLite(默认,开启 WAL 模式)和通过 HikariCP 连接的 MySQL 存储
- 完整 GUI——主菜单、物品选择器、创建订单向导、我的订单、历史记录和市场信息视图,以及基于聊天的物品搜索功能
- 过期清理机制——过期的订单自动取消并退款
- 管理工具——清除、统计、强制取消、配置重载
依赖要求
- Paper(或其分支)1.21.x,Java 21+
- Vault + 一个经济插件(如 EssentialsX、CMI、CoinsEngine 等)——必需
- PlaceholderAPI(可选)
安装方法
- 将 OrderX.jar 复制到服务器 plugins/ 文件夹中。
- 确保已安装 Vault 和一个经济插件。
- 重启服务器。运行
/order 打开市场界面。
命令:/order buy|sell <item> <qty> <price>、/order myorders、/order history、/order market <item>、/order search <query>、/orderadmin(管理员专用)。完整文档随插件一同提供(请参阅 README)。
OrderX
A production-ready Paper 1.21.x marketplace plugin that implements a player-driven buy/sell order system with automatic order matching, escrow-based transaction safety, Vault economy integration, SQLite/MySQL persistence, and a full Bukkit inventory GUI.
Orders are matched automatically and continuously. Nobody trades directly with another player: money and items are held in escrow until an order fills, guaranteeing there is no item or money duplication even under concurrent access.
Features
- Buy and sell orders with configurable durations (up to 30 days, plus "permanent")
- Automatic order matching - buy orders fill against the cheapest sell, sell orders against the highest buy; oldest orders match first on ties; partial fills supported
- Escrow accounting - money and items are held in escrow until an order fills
- Strict serialization - every order mutation runs on a single-threaded order engine (double-fills are impossible)
- Fees - configurable buy/listing fee (at creation) and sell tax (at fill)
- Vault economy integration (required) and PlaceholderAPI support
- SQLite (default, WAL mode) and MySQL storage via HikariCP
- Full GUI - main menu, item picker, create-order wizard, my-orders, history, and market-info views, plus chat-based item search
- Expiry sweeper - expired orders auto-cancel and refund
- Admin tools - purge, statistics, force-cancel, config reload
Requirements
- Paper (or fork) 1.21.x, Java 21+
- Vault + an economy plugin (EssentialsX, CMI, CoinsEngine, etc.) - required
- PlaceholderAPI (optional)
Installation
- Copy OrderX.jar into your server's plugins/ folder.
- Make sure Vault and an economy plugin are installed.
- Restart the server. Run /order to open the market.
Commands: /order buy|sell <item> <qty> <price>, /order myorders, /order history, /order market <item>, /order search <query>, /orderadmin for admins. Full docs shipped with the plugin (see README).
评论 0
登录后参与评分
还没有评论,来抢沙发吧