Permissions Reference

Complete guide to all permission nodes in CryptocurrencyMC. Configure these in your permission plugin (e.g., LuckPerms, PermissionsEx, GroupManager).

All Permissions

Permission Node	Description	Default
`crypto.user.price`	View cryptocurrency prices	true
`crypto.user.trade`	Buy, sell, transfer, and convert crypto	true
`crypto.user.balance`	View wallet balance and history	true
`crypto.user.top`	View leaderboard of top investors	true
`crypto.user.chart`	View price charts	true
`crypto.user.market`	Access the market GUI	true
`crypto.admin.reload`	Reload config and manage API	op
`crypto.admin.edit`	Modify player wallets (set/add/remove)	op
`crypto.admin.giveall`	Distribute crypto to all players	op

User Permissions

These permissions control player access to basic cryptocurrency features.

crypto.user.price

Default: true

Commands:

/crypto price [symbol]

Description: Allows players to view current cryptocurrency prices. This is a read-only permission with no economic impact.

crypto.user.trade

Default: true

Commands:

/crypto buy [symbol] [amount]
/crypto sell [symbol] [amount]
/crypto transfer [player] [symbol] [amount]
/crypto convert [from] [to] [amount]

Description: The main trading permission. Controls all buying, selling, and peer-to-peer trading functions. This is essential for an active crypto economy.

💡 Note: This permission is required for players to participate in the economy. Without it, they can only view prices and balances.

crypto.user.balance

Default: true

Commands:

/crypto balance [player]
/crypto history [player] [limit]

Description: Allows viewing wallet balances and transaction history. Players can view their own data by default, but need admin permissions to view others.

crypto.user.top

Default: true

Commands:

/crypto top [limit]

Description: Allows viewing the leaderboard of top cryptocurrency investors. Great for creating competition among players!

crypto.user.chart

Default: true

Commands:

/crypto chart [symbol]

Description: Allows viewing ASCII price charts in chat. Helps players make informed trading decisions.

crypto.user.market

Default: true

Commands:

/crypto market

Description: Allows access to the interactive market GUI with real-time prices, charts, and click-to-trade functionality.

Admin Permissions

These permissions are restricted to operators by default and provide administrative control.

crypto.admin.reload

Default: op

Commands:

/crypto reload
/crypto api status
/crypto api refresh [symbol]

Description: Allows reloading the plugin configuration and managing API connections. Use this to apply config changes without restarting the server.

crypto.admin.edit

Default: op

Commands:

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

Description: Allows direct modification of player cryptocurrency wallets. Useful for resolving issues, compensating players, or manual economic adjustments.

⚠️ Warning: This is a powerful permission. Only grant to trusted staff members as it allows complete control over player balances.

crypto.admin.giveall

Default: op

Commands:

/crypto giveall [symbol] [amount]

Description: Allows distributing cryptocurrency to all online players (airdrops). Great for events, promotions, or economy boosts.

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

Permission Setup Examples

LuckPerms

Examples using LuckPerms commands:

Give all user permissions to a group:

/lp group default permission set crypto.user.price true
/lp group default permission set crypto.user.trade true
/lp group default permission set crypto.user.balance true
/lp group default permission set crypto.user.top true
/lp group default permission set crypto.user.chart true
/lp group default permission set crypto.user.market true

Give admin permissions to moderators:

/lp group moderator permission set crypto.admin.reload true
/lp group moderator permission set crypto.admin.edit true

Give airdrop permission to admin group:

/lp group admin permission set crypto.admin.giveall true

Give specific player full access:

/lp user Steve permission set crypto.* true

PermissionsEx

Examples using PermissionsEx commands:

Set group permissions:

/pex group default add crypto.user.*
/pex group admin add crypto.admin.*

Set user permissions:

/pex user Steve add crypto.admin.edit

Configuration File (permissions.yml)

If using a permissions plugin with YAML config:

groups:
  default:
    permissions:
      - crypto.user.price
      - crypto.user.trade
      - crypto.user.balance
      - crypto.user.top
      - crypto.user.chart
      - crypto.user.market
  
  moderator:
    permissions:
      - crypto.admin.reload
      - crypto.admin.edit
  
  admin:
    permissions:
      - crypto.*

Permission Wildcards

You can use wildcards to grant multiple permissions at once:

Wildcard	Grants
`crypto.*`	All permissions (user and admin)
`crypto.user.*`	All user permissions
`crypto.admin.*`	All admin permissions

💡 Tip: Most permission plugins support wildcards. Use crypto.user.* for regular players and crypto.* for admins.

Recommended Permission Setups

For Regular Players

Give these permissions to your default player group:

crypto.user.price
crypto.user.trade
crypto.user.balance
crypto.user.top
crypto.user.chart
crypto.user.market

Or simply: crypto.user.*

For VIP Players

VIP players can have the same as regular players, or add custom features through other plugins using PlaceholderAPI integration.

For Moderators

Moderators should have user permissions plus:

crypto.user.*
crypto.admin.reload

This allows them to reload configs but not modify wallets.

For Administrators

Administrators should have full access:

crypto.*

Or explicitly:

crypto.user.*
crypto.admin.*

For Economy Managers

Staff focused on economy management need:

crypto.user.*
crypto.admin.edit
crypto.admin.giveall

Restricted Trading (Example)

If you want players to only view prices but not trade:

crypto.user.price
crypto.user.balance
crypto.user.chart
crypto.user.market

Remove crypto.user.trade to disable buying/selling.

Troubleshooting Permissions

Players Can't Use Commands

Issue: Players get "You don't have permission" messages.

Solutions:

Verify the permission is granted: /lp user [player] permission check crypto.user.trade
Check if your permission plugin is loaded and working
Ensure there are no permission negations (permissions set to false)
Try granting the wildcard: crypto.user.*
Restart the server after changing permissions

Admin Commands Not Working

Issue: Operators can't use admin commands.

Solutions:

Check if you're actually OP: /op [your_name]
Verify admin permissions are granted
Try granting explicitly: /lp user [name] permission set crypto.admin.* true
Check server.properties has enable-command-block=true

Permission Conflicts

Issue: Permissions don't work as expected.

Solutions:

Check for negative permissions that override positive ones
Verify group inheritance order in your permission plugin
Use /lp user [player] permission info to see all active permissions
Clear permission cache: /lp reloadconfig

Security Best Practices

Principle of Least Privilege: Only grant permissions that players actually need
Separate Roles: Create different staff roles with appropriate permission levels
Audit Regularly: Review who has admin permissions periodically
Log Admin Actions: All admin commands are logged to console for audit trails
Restrict Giveall: Only give crypto.admin.giveall to highly trusted staff
Test Permissions: Test new permission setups on a test server first
Document Changes: Keep track of which groups have which permissions