πŸ”‘Commands & Permissions

Complete reference for all BlackMarket commands and permissions.

Player Commands

/blackmarket

Opens the BlackMarket GUI.

Aliases: /bm, /market

Permission: blackmarket.use

Usage:

/blackmarket
/blackmarket help
/blackmarket info

Subcommands:

Subcommand
Description
Permission

(none)

Opens market GUI

blackmarket.use

help

Shows help message

blackmarket.use

info

Shows market information

blackmarket.use


Admin Commands

/blackmarketadmin

Administrative commands for managing the market.

Aliases: /bma, /bmadmin

Permission: blackmarket.admin

Usage: /bma <subcommand> [args]

Subcommands Reference

/bma help

Displays all admin commands.

Permission: blackmarket.admin


/bma reload

Reloads configuration files.

Permission: blackmarket.admin.reload

Arguments:

  • config - Reload config.yml only

  • messages - Reload messages/language files only

  • items - Reload items.yml only

  • all - Reload everything (default)

Examples:


/bma reset

Forces an immediate market reset.

Alias: /bma refresh

Permission: blackmarket.admin.reset

Effects:

  • Rotates market items immediately

  • Resets all purchase data

  • Clears cooldowns and stock counts

  • Updates next reset time

Warning: This affects all players and cannot be undone!


/bma open

Opens the market GUI for another player.

Permission: blackmarket.admin.open

Arguments:

  • <player> - Target player name

Examples:

Use Cases:

  • Testing as another player

  • Customer support

  • Demonstrating features


/bma info

Shows detailed plugin information.

Permission: blackmarket.admin.info

Displays:

  • Plugin version

  • Server type (Bukkit/Spigot/Paper/Folia)

  • Market type (Global/Per-Player)

  • Database type (SQLite/MySQL)

  • Economy provider

  • Online players

  • Current language

  • Active market items (if global)


/bma debug

Toggles debug mode on/off.

Permission: blackmarket.admin.debug

Effects:

  • Enables/disables verbose logging

  • Shows detailed system information

  • Helps diagnose issues

Debug Information Shown:

  • Folia support status

  • Reset interval

  • Items per reset

  • Pagination status

  • Categories status

  • MiniMessage status

  • Localization status

  • Current language


/bma migrate

Migrates data between database types.

Permission: blackmarket.admin.migrate

Arguments:

  • sqlite - Migrate to SQLite

  • mysql - Migrate to MySQL

  • confirm - Confirmation flag (required)

Process:

  1. Run without confirm to see warning

  2. Run with confirm to execute migration

  3. Wait for completion message

  4. Update config.yml database type

  5. Reload plugin

Examples:

What Gets Migrated:

  • βœ… Player data

  • βœ… Purchase history

  • βœ… Player market items

  • βœ… Global market items

  • βœ… Item sold counts

  • βœ… Purchase records

  • βœ… Global settings

Warning: Always backup your database before migrating!


Complete Permissions List

Player Permissions

Permission
Description
Default

blackmarket.use

Access /blackmarket command

true

blackmarket.buy.<item>

Purchase specific item

true

Admin Permissions

Permission
Description
Default

blackmarket.admin

Access all admin commands

op

blackmarket.admin.reload

Reload configuration

op

blackmarket.admin.reset

Force market reset

op

blackmarket.admin.open

Open market for others

op

blackmarket.admin.info

View plugin info

op

blackmarket.admin.debug

Toggle debug mode

op

blackmarket.admin.migrate

Migrate databases

op

Item-Specific Permissions

You can require permissions for individual items using the permission property:

Common Permission Patterns:


Permission Examples

LuckPerms Setup

GroupManager Setup

PermissionsEx Setup


Permission Hierarchies

Wildcard Permissions

Grant all permissions at once:


Command Blocks

All commands can be executed from command blocks:

Note: Command blocks always have operator permissions.


Console Commands

All admin commands work from console:

Player-specific commands require player argument:


Tab Completion

/blackmarket

/bma


Command Cooldowns

You can add cooldowns to commands using external plugins like DeluxeCommands or CommandCooldown:


Command Aliases

Creating Custom Aliases

Using Bukkit commands.yml:

Using EssentialsX:


Common Use Cases

Daily Market Check

Automated Resets

Testing Items

Debugging Issues


Next Steps

Last updated