UltraCommand

A powerful custom-command system.

UltraCommand allows a server administrator to define custom commands that can send the executing player messages, run commands as the player or as the console, and more!

Usage

Add a command named <name>:

/uc add <name>

Add an element with content <value> to the command <name>:

/uc add <element> <name> <value

where <element> is one of:

  • text - Text that will be sent to the player. Colour codes using '&' can be used.
  • chat - Chat messages that will be force-sent by the player. Colour codes using & can be used.
  • pcmd - Commands that will be run as the player. The leading slash is optional.
  • ccmd - Commands that will be run as the console. The leading slash is optional.

If the command named <name> does not exist when this command is run, it is automatically created. This makes it optional to create it with /uc add <name> beforehand.

The element value can contain substitutions (placeholders for data that is specific to a certain time and context a command is run in). A list of substitions is available further down the page.

Examples

Define /ranks to display a list of server ranks to the player:

[/uc add ranks]
/uc add text ranks &eOur server's ranks:
/uc add text ranks &e- &aBuilder
/uc add text ranks &e- &aForeman
/uc add text ranks &e- &aArchitect
/uc add text ranks &e- &aPlanner
/uc add text ranks &e- &cAdmin
/uc add text ranks &e- &bCEO

Define /welcome <player> to show a welcome message to a new player in a chat message:

[/uc add welcome]
/uc add chat welcome Welcome to the server, $1!

The $1 substitution is used to refer to the actual content of <player> part of the command above.

Define /nightvision to give the player the Night Vision effect for an hour.

[/uc add nightvision]
/uc add ccmd nightvision /effect $p 16 3600 10

The $p substitution is used to refer to the player's username.

Substitutions

  • $p - The username of the player running the custom command.
  • $d - The display name of the player running the custom command.
  • $a - All arguments given to the custom command, separated with spaces (e.g. for passing to another command).
  • $1, $2, $3 etc. - The arguments given to the custom command.

Commands

/ultracommand can be used as an alias to /uc.

  • /uc add <name> - Add a command named <name>.
  • /uc add text <name> <text> - Add text <text> to command <name>.
  • /uc add chat <name> <chat> - Add chat message <chat> to command <name>.
  • /uc add pcmd <name> <command> - Add player command <text> to command <name>.
  • /uc add ccmd <name> <command> - Add console command <text> to command <name>.
  • /uc list [name] - List all commands, or the elements of command <name>.
  • /uc reload - Reload the configuration from disk.
  • /uc remove <name> - Remove command <name>.
  • /uc remove text <name> - Remove all text from command <name>.
  • /uc remove chat <name> - Remove all chat messages from command <name>.
  • /uc remove pcmd <name> - Remove all player commands from command <name>.
  • /uc remove ccmd <name> - Remove all console commands from command <name>.
  • /uc save - Save configuration modified in-game to disk (this is done once per minute automatically).

Permissions

  • ultracommand.configure - Gives access to use /uc and /ultracommand.
  • ultracommand.commands.* - Gives access to use all custom commands defined with this plugin.
  • ultracommand.commands.<name> - Gives access to use the command named <name> defined with this plugin.

Source code

The plugin's source code can be found on its Github repository.

Support

If you have a bug report or feature request, bear in mind that I rarely check the comments on my plugins. Consider opening an issue on GitHub for a swifter response, as this will notify me by email.

The UltraCommand Team

profile avatar
  • 4
    Projects
  • 24.1K
    Downloads

More from _ForgeUser7706121View all

  • MyMOTD project image

    MyMOTD

    • 12.5K
    • Bukkit Plugins

    A lightweight plugin to allow the server list MOTD to be changed in-game.

    • 12.5K
    • October 16, 2013
    • Bukkit Plugins
    • +1
  • KMail project image

    KMail

    • 3.0K
    • Bukkit Plugins

    A simple yet powerful inter-server mail plugin.

    • 3.0K
    • June 8, 2013
    • Bukkit Plugins
  • Night Vision Goggles project image

    Night Vision Goggles

    • 0
    • Bukkit Plugins

    Place a pumpkin on your head and you have night vision! Very useful for ordinary players

    • 0
    • June 8, 2013
    • Bukkit Plugins
  • ClearFX project image

    ClearFX

    • 2.4K
    • Bukkit Plugins

    Clears player's potion effects.

    • 2.4K
    • May 25, 2013
    • Bukkit Plugins
  • MyMOTD project image

    MyMOTD

    • 12.5K
    • Bukkit Plugins

    A lightweight plugin to allow the server list MOTD to be changed in-game.

    • 12.5K
    • October 16, 2013
    • Bukkit Plugins
    • +1
  • KMail project image

    KMail

    • 3.0K
    • Bukkit Plugins

    A simple yet powerful inter-server mail plugin.

    • 3.0K
    • June 8, 2013
    • Bukkit Plugins
  • Night Vision Goggles project image

    Night Vision Goggles

    • 0
    • Bukkit Plugins

    Place a pumpkin on your head and you have night vision! Very useful for ordinary players

    • 0
    • June 8, 2013
    • Bukkit Plugins
  • ClearFX project image

    ClearFX

    • 2.4K
    • Bukkit Plugins

    Clears player's potion effects.

    • 2.4K
    • May 25, 2013
    • Bukkit Plugins