CoinOp
一款基于订单簿的动态经济插件,适用于 Minecraft 服务器。
插件功能
该插件创建了一个玩家之间可以交易物品的市场。与固定价格不同,市场价格由供需关系决定——类似于股票市场或 Hypixel 的 Bazaar(拍卖行)的工作方式。
主要特性:
- 玩家可以挂出买单(“我想以每个 50 美元的价格购买 100 个钻石”)
- 玩家可以挂出卖单(“我想以每个 50 美元的价格出售 100 个钻石”)
- 当价格匹配时,交易自动完成
- 按当前市场价格即时买入/卖出
- 物品提示框显示当前市场价格
- 支持跨服务器运行(使用 Redis)
- 可选 GUI 界面以便更轻松地交易
- 重做铁砝台消耗(不再出现“太贵了!”)
前置要求
安装前,请确保您具备以下条件:
- Minecraft 服务器,运行 Paper 或 Spigot(版本 1.19.x - 1.21.x)
- Java 17+(用于 Minecraft 1.19-1.20),或 Java 21+(用于 Minecraft 1.21+)
- 经济类插件,如 EssentialsX、CMI 或 PlayerPoints
- 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, 等.)
安装方法
- 从发布页面下载对应 Minecraft 版本的 JAR 文件
- 将其放入服务器的
plugins 文件夹中
- 启动服务器
- 插件将在
plugins/CoinOp/ 目录下生成包含配置文件的文件夹
- 编辑
config.yml 以自定义插件设置
- 重启服务器或执行
/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 使用订单簿系统——与真实股票市场相同的系统:
-
买入订单(Bids): 玩家表示“我想以每件 $Y 的价格购买 X 个物品”
- 最高价格优先匹配
- 示例:如果有人愿意支付 $55,另一个人愿意支付 $50,那么 $55 的订单优先成交
-
卖出订单(Asks): 玩家表示“我想以每件 $Y 的价格出售 X 个物品”
- 最低价格优先匹配
- 示例:如果有人在以 $45 出售,另一个人在以 $50 出售,那么 $45 的订单优先成交
-
匹配: 当买入订单的价格等于或高于卖出订单的价格时,交易将以卖出订单的价格成交。
交易示例:
- Alice 挂出一个买入订单:“我想以每件 $50 的价格购买 100 个钻石”
- Bob 挂出一个卖出订单:“我想以每件 $48 的价格出售 50 个钻石”
- 由于 $50 ≥ $48,他们成交:Bob 以每件 $48 的价格向 Alice 出售 50 个钻石
- Alice 的订单现在剩余 50 个钻石,价格为每件 $50
即时买入/卖出
对于希望立即交易的玩家:
- 即时买入: 按最低的可用卖出价格买入
- 即时卖出: 按最高的可用买入价格卖出
如果没有匹配的订单,交易将被拒绝。
故障排除
“未找到 Vault”错误
插件将在首次运行时自动下载 Vault。如果失败:
- 从 下载 Vault
- 将其放入
plugins 文件夹
- 重启服务器
“未找到经济插件”错误
你需要一个经济插件。安装以下之一:
- 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 连接失败
- 确保 Redis 已安装并正在运行
- 检查 config.yml 中的连接详情
- 使用
/coa sync status 测试
从源码构建
如果你想修改插件:
- 安装 Java 17 或 Java 21
- 克隆或下载源代码
- 运行
./gradlew build (Linux/Mac) 或 gradlew.bat build (Windows)
- 在
versions/*/build/libs/ 中找到 JAR 文件
支持
许可证
MIT License with Attribution
致谢
开发者: APPLEPIE6969
灵感来源于 Hypixel 的 Bazaar 系统以及 Minecraft 社区对动态经济插件的需求。
CoinOp
A dynamic, order-book-based economy plugin for Minecraft servers.
What This Plugin Does
This plugin creates a marketplace where players can trade items with each other. Instead of fixed prices, the market determines prices based on supply and demand - similar to how stock markets or Hypixel's Bazaar works.
Key Features:
- Players can place buy orders ("I want to buy 100 diamonds for $50 each")
- Players can place sell orders ("I want to sell 100 diamonds for $50 each")
- When prices match, trades happen automatically
- Instant buy/sell at current market price
- Item tooltips show current market prices
- Works across multiple servers (using Redis)
- Optional GUI for easier trading
- Anvil cost rework (no more "Too Expensive!")
Requirements
Before installing, make sure you have:
- A Minecraft Server running Paper or Spigot (versions 1.19.x - 1.21.x)
- Java 17+ for Minecraft 1.19-1.20, or Java 21+ for Minecraft 1.21+
- An economy plugin like EssentialsX, CMI, or PlayerPoints
- Vault (will auto-download if missing)
Server Compatibility
CoinOp works with all major Minecraft server software:
| Server |
Status |
Notes |
| Paper |
✅ Full |
Primary target - uses Paper API |
| Spigot |
✅ Full |
Compatible via Spigot API |
| Bukkit |
✅ Full |
Basic Bukkit API |
| Purpur |
✅ Full |
Paper fork, 100% compatible |
| Pufferfish |
✅ Full |
Paper fork, 100% compatible |
| Airplane |
✅ Full |
Paper fork, 100% compatible |
| TacoSpigot |
✅ Full |
Paper/Spigot fork, compatible |
| Akarin |
✅ Full |
Paper fork, compatible |
Minecraft Versions:
- 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, etc.)
Installation
- Download the JAR file for your Minecraft version from the releases
- Put it in your server's
plugins folder
- Start the server
- The plugin will create a
plugins/CoinOp/ folder with configuration files
- Edit
config.yml to customize the plugin
- Restart the server or run
/coa reload
Configuration Guide
The main configuration file is config.yml located in plugins/CoinOp/. Here's a detailed explanation of each section:
Economy Settings
economy:
tax-rate: 0.0
tax-rate: A percentage taken from each trade. Set to 0.0 for no tax, 0.05 for 5% tax. The tax money disappears from the economy (it's not collected by anyone).
Example: If you set 0.05 and a player sells diamonds for $100, they only receive $95.
Order Settings
orders:
min-amount: 1
max-amount: 2304
expiration-minutes: -1
min-amount: Minimum items per order. Default is 1.
max-amount: Maximum items per order. Default is 2304 (36 stacks = one double chest). Set to -1 for unlimited.
expiration-minutes: How long orders stay active. Default -1 means orders never expire. Set to 1440 for 24 hours, 10080 for 1 week.
Commodities Configuration
commodities:
allowed: []
categories:
ores:
- DIAMOND
- IRON_INGOT
- GOLD_INGOT
crops:
- WHEAT
- CARROT
allowed: Leave empty [] to allow all items. Or list specific items like [DIAMOND, IRON_INGOT] to only allow those.
categories: Groups items together for the GUI. You can add your own categories.
Adding a new category:
commodities:
categories:
nether:
- NETHERITE_INGOT
- QUARTZ
- GLOWSTONE_DUST
Trade Limits
limits:
global-daily-limit: 0
daily-limits:
DIAMOND: 1000
global-daily-limit: Maximum total items a player can trade per day. 0 means unlimited.
daily-limits: Per-item limits. The example limits players to 1000 diamonds per day.
Why use limits? Prevents players from manipulating the market or laundering money.
Price Bounds
price-bounds:
enabled: true
global-min: 0.01
global-max: 1000000000
commodities:
DIAMOND:
min: 10.0
max: 10000.0
enabled: Turn price bounds on/off
global-min: Minimum price for any item (default: $0.01)
global-max: Maximum price for any item (default: $1 billion)
commodities: Set specific limits per item
Why use price bounds? Prevents players from:
- Selling items for $0.01 to transfer money between accounts
- Buying items for extreme prices to manipulate the market
Example scenario: You want diamonds to trade between $10 and $10,000:
price-bounds:
enabled: true
commodities:
DIAMOND:
min: 10.0
max: 10000.0
Now if someone tries to place a buy order for $5, it will be rejected. If someone tries to sell for $15,000, it will be rejected.
Multi-Server Sync (Redis)
If you run multiple servers and want them to share the same market:
sync:
enabled: true
redis:
host: localhost
port: 6379
password: ""
database: 0
enabled: Turn sync on/off
host: Redis server IP address
port: Redis port (default 6379)
password: Redis password (leave empty if none)
database: Redis database number (0-15)
How it works: When a player places an order on Server A, it instantly appears on Server B. Trades are synchronized across all connected servers.
Do I need Redis? Only if you run multiple servers. For a single server, leave enabled: false.
Database Configuration
database:
type: sqlite
host: localhost
port: 3306
name: CoinOp
user: root
password: ""
type: Either sqlite or mysql
sqlite: Stores data in a local file. Good for single servers.
mysql: Connects to a MySQL server. Good for multi-server setups.
host, port, name, user, password: MySQL connection details (ignored if using SQLite)
When to use MySQL: If you run multiple servers and want them to share order history and player data.
Lore Display Settings
lore:
enabled: true
update-interval: 20
show-history: true
history-points: 5
enabled: Show market prices in item tooltips
update-interval: How often to refresh prices (in ticks, 20 ticks = 1 second)
show-history: Show price trend in tooltip
history-points: How many price points to show
What players see: When they hover over a diamond in their inventory, they'll see:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CoinOp Market Data
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Buy Price: $50.00 each
Sell Price: $48.50 each
24h Volume: 125,300
Trend: ▲ Up
Anvil Rework Settings
anvil-rework:
enabled: true
enchantment-extraction: true
max-cost: 0
material-costs:
NETHERITE_INGOT: 15
DIAMOND: 10
enabled: Turn the anvil rework on/off
enchantment-extraction: Allow moving enchants to books
max-cost: Maximum anvil cost. 0 means unlimited (no "Too Expensive!")
material-costs: Base costs for different materials
How it works: Instead of exponential costs (2^n - 1), the anvil uses linear costs based on material rarity. This means you can combine many enchantments without hitting the "Too Expensive!" limit.
Enchantment Extraction: Put an enchanted item in the left slot and a book in the right slot. The enchantments will transfer to the book.
GUI Settings
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: Turn the GUI on/off
open-on-command: Open GUI when player runs /CoinOp without arguments
title: GUI title (supports color codes: &6 = gold, &8 = dark gray, &7 = gray)
main-menu-size: GUI size (must be multiple of 9, max 54)
sounds: Sound effects for different actions
icons: Which items represent each category
Color Codes:
&0 - Black
&1 - Dark Blue
&2 - Dark Green
&3 - Dark Aqua
&4 - Dark Red
&5 - Dark Purple
&6 - Gold
&7 - Gray
&8 - Dark Gray
&9 - Blue
&a - Green
&b - Aqua
&c - Red
&d - Light Purple
&e - Yellow
&f - White
Commands
Player Commands
| Command |
Aliases |
Description |
Example |
/coinop |
/co, /market |
Open the CoinOp menu |
/coinop |
/coinop buy <item> <amount> <price> |
/coinbuy |
Place a buy order |
/coinbuy DIAMOND 100 50 |
/coinop sell <item> <amount> <price> |
/coinsell |
Place a sell order |
/coinsell DIAMOND 100 50 |
/coinop instant buy <item> <amount> |
/coininstant |
Buy at market price |
/coininstant buy DIAMOND 64 |
/coinop instant sell <item> <amount> |
/coininstant |
Sell at market price |
/coininstant sell DIAMOND 64 |
/coinop orders |
/coinorders |
View your active orders |
/coinorders |
/coinop orders cancel <item> <id> |
- |
Cancel an order |
/coinop orders cancel DIAMOND 12345 |
/coinop price <item> |
/coinprice |
Check current prices |
/coinprice DIAMOND |
/coinop history <item> |
- |
View recent trades |
/coinop history DIAMOND |
Admin Commands
| Command |
Aliases |
Description |
/coinadmin reload |
/coa reload |
Reload configuration |
/coinadmin bounds list |
/coa bounds list |
List all price bounds |
/coinadmin bounds set <item> <min> <max> |
/coa bounds set |
Set price bounds |
/coinadmin bounds remove <item> |
/coa bounds remove |
Remove price bounds |
/coinadmin limits list |
/coa limits list |
List all trade limits |
/coinadmin limits set <item> <limit> |
/coa limits set |
Set daily trade limit |
/coinadmin stats [item] |
/coa stats |
View trading statistics |
/coinadmin cleanup |
/coa cleanup |
Remove inactive orders |
/coinadmin sync status |
/coa sync status |
Check Redis connection |
Permissions
| Permission |
Description |
Default |
CoinOp.use |
Basic CoinOp usage |
Everyone |
CoinOp.buy |
Place buy orders |
Everyone |
CoinOp.sell |
Place sell orders |
Everyone |
CoinOp.instant |
Use instant buy/sell |
Everyone |
CoinOp.orders |
View own orders |
Everyone |
CoinOp.cancel |
Cancel own orders |
Everyone |
CoinOp.admin |
Admin commands |
OPs only |
CoinOp.admin.bounds |
Set price bounds |
OPs only |
CoinOp.admin.limits |
Set trade limits |
OPs only |
CoinOp.admin.reload |
Reload config |
OPs only |
CoinOp.admin.sync |
Manage sync settings |
OPs only |
CoinOp.bypass.limit |
Bypass trade limits |
OPs only |
CoinOp.bypass.bounds |
Bypass price bounds |
OPs only |
How Trading Works
Order Book System
The CoinOp uses an order book - the same system used by real stock markets:
-
Buy Orders (Bids): Players say "I want to buy X items at $Y each"
- Highest prices are matched first
- Example: If someone is willing to pay $55 and another $50, the $55 order trades first
-
Sell Orders (Asks): Players say "I want to sell X items at $Y each"
- Lowest prices are matched first
- Example: If someone is selling at $45 and another at $50, the $45 order trades first
-
Matching: When a buy order's price meets or exceeds a sell order's price, a trade happens at the sell order's price.
Example Trade:
- Alice places a buy order: "I want to buy 100 diamonds at $50 each"
- Bob places a sell order: "I want to sell 50 diamonds at $48 each"
- Since $50 ≥ $48, they trade: Bob sells 50 diamonds to Alice for $48 each
- Alice's order now has 50 diamonds remaining at $50 each
Instant Buy/Sell
For players who want immediate trades:
- Instant Buy: Buys at the lowest available sell price
- Instant Sell: Sells at the highest available buy price
If no matching orders exist, the trade is rejected.
Troubleshooting
"Vault not found" error
The plugin will auto-download Vault on first run. If it fails:
- Download Vault from
- Put it in your
plugins folder
- Restart the server
"No economy plugin found" error
You need an economy plugin. Install one of these:
- EssentialsX (recommended): or
- CMI: or if you want to stay on modrinth SunLight
- PlayerPoints: or
"Price outside allowed bounds" error
The price is outside the limits set in config.yml. Either:
- Change the price bounds in the config
- Give the player
CoinOp.bypass.bounds permission
"Daily trade limit reached" error
The player has traded too much of that item today. Either:
- Wait until tomorrow (limits reset daily)
- Increase the limit in config.yml
- Give the player
CoinOp.bypass.limit permission
GUI not opening
Check these settings in config.yml:
gui:
enabled: true
open-on-command: true
Redis connection failed
- Make sure Redis is installed and running
- Check the connection details in config.yml
- Test with
/coa sync status
Building from Source
If you want to modify the plugin:
- Install Java 17 or Java 21
- Clone or download the source code
- Run
./gradlew build (Linux/Mac) or gradlew.bat build (Windows)
- Find the JARs in
versions/*/build/libs/
Support
License
MIT License with Attribution
Credits
Developer: APPLEPIE6969
Inspired by Hypixel's Bazaar system and the Minecraft community's requests for a dynamic economy plugin.
评论 0
登录后参与评分
还没有评论,来抢沙发吧