DonutOrders

插件

· 作者 KafaSallayanAmca

一个带有游戏内购买的市集,氛围感十足。

0 本站下载 0 关注 更新于 5 个月前

最新 1.0.0 · 26.1.2 · Bukkit / Folia

一键开服(送7天)

? DonutOrders

一个由玩家主导的购买订单市场。 没有箱子商店,无需管理员设置。只有简洁的 GUI 和自动化的经济系统。

Paper · Purpur · Folia · Spigot — 1.20.x / 1.21.x · Java 17+ · 需要 Vault


工作原理

  1. 买家打开 /orders → New Order(新订单)→ 选择材料 → 在聊天栏中输入数量和单价。
  2. 资金会立即托管——买家无法花费他们不拥有的资金。
  3. 卖家浏览市场,选择一个订单,将物品放入 45 格的交付 GUI → 即时收款。
  4. 部分完成的订单会将已交付的物品保存在虚拟仓库中,直到买家领取。
  5. 订单会在配置的天数后自动过期;任何未使用的资金都会退还。

功能

买家端

  • 为服务器允许列表中的任何材料发布购买订单
  • 托管系统——创建订单时扣除资金,防止重复消费
  • 状态追踪——活跃、已完成、已过期或已取消
  • 虚拟仓库——即使你的背包已满,交付的物品也会存储在服务器端
  • 溢出保护——无法装入背包的物品会掉落在你脚边
  • 取消与退款——可以取消任何活跃订单并收回未使用的余额

卖家端

  • 在分页的市场 GUI 中浏览所有活跃订单
  • 45 格交付网格——仅接受正确的材料
  • 错误物品拒绝——GUI 会立即拒绝不兼容的物品并显示清晰的消息
  • 部分填充——你可以交付任意数量的物品;按件付款
  • 防复制锁定——对同一订单的并发交付尝试会在服务器端串行化执行
  • 多余物品退回——超出订单需求的物品会自动退回你的背包

经济系统

  • Vault 驱动——兼容 EssentialsX、CMI 以及任何支持 Vault 的经济插件
  • 可选的卖家税作为经济消耗项(默认关闭)
  • 退款金额精确无误——无舍入误差

技术特性

  • 完全支持 Folia——所有调度均使用区域化的实体/全局调度器;同样适用于标准的 Paper/Spigot
  • SQLite + HikariCP——订单持久化到本地 WAL 模式数据库;无需外部数据库
  • 完全异步 I/O——数据库读写绝不会阻塞主线程
  • 阴影且重定位的依赖项——不会与其他插件产生类路径冲突

GUI 界面

界面 用途
主菜单 我的订单 / 浏览市场 / 领取仓库
我的订单 查看活跃订单、取消、领取仓库
新订单 选择材料,通过聊天栏设置数量和价格
浏览市场 所有活跃订单的分页列表
交付物品 45 格网格,仅接受正确的材料
订单详情 进度、价格、过期时间、仓库状态、取消按钮

命令

命令 描述 权限
/orders 打开订单菜单(别名:/order, /market) donutorders.use
/orders admin reload 重新加载配置文件和消息 donutorders.admin

权限

权限 描述 默认值
donutorders.use 所有 /orders 命令和 GUI 功能 所有人
donutorders.admin 访问管理员子命令 OP

配置

orders:
  max-per-player: 10        # 每个玩家同时活跃的最大订单数
  default-expiry-days: 7    # 未完成的订单过期前的天数
  tax-percent: 0.0          # 从卖家收益中抽取作为经济消耗项的百分比(0 = 关闭)

database:
  filename: donutorders.db

allowed-materials:
  - DIAMOND
  - EMERALD
  - GOLD_INGOT
  # ... 任何 Bukkit Material 名称

所有面向玩家的字符串都在 messages.yml 中——支持 & 颜色代码和 #RRGGBB 十六进制颜色。


安装

  1. 将 DonutOrders.jar 放入你的 plugins/ 文件夹。
  2. 确保已安装 Vault 和经济插件(例如 EssentialsX)。
  3. 启动服务器——config.yml 和 messages.yml 会自动生成。
  4. 根据需要编辑 allowed-materials 和其他选项。
  5. 运行 /orders admin reload 以应用更改而无需重启服务器。

要求

要求 版本
Paper / Purpur / Folia / Spigot 1.20.x 或 1.21.x
Java 17+
Vault 任何兼容版本
经济插件 EssentialsX、CMI 或任何 Vault 经济插件

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源