MaintenanceMOTD

### **THIS PLUGIN DOES NOT SUPPORT VELOCITY YET (IT IS COMPATIBLE WITH PAPER/WATERFALL)** #### **NOTE:** If you run this plugin on Spigot 1.7 it does not access ProtocolLib on that version. Therefore, it won't have Custom Player Count / Custom Hover over Player Count / Fake Players. (I deactivated it because I could not find a ProtocolLib version that works on 1.7. Therefore, I could not test it. If someone finds a version of ProtocolLib that works on 1.7 please message me. Thanks!) #### **NOTE 2:** To access **HEX** colors, you need **Spigot/Paper 1.13+** OR **BungeeCord/Waterfall 1.16+**! It works on all versions of **Spigot/Paper/BungeeCord/Waterfall**! #### **Please leave a review if you liked this plugin! Thank you! ## MaintenanceMOTD (IMO this is a Premium tier plugin) ### **Description** MaintenanceMOTD is one of the best free MOTD plugins you have ever seen. It is fully customizable, and I really mean it! You have configs for everything that the plugin does, this also includes MESSAGES! In addition to that it supports **HEX COLORS**! You also have a special MOTD for when you enter Maintenance Mode! ### **Color codes** * Important note: this plugin usually does not use the normal color codes, but it uses [MiniMessage](https://docs.advntr.dev/minimessage/format.html)! * It uses normal color codes only for PlayerCounts and Hover over PlayerCount(because I think ProtocolLib does not support it yet) ### **Features** * Fully Customizable! * Customizable Messages * Customizable MOTD * Customizable MaxPlayers * Customizable MOTD for Maintenance * Supports RANDOM MOTDS * Almost everything can be changed through commands! (the only thing that can not be changed through commands is the content of the RANDOM MOTDS/PlayerCounts/Hovers over PlayerCount, but the default one can be changed) * You can set a time for the Maintenance and Reason! (After the time finishes the Maintenance mode is turned off) * Kick players that do not have permission when Maintenance Mode is turned ON * Customizable Kick Messages * Customizable time units * Support auto-complete commands * If Custom Player Count is active, it solves the issue with "and x more..." when hovering * It also supports **GRADIENTS** * If you have **ProtocolLib(it is not required for BungeeCord version)** you will have access to the following features: * Customizable PlayerCount * Customizable Hover over PlayerCount * Customizable FakePlayers(if Hover over PlayerCount is deactivated it will add them into the hover player list) * Supports RANDOM PlayerCounts and RANDOM Hovers over PlayerCount * If you have **PlaceholderAPI(it is not required for BungeeCord version)** you can use the placeholders provided by it * Customizable Icons for Maintenance Mode and Normal Mode * The Icons can be randomly cycled * Downscaling gradients and rainbow if the server version is less than 1.13(1.8->1.12) * Scaling gradients and rainbow if the server version is higher than 1.12(1.13->1.20) * Added support for these placeholders: **%time%**, **%date%**, **%online%**, **%max%**, **%remain%**, **%for%** * There could be more features but I do not remember them if there are. ### **Permissions** * **maintenancemotd.maintenance** - access to the main command * **maintenancemotd.bypass** - bypass the maintenance ### **Commands** * MAIN COMMAND: **maintenancemotd** (aliases **maintenance** and **mm**) * **/mm [reason]** - Toggle maintenance mode * **/mm [reason]** - Toggle maintenance mode for a period of time (Example: **/mm for 30m** -> This will turn maintenance mode for 30 minutes) * **/mm ** - Set the max players * **/mm maxplayers set ** - Set the value of max players * **/mm ** * **/mm fakeplayers set ** - Set the value of fake players * **/mm fakeplayers set-add-in-list ** - Toggle if you want to show the fake players in online list when hovering over Player Count * **/mm fakeplayers set-random-order ** - Toggle if you want to show the fake players in a random order from the list * **/mm [text]** - Set the normal MOTD (Examle: **/mm normal-motd 1** -> this will clear line 1 for the default MOTD, if I would have typed something after the "1" then it will set to that) * **/mm [text]** - Set the maintenance MOTD(works the same as before) * **/mm ** - Set the normal Player Count * **/mm normal-player-count set ** - Set the normal Player Count * **/mm normal-player-count remove** - Clear the normal Player Count(it will show nothing) * **/mm normal-player-count hover ** - Toggle the hover on normal-player-count * **/mm normal-player-count set-hover ** - Set the hover text for a specific line(if the line does not exist add clear lines until then) * **/mm normal-player-count remove-hover ** - Delete a line from the hover * **/mm ** - Set the maintenance Player Count * **/mm maintenance-player-count set ** - Set the maintenancePlayer Count * **/mm maintenance-player-count remove** - Clear the maintenancePlayer Count(it will show nothing) * **/mm maintenance-player-count hover ** - Toggle the hover on maintenance-player-count * **/mm maintenance-player-count set-hover ** - Set the hover text for a specific line(if the line does not exist add clear lines until then) * **/mm maintenance-player-count remove-hover ** - Delete a line from the hover * **/mm ** - Set the normal random motd * **/mm normal-random motd ** - Toggle if it should show random MOTDS instead of the default one(it includes the default one) * **/mm normal-random player-count ** - Toggle if it should show random Player Counts instead of the default one(it includes the default one) * **/mm normal-random hover ** - Toggle if it should show random Hovers over Player Count instead of the default one(it includes the default one) * **/mm ** - Set the maintenance random motd * **/mm maintenance-random motd ** - Toggle if it should show random MOTDS instead of the default one(it includes the default one) * **/mm maintenance-random player-count ** - Toggle if it should show random Player Counts instead of the default one(it includes the default one) * **/mm maintenance-random hover ** - Toggle if it should show random Hovers over Player Count instead of the default one(it includes the default one) * **/mm ** - Set the normal icon * **/mm normal-icon random ** - Toggle if you want to cycle images randomly for normal mode * **/mm ** - Set the maintenance icon * **/mm maintenance-icon random ** - Toggle if you want to cycle images randomly for maintenance mode * **/mm reload** - Reload the plugin(loads configs again if you changed anything without having to reload all server) ### **Pictures** #### **Downscaling:** ### **Dependencies** #### **For Spigot/Paper** * [ProtocolLib](https://www.spigotmc.org/resources/protocollib.1997/) (NOT REQUIRED) * [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) (NOT REQUIRED) #### **For BungeeCord/Waterfall** * NONE ### **Known Issues** * NONE :) ### **Features that will come into the feature** * ~~Customizable MOTD Image~~ (**Added in 1.1.0**) * ~~Support for versions 1.13->1.20, including Spigot~~ (**Added in 1.2.0**) * ~~Support for version 1.8->1.12, including Spigot~~ (**Added in 1.3.0**) * ~~Reverse compatibility for gradients and rainbows if the server version is under 1.13~~ (**Added in 1.3.0**) * ~~Support for version 1.7, including Spigot~~ (**Added in 1.4.0, without support for ProtocolLib**) * ~~Reverse compatibility for gradients and rainbows when the server runs a Minecraft version 1.13 or above, and players see MOTD from 1.12 or below~~ (**Added in 1.5.0**) * ~~Include %online% and %max% to be able to show in MOTD~~ (**Added in 2.0.0**) * ~~Include %remain% and %for% to be able to show in MOTD, Player Count, and Hover~~ (**Added in 2.0.0**) * ~~Include **PlaceholderAPI** support~~ (**Added in 2.0.0**) * ~~Compatibility for gradients and rainbows when the server runs a Minecraft version 1.12 or below, and players see MOTD from 1.13 or above~~ (**Added in 2.1.0**) * ~~Added missing prefixes to commands~~ (**Added in 2.1.0**) * ~~Include %date% and %time% to be able to show in MOTD, Player Count, and Hover~~ (**Added in 2.2.0**) * ~~Solved the bugs on some commands~~ (**Added in 2.2.0**) * ~~Restructure code~~ (**Added in 2.3.0**) * ~~Do not print errors in the console when failing to send the MOTD to a player~~ (**Added in 2.3.0**) * ~~Add **BungeeCord/Waterfall** support~~ (**Added in 3.0.0**) * ~~Add **BungeeCord/Waterfall** support for all versions~~ (**Added in 3.1.0**) * ~~Solved an issue where the version of the server was not detected properly~~ (**Added in 3.2.0**) * Add **Velocity** support (**Will be added in 4.0.0**) * Change the random MOTDS / PlayerCounts / Hovers from commands(most probably, I won't do this because I don't use it) ### **Configs** config.yml ```yaml # is the server in maintenance mode? maintenance-mode: false reason : '' until: 0 # show fake players fake-players: custom: true value-to-add: 5 add-in-list: true random-order: true # custom max players max-players: custom: true value: 0 # normal-motd normal-motd: line1: 'Welcome to the server!' line2: 'Second line' custom-player-count: false player-count: '&a&l%online%&7/&a&l%max%' custom-hover: false player-count-hover: - '&aOnline Players:' - '&7%online%' - '&aMax Players:' - '&7%max%' random-motd: true motds: motd1: line1: 'Welcome to the server!' line2: 'Online: %online%' motd2: line1: 'Welcome to the server!' line2: 'Max: %max%' random-player-count: true player-counts: - '&2&l%online%&7/&2&l%max%' - '&e&l%online%&7/&e&l%max%' random-hover: true player-count-hovers: hover1: - '&bOnline Players:' - '&7%online%' - '&bMax Players:' - '&7%max%' hover2: - '&6Online Players:' - '&7%online%' - '&6Max Players:' - '&7%max%' # maintenance-motd maintenance-motd: line1: 'The server is currently in maintenance mode.' line2: 'Please check back later.' custom-player-count: true player-count: '&cServer in Maintenance' custom-hover: true player-count-hover: - '&cServer in Maintenance' - '&cPlease check back later' - '&cReason: %reason%' - '&cUntil: %until%' - '&cPlayers: %online%' - '&cMax Players: %max%' - '&cRemain: %remain%' - '&cTime: %time%' - '&cDate: %date%' random-motd: true motds: motd1: line1: 'The server is currently in maintenance mode.' line2: 'Reason: %reason%' motd2: line1: 'The server is currently in maintenance mode.' line2: 'Until: %date%' motd3: line1: 'The server is currently in maintenance mode.' line2: 'Remain: %time%' random-player-count: true player-counts: - '&4Server in Maintenance' - '&dServer in Maintenance' - '&dReason: %reason%' - '&dUntil: %until%' - '&dPlayers: %online%' - '&dMax Players: %max%' - '&dRemain: %remain%' - '&dTime: %time%' - '&dDate: %date%' random-hover: true player-count-hovers: hover1: - '&4Server in Maintenance' - '&4Please check back later' - '&4Reason: %reason%' - '&4Until: %until%' - '&4Players: %online%' - '&4Max Players: %max%' - '&4Remain: %remain%' - '&4Time: %time%' - '&4Date: %date%' hover2: - '&dServer in Maintenance' - '&dPlease check back later' - '&dReason: %reason%' - '&dUntil: %until%' - '&dPlayers: %online%' - '&dMax Players: %max%' - '&dRemain: %remain%' - '&dTime: %time%' - '&dDate: %date%' # custom icons custom-icon: normal: enabled: true random: false default: '1.png' maintenance: enabled: true random: false default: '1.png' ``` messages.yml ```yaml # prefix prefix : '[Maintenance] ' # help command help: - '/maintenance [reason] - Toggle maintenance mode' - '/maintenance [reason] - Toggle maintenance mode' - '/maintenance - Set the max players' - '/maintenance - Set the fake players' - '/maintenance [text] - Set the normal MOTD' - '/maintenance [text] - Set the maintenance MOTD' - '/maintenance - Set the normal player count' - '/maintenance - Set the maintenance player count' - '/maintenance - Set the normal random motd' - '/maintenance - Set the maintenance random motd' - '/maintenance - Set the normal icon' - '/maintenance - Set the maintenance icon' - '/maintenance reload - Reload the plugin' # general messages no-permission: 'You do not have permission to use this command.' already-enabled: 'Maintenance mode is already enabled.' already-disabled: 'Maintenance mode is already disabled.' enabled: 'Maintenance mode has been enabled.' enabled-with-reason: 'Maintenance mode has been enabled. Reason: %reason%.' disabled: 'Maintenance mode has been disabled.' invalid-line: 'The line number must be 1 or 2.' at-least-one: 'The line number must be at least 1.' must-be-positive: 'The max players must be a positive number.' this-line-does-not-exist: 'This line does not exist.' reloaded: 'The plugin has been reloaded.' until-usage: 'Usage: /maintenance for [reason]' until: 'The maintenance mode has been enabled until %until%(for %remain%).' until-with-reason: 'The maintenance mode has been enabled until %until%(for %remain%). Reason: %reason%.' # default messages default-no-reason: 'No reason given.' default-no-until: 'The maintenance period has not been defined.' default-no-remain: 'The maintenance period has not been defined.' # time and date format format: time: 'hh:mm:ss' date: 'dd/mm/yyyy' # time units days: 'days' hours: 'hours' minutes: 'minutes' seconds: 'seconds' days-short: 'd' hours-short: 'h' minutes-short: 'm' seconds-short: 's' # kick messages kick: message: 'The server is currently in maintenance mode.' message-with-reason: 'The server is currently in maintenance mode. Reason: %reason%.' message-with-until: 'The server is currently in maintenance mode. Until: %until%(for %remain%).' message-with-until-and-reason: 'The server is currently in maintenance mode. Until: %until%(for %remain%). Reason: %reason%.' # fake-players messages fake-players: set: 'The fake players has been set to %fakeplayers%.' enabled: 'The fake players has been enabled.' disabled: 'The fake players has been disabled.' add-in-list: enabled: 'The fake players add in list has been enabled.' disabled: 'The fake players add in list has been disabled.' random-order: enabled: 'The fake players random order has been enabled.' disabled: 'The fake players random order has been disabled.' usage: general: 'Usage: /maintenance ' set: 'Usage: /maintenance fakeplayers set ' add-in-list: 'Usage: /maintenance fakeplayers set-add-in-list ' random-order: 'Usage: /maintenance fakeplayers set-random-order ' # max-players messages max-players: set: 'The max players has been set to %maxplayers%.' enabled: 'The custom max players has been enabled.' disabled: 'The custom max players has been disabled.' usage: general: 'Usage: /maintenance ' set: 'Usage: /maintenance maxplayers set ' # normal-motd messages normal-motd: usage: 'Usage: /maintenance [text]' set: 'The line %line% of the normal MOTD has been set to %text%.' set-clean: 'The line %line% of the normal MOTD has been cleared.' random: motd: enabled: 'The normal random MOTD has been enabled.' disabled: 'The normal random MOTD has been disabled.' player-count: enabled: 'The normal random player count has been enabled.' disabled: 'The normal random player count has been disabled.' hover: enabled: 'The normal random hover has been enabled.' disabled: 'The normal random hover has been disabled.' usage: general: 'Usage: /maintenance ' motd: 'Usage: /maintenance normal-random motd ' player-count: 'Usage: /maintenance normal-random player-count ' hover: 'Usage: /maintenance normal-random hover ' player-count: enabled: 'The normal player count has been enabled.' disabled: 'The normal player count has been disabled.' set: 'The normal player count has been set to %text%.' remove: 'The normal player count has been removed.' hover: enabled: 'The normal player count hover has been enabled.' disabled: 'The normal player count hover has been disabled.' set: 'The normal player count hover has been set to %text% at line %line%.' remove: 'The normal player count hover at line %line% has been removed.' usage: general: 'Usage: /maintenance ' set: 'Usage: /maintenance normal-player-count set ' hover: 'Usage: /maintenance normal-player-count hover ' set-hover: 'Usage: /maintenance normal-player-count set-hover ' remove-hover: 'Usage: /maintenance normal-player-count remove-hover ' icon: enabled: 'The normal icon has been enabled.' disabled: 'The normal icon has been disabled.' random: enabled: 'The normal random icon has been enabled.' disabled: 'The normal random icon has been disabled.' usage: general: 'Usage: /maintenance ' random: 'Usage: /maintenance normal-icon random ' # maintenance-motd messages maintenance-motd: usage: 'Usage: /maintenance [text]' set: 'The line %line% of the maintenance MOTD has been set to %text%.' set-clean: 'The line %line% of the maintenance MOTD has been cleared.' random: motd: enabled: 'The maintenance random MOTD has been enabled.' disabled: 'The maintenance random MOTD has been disabled.' player-count: enabled: 'The maintenance random player count has been enabled.' disabled: 'The maintenance random player count has been disabled.' hover: enabled: 'The maintenance random hover has been enabled.' disabled: 'The maintenance random hover has been disabled.' usage: general: 'Usage: /maintenance ' motd: 'Usage: /maintenance maintenance-random motd ' player-count: 'Usage: /maintenance maintenance-random player-count ' hover: 'Usage: /maintenance maintenance-random hover ' player-count: enabled: 'The maintenance player count has been enabled.' disabled: 'The maintenance player count has been disabled.' set: 'The maintenance player count has been set to %text%.' remove: 'The maintenance player count has been removed.' hover: enabled: 'The maintenance player count hover has been enabled.' disabled: 'The maintenance player count hover has been disabled.' set: 'The maintenance player count hover has been set to %text% at line %line%.' remove: 'The maintenance player count hover at line %line% has been removed.' usage: general: 'Usage: /maintenance ' set: 'Usage: /maintenance maintenance-player-count set ' hover: 'Usage: /maintenance maintenance-player-count hover ' set-hover: 'Usage: /maintenance maintenance-player-count set-hover ' remove-hover: 'Usage: /maintenance maintenance-player-count remove-hover ' icon: enabled: 'The maintenance icon has been enabled.' disabled: 'The maintenance icon has been disabled.' random: enabled: 'The maintenance random icon has been enabled.' disabled: 'The maintenance random icon has been disabled.' usage: general: 'Usage: /maintenance ' random: 'Usage: /maintenance maintenance-icon random ' ``` fake-players.yml ```yaml fake-players: - 'Player1' - 'Player2' - 'Player3' - 'Player4' - 'Player5' - 'Player6' - 'Player7' - 'Player8' - 'Player9' - 'Player10' ``` ### **Support me if you like what I do** ### **[PayPal](https://www.paypal.com/donate/?hosted_button_id=ll2uzd72acvhc)**