Create Custom Commands

Changelog 2.0:

 

### Added

- Custom commands now also work from console, command blocks and functions, not only from players.

- Per-command cooldown: "cooldown" (seconds) and optional "cooldownmessage" with a {time} placeholder.

  Cooldown is per player and per command, cleared at server start, and not applied to console or command blocks.

- Clickable links: "url" (http/https only) and optional "urltext" (supports & color codes).

  Only the player who ran the command receives the link.

- LuckPerms support through Forge's permission API:

- every command gets the node create_custom_command.command.<key>

- "permission" can be a custom node instead of a number, e.g. "vip.feed" (node used exactly as written) or "abc" (becomes create_custom_command.abc)

- "permissionlevel" (default 4) is the fallback level for custom nodes

- several commands can share one node

- when the node is not set, or LuckPerms is not installed, the numeric permission level is used

- /reload now re-reads the config and re-registers all commands.

 

### Changed

- Commands run from the original command source, so position, dimension and /execute chains

  (for example /execute positioned ... run <command>) are kept.

- Commands now return success (1), so /execute if, /execute store success and command blocks see them as successful.

- "notify": "yes" with an empty "notifystring" no longer suppresses output or sends an empty message.

- "notify" also accepts "false" and "off" as no.

- Invalid "permission" or "cooldown" numbers fall back to 4 and 0 with a warning, instead of skipping the command.

- Config is read and written as UTF-8.

- Removed the registration of Forge's /config command from this mod.

 

### Fixed

- A syntax error in the config no longer crashes startup; it is logged and the commands return after fixing and /reload.

- Config entries that are not JSON objects are ignored.

- Command loops (a calls a, or a calls b calls a) no longer crash the server; nesting is limited to 8.

- Command names that are blank or contain spaces are skipped with an error.

- Error logs now include the stack trace.

 

### Notes

- Existing configs keep working unchanged; all new keys are optional.

- A permission node added after the server started works with LuckPerms only after a restart; until then the numeric level is used.

- Cooldowns are not saved across server restarts.