This plugin allows you to control which plugins have to be enabled for the server continues running.
Inspired by
this and
this 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 <action-type> to set the action to be taken if any of the listed plugins are not enabled. See the Actions section for available actions.
5. Add plugins to the list using the command /plugincontrol add <plugin-name>.
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
<action-type> and
<plugin-name> placeholders should be replaced with the specific action and
plugin names as needed.
Note: This plugin needs Java 17 to work.
Configuration
Code (YAML):
enabled
: Whether the plugin is enabled or not.
action
: Action to take if
all listed plugins are not enabled.
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
Code (YAML):
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 &#<hex> code or legacy color codes (no MiniMessage support).
Default config.yml
Code (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
Placeholders
Code (YAML):
<prefix>
:
All messages accept this placeholder
<action>
: command.action-type
<actions>
: command.action-list
<command>
: command.command-not-found, command.plugin-add-error and command.plugin-remove-error
<kick-message>
: command.kick-message and command.kick-message-set
<plugin>
: command.plugin-added, command.plugin-not-found and command.plugin-removed
<plugins>
: console.disabling-server and command.plugin-list
Default lang.yml
Code (YAML):
prefix
: '<dark_gray>
[<red>PluginControl<dark_gray>
]'
kick-message
: '<red>
[PluginControl
] You are not allowed to join the server!'
console:
checking-plugins
: '<prefix> <red>Checking plugins
...'
disabling-server
: '<prefix> <red>Disabling server because plugins or groups were not found or enabled!'
finished-checking
: '<prefix> <green>Plugins verified!'
log-to-console-plugin
: '<prefix> <red>Required plugins were not found
: <plugins>'
log-to-console-group
: '<prefix> <red>Required groups were not found
: <groups>'
plugin-disabled
: '<prefix> <red>Plugin Control is disabled!'
command:
action-list
: '<prefix> <green>Actions available
: <yellow><actions>'
action-set
: '<prefix> <green>Action set to <yellow><action>'
action-type
: '<prefix> <green>Action type
: <yellow><action>'
checking-plugins
: '<prefix> <green>Checking plugins
... See the console for more information.'
check-depend-error
: '<red>Usage
: <yellow>/<command> check-depend <green><plugin-name>'
check-depend-not-found
: '<prefix> <red>
No plugins depend or softdepend on <plugin>!'
check-depend-depend
: '<prefix> <yellow>Plugins that depend on <green><plugin>
: <red><plugins>'
check-depend-softdepend
: '<prefix> <yellow>Plugins that softdepend on <green><plugin>
: <red><plugins>'
command-not-found
: '<red>Usage
: <yellow>/<command> help <red>to see the available commands'
kick-message
: '<prefix> <green>Kick message
: <yellow><kick-message>'
kick-message-set
: '<prefix> <green>Kick message set to <yellow><kick-message>'
plugin-add-error
: '<red>Usage
: <yellow>/<command> add <
all|plugin-name>'
plugin-added
: '<prefix> <green>Plugin <yellow><plugin> <green>added!'
plugin-added-all
: '<prefix> <green>
All plugins added to the list of required plugins!'
plugin-already-added
: '<prefix> <red>Plugin already added!'
plugin-disabled
: '<prefix> <red>Deactivating plugin features
...'
plugin-enabled
: '<prefix> <green>Activating plugin features
...'
plugin-list
: '<prefix> <yellow>Required Plugins
: <plugins>'
plugin-list-separator
: '<gray>, '
plugin-list-separator-last
: '<gray> and '
plugin-list-enabled-color
: '<green>'
plugin-list-disabled-color
: '<red>'
plugin-list-empty
: '<prefix> <red>
No plugins added!'
plugin-not-found
: '<prefix> <red>Plugin <yellow><plugin> <red>not found in the list!'
plugin-reload
: '<prefix> <green>Config and Language reloaded!'
plugin-remove-error
: '<red>Usage
: <yellow>/<command> remove <
all|plugin-name>'
plugin-removed
: '<prefix> <green>Plugin <yellow><plugin> <green>removed!'
plugin-removed-all
: '<prefix> <green>
All plugins removed!'
plugin-click-remove
: '<red>Click to remove the plugin'
group-create-error
: '<red>Usage
: <yellow>/<command> group create <group-name>'
group-created
: '<prefix> <green>Group <yellow><group> <green>created!'
group-already-exist
: '<prefix> <red>Group already exists!'
group-remove-error
: '<red>Usage
: <yellow>/<command> group delete <group-name>'
group-removed
: '<prefix> <green>Group <yellow><group> <green>removed!'
group-not-found
: '<prefix> <red>Group <yellow><group> <red>not found!'
group-list-empty
: '<prefix> <red>
No groups added!'
group-list
: '<prefix> <yellow>Required Groups
: <groups>'
group-list-error
: '<red>Usage
: <yellow>/<command> group list <group-name>'
plugin-added-to-group
: '<prefix> <green>Plugin <yellow><plugin> <green>added to group <yellow><group>'
plugin-add-to-group-error
: '<red>Usage
: <yellow>/<command> group add <group-name> <plugin-name>'
plugin-removed-from-group
: '<prefix> <green>Plugin <yellow><plugin> <green>removed from group <yellow><group>'
plugin-removed-from-group-error
: '<red>Usage
: <yellow>/<command> group remove <group-name> <plugin-name>'
plugin-not-in-group
: '<prefix> <red>Plugin <yellow><plugin> <red>not in group <yellow><group>'
group-plugin-list-error
: '<red>Usage
: <yellow>/<command> group list <group-name>'
group-has-no-plugins
: '<prefix> <red>Group <yellow><group> <red>has
no plugins!'
group-plugin-list
: '<prefix> <yellow>Plugins in group <green><group><yellow>
: <yellow><plugins>'
group-list-name
: '<yellow>Group <group>:'
group-click-delete
: '<red>Click to delete the group'
group-click-remove-plugin
: '<red>Click to remove the plugin from the group'
group-click-info
: '<yellow>Click to see the group info'
group-help
:
- '<gradient:aqua:green>=== Plugin Control Group Help ===</gradient>'
- '<aqua>/<command> group create <green><group> <yellow>- Create a group'
- '<aqua>/<command> group delete <green><group> <yellow>- Remove a group'
- '<aqua>/<command> group list <yellow>- List
all required groups'
- '<aqua>/<command> group add <green><group> <plugin> <yellow>- Add a plugin into a group'
- '<aqua>/<command> group remove <green><group> <plugin> <yellow>- Remove a plugin from a group'
- '<aqua>/<command> group list <green><group> <yellow>- List
all plugins in a group'
- '<aqua>/<command> group help <yellow>- Show the group help'
- '<gradient:aqua:green>================================</gradient>'
help
:
- '<gradient:aqua:green>==== Plugin Control Help ====</gradient>'
- '<aqua>/<command> add <green><
all|plugin> <yellow>- Add a plugin to the list'
- '<aqua>/<command> remove <green><
all|plugin> <yellow>- Remove a plugin from the list'
- '<aqua>/<command> action <yellow>- List
all actions available'
- '<aqua>/<command> action <green><action-type> <yellow>- Set an action type'
- '<aqua>/<command> group create <green><group> <yellow>- Create a group'
- '<aqua>/<command> group delete <green><group> <yellow>- Remove a group'
- '<aqua>/<command> group list <yellow>- List
all required groups'
- '<aqua>/<command> group add <green><group> <plugin> <yellow>- Add a plugin into a group'
- '<aqua>/<command> group remove <green><group> <plugin> <yellow>- Remove a plugin from a group'
- '<aqua>/<command> group list <green><group> <yellow>- List
all plugins in a group'
- '<aqua>/<command> group help <yellow>- Show the group help'
- '<aqua>/<command> kick-message <yellow>- Show the kick message'
- '<aqua>/<command> kick-message <green><message> <yellow>- Set the kick message'
- '<aqua>/<command> enable <yellow>- Enable the plugin'
- '<aqua>/<command> disable <yellow>- Disable the plugin'
- '<aqua>/<command> toggle <yellow>- Enable or disable the plugin'
- '<aqua>/<command> list <yellow>- List
all required plugins'
- '<aqua>/<command> check <yellow>- Checks if required plugins are activated'
- '<aqua>/<command> check-depend <green><plugin> <yellow>- Check which plugins depend or softdepend on a plugin'
- '<aqua>/<command> reload <yellow>- Reload the config and language'
- '<aqua>/<command> help <yellow>- Show this help'
- '<gradient:aqua:green>=========================</gradient>'
Commands
Main Command
/plugincontrol - Aliases:
/pc and
/pcontrol
Code (YAML):
/plugincontrol add <plugin-name>
: Add a plugin to the list.
/plugincontrol remove <plugin-name>
: Remove a plugin from the list.
/plugincontrol action
: Check the current action.
/plugincontrol action <action-type>
: Set the action to take.
/plugincontrol kick-message
: Check the current kick message.
/plugincontrol kick-message <message>
: Set the kick message.
/plugincontrol <enable|on>
: Enable PluginControl.
/plugincontrol <disable|off>
: Disable PluginControl.
/plugincontrol toggle
: Enable or disable PluginControl.
/plugincontrol list
: List
all plugins in the list.
/plugincontrol check
: Checks if required plugins are activated.
/plugincontrol check-depend <plugin>
: 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
<plugin-name>,
<action-type> and
<message> placeholders should be replaced with the specific plugin name, action and kick message, respectively, as required.
Permissions
Code (YAML):
plugincontrol.use
: Permission to use
all commands
plugincontrol.bypass
: Bypass the disallow-player-login in action
Suggestions and Issues
Click here to send suggestions or report bugs!