Melius Commands

# Melius Commands [](https://discord.gg/HeZayd6SxF) A fabric server side mod to create custom, and modify existing commands ## Custom Commands To add custom commands, create a json file in `./config/melius-commands/commands`. For example files, see [examples/commands](https://github.com/DrexHD/MeliusCommands/tree/1.21/examples/commands)! Apply your changes, by running `/reload` in-game. ### JSON Format Json format includes comments for clarification (don't copy `//` in your files) #### Command node (literal / argument) Check out the [online generator](https://drexhd.vercel.app/melius-commands/commands/) to create your custom commands quick and easy! This will also make sure your syntax is valid. The root node must always be a literal node. ```json5 { "id": "...", // Command id (command name for literal command nodes) (required) "type": "...", // Argument type, see below. (argument node only, required) "executes": [ // A list of command node executions, see below. ], "require": { // See https://github.com/Patbox/PredicateAPI/ for further information. // If this evaluates to true for a Command Source, it will have access to this command node! }, "literals": [ // A list of literal children nodes ], "arguments": [ // A list of argument children nodes ], "redirect": "..." // If specified the command will copy execution, requirements and children from the specified node. // This can effectively create an alias for another command } ``` #### Execution This can either be a simple string, which will be executed silent, as console with op level 4 or manually configured like this: ```json5 { "command": "...", // The command that will be executed (can reference argument values, with ${id}) "silent": false, // Disable command output if set to true "as_console": false, // Whether this command should be executed as console command source "op_level": 4 // The operator level of the command source (optional) (Possible values: 0 - 4) } ``` The `command` execution value can use placeholders from command arguments and global placeholders, by using this format `${PLACEHOLDER}`, where `PLACEHOLDER` can either be the argument id, or a global placeholder like [player:name](https://placeholders.pb4.eu/user/default-placeholders/). #### Argument Type For a full list of all argument types refer to the [Argument types wiki](https://minecraft.wiki/w/Argument_types). Some argument types require additional arguments, which must be appended seperated by spaces. ## Command Modifiers To add command requirements, create a json file in `./config/melius-commands/modifiers`. For example files, see [examples/modifiers](https://github.com/DrexHD/MeliusCommands/tree/1.21/examples/modifiers)! ### JSON Format Check out the [online generator](https://drexhd.vercel.app/melius-commands/modifiers/) to create your custom command modifiers quick and easy! This will also make sure your syntax is valid. Json format includes comments for clarification (don't copy `//` in your files) #### Command modifier The syntax depends on the modifier type you choose. The most important thing to note is that there are two types of command matchers: - Node matchers will match command nodes (the structure used by brigadier to represent commands internally) by their path (for example `teleport.location`, will match any command like this `/teleport 0 100 0`) - Command matchers will match against the string used during command execution (for example `warp end` will match `/warp end`) Both of these types come with three different flavours: - `strict` modifiers will only be applied to that exact node / that exact command input - `starts_with` modifiers will be applied to the specified node / command and anything that is "longer" than it - `regex` modifiers will be applied to everything matching the regular expression Node matchers have an extra field called `requirement_modifier`, which allows you to modify the requirement of the node, which will completely remove the command from players / command sources that don't meet the requirement! ### Command node paths You can use `/melius-commands path ` command to determine command node paths of any command. Example: to check the path of `/tp DrexHD 0 100 0` (teleporting an entity to a block location) you type `/melius-commands path tp DrexHD 0 100 0` and will receive `teleport.targets.location`, which you can use in command modifiers. ## Placeholders - `%melius-commands:cooldown [id]%` / `%melius-commands:cooldown [id] [formatting]%` - Player command cooldowns. - `[id]` is the id specified in the cooldown modifier. - `[formatting]` is the [duration formatting](https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/time/DurationFormatUtils.html), make sure to escape properly.