# CoinOp<\/p>\n
A dynamic, order-book-based economy plugin for Minecraft servers.<\/p>\n
## What This Plugin Does<\/p>\n
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.<\/p>\n
**Key Features:**
\n– Players can place buy orders (“I want to buy 100 diamonds for $50 each”)
\n– Players can place sell orders (“I want to sell 100 diamonds for $50 each”)
\n– When prices match, trades happen automatically
\n– Instant buy\/sell at current market price
\n– Item tooltips show current market prices
\n– Works across multiple servers (using Redis)
\n– Optional GUI for easier trading
\n– Anvil cost rework (no more “Too Expensive!”)<\/p>\n
## Requirements<\/p>\n
Before installing, make sure you have:<\/p>\n
1. **A Minecraft Server** running Paper or Spigot (versions 1.19.x – 1.21.x)
\n2. **Java 17+** for Minecraft 1.19-1.20, or **Java 21+** for Minecraft 1.21+
\n3. **An economy plugin** like EssentialsX, CMI, or PlayerPoints
\n4. **Vault** (will auto-download if missing)<\/p>\n
## Server Compatibility<\/p>\n
CoinOp works with all major Minecraft server software:<\/p>\n
| Server | Status | Notes |
\n|——–|——–|——-|
\n| Paper | \u2705 Full | Primary target – uses Paper API |
\n| Spigot | \u2705 Full | Compatible via Spigot API |
\n| Bukkit | \u2705 Full | Basic Bukkit API |
\n| Purpur | \u2705 Full | Paper fork, 100% compatible |
\n| Pufferfish | \u2705 Full | Paper fork, 100% compatible |
\n| Airplane | \u2705 Full | Paper fork, 100% compatible |
\n| TacoSpigot | \u2705 Full | Paper\/Spigot fork, compatible |
\n| Akarin | \u2705 Full | Paper fork, compatible |<\/p>\n
**Minecraft Versions:**
\n– 1.19.x (1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4)
\n– 1.20.x (1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6)
\n– 1.21.x (1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, etc.)<\/p>\n
## Installation<\/p>\n
1. Download the JAR file for your Minecraft version from the releases
\n2. Put it in your server’s `plugins` folder
\n3. Start the server
\n4. The plugin will create a `plugins\/CoinOp\/` folder with configuration files
\n5. Edit `config.yml` to customize the plugin
\n6. Restart the server or run `\/coa reload`<\/p>\n
## Configuration Guide<\/p>\n
The main configuration file is `config.yml` located in `plugins\/CoinOp\/`. Here’s a detailed explanation of each section:<\/p>\n
### Economy Settings<\/p>\n
“`yaml
\neconomy:
\n tax-rate: 0.0
\n“`<\/p>\n
– `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).<\/p>\n
**Example:** If you set `0.05` and a player sells diamonds for $100, they only receive $95.<\/p>\n
### Order Settings<\/p>\n
“`yaml
\norders:
\n min-amount: 1
\n max-amount: 2304
\n expiration-minutes: -1
\n“`<\/p>\n
– `min-amount`: Minimum items per order. Default is 1.
\n– `max-amount`: Maximum items per order. Default is 2304 (36 stacks = one double chest). Set to `-1` for unlimited.
\n– `expiration-minutes`: How long orders stay active. Default `-1` means orders never expire. Set to `1440` for 24 hours, `10080` for 1 week.<\/p>\n
### Commodities Configuration<\/p>\n
“`yaml
\ncommodities:
\n allowed: []
\n categories:
\n ores:
\n – DIAMOND
\n – IRON_INGOT
\n – GOLD_INGOT
\n crops:
\n – WHEAT
\n – CARROT
\n“`<\/p>\n
– `allowed`: Leave empty `[]` to allow all items. Or list specific items like `[DIAMOND, IRON_INGOT]` to only allow those.
\n– `categories`: Groups items together for the GUI. You can add your own categories.<\/p>\n
**Adding a new category:**
\n“`yaml
\ncommodities:
\n categories:
\n nether:
\n – NETHERITE_INGOT
\n – QUARTZ
\n – GLOWSTONE_DUST
\n“`<\/p>\n
### Trade Limits<\/p>\n
“`yaml
\nlimits:
\n global-daily-limit: 0
\n daily-limits:
\n DIAMOND: 1000
\n“`<\/p>\n
– `global-daily-limit`: Maximum total items a player can trade per day. `0` means unlimited.
\n– `daily-limits`: Per-item limits. The example limits players to 1000 diamonds per day.<\/p>\n
**Why use limits?** Prevents players from manipulating the market or laundering money.<\/p>\n
### Price Bounds<\/p>\n
“`yaml
\nprice-bounds:
\n enabled: true
\n global-min: 0.01
\n global-max: 1000000000
\n commodities:
\n DIAMOND:
\n min: 10.0
\n max: 10000.0
\n“`<\/p>\n
– `enabled`: Turn price bounds on\/off
\n– `global-min`: Minimum price for any item (default: $0.01)
\n– `global-max`: Maximum price for any item (default: $1 billion)
\n– `commodities`: Set specific limits per item<\/p>\n
**Why use price bounds?** Prevents players from:
\n– Selling items for $0.01 to transfer money between accounts
\n– Buying items for extreme prices to manipulate the market<\/p>\n
**Example scenario:** You want diamonds to trade between $10 and $10,000:
\n“`yaml
\nprice-bounds:
\n enabled: true
\n commodities:
\n DIAMOND:
\n min: 10.0
\n max: 10000.0
\n“`<\/p>\n
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.<\/p>\n
### Multi-Server Sync (Redis)<\/p>\n
If you run multiple servers and want them to share the same market:<\/p>\n
“`yaml
\nsync:
\n enabled: true
\n redis:
\n host: localhost
\n port: 6379
\n password: “”
\n database: 0
\n“`<\/p>\n
– `enabled`: Turn sync on\/off
\n– `host`: Redis server IP address
\n– `port`: Redis port (default 6379)
\n– `password`: Redis password (leave empty if none)
\n– `database`: Redis database number (0-15)<\/p>\n
**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.<\/p>\n
**Do I need Redis?** Only if you run multiple servers. For a single server, leave `enabled: false`.<\/p>\n
### Database Configuration<\/p>\n
“`yaml
\ndatabase:
\n type: sqlite
\n host: localhost
\n port: 3306
\n name: CoinOp
\n user: root
\n password: “”
\n“`<\/p>\n
– `type`: Either `sqlite` or `mysql`
\n – `sqlite`: Stores data in a local file. Good for single servers.
\n – `mysql`: Connects to a MySQL server. Good for multi-server setups.
\n– `host`, `port`, `name`, `user`, `password`: MySQL connection details (ignored if using SQLite)<\/p>\n
**When to use MySQL:** If you run multiple servers and want them to share order history and player data.<\/p>\n
### Lore Display Settings<\/p>\n
“`yaml
\nlore:
\n enabled: true
\n update-interval: 20
\n show-history: true
\n history-points: 5
\n“`<\/p>\n
– `enabled`: Show market prices in item tooltips
\n– `update-interval`: How often to refresh prices (in ticks, 20 ticks = 1 second)
\n– `show-history`: Show price trend in tooltip
\n– `history-points`: How many price points to show<\/p>\n
**What players see:** When they hover over a diamond in their inventory, they’ll see:
\n“`
\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
\nCoinOp Market Data
\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
\nBuy Price: $50.00 each
\nSell Price: $48.50 each
\n24h Volume: 125,300
\nTrend: \u25b2 Up
\n“`<\/p>\n
### Anvil Rework Settings<\/p>\n
“`yaml
\nanvil-rework:
\n enabled: true
\n enchantment-extraction: true
\n max-cost: 0
\n material-costs:
\n NETHERITE_INGOT: 15
\n DIAMOND: 10
\n“`<\/p>\n
– `enabled`: Turn the anvil rework on\/off
\n– `enchantment-extraction`: Allow moving enchants to books
\n– `max-cost`: Maximum anvil cost. `0` means unlimited (no “Too Expensive!”)
\n– `material-costs`: Base costs for different materials<\/p>\n
**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.<\/p>\n
**Enchantment Extraction:** Put an enchanted item in the left slot and a book in the right slot. The enchantments will transfer to the book.<\/p>\n
### GUI Settings<\/p>\n
“`yaml
\ngui:
\n enabled: true
\n open-on-command: true
\n title: “&6CoinOp &8- &7Market”
\n main-menu-size: 54
\n sounds:
\n open: “BLOCK_CHEST_OPEN”
\n click: “UI_BUTTON_CLICK”
\n icons:
\n ores: “DIAMOND”
\n crops: “WHEAT”
\n“`<\/p>\n
– `enabled`: Turn the GUI on\/off
\n– `open-on-command`: Open GUI when player runs `\/CoinOp` without arguments
\n– `title`: GUI title (supports color codes: `&6` = gold, `&8` = dark gray, `&7` = gray)
\n– `main-menu-size`: GUI size (must be multiple of 9, max 54)
\n– `sounds`: Sound effects for different actions
\n– `icons`: Which items represent each category<\/p>\n
**Color Codes:**
\n– `&0` – Black
\n– `&1` – Dark Blue
\n– `&2` – Dark Green
\n– `&3` – Dark Aqua
\n– `&4` – Dark Red
\n– `&5` – Dark Purple
\n– `&6` – Gold
\n– `&7` – Gray
\n– `&8` – Dark Gray
\n– `&9` – Blue
\n– `&a` – Green
\n– `&b` – Aqua
\n– `&c` – Red
\n– `&d` – Light Purple
\n– `&e` – Yellow
\n– `&f` – White<\/p>\n
## Commands<\/p>\n
### Player Commands<\/p>\n
| Command | Aliases | Description | Example | ### Admin Commands<\/p>\n | Command | Aliases | Description | ## Permissions<\/p>\n | Permission | Description | Default | ## How Trading Works<\/p>\n ### Order Book System<\/p>\n The CoinOp uses an order book – the same system used by real stock markets:<\/p>\n 1. **Buy Orders (Bids):** Players say “I want to buy X items at $Y each” 2. **Sell Orders (Asks):** Players say “I want to sell X items at $Y each” 3. **Matching:** When a buy order’s price meets or exceeds a sell order’s price, a trade happens at the sell order’s price.<\/p>\n **Example Trade:** ### Instant Buy\/Sell<\/p>\n For players who want immediate trades:<\/p>\n – **Instant Buy:** Buys at the lowest available sell price If no matching orders exist, the trade is rejected.<\/p>\n ## Troubleshooting<\/p>\n ### “Vault not found” error<\/p>\n The plugin will auto-download Vault on first run. If it fails: ### “No economy plugin found” error<\/p>\n You need an economy plugin. Install one of these: ### “Price outside allowed bounds” error<\/p>\n The price is outside the limits set in config.yml. Either: ### “Daily trade limit reached” error<\/p>\n The player has traded too much of that item today. Either: ### GUI not opening<\/p>\n Check these settings in config.yml: ### Redis connection failed<\/p>\n 1. Make sure Redis is installed and running ## Building from Source<\/p>\n If you want to modify the plugin:<\/p>\n 1. Install Java 17 or Java 21 ## Support<\/p>\n – Report bugs on the **issue tracker** ## License<\/p>\n MIT License with Attribution<\/p>\n ## Credits<\/p>\n **Developer:** APPLEPIE6969<\/p>\n Inspired by Hypixel’s Bazaar system and the Minecraft community’s requests for a dynamic economy plugin.<\/p>\n","protected":false},"excerpt":{"rendered":" A dynamic order-book economy plugin where players trade items at player-driven prices. Features instant buy\/sell, lore-based price tooltips, multi-server sync, optional GUI, and anvil cost rework.<\/p>\n","protected":false},"featured_media":43778,"template":"","meta":{"_minecraft_slug":"coinop","_minecraft_project_id":"C1QQIzCI","_minecraft_author":"APPLEPIE6969","_minecraft_license":"LicenseRef-MIT-License-with-attribution","_minecraft_downloads":1228,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"coinop.zip","_minecraft_size_bytes":87925505,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T07:55:55.187778Z","_minecraft_date_created":"2026-03-24T22:52:08.083735Z","_minecraft_date_modified":"2026-03-22T22:58:31.764188Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/coinop","_minecraft_icon_attachment_id":43778,"_minecraft_imported_at":"2026-06-02T00:49:45+00:00","_minecraft_import_hash":"ac1510e9fb2a0cdf8dd197ef6599acee","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,89,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-43777","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|———|————-|———|
\n| `\/coinop` | `\/co`, `\/market` | Open the CoinOp menu | `\/coinop` |
\n| `\/coinop buy
\n| `\/coinop sell
\n| `\/coinop instant buy
\n| `\/coinop instant sell
\n| `\/coinop orders` | `\/coinorders` | View your active orders | `\/coinorders` |
\n| `\/coinop orders cancel
\n| `\/coinop price
\n| `\/coinop history
\n|———|———|————-|
\n| `\/coinadmin reload` | `\/coa reload` | Reload configuration |
\n| `\/coinadmin bounds list` | `\/coa bounds list` | List all price bounds |
\n| `\/coinadmin bounds set
\n| `\/coinadmin bounds remove
\n| `\/coinadmin limits list` | `\/coa limits list` | List all trade limits |
\n| `\/coinadmin limits set
\n| `\/coinadmin stats [item]` | `\/coa stats` | View trading statistics |
\n| `\/coinadmin cleanup` | `\/coa cleanup` | Remove inactive orders |
\n| `\/coinadmin sync status` | `\/coa sync status` | Check Redis connection |<\/p>\n
\n|————|————-|———|
\n| `CoinOp.use` | Basic CoinOp usage | Everyone |
\n| `CoinOp.buy` | Place buy orders | Everyone |
\n| `CoinOp.sell` | Place sell orders | Everyone |
\n| `CoinOp.instant` | Use instant buy\/sell | Everyone |
\n| `CoinOp.orders` | View own orders | Everyone |
\n| `CoinOp.cancel` | Cancel own orders | Everyone |
\n| `CoinOp.admin` | Admin commands | OPs only |
\n| `CoinOp.admin.bounds` | Set price bounds | OPs only |
\n| `CoinOp.admin.limits` | Set trade limits | OPs only |
\n| `CoinOp.admin.reload` | Reload config | OPs only |
\n| `CoinOp.admin.sync` | Manage sync settings | OPs only |
\n| `CoinOp.bypass.limit` | Bypass trade limits | OPs only |
\n| `CoinOp.bypass.bounds` | Bypass price bounds | OPs only |<\/p>\n
\n – Highest prices are matched first
\n – Example: If someone is willing to pay $55 and another $50, the $55 order trades first<\/p>\n
\n – Lowest prices are matched first
\n – Example: If someone is selling at $45 and another at $50, the $45 order trades first<\/p>\n
\n– Alice places a buy order: “I want to buy 100 diamonds at $50 each”
\n– Bob places a sell order: “I want to sell 50 diamonds at $48 each”
\n– Since $50 \u2265 $48, they trade: Bob sells 50 diamonds to Alice for $48 each
\n– Alice’s order now has 50 diamonds remaining at $50 each<\/p>\n
\n– **Instant Sell:** Sells at the highest available buy price<\/p>\n
\n1. Download Vault from https:\/\/www.spigotmc.org\/resources\/vault.34315\/
\n2. Put it in your `plugins` folder
\n3. Restart the server<\/p>\n
\n– EssentialsX (recommended): https:\/\/essentialsx.net\/ or https:\/\/modrinth.com\/plugin\/essentialsx
\n– CMI: https:\/\/www.spigotmc.org\/resources\/cmi.3742\/ or if you want to stay on modrinth SunLight
\n– PlayerPoints: https:\/\/www.spigotmc.org\/resources\/playerpoints.1997\/ or https:\/\/modrinth.com\/plugin\/playerpoints<\/p>\n
\n– Change the price bounds in the config
\n– Give the player `CoinOp.bypass.bounds` permission<\/p>\n
\n– Wait until tomorrow (limits reset daily)
\n– Increase the limit in config.yml
\n– Give the player `CoinOp.bypass.limit` permission<\/p>\n
\n“`yaml
\ngui:
\n enabled: true
\n open-on-command: true
\n“`<\/p>\n
\n2. Check the connection details in config.yml
\n3. Test with `\/coa sync status`<\/p>\n
\n2. Clone or download the source code
\n3. Run `.\/gradlew build` (Linux\/Mac) or `gradlew.bat build` (Windows)
\n4. Find the JARs in `versions\/*\/build\/libs\/`<\/p>\n
\n– For questions, ask in the **discussion forum**<\/p>\n