[API] CommandAPI [1.16.5-1.21.4]

[API] CommandAPI [1.16.5-1.21.4] -----

An API to use the command UI introduced in Minecraft 1.13

Download Now
742.3 KB .jar

CommandAPI 9.7.0

New improvements from 9.6.0:

Adds support for Minecraft 1.21.4
#575 Adds a NMS independent test toolkit to allow developers to test their commands with MockBukkit
#613 Adds a thenNested method for CommandTrees to reduce nesting in code

----------, Dec 4, 2024

CommandAPI 9.6.0

New improvements from 9.5.3:

Adds support for Minecraft 1.21.2 and 1.21.3
#594 Adds a config option to allow the CommandAPI to be more lenient when updating to a new minor version (e.g. from 1.21 to 1.21.1)
#596, #605 The plugin's config.yml file will be updated when config options are added or removed

----------, Oct 28, 2024

CommandAPI 9.5.3

New improvements from 9.5.2:

Fixes Folia startup error due to scheduling a task with a delay of 0

----------, Aug 11, 2024

CommandAPI 9.5.2

New improvements from 9.5.1:

Adds support for Minecraft 1.21.1
#588 Fix Folia scheduling methods using the wrong scheduler implementation
#580 Fix running a non-vanilla command on paper in Minecraft functions with the CommandAPI throwing runtime exceptions
Fix namespaces not being propagated when registering subcommands
#577 Adds a CommandAPIBukkit#failWithAdventureComponent(ComponentLike) method

----------, Aug 11, 2024

CommandAPI 9.5.1

New improvements from 9.5.0:

Fixes the CommandAPI not loading correctly on Paper 1.21

----------, Jun 18, 2024

CommandAPI 9.5.0

New improvements from 9.4.2:

Adds support for Minecraft 1.21
Drops support for Minecraft 1.16.1, 1.16.2, 1.16.3 and 1.16.4
Fixes ResourceLocationArgument not working in 1.20.5 and 1.20.6
Fixes /minecraft:reload deleting commands on Paper 1.20.6 (build 65+)

----------, Jun 14, 2024

CommandAPI 9.4.2

New improvements from 9.4.1:

#554 Fixes the CommandAPI failing to run on Paper build 64+

----------, May 28, 2024

CommandAPI 9.4.1

New improvements from 9.4.0:

#551 Fixes mojang-mapped versions of the CommandAPI causing errors in certain Minecraft versions
#552 Adds a configuration option to disable datapack reloading on server load

----------, May 9, 2024

CommandAPI 9.4.0

New improvements from 9.3.0:

Adds support for Minecraft 1.20.5 and 1.20.6
Drops support for Minecraft 1.15.x
Fixed implementation issues with FunctionArgument from 9.3.0
#536, #537 Fixed MultiLiteralArgument help displaying the node name instead of the literal text
#524 Fixes CommandAPIBukkit.get().getTags() erroring in 1.20.4
#540 Add methods to "safe-cast" arguments to CommandArguments
#495 Adds a parameter to EntitySelectorArgument to allow failure when no entity lists are empty
#367, #509 Adds the ability to register commands with a custom namespace
#523 Exposed more details of the CommandPermission
#490 Adds support for Mojang-mapped servers via the CommandAPI config
#541 Adds support for a NamespacedKey variant for the PotionEffectArgument

----------, Apr 30, 2024

CommandAPI 9.3.0

New improvements from 9.2.0:

Adds support for Minecraft 1.20.3 and 1.20.4
Fixed bug where calling SimpleFunctionWrapper.getTag() on 1.19+ would throw an error
#499 Fix typo in Adventure methods for tooltips
Fixed executesFeedbackForwarding() not checking for a FeedbackForwardingCommandSender correctly thus allowing every executor to execute the command
#473 Fix RGB colors in CustomArgument.CustomArgumentException#fromString creating the wrong colors
Adds ExecutionInfo executors for the Kotlin DSL
#497 Adds support for RemoteConsoleCommandSender

Known issues:

Functions generated by the FunctionArgument will always return a value of 1 when executed, regardless if the function succeeds, fails or returns a result
Functions generated by the FunctionArgument will always return an empty array of commands when you retrieve the list of commands in that function

----------, Dec 11, 2023

CommandAPI 9.2.0

