CryptocurrencyMC
Bring real-world cryptocurrency trading to your Minecraft server.
Players can buy, sell, and trade popular cryptocurrencies with live price updates!

Get Started
View the wiki (very important!!)

Real-Time Prices
Live cryptocurrency prices from CoinGecko API with automatic updates and circuit breaker protection for reliability.

Vault Integration
Seamlessly integrates with your server's economy through Vault.
Players buy and sell crypto using your server's currency.

Interactive GUI
Beautiful market GUI with real-time charts, sparklines, and an easy-to-use trading interface for all your players.

Player Trading
Transfer cryptocurrencies between players and convert between different crypto assets with automatic rate calculation.

Leaderboards
Display top crypto investors on your server based on total portfolio value in USD.

Persistent Wallets
All player wallets are automatically saved and persist across server restarts.
Never lose your crypto investments!

Key Features
Supported Cryptocurrencies
CryptocurrencyMC supports a wide range of popular cryptocurrencies including:

• Bitcoin (BTC) — The original cryptocurrency
• Ethereum (ETH) — Smart contract platform
• Binance Coin (BNB) — Exchange token
• Cardano (ADA) — Proof of stake blockchain
• Solana (SOL) — High-performance blockchain
• Dogecoin (DOGE) — The meme coin
• And many more configurable options!

Transaction History
Every transaction is recorded and can be viewed by players:

• Buy and sell operations
• Player-to-player transfers
• Crypto conversions
• Admin operations and airdrops

⚙️ Admin Tools
Comprehensive admin commands for managing player wallets:

• Set, Add, Remove — Modify player balances directly
• Giveall — Distribute crypto to all online players (airdrops)
• API Management — Monitor API health and force price refreshes
• Hot Reload — Reload configuration without restarting

How It Works
Quick Overview:
Players use your server's currency (via Vault) to purchase cryptocurrencies at real-world prices.
They can hold, trade, and sell their crypto for profit or loss based on market fluctuations.

Trading Flow

1. Check Prices: /crypto price [symbol]
2. Buy Crypto: /crypto buy [symbol] [amount]
3. View Balance: /crypto balance
4. Sell or Trade: Sell back to currency or trade with other players
5. Track History: /crypto history

Market GUI
Players can access an interactive GUI with /crypto market that displays:

• Real-time prices for all enabled cryptocurrencies
• 24-hour price change indicators
• Sparkline charts showing price trends
• Click-to-trade functionality

PlaceholderAPI Support
Integrate crypto data into other plugins with PlaceholderAPI placeholders:

%crypto_balance_[symbol]% - Player's balance of a specific crypto
%crypto_balance_usd_[symbol]% - USD value of player's crypto holdings
%crypto_price_[symbol]% - Current price of a cryptocurrency
%crypto_total_usd% - Total portfolio value in USD

Requirements

• Minecraft Version: 1.21+ (Paper or Spigot)
• Java Version: 21+
• Dependencies:
  • ✅ Required: Vault (for economy integration)
  • Optional: PlaceholderAPI (for placeholders)
• Internet Connection: Required for fetching live cryptocurrency prices

⚡ Quick Start

1. Download the latest plugin JAR file
2. Place it in your server’s plugins/ folder
3. Ensure Vault and an economy plugin are installed
4. Start your server
5. Configure plugins/Cryptocurrency/config.yml to your liking
6. Reload with /crypto reload
7. Start trading with /crypto!