CoinOp

插件

· 作者 APPLEPIE6969

一个动态订单簿经济插件,玩家以玩家驱动的价格交易物品。功能包括即时买卖、基于描述的价格提示、多服务器同步、可选图形界面以及铁砝成本重做。

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

需要前置:VaultUnlocked

最新 1.21.11-1.0.0-SNAPSHOT · 1.21.11 · Bukkit / Paper

一键开服(送7天)

CoinOp

一款基于订单簿的动态经济插件,适用于 Minecraft 服务器。

插件功能

该插件创建了一个玩家之间可以交易物品的市场。与固定价格不同,市场价格由供需关系决定——类似于股票市场或 Hypixel 的 Bazaar(拍卖行)的工作方式。

主要特性:

  • 玩家可以挂出买单(“我想以每个 50 美元的价格购买 100 个钻石”)
  • 玩家可以挂出卖单(“我想以每个 50 美元的价格出售 100 个钻石”)
  • 当价格匹配时,交易自动完成
  • 按当前市场价格即时买入/卖出
  • 物品提示框显示当前市场价格
  • 支持跨服务器运行(使用 Redis)
  • 可选 GUI 界面以便更轻松地交易
  • 重做铁砝台消耗(不再出现“太贵了!”)

前置要求

安装前,请确保您具备以下条件:

  1. Minecraft 服务器,运行 Paper 或 Spigot(版本 1.19.x - 1.21.x)
  2. Java 17+(用于 Minecraft 1.19-1.20),或 Java 21+(用于 Minecraft 1.21+)
  3. 经济类插件,如 EssentialsX、CMI 或 PlayerPoints
  4. Vault(如果缺失将自动下载)

服务器兼容性

CoinOp 兼容所有主流的 Minecraft 服务器软件:

服务器 状态 备注
Paper ✅ 完全支持 主要目标平台 - 使用 Paper API
Spigot ✅ 完全支持 通过 Spigot API 兼容
Bukkit ✅ 完全支持 基础 Bukkit API
Purpur ✅ 完全支持 Paper 分支,100% 兼容
Pufferfish ✅ 完全支持 Paper 分支,100% 兼容
Airplane ✅ 完全支持 Paper 分支,100% 兼容
TacoSpigot ✅ 完全支持 Paper/Spigot 分支,兼容
Akarin ✅ 完全支持 Paper 分支,兼容

Minecraft 版本:

  • 1.19.x (1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4)
  • 1.20.x (1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6)
  • 1.21.x (1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 等.)

安装方法

  1. 从发布页面下载对应 Minecraft 版本的 JAR 文件
  2. 将其放入服务器的 plugins 文件夹中
  3. 启动服务器
  4. 插件将在 plugins/CoinOp/ 目录下生成包含配置文件的文件夹
  5. 编辑 config.yml 以自定义插件设置
  6. 重启服务器或执行 /coa reload 命令

配置指南

主配置文件为位于 plugins/CoinOp/ 目录下的 config.yml。以下是各部分的详细说明:

经济设置

economy:
  tax-rate: 0.0
  • tax-rate: 每笔交易中扣除的百分比。设置为 0.0 表示无税,0.05 表示 5% 的税率。税收金额将从经济系统中消失(不会被任何人收集)。

示例: 如果您设置为 0.05,且玩家以 100 美元的价格出售钻石,他们实际只能收到 95 美元。

订单设置

orders:
  min-amount: 1
  max-amount: 2304
  expiration-minutes: -1
  • min-amount: 每笔订单的最小物品数量。默认为 1。
  • max-amount: 每笔订单的最大物品数量。默认为 2304(36 组 = 一个双层箱子)。设置为 -1 表示无限。
  • expiration-minutes: 订单保持活跃的时间长度。默认值 -1 表示订单永不过期。设置为 1440 表示 24 小时,10080 表示 1 周。

商品配置

commodities:
  allowed: []
  categories:
    ores:
      - DIAMOND
      - IRON_INGOT
      - GOLD_INGOT
    crops:
      - WHEAT
      - CARROT
  • allowed: 留空 [] 以允许所有物品。或者列出特定物品,如 [DIAMOND, IRON_INGOT],仅允许这些物品。
  • categories: 将物品分组以便在 GUI 中使用。您可以添加自己的分类。

添加新分类:

commodities:
  categories:
    nether:
      - NETHERITE_INGOT
      - QUARTZ
      - GLOWSTONE_DUST

交易限制

limits:
  global-daily-limit: 0
  daily-limits:
    DIAMOND: 1000
  • global-daily-limit: 玩家每天可交易的物品总数上限。0 表示无限。
  • daily-limits: 单项物品的限制。示例中将玩家每日钻石交易量限制为 1000 个。

为什么要使用限制? 防止玩家操纵市场或洗钱。

价格边界

