Commands Reference

Complete guide to all CryptocurrencyMC commands. All commands can be used with aliases: /crypto, /cryptocurrency, or /cc

Player Commands

These commands are available to all players by default.

Price Information

/crypto price [symbol]

View the current price of a cryptocurrency.

/crypto price [symbol]

Parameter	Description	Required
symbol	Cryptocurrency symbol (BTC, ETH, etc.)	No - shows all if omitted

Permission: crypto.user.price (default: true)

Examples:

/crypto price BTC
/crypto price
/cc price ETH

Trading Commands

/crypto buy [symbol] [amount]

Purchase cryptocurrency using your server currency.

/crypto buy <symbol> <amount>

Parameter	Description	Required
symbol	Cryptocurrency to buy (BTC, ETH, etc.)	Yes
amount	Amount of crypto to purchase	Yes

Permission: crypto.user.trade (default: true)

Examples:

/crypto buy BTC 0.5
/crypto buy ETH 10
/crypto buy DOGE 1000

💡 Note: The cost in server currency is calculated based on current market prices. You must have sufficient balance in your economy account.

/crypto sell [symbol] [amount]

Sell cryptocurrency for server currency.

/crypto sell <symbol> <amount>

Parameter	Description	Required
symbol	Cryptocurrency to sell	Yes
amount	Amount of crypto to sell	Yes

Permission: crypto.user.trade (default: true)

Examples:

/crypto sell BTC 0.25
/crypto sell ETH 5
/crypto sell ADA 100

/crypto transfer [player] [symbol] [amount]

Transfer cryptocurrency to another player.

/crypto transfer <player> <symbol> <amount>

Parameter	Description	Required
player	Target player username	Yes
symbol	Cryptocurrency to transfer	Yes
amount	Amount to transfer	Yes

Permission: crypto.user.trade (default: true)

Examples:

/crypto transfer Steve BTC 0.1
/crypto transfer Alex ETH 2.5

/crypto convert [from] [to] [amount]

Convert one cryptocurrency to another.

/crypto convert <from_symbol> <to_symbol> <amount>

Parameter	Description	Required
from_symbol	Source cryptocurrency	Yes
to_symbol	Target cryptocurrency	Yes
amount	Amount to convert	Yes

Permission: crypto.user.trade (default: true)

Examples:

/crypto convert BTC ETH 0.5
/crypto convert ETH BNB 10

💡 Note: Conversion rates are calculated using USD as an intermediary currency based on current market prices.

Portfolio Management

/crypto balance [player]

View your cryptocurrency portfolio or another player's portfolio.

/crypto balance [player]

Parameter	Description	Required
player	Player username to check	No - shows your own if omitted

Permission: crypto.user.balance (default: true)

Examples:

/crypto balance
/crypto balance Steve

/crypto top [limit]

View the leaderboard of top cryptocurrency investors.

/crypto top [limit]

Parameter	Description	Required
limit	Number of top players to show (max 20)	No - defaults to 10

Permission: crypto.user.top (default: true)

Examples:

/crypto top
/crypto top 20

/crypto history [player] [limit]

View transaction history.

/crypto history [player] [limit]

Parameter	Description	Required
player	Player to view history for	No - shows your own
limit	Number of transactions to show (max 50)	No - defaults to 10

Permission: crypto.user.balance (default: true)

Examples:

/crypto history
/crypto history Steve 20

Market & Charts

/crypto market

Open the interactive market GUI with real-time prices and charts.

/crypto market

Permission: crypto.user.market (default: true)

Example:

/crypto market

/crypto chart [symbol]

View a price chart for a specific cryptocurrency.

/crypto chart <symbol>

Parameter	Description	Required
symbol	Cryptocurrency symbol	Yes

Permission: crypto.user.chart (default: true)

Examples:

/crypto chart BTC
/crypto chart ETH

Admin Commands

These commands require operator status or specific admin permissions.

Wallet Management

/crypto set [player] [symbol] [amount]

Set a player's cryptocurrency balance to a specific amount.

/crypto set <player> <symbol> <amount>

Parameter	Description	Required
player	Target player username	Yes
symbol	Cryptocurrency symbol	Yes
amount	New balance amount	Yes

Permission: crypto.admin.edit (default: op)

Examples:

/crypto set Steve BTC 1.0
/crypto set Alex ETH 50

/crypto add [player] [symbol] [amount]

Add cryptocurrency to a player's wallet.

/crypto add <player> <symbol> <amount>

Parameter	Description	Required
player	Target player username	Yes
symbol	Cryptocurrency symbol	Yes
amount	Amount to add	Yes

Permission: crypto.admin.edit (default: op)

Examples:

/crypto add Steve BTC 0.5
/crypto add Alex DOGE 100

/crypto remove [player] [symbol] [amount]

Remove cryptocurrency from a player's wallet.

/crypto remove <player> <symbol> <amount>

Parameter	Description	Required
player	Target player username	Yes
symbol	Cryptocurrency symbol	Yes
amount	Amount to remove	Yes

Permission: crypto.admin.edit (default: op)

Examples:

/crypto remove Steve BTC 0.25
/crypto remove Alex ETH 10

Mass Distribution

/crypto giveall [symbol] [amount]

Give cryptocurrency to all online players (airdrop).

/crypto giveall <symbol> <amount>

Parameter	Description	Required
symbol	Cryptocurrency symbol	Yes
amount	Amount to give each player	Yes

Permission: crypto.admin.giveall (default: op)

Examples:

/crypto giveall BTC 0.01
/crypto giveall DOGE 50

⚠️ Warning: This command affects all online players. Use with caution as it can significantly impact your server's economy.

System Management

/crypto reload

Reload the plugin configuration without restarting the server.

/crypto reload

Permission: crypto.admin.reload (default: op)

Example:

/crypto reload

💡 Note: This reloads messages, enabled cryptocurrencies, and other config options. Wallets and transaction history are not affected.

/crypto api status

Check the health status of the CoinGecko API connection.

/crypto api status

Permission: crypto.admin.reload (default: op)

Example:

/crypto api status

/crypto api refresh [symbol]

Force a price refresh for a specific cryptocurrency.

/crypto api refresh <symbol>

Parameter	Description	Required
symbol	Cryptocurrency symbol to refresh	Yes

Permission: crypto.admin.reload (default: op)

Examples:

/crypto api refresh BTC
/crypto api refresh ETH

Command Aliases

The main command /crypto has the following aliases:

Alias	Example
`/crypto`	`/crypto balance`
`/cryptocurrency`	`/cryptocurrency price BTC`
`/cc`	`/cc buy ETH 10`

Tips & Best Practices

Use Tab Completion: Most commands support tab completion for symbols and player names
Check Prices First: Always check current prices before making large trades
Monitor API Status: Use /crypto api status if experiencing price fetch issues
Regular Backups: Admins should backup wallets.yml regularly
Test Transfers: Test with small amounts before large transfers
Use the GUI: The market GUI provides the best trading experience for players