# PluginControl ## Description This plugin allows you to control which plugins have to be enabled for the server continues running. Inspired by [this](https://github.com/PaperMC/Paper/issues/8859#issuecomment-1435905791) and [this](https://github.com/PaperMC/Paper/pull/8108#issuecomment-1419304955) comment and myself having the same problem. ## Installation 1. Download the PluginControl plugin. 2. Place the downloaded plugin file in the `plugins` folder of your server. 3. Restart the server to load the PluginControl plugin. 4. Use the command `/plugincontrol action ` to set the action to be taken if any of the listed plugins are not enabled. See the [Actions](#actions) section for available actions. 5. Add plugins to the list using the command `/plugincontrol add `. 6. Enable the PluginControl plugin by running the command `/plugincontrol enable`. 7. Reload the PluginControl plugin configuration and language files with the command `/plugincontrol reload`. Please note that the `` and `` placeholders should be replaced with the specific action and plugin names as needed. **Note: This plugin needs Java 17 to work.** ## Configuration | Option | Description | |----------------|--------------------------------------------------------------------------------| | `enabled` | Whether the plugin is enabled or not. | | `action` | [Action to take if all listed plugins are not enabled.](#actions) | | `kick-message` | Message sent to the player when the `disallow-player-login` action is enabled. | | `plugins` | List of plugins to be enabled when the server starts. | ### Actions | Action Type | Description | |-------------------------|---------------------------------------------------------------------------------------| | `log-to-console` | Sends a warning (`log-to-console` inside lang.yaml) in the console. | | `disallow-player-login` | Block player from enter the server with a message (`kick-message` inside config.yml). | | `shutdown-server` | Shutdown the server with a warning (`disabling-server` inside lang.yml). | ### Kick Message Allows you to customize the message sent to the player when the `disallow-player-login` action is enabled. Can be customized using `&#` code or legacy color codes (no MiniMessage support). ## Messages Change the message formatting using [MiniMessage](https://webui.advntr.dev/) ### Placeholders | Placeholder | Usage | |------------------|-------------------------------------------------------------------------------------------| | `` | All messages accept this placeholder | | `` | `command.action-type` | | `` | `command.action-list` | | `` | `command.command-not-found`, `command.plugin-add-error` and `command.plugin-remove-error` | | `` | `command.kick-message` and `command.kick-message-set` | | `` | `command.plugin-added`, `command.plugin-not-found` and `command.plugin-removed` | | `` | `console.disabling-server` and `command.plugin-list` | ### Default ```yaml prefix: '[PluginControl]' console: checking-plugins: ' Checking plugins...' disabling-server: ' Disabling server because was not found or enabled successfully!' finished-checking: ' Plugins successfully verified!' log-to-console: ' Plugin not found or enabled successfully...' command: action-list: ' Actions available: ' action-set: ' Action set to ' action-type: ' Action type: ' command-not-found: 'Use / help to see the available commands' kick-message: ' Kick message:

' kick-message-set: ' Kick message set to

' no-permission-error: ' You do not have permission to use this command' plugin-add-error: 'Usage: / add [plugin-name]' plugin-added: ' Plugin added successfully!' plugin-already-added: ' Plugin already added!' plugin-disabled: ' Deactivating plugin features...' plugin-enabled: ' Activating plugin features...' plugin-list: ' Plugins added: ' plugin-list-separator: ', ' plugin-list-separator-last: ' and ' plugin-list-empty: ' No plugins added!' plugin-not-found: ' Plugin not found in the list!' plugin-reload: ' Config and Language reloaded!' plugin-remove-error: 'Usage: / remove ' plugin-removed: ' Plugin removed!' plugin-click-remove: 'Click to remove the plugin' help: - '==== Plugin Control Help ====' - '/ add

- Add a plugin to the list' - '/ remove

- Remove a plugin from the list' - '/ action - List all actions available' - '/ kick-message - Show the kick message' - '/ kick-message - Set the kick message' - '/ enable - Enable the plugin' - '/ disable - Disable the plugin' - '/ toggle - Enable or disable the plugin' - '/ list - List all plugins added' - '/ reload - Reload the config and language' - '/ help - Show this help' - '============================' ``` ## Commands Main Command `/plugincontrol` - Aliases: `/pc` and `/pcontrol` | Command | Sub Command | Description | |------------------|--------------------------|----------------------------------------------| | `/plugincontrol` | `add ` | Add a plugin to the list. | | `/plugincontrol` | `remove ` | Remove a plugin from the list. | | `/plugincontrol` | `action` | Check the current action. | | `/plugincontrol` | `action ` | [Set the action to take.](#actions) | | `/plugincontrol` | `kick-message` | Check the current kick message. | | `/plugincontrol` | `kick-message ` | Set the kick message. | | `/plugincontrol` | `enable \| on` | Enable PluginControl. | | `/plugincontrol` | `disable \| off` | Disable PluginControl. | | `/plugincontrol` | `toggle` | Toggle PluginControl on or off. | | `/plugincontrol` | `list` | List all plugins in the list. | | `/plugincontrol` | `reload` | Reload the configuration and language files. | | `/plugincontrol` | `help \| ?` | Show the list of commands. | Please note that the ``, `` and `` placeholders should be replaced with the specific plugin name and kick message, respectively, as required. ## Permissions | Permissions | Description | |------------------------|------------------------------------------------| | `plugincontrol.use` | Permission to use all [commands](#commands) | | `plugincontrol.bypass` | Bypass the `disallow-player-login` in `action` |

SrBedrock

PluginControl

Badges