Improvements from 9.1.0:

487 Added support for disabling integer centering for location arguments
#482 Adds Kotlin DSL support for delegated properties
#488 Fixed calling CommandAPI commands with Bukkit.createCommandSender() not working on paper
Fixed a bug where the CommandAPI would throw errors when unregistering commands when a command exists with a : at the end of its name
Adds support for 1.20.2

----------, Sep 27, 2023

CommandAPI 9.1.0

New improvements from 9.0.3:

Fixes a bug where datapacks would disable themselves on 1.20.1 Paper servers because the CommandAPI thought it was running on a Folia server
#459 Added the ability to access raw arguments in the command executor
#469 Adds AdventureChatColorArgument
#417 Added the ability for commands to be registered and unregistered while the server is running

----------, Aug 17, 2023

CommandAPI 9.0.3

New improvements from 9.0.2:

Adds support for Minecraft 1.20.1
Improves MapArgument to support keys/values with optional quotes, keys having no character restrictions and allowing developers to specify the separator between key-value pairs
Fixes 'use-latest-nms-version' not working properly

----------, Jun 13, 2023

CommandAPI 9.0.2

New improvements from 9.0.1:

Adds support for Minecraft 1.20
Adds the ability to retrieve LiteralArguments and MultiLiteralArguments by their node names
Adds withUsage() method to customise command usage info
Updates default short description to now mention the plugin creating the command
Fixed literal arguments in command conversion causing errors due to parsing problems

----------, Jun 7, 2023

CommandAPI 9.0.1

New improvements from 9.0.0:

Fixed MapArgument not allowing player names as keys because we forgot to allow the _ character
Fixed /execute as ... not working because we were casting to a player instead of a proxied sender
Fixed IntegerArgument failing to compile in certain circumstances
Added CommandArguments.count() utility method to get the number of arguments
Added CommandArguments.getOptional() methods
Added CustomArgumentException static factory methods to accept Spigot/Paper text components
Added basic support for Folia

----------, May 11, 2023

CommandAPI 9.0.0

⚠️ This version of the CommandAPI is incompatible with plugins that use CommandAPI 8.8.0 or previous!

New improvements from 8.8.0:

Made executor methods now use CommandArguments to allow for accessing arguments by name instead of index
Added optional arguments
Added new hook-paper-reload config option to toggle whether the CommandAPI hooks into /minecraft:reload
Reworked the implementation of ItemArgument, so the ItemStack count is correctly reflected and ItemMeta is properly assigned
Made the TeamArgument return a Team instead of a String
Made the ObjectiveArgument return a Objective instead of a String
Made the CommandAPI only complain about commands registered in a plugin.yml if this plugin.yml belongs to the plugin calling the CommandAPI
Added a way to access the raw command a player typed from the executor
Added a way to access more info to construct lists for the ListArgumentBuilder
Added support for sidebar team colors using an enum for ScoreboardSlot
Fixed commandapi-preprocessor appearing in the plugin and shaded jar file
Fixed .executesNative()'s CommandSender's getLocation() method returning the wrong pitch and yaw
Fixed tags showing up in the BiomeArgument when they shouldn't have been doing so
Fixed LocationArgument with BLOCK_POSITION not returning locations in unloaded chunks
Fixed IntegerRangeArgument and FloatRangeArgument not working on Minecraft 1.16.4 and 1.16.5
Fixed RecipeArgument not working on Minecraft 1.17
Fixed TeamArgument not working on Minecraft 1.17
Fixed AdventureChatArgument not working on Minecraft 1.17
Fixed commands with no executors not being caught by the CommandAPI
Fixed ParticleArgument producing "Invalid particle data type" warnings on Minecraft 1.16.5 and below
Fixed FunctionArgument not working on Minecraft 1.17.x and 1.18.x
Fixed NamespacedKeyArgument not working on Minecraft 1.18
Fixed the FunctionArgument not correctly retrieving datapack (function) tags in 1.17+
Removed some redundant vibration particle handling code that would never be run under any circumstances

----------, Apr 22, 2023

CommandAPI 8.8.0

New improvements from 8.7.6:

Adds support for Minecraft 1.19.4

----------, Mar 14, 2023

CommandAPI 8.7.6

New improvements from 8.7.5:

