Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for SrBedrock

This plugin allows you to define which plugin have to be successful enabled after server startup

Report PluginControl?

PluginControl

Description

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. Add plugins to the list using the command /plugincontrol add <plugin-name>.
  5. 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.
  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

Option Description
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

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 &#<hex> code or legacy color codes (no MiniMessage support).

Default config.yml

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

Placeholder Usage
<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

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

Command Sub Command Description
/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 Toggle PluginControl on or off.
/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 and kick message, respectively, as required.

Permissions

Permissions Description
plugincontrol.use Permission to use all commands
plugincontrol.bypass Bypass the disallow-player-login in action

Information

CategoryAdmin Tools
Published onJune 4, 2023
LicenseGPL
Downloads107
Stars1
Watchers2

Pinned Versions

Members