Skip to content

Norbit4/BetterCommands

Repository files navigation

Commands

/bettecommands reload - reload plugin config.

⚠️ When you add new command or change name existing command, you need to restart server. Bukkit server don't support add new commands without restart server :c

Config

#---------------------------------------#
#                [Help]                 #
#---------------------------------------#

# 1.Reload config:
#  To reload config use /bc reload, or /bettercommands reload command.

#  [!] When you add new command or change name existing command, you need to restart server!
#  Bukkit server don't support add new commands without restart server :c

# 2.Actions:
#   - replace:
#      replace command to another command
#      ex. /core -> /essentials, when player use /core reload it will replace to /essentials reload

#   - text:
#      send message to player who use command

#   - broadcast:
#      broadcast message to all players on server

#   - server_command:
#      execute command as console

#   - player_command:
#      execute command as player

# 3.Sub-commands:
#   - You can create sub-commands for main command
#   - To use sub-commands, use /main-command sub-command
#   - enable/disable tab completer for sub-commands

# 4.Placeholders:
#   - {PLAYER} - player name who use command

#  For other placeholders, use PlaceholderAPI plugin:
#   - https://www.spigotmc.org/resources/placeholderapi.6245/

# 4.Hex colors:
#   - To use HEX color, use &#HEXCODE (ex. &#DBC7FF)

# hex codes: https://htmlcolorcodes.com/
#---------------------------------------#
#               [Config]                #
#---------------------------------------#

blocked:
  commands:
    - 'pl'
    - 'plugins'
    - 'help'
    - 'version'
    - '?'
  perm: 'bc.*' # <- permission to use blocked commands
  message: '&cYou cannot use this command!' # <- default message when player don't have permission

commands:
  core: # <- command name (without /)
    perm: 'core.admin' # <- when player don't have permission, it will send message default message
    actions:
      action-1:
        type: 'replace' # <- replace, message, broadcast
        action:
          - 'essentials' # <- command to replace, when player use /core, it will replace to /essentials
  info:
    perm: 'info.admin' # <- permission to use this command
    perm-message: '&cYou cannot use this command!' # <- message when player don't have permission
    completer: true
    #multi actions
    actions:
      action-1:
        type: 'text'
        action:
          - '&#DBC7FFSended to all players!!' # <- to use HEX color, use &#HEXCODE
      action-2:
        type: 'broadcast'
        action:
          - '&aSended from {PLAYER}!'
          - '&aHI ALL!'
  diamonds:
    actions:
      action-1:
        type: 'text'
        action:
          - '&#DBC7FFDiamonds!'
      action-2:
        type: 'server_command' # <- execute command as console
        action:
          - 'give {PLAYER} minecraft:diamond 1' # (without /)
  sop:
    completer: true # <- enable tab completer
    actions:
      action-1:
        type: 'text'
        action:
          - '&aUsage: /sop <op/deop>'
    sub-commands: # <- sub-commands
      op: # <- sub-command name, use /sop op
        actions:
          action-1:
            type: 'server_command'
            action:
              - 'op {PLAYER}'
      deop: # <- sub-command name, use /sop deop
        actions:
          action-1:
            type: 'server_command'
            action:
              - 'deop {PLAYER}'

Links

spigot
builtbybit