Fixes NullPointerException that occurs rarely in the CommandAPI's post-loading step

----------, Feb 28, 2023

CommandAPI 8.7.5

New improvements from 8.7.3:

Fixed @AWorldArgument not being processed properly by the annotation system
Fixed LootTableArgument not working in 1.17 - 1.19.3

----------, Feb 11, 2023

CommandAPI 8.7.3

New improvements from 8.7.2:

Fixed issue where the WorldArgument wouldn't work in 1.16.5

----------, Jan 8, 2023

CommandAPI 8.7.2

New improvements from 8.7.1:

Hotfixed issue where various arguments wouldn't work in 1.19.3 (function, recipe, sound, advancement, biome, entities, loot table)
Fixed issue where the WorldArgument wouldn't work in 1.19.3

----------, Jan 7, 2023

CommandAPI 8.7.1

New improvements from 8.7.0:

Fixed ParticleArgument not working in 1.19.3
Fixed EnchantmentArgument not working in 1.19.3
Hotfixed a permission check bug when permissions are incorrectly initialized
Hotfixed a null pointer exception when autocompletion occurs via redirected commands
Fixed JavaDocs not showing in your IDE when using commandapi-shade

----------, Dec 19, 2022

CommandAPI 8.7.0

New improvements from 8.6.0:

Adds support for Minecraft 1.19.3
Removes the need for generics and argumenttype parameters for certain arguments

----------, Dec 12, 2022

CommandAPI 8.6.0

New improvements from 8.5.1:

#307 Adds a CommandArgument to let users submit commands as an argument
#334 Adds support for chat components in CommandAPI.fail()
#338 Adds a way to clone a CommandAPICommand instance using instance.copy()
#351 Adds support for a ListArgument with the TextArgument backend, to allow inline lists
#358 Adds a new WorldArgument argument that lets you get a list of Minecraft dimensions
Adds support for SoundArgument to return string-based sounds via the NamespacedKey
#352 Adds some helper methods to the LiteralArgument to make it easier to use via a static import
#357 Adds a Kotlin DSL to register commands in Kotlin!

----------, Dec 4, 2022

CommandAPI 8.5.1

New improvements from 8.5.0:

Adds support for Minecraft 1.19.2
Fixes bug with players being kicked when using chat preview with colors on 1.19+
Prevents developers creating dodgy commands with duplicate argument node names that caused clients to crash when they tried to run those commands
Fix subcommand internal information being overwritten at runtime when the parent command was registered
Fixes time arguments not working in 1.17+
Fixes namespaced key arguments not working in 1.17
Fixes commands not working in 1.17 and 1.18
Fixes server reloading on Spigot throwing asynchronous-related exceptions
Fixes argument suggestions not working if a subcommand's node name is the same as the argument's node name
Improves backend code for chatcolor, enchantment and potion arguments in 1.17+
Optimize code size for 1.19+
Improves list arguments to only display suggestions for the last item and prevent list arguments accepting unlisted items

----------, Aug 11, 2022

CommandAPI 8.5.0

New improvements from 8.4.1:

Adds support for Minecraft 1.19.1
Fixes suggestions not working in 1.16.5 and below
Prevents spaces being allowed in command names
Fixes datapack reloading on 1.17.1
Adds support for chat preview with ChatArgument and AdventureChatArgument
Prevent the CommandAPI re-parsing previous arguments multiple times when running a command
Share NMS code to reduce the jar size
Adds methods to check if the CommandAPI is loaded and disable the CommandAPI gracefully

----------, Jul 28, 2022

CommandAPI 8.4.1

New improvements from 8.4.0:

Fixes bug with converted commands not working
Fixes commandapi-annotations dependency depending on spigot instead of spigot-api

----------, Jun 23, 2022

CommandAPI 8.4.0

New improvements from 8.3.1:

Decouples CustomArgument from CommandAPIHandler
Decouples EntitySelector from EntitySelectorArgument
- Allow developers to shade their own copy of an NBT API framework (e.g. NBT API or PowerNBT)
- Includes the NBT API built-in for plugin versions

Implement base arguments for CustomArguments, allowing more powerful parsing

Implement common NMS code for 1.17+

Adds NamespacedKeyArgument

Adds support for shaded versions of the CommandAPI to create their own command_registration.json files for debugging

