plugin_disable
Turn off a plugin but keep it installed. Its slash commands disappear and its onEvent hook stops running. Its files and stored data stay, so plugin_enable brings it back as it was.
Request
Section titled “Request”{ "cmd": "plugin_disable", "name": "hello"}| Field | Type | Required | Description |
|---|---|---|---|
name |
string | Yes | Name of an installed plugin. |
Response
Section titled “Response”{ "cmd": "plugin_disable", "val": true}The server sets enabled: false in the plugin’s plugin.json and unloads it. If it had slash commands, every authenticated connection receives slash_remove with them. The change is recorded in the audit log. The plugin stays off across restarts.
Permissions
Section titled “Permissions”Requires manage_server. It is blocked while you are timed out.
Errors
Section titled “Errors”val |
When |
|---|---|
Invalid plugin name |
name has characters other than letters, digits, _, and -. |
Plugin '<name>' is not installed |
There is no readable plugin.json for that name. |
Unable to save plugin manifest |
The server couldn’t write plugin.json. The plugin keeps running. |
| Validation message | name is missing, blank, or longer than 64 characters. |