# 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. Add plugins to the list using the command `/plugincontrol add `. 5. Use the command `/plugincontrol action ` to set the action to be taken if any of the listed plugins are not enabled. See the [Actions](https://hangar.papermc.io/SrBedrock/PluginControl#-actions) section for available actions. 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). ### Default config.yml ```yaml update-notifier: false enabled: false # Action to take if all listed plugins are not enabled. # log-to-console # disallow-player-login # shutdown-server action: log-to-console plugins: [ ] groups: { } ``` ## 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 lang.yml ```yaml prefix: '[PluginControl]' kick-message: '[PluginControl] You are not allowed to join the server!' console: checking-plugins: ' Checking plugins...' disabling-server: ' Disabling server because plugins or groups were not found or enabled!' finished-checking: ' Plugins verified!' log-to-console-plugin: ' Required plugins were not found: ' log-to-console-group: ' Required groups were not found: ' plugin-disabled: ' Plugin Control is disabled!' command: action-list: ' Actions available: ' action-set: ' Action set to ' action-type: ' Action type: ' checking-plugins: ' Checking plugins... See the console for more information.' check-depend-error: 'Usage: / check-depend

' check-depend-not-found: ' No plugins depend or softdepend on !' check-depend-depend: ' Plugins that depend on : ' check-depend-softdepend: ' Plugins that softdepend on : ' command-not-found: 'Usage: / help to see the available commands' kick-message: ' Kick message:

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

' plugin-add-error: 'Usage: / add ' plugin-added: ' Plugin added!' plugin-added-all: ' All plugins added to the list of required plugins!' plugin-already-added: ' Plugin already added!' plugin-disabled: ' Deactivating plugin features...' plugin-enabled: ' Activating plugin features...' plugin-list: ' Required Plugins: ' plugin-list-separator: ', ' plugin-list-separator-last: ' and ' plugin-list-enabled-color: '' plugin-list-disabled-color: '' 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-removed-all: ' All plugins removed!' plugin-click-remove: 'Click to remove the plugin' group-create-error: 'Usage: / group create ' group-created: ' Group created!' group-already-exist: ' Group already exists!' group-remove-error: 'Usage: / group delete ' group-removed: ' Group removed!' group-not-found: ' Group not found!' group-list-empty: ' No groups added!' group-list: ' Required Groups: ' group-list-error: 'Usage: / group list ' plugin-added-to-group: ' Plugin added to group ' plugin-add-to-group-error: 'Usage: / group add

' plugin-removed-from-group: ' Plugin removed from group ' plugin-removed-from-group-error: 'Usage: / group remove

' plugin-not-in-group: ' Plugin not in group ' group-plugin-list-error: 'Usage: / group list ' group-has-no-plugins: ' Group has no plugins!' group-plugin-list: ' Plugins in group : ' group-list-name: 'Group :' group-click-delete: 'Click to delete the group' group-click-remove-plugin: 'Click to remove the plugin from the group' group-click-info: 'Click to see the group info' group-help: - '=== Plugin Control Group Help ===' - '/ group create - Create a group' - '/ group delete - Remove a group' - '/ group list - List all required groups' - '/ group add - Add a plugin into a group' - '/ group remove - Remove a plugin from a group' - '/ group list - List all plugins in a group' - '/ group help - Show the group help' - '================================' help: - '==== Plugin Control Help ====' - '/ add - Add a plugin to the list' - '/ remove - Remove a plugin from the list' - '/ action - List all actions available' - '/ action

- Set an action type' - '/ group create - Create a group' - '/ group delete - Remove a group' - '/ group list - List all required groups' - '/ group add - Add a plugin into a group' - '/ group remove - Remove a plugin from a group' - '/ group list - List all plugins in a group' - '/ group help - Show the group help' - '/ 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 required plugins' - '/ check - Checks if required plugins are activated' - '/ check-depend - Check which plugins depend or softdepend on a plugin' - '/ 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` | `check` | Checks if required plugins are activated. | | `/plugincontrol` | `check-depend ` | Check which plugins depend or softdepend on a plugin.| | `/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

Pinned plugins

PluginControl

Organizations

Stars

Watching