Introduction to Brigadier Commands

Paper's command system is built on top of Minecraft's Brigadier command system. This system provides a powerful and flexible way to define commands and arguments. It offers many advantages above the previously widely used Bukkit command system:

• Less parsing or error checking required by the developer for arguments.
• Better user experience with client error checking.
• Integration with reload events, allowing the definition of commands usable in datapacks.
• Easier creation of subcommands.

info

To see a comparison between the new Brigadier system and the old Bukkit system, click here.

Guide

The following sites are worth-while to look through first when learning about Brigadier:

• The Command Tree
• Arguments and Literals
• Command Executors
• Command Registration
• Command Requirements

For a reference of more advanced arguments, you should look here:

• Minecraft Arguments
• Custom Arguments

If you prefer learning by doing, you might be interested in a step-by-step tutorial:

• Tutorial: Creating Utility Commands

More advanced topics can be found here:

• The Command Dispatcher
• Forks and Redirects
• Tutorial: Extending the execute method

Additional Support

For support regarding the command api, you can always ask in our Discord Server in the #paper-dev channel!