price-bounds:
  enabled: true
  global-min: 0.01
  global-max: 1000000000
  commodities:
    DIAMOND:
      min: 10.0
      max: 10000.0
  • enabled: 开启或关闭价格边界
  • global-min: 任何物品的最低价格(默认:$0.01)
  • global-max: 任何物品的最高价格(默认:$10 亿)
  • commodities: 为特定物品设置具体限制

为什么要使用价格边界? 防止玩家:

  • 以 $0.01 的价格出售物品以在不同账号间转移资金
  • 以极端价格购买物品以操纵市场

示例场景: 您希望钻石的交易价格在 $10 到 $10,000 之间:

price-bounds:
  enabled: true
  commodities:
    DIAMOND:
      min: 10.0
      max: 10000.0

如果有人试图以 $5 的价格挂出买单,将被拒绝。如果有人试图以 $15,000 的价格挂出卖单,也将被拒绝。

多服务器同步 (Redis)

如果您运行多个服务器并希望它们共享同一个市场:

sync:
  enabled: true
  redis:
    host: localhost
    port: 6379
    password: ""
    database: 0
  • enabled: 开启或关闭同步
  • host: Redis 服务器 IP 地址
  • port: Redis 端口(默认 6379)
  • password: Redis 密码(如果没有则留空)
  • database: Redis 数据库编号(0-15)

工作原理: 当玩家在服务器 A 上挂出订单时,它会立即出现在服务器 B 上。所有连接的服务器上的交易都会同步。

我需要 Redis 吗? 仅在运行多个服务器时需要。对于单个服务器,请将 enabled 设置为 false。

数据库配置

database:
  type: sqlite
  host: localhost
  port: 3306
  name: CoinOp
  user: root
  password: ""
  • type: 可以是 sqlite 或 mysql
    • sqlite: 将数据存储在本地文件中。适合单服务器环境。
    • mysql: 连接到 MySQL 服务器。适合多服务器设置。
  • host, port, name, user, password: MySQL 连接详情(如果使用 SQLite 则忽略)

何时使用 MySQL: 如果您运行多个服务器并希望它们共享订单历史和玩家数据。

描述栏显示设置

lore:
  enabled: true
  update-interval: 20
  show-history: true
  history-points: 5
  • enabled: 在物品提示中显示市场价格
  • update-interval: 刷新价格的频率(以刻为单位,20 刻 = 1 秒)
  • show-history: 在提示中显示价格趋势
  • history-points: 显示多少个价格数据点

玩家看到的效果: 当他们在背包中将鼠标悬停在钻石上时,会看到:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CoinOp 市场数据
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
买入价:每件 $50.00
卖出价:每件 $48.50
24小时成交量:125,300
趋势:▲ 上涨

铁砧重做设置

anvil-rework:
  enabled: true
  enchantment-extraction: true
  max-cost: 0
  material-costs:
    NETHERITE_INGOT: 15
    DIAMOND: 10
  • enabled: 开启/关闭铁砧重做功能
  • enchantment-extraction: 允许将附魔转移到书本上
  • max-cost: 铁砧最大消耗。0 表示无限制(不会出现“过于昂贵!”的提示)
  • material-costs: 不同材料的基础消耗

工作原理: 铁砧不再使用指数级消耗(2^n - 1),而是基于材料稀有度采用线性消耗。这意味着你可以组合大量附魔而不会触及“过于昂贵!”的限制。

附魔提取: 将附魔物品放入左侧槽位,将书本放入右侧槽位。附魔将被转移到书本上。

GUI 设置

gui:
  enabled: true
  open-on-command: true
  title: "&6CoinOp &8- &7Market"
  main-menu-size: 54
  sounds:
    open: "BLOCK_CHEST_OPEN"
    click: "UI_BUTTON_CLICK"
  icons:
    ores: "DIAMOND"
    crops: "WHEAT"
  • enabled: 开启/关闭 GUI
  • open-on-command: 当玩家运行不带参数的 /CoinOp 命令时打开 GUI
  • title: GUI 标题(支持颜色代码:&6 = 金色,&8 = 深灰色,&7 = 灰色)
  • main-menu-size: GUI 大小(必须是 9 的倍数,最大为 54)
  • sounds: 不同动作的声音效果
  • icons: 代表每个类别的物品

颜色代码:

  • &0 - 黑色
  • &1 - 深蓝色
  • &2 - 深绿色
  • &3 - 深青色
  • &4 - 深红色
  • &5 - 深紫色
  • &6 - 金色
  • &7 - 灰色
  • &8 - 深灰色
  • &9 - 蓝色
  • &a - 绿色
  • &b - 青色
  • &c - 红色
  • &d - 浅紫色
  • &e - 黄色
  • &f - 白色

命令

玩家命令

命令 别名 描述 示例
/coinop /co, /market 打开 CoinOp 菜单 /coinop
/coinop buy <item> <amount> <price> /coinbuy 挂出买入订单 /coinbuy DIAMOND 100 50
/coinop sell <item> <amount> <price> /coinsell 挂出卖出订单 /coinsell DIAMOND 100 50
/coinop instant buy <item> <amount> /coininstant 按市价买入 /coininstant buy DIAMOND 64
/coinop instant sell <item> <amount> /coininstant 按市价卖出 /coininstant sell DIAMOND 64
/coinop orders /coinorders 查看你的活跃订单 /coinorders
/coinop orders cancel <item> <id> - 取消订单 /coinop orders cancel DIAMOND 12345
/coinop price <item> /coinprice 检查当前价格 /coinprice DIAMOND
/coinop history <item> - 查看近期交易 /coinop history DIAMOND

管理员命令

命令 别名 描述
/coinadmin reload /coa reload 重新加载配置
/coinadmin bounds list /coa bounds list 列出所有价格区间
/coinadmin bounds set <item> <min> <max> /coa bounds set 设置价格区间
/coinadmin bounds remove <item> /coa bounds remove 移除价格区间
/coinadmin limits list /coa limits list 列出所有交易限额
/coinadmin limits set <item> <limit> /coa limits set 设置每日交易限额
/coinadmin stats [item] /coa stats 查看交易统计信息
/coinadmin cleanup /coa cleanup 移除非活跃订单
/coinadmin sync status /coa sync status 检查 Redis 连接状态

权限

权限 描述 默认值
CoinOp.use 基本 CoinOp 使用 所有人
CoinOp.buy 挂出买入订单 所有人
CoinOp.sell 挂出卖出订单 所有人
CoinOp.instant 使用即时买入/卖出 所有人
CoinOp.orders 查看自己的订单 所有人
CoinOp.cancel 取消自己的订单 所有人
CoinOp.admin 管理员命令 仅限 OP
CoinOp.admin.bounds 设置价格区间 仅限 OP
CoinOp.admin.limits 设置交易限额 仅限 OP
CoinOp.admin.reload 重新加载配置 仅限 OP
CoinOp.admin.sync 管理同步设置 仅限 OP
CoinOp.bypass.limit 绕过交易限额 仅限 OP
CoinOp.bypass.bounds 绕过价格区间 仅限 OP

交易工作原理

订单簿系统

CoinOp 使用订单簿系统——与真实股票市场相同的系统:

  1. 买入订单(Bids): 玩家表示“我想以每件 $Y 的价格购买 X 个物品”

    • 最高价格优先匹配
    • 示例:如果有人愿意支付 $55,另一个人愿意支付 $50,那么 $55 的订单优先成交
  2. 卖出订单(Asks): 玩家表示“我想以每件 $Y 的价格出售 X 个物品”

    • 最低价格优先匹配
    • 示例:如果有人在以 $45 出售,另一个人在以 $50 出售,那么 $45 的订单优先成交
  3. 匹配: 当买入订单的价格等于或高于卖出订单的价格时,交易将以卖出订单的价格成交。

交易示例:

  • Alice 挂出一个买入订单:“我想以每件 $50 的价格购买 100 个钻石”
  • Bob 挂出一个卖出订单:“我想以每件 $48 的价格出售 50 个钻石”
  • 由于 $50 ≥ $48,他们成交:Bob 以每件 $48 的价格向 Alice 出售 50 个钻石
  • Alice 的订单现在剩余 50 个钻石,价格为每件 $50

即时买入/卖出

对于希望立即交易的玩家:

  • 即时买入: 按最低的可用卖出价格买入
  • 即时卖出: 按最高的可用买入价格卖出

如果没有匹配的订单,交易将被拒绝。

故障排除

“未找到 Vault”错误

插件将在首次运行时自动下载 Vault。如果失败:

  1. 从 下载 Vault
  2. 将其放入 plugins 文件夹
  3. 重启服务器

“未找到经济插件”错误

你需要一个经济插件。安装以下之一:

  • EssentialsX(推荐): 或
  • CMI: 或者如果你想留在 Modrinth,SunLight
  • PlayerPoints: 或

“价格超出允许范围”错误

价格超出了 config.yml 中设置的限制。你可以:

  • 在配置文件中更改价格限制
  • 给予玩家 CoinOp.bypass.bounds 权限

“每日交易次数已达上限”错误

玩家今天已交易过多该物品。你可以:

  • 等到明天(限制每天重置)
  • 在 config.yml 中增加限制
  • 给予玩家 CoinOp.bypass.limit 权限

GUI 无法打开

检查 config.yml 中的这些设置:

gui:
  enabled: true
  open-on-command: true

Redis 连接失败

  1. 确保 Redis 已安装并正在运行
  2. 检查 config.yml 中的连接详情
  3. 使用 /coa sync status 测试

从源码构建

如果你想修改插件:

  1. 安装 Java 17 或 Java 21
  2. 克隆或下载源代码
  3. 运行 ./gradlew build (Linux/Mac) 或 gradlew.bat build (Windows)
  4. 在 versions/*/build/libs/ 中找到 JAR 文件

支持

许可证

MIT License with Attribution

致谢

开发者: APPLEPIE6969

灵感来源于 Hypixel 的 Bazaar 系统以及 Minecraft 社区对动态经济插件的需求。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源