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 Commands

📈

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 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

Check Prices: Players view current cryptocurrency prices using /crypto price [symbol]
Buy Crypto: Purchase cryptocurrencies with server currency using /crypto buy [symbol] [amount]
View Balance: Check portfolio value with /crypto balance
Sell or Trade: Sell back to currency or trade with other players
Track History: View all transactions with /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

Download the latest plugin JAR file
Place it in your server's plugins/ folder
Ensure Vault and an economy plugin are installed
Start your server
Configure plugins/Cryptocurrency/config.yml to your liking
Use /crypto reload to apply changes
Start trading with /crypto!

✅ Ready to Go! Check out the Installation Guide for detailed setup instructions.