Fixes bug where WrapperCommandSyntaxException wouldn't work as intended

Adds support for /minecraft:reload on paper servers

Adds CommandAPI.getRegisteredCommands() to get a list of registered commands

----------, Jun 18, 2022

CommandAPI 8.3.1

New improvements from 8.3.0:

Fixes critical issue where non-Vanilla commands had no suggestions when viewed by the player

----------, Jun 9, 2022

CommandAPI 8.3.0

New improvements from 8.2.1:

Adds support for Minecraft 1.19
Adds support back for Minecraft 1.13 - 1.16.4
Change compiled Java version to Java 16 instead of Java 17

----------, Jun 7, 2022

CommandAPI 8.2.1

New improvements from 8.2.0:

Adds a .withSubcommands() method to add multiple subcommands in one go
Exposed registeredCommands field in the CommandAPIHandler to get a list of registered commands
Fixed CommandAPI logging prefix twice in shaded versions of the CommandAPI

----------, Jun 4, 2022

CommandAPI 8.2.0

New improvements from 8.1.0:

Fixed suggestion filtering not working when typing provided command argument suggestions
Adds ListArgument to allow developers to use lists

----------, May 25, 2022

CommandAPI 8.1.0

New improvements from 8.0.0:

Fixed CommandPermission.OP throwing a null pointer exception
Fixed WrapperCommandSyntaxException failing to initialize
Fixed particle arguments with safe suggestions crashing
Fixed shaded plugins complaining when CommandAPI.onLoad() hasn't been called
Improve error logging for greedy string arguments
Adds generic types to arguments for compile-time type checking

----------, May 4, 2022

CommandAPI 8.0.0

New improvements from 7.0.0:

Improves the ParticleArgument to accept additional particle data
Improves WrapperComandSyntaxException to include more methods to access the underlying exception
Improves error checking for config.yml

Important notes:

Drops support for 1.16.5

----------, Apr 26, 2022

CommandAPI 7.0.0

New improvements from 6.5.4:

Adds support for using the same command executor for multiple command sender types
Makes the CommandAPI display a warning if it finds commands present in a plugin.yml file
Adds more helper methods to the Brigadier class
Adds a tree-like syntax for command declarations
Adds support for asynchronous suggestions
Rewrote how argument suggestions are declared, instead of lots of overloads, require a single object which encompasses the various different suggestion methods
- Remove various deprecated safeOverrideSuggestions methods
- Changed CommandAPI.fail() so it doesn't automatically throw the exception it generates

----------, Apr 13, 2022

CommandAPI 6.5.4

New improvements from 6.5.3:

Adds support for Minecraft 1.18.2
Improves converted command support for "/execute at" and "/execute positioned" for players, entity and command block locations

----------, Mar 7, 2022

CommandAPI 6.5.3

New improvements from 6.5.2:

Adds support for Minecraft 1.18.1

----------, Dec 10, 2021

CommandAPI 6.5.2

New improvements from 6.5.0:

Fixes shaded builds
Fixes annotation builds

----------, Dec 2, 2021

CommandAPI 6.5.0

New improvements from 6.4.0:

Adds support for Minecraft 1.18. In order to use this version, you'll need Java 17

----------, Dec 1, 2021

CommandAPI 6.4.0

New improvements from 6.3.1:

Adds functionality to create help topics for commands which can be viewed with /help
Improve initialization stability

----------, Nov 30, 2021

CommandAPI 6.3.1

New improvements from 6.2.0:

Improve the CustomArgument's constructor to allow for better customization and control over CustomArguments
Fix issue with converted commands not validating permissions properly
Fix issue where converted commands with greedy string arguments would almost always fail
Adds some limited support for the /reload command by unregistering commands on disable
Adds a plugin checking tool to the documentation to retrieve a list of available commands for a plugin

----------, Sep 13, 2021

CommandAPI 6.2.0

New improvements from 6.1.0:

Adds a config option to change the message displayed to a command sender when a command executor's implementation is not present
Adds a config option to use the latest NMS version
Update documentation for shading the CommandAPI

----------, Jul 28, 2021

CommandAPI 6.1.0

New improvements from 6.0.5:

Adds support for Minecraft 1.17.1

----------, Jul 7, 2021

CommandAPI 6.0.5

New improvements from 6.0.2:

Fixes issue where converted commands would always fail unless the converted command was made up entirely of entity selector arguments

----------, Jun 19, 2021

CommandAPI 6.0.4

New improvements from 6.0.2:

Fixes issue where custom implementations of CommandSender would not work with the CommandAPI
Fixes issue where multi literal arguments would skip certain literals, causing null to be registered and crashing the CommandAPI

----------, Jun 17, 2021

CommandAPI 6.0.2

New improvements from 6.0.0:

Fixed issue where registering a command which had a MultiLiteralArgument would expand arguments incorrectly, causing a registration crash
Fixes issue where duplicate permissions would crash the CommandAPI

----------, Jun 16, 2021

CommandAPI 6.0.0

In order to run this version, you'll need to have Java 16

New improvements from 5.12:

Adds support for Minecraft 1.17
Drops support for Minecraft 1.16.4 and below
Switches version convention to use Semanic Versioning
Uses CodeFactor.io for code quality checking
Adds OfflinePlayerArgument for offline players
Adds a way to add suggestions to existing vanilla suggestions
Adds a way to access the CommandSender for CustomArgument parsing
Adds support for Paper's console tab-completion
Adds a way to completely silence all CommandAPI logs
Adds access to the current input and current argument input for argument suggestions
Improve API for setting configuration for plugins that shade the CommandAPI
Fixes bug with converted commands crashing due to poor interface proxying
Adds a way to access the CommandSender for CustomArgument parsing
Adds support for Paper's console tab-completion
Adds a way to completely silence all CommandAPI logs
Fix bugs where the NBTAPI wouldn't be hooked into properly
Fixes critical issue where converted commands with entity selectors may sometimes just not run
Improves overall performance
Improves performance for the PotionArgument
Improves performance for the MathOperationArgument
Fixes spacing issues with code blocks in the documentation
Fixes invalid code examples in the documentation
Fixes typos in the documentation
Adds syntax highlighting for command code blocks in the documentation

----------, Jun 15, 2021

CommandAPI 5.12

New improvements from 5.11:

Fixes bug with SoundArgument not working in Minecraft 1.16.4 and 1.16.5.

----------, May 17, 2021

CommandAPI v5.11

New improvements from 5.10:

Adds support for entity selectors in plugin converted commands
Adds support for converting arbitrary commands which aren't declared in plugin.yml files

----------, May 4, 2021

CommandAPI v5.10

New improvements from 5.9:

Adds support for Paper's Adventure API for ChatComponent and Chat arguments
Update native proxied sender wrapper for Spigot 1.16.5
Deprecated some old methods

----------, May 1, 2021

CommandAPI v5.9

New improvements from 5.8:

Fixes critical issue where commandblocks would not execute converted commands properly. This means you most likely no longer need to add the offending plugin under "skip-sender-proxy"

----------, Feb 28, 2021

CommandAPI v5.8

New improvements from 5.7:

Removes some debug code which added a command /test

----------, Jan 18, 2021

CommandAPI v5.7

New improvements from 5.6:

Adds support for Minecraft 1.16.5

----------, Jan 16, 2021

CommandAPI v5.6

New improvements from 5.5:

Fixes plugin conversion incompatibility with plugins that use Aikar's ACF
Adds a configuration option skip-sender-proxy which improves plugin conversion compatibility with certain plugins

----------, Jan 10, 2021

CommandAPI v5.5

New improvements from 5.4:

Fixes bug with annotations where @NeedsOp didn't work if placed on a class
Fixes bug where entity selector arguments with @ selectors return empty values if the sender is not op

----------, Jan 7, 2021

CommandAPI v5.4

New improvements from 5.3:

Fixes shading conflicts when both the CommandAPI and the NBT-API are shaded.
Fixes other general NBT-API-related bugs

----------, Dec 12, 2020

CommandAPI v5.3

New improvements from 5.2:

Adds an annotation-based command framework
Fixes bug where subcommands didn't apply permissions properly
Adds a way to 'negate' permissions required for a command
Adds a checker for conflicting commands being registered
Fixes bug where converted commands didn't apply multiple parameters
Expose the fields of the CommandAPICommand class via getters and setters

----------, Nov 22, 2020

CommandAPI v5.2

New improvements from 5.1:

Adds a method CommandAPI.reloadDatapacks() which performs the CommandAPI's datapack reloading sequence
Adds support for Minecraft 1.16.4

----------, Nov 3, 2020

CommandAPI v5.1

New improvements from 5.0:

Fixes bug where converted commands could not be executed by players ingame
Adds withPermission(String) to arguments and CommandAPICommands
Adds SimpleFunctionWrapper with helper methods to get functions and tags from ingame, as well as run them without needing to parse them via commands
Greatly improve the type-safety of the internal CommandAPI code
Move the Brigadier class outside of the CommandAPIHandler class

----------, Oct 18, 2020

CommandAPI v5.0

New improvements from 4.3c:

Commands no longer need a LinkedHashMap and instead use a List for arguments
Permission logs are more accurate
Fixes bugs with suggestion overriding
Fixes bugs with suggestion arguments
Fixes bugs with LongArgument
Fixes bug where converted commands crash when run from the console
Fixes bug where turning off verbose logging was still too verbose
Adds AngleArgument
Adds subcommands
Arguments can be hidden from the Object[] args array
Command conversion is more powerful for server owners
CommandAPI suggestions can be converted to Brigadier ones
Startup is faster
Fixes issue where CommandAPI's Brigadier method for registering literals unnecessarily registered the command node to the command graph

----------, Oct 13, 2020

CommandAPI v4.3c

New improvements from 4.3b:

Fixes a bug where functions wouldn't load because permission checks would fail

----------, Oct 8, 2020

CommandAPI v4.3b

New improvements from 4.3a:

Fixes a bug where permissions broke with 4.3a's command conversion with /execute ... as ... support

----------, Sep 28, 2020

CommandAPI v4.3a

New improvements from 4.3:

Fixes a bug where using /execute as ... from a plugin converted command wouldn't apply the command sender properly

----------, Sep 28, 2020

CommandAPI v4.3

New improvements from 4.2:

Command conversion config.yml now accepts YAML's null via the ~ character
Internal command conversion is now more powerful and lets you declare the arguments for command conversion
Fixes a bug where command block command senders that have resulting command executors crashes

----------, Sep 19, 2020

CommandAPI v4.2

New improvements from 4.1:

Fixed bug where shading didn't work with shaded copies of the NBT API
Adds ability to use native proxied command senders that lets you use /execute in|positioned|at|facing|rotated
Adds support for Minecraft 1.16.3
Fixes a bug with command redirects and previously declared argument suggestion overrides

----------, Sep 12, 2020

CommandAPI v4.1

New improvements from 4.0:

#133 The CommandAPI is now shadeable
CommandAPI now lets you add hover tooltips
Adds multi-literal arguments
This file is finally uploaded on Spigot instead of being a link to the GitHub page!

----------, Sep 2, 2020

CommandAPI v4.0

New improvements from 3.3 and 3.4:

Adds support for Minecraft 1.16.2
Adds new predicate arguments and the UUID argument
Adds support for Java 12+
Fixes bug with FloatRange argument
Fixes bug with Custom arguments
Adds brigadier/CommandAPI interop
Adds support for argument and command requiresments
Improves performance of command aliases
Improves safety of suggestion overriding

----------, Aug 23, 2020

CommandAPI v3.3

New improvements from 3.2:

Fixes a bug where datapacks didn't load custom commands properly in 1.16+

----------, Jul 16, 2020

CommandAPI v3.2

New improvements from 3.0:

Fixes bug where command senders were derping and not working
Fixes bug where .overrideSuggestions didn't work in v3.1
Adds the ability to override suggestions with information from previously declared arguments

----------, Jul 5, 2020

CommandAPI v3.0

New improvements from 2.3:

Adds support for Minecraft 1.16.1
Adds a tonne of new arguments
Adds new documentation & Javadocs
Refactors main code structure to be cleaner and leaner

----------, Jun 26, 2020

CommandAPI v2.3a (1.15 compatible)

New improvements from 2.3:

Adds support for Minecraft 1.15

----------, Dec 12, 2019

CommandAPI v2.3

New improvements from 2.2:

Fix bug where permissions weren't being applied correctly
Fix bug where custom functions declared in .mcfunction files didn't work in 1.14.3 and 1.14.4

----------, Aug 26, 2019

CommandAPI v2.2

New improvements from 2.1: