Shortcut

A Minecraft plugin for creating command shortcuts without needing another plugin

Reload ready! This plugin has no adverse effects when /reload is executed: commands will be disabled and added according to the changes to the configuration

Configuration

Each command can be individually configured

The basic yaml structure is as follows:

# This is the command name/label that you will type ingame (think /command_name)
command_name:
  # An OPTIONAL permission to use, this can be anything
  # If the sender doesn't have this permission they cannot run this shortcut
  permision: example.permission
  # If the command can only be executed by players (this is also optional) 
  # For none players the execution method returns instantly
  playerOnly: false
  # An OPTIONAL way to describe how the command should be used
  usage: "/command_name <value>"
  # What is actually used to control what the shortcut does
  executions:
    - {
        # This is the command to run
        # %%0 is replaced with the first argument provided, %%1 is the second and so on
        # Placeholders can be used if you so choose
        run: say %%0,
        # Who to run the command as
        # Must be either "sender" OR "console"
        as: sender
    }
    - {
        # This is a message that is to be sent to the user
        # Formatting and placeholders can be used here
        display: Example message with §aFormatting!
    }

Example

The following is an example for a "gmc" command shortcut:

Placeholders are utilised in this example, ensure you have PlaceHolderApi if you wish to use it

# the command label to use
gmc:
  # permission required to run this shortcut
  # this doesn't bypass the check on the original command if proxying!
  # placeholders do NOT work here
  permission: command.gamemode
  # if the command can only be ran by a player
  # placeholders do NOT work here
  playerOnly: true
  # displayed when an invalid version of this command is issued
  # placeholders do NOT work here
  usage: /gmc
  executions:
    # runs the command "gamemode creative" as the sender
    # placeholders can be used here
    - { run: gamemode creative %player_name%, as: console }
    # displays this message to the executor
    # placeholders can be used here
    - { display: "§0[§a✓§0]§r You are now in creative mode" }

Below is each element explained:

Execution Step 1

This step instructs the system to set the executor's game mode to creative. The %player_name% placeholder is replaced with the executor's name. The command is executed as the console.

Execution Step 2

This step displays a message to the executor indicating that they are now in creative mode. The message includes formatting for visual appeal.