CoinOp

# 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: 1. **A Minecraft Server** running Paper or Spigot (versions 1.19.x - 1.21.x) 2. **Java 17+** for Minecraft 1.19-1.20, or **Java 21+** for Minecraft 1.21+ 3. **An economy plugin** like EssentialsX, CMI, or PlayerPoints 4. **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 1. Download the JAR file for your Minecraft version from the releases 2. Put it in your server's `plugins` folder 3. Start the server 4. The plugin will create a `plugins/CoinOp/` folder with configuration files 5. Edit `config.yml` to customize the plugin 6. 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 ```yaml 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 ```yaml 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 ```yaml commodities: allowed: categories: ores: - DIAMOND - IRON_INGOT - GOLD_INGOT crops: - WHEAT - CARROT ``` - `allowed`: Leave empty `` to allow all items. Or list specific items like `` to only allow those. - `categories`: Groups items together for the GUI. You can add your own categories. **Adding a new category:** ```yaml commodities: categories: nether: - NETHERITE_INGOT - QUARTZ - GLOWSTONE_DUST ``` ### Trade Limits ```yaml 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 ```yaml 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: ```yaml 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: ```yaml sync: enabled: true redis: host: localhost port: 6379 password: "" database: 0 ``` - `enabled`: Turn sy