BlockMessage

BlockMessage is a simple Velocity plugin for temporarily blocking player connections during server maintenance or emergencies.
It allows you to restrict server access with a single command, displaying custom messages to players in both the server list (MOTD) and upon connection attempts.

Features

• Command-Based Blocking: Toggle connection blocking on and off in real-time with the /block <on|off> command, no server restart required.
• Custom Kick Message: Fully customize the message shown to blocked players in config.yml. Multi-line messages and color codes are supported.
• Custom MOTD: Change the MOTD (server description), version name, and player count displayed in the server list while blocking is active. This makes it easy to inform players about maintenance at a glance.
• Permission Control: Restrict command usage to administrators with the blockmessage.command.admin permission.
• Persistent Settings: The plugin's state is saved in config.yml, so your settings will be maintained even after restarting Velocity.

Configuration (default.yml)

The plugins/blockmessage/config.yml file is generated on the first startup.

# =================================================================
# BlockMessage Plugin Configuration (Default Profile Template)
# This file will be copied to profiles/default.yml if it doesn't exist.
# =================================================================

# Enable or disable the entire plugin for this profile.
# If false, no players will be blocked and the MOTD will not be changed when this profile is active.
enabled: true

# The message displayed to players when they are blocked from joining.
# This is a list of strings, where each string represents a new line.
# You can use '&' for color codes.
block-message:
  - "&cThis server is currently in maintenance mode."
  - "&ePlease try again later."

# Configuration for the custom MOTD (Message of the Day) shown in the server list.
block-motd:
  # Enable or disable the custom MOTD when the plugin is enabled in this profile.
  enabled: true

  # The first line of the MOTD.
  line1: "&cServer is in Maintenance"

  # The second line of the MOTD.
  line2: "&eWe will be back soon!"

  # The maximum player count to display. Set to -1 to use the server's default from bungee config.
  max-players: 0 # Set to 0 to override Bungee default and show 'Maintenance' count

  # The online player count to display. Set to -1 to use the server's default from bungee config.
  online-players: 0 # Set to 0 to override Bungee default and show 'Maintenance' count

# Players in this list will not be blocked, even if the plugin is enabled in this profile.
# This is useful for allowing admins to join during maintenance.
# Names are case-insensitive during checks, but stored as entered.
whitelist:
  - "AdminPlayer1"
  - "AnotherAdmin"

Color Codes

&0	Black
&1	Dark Blue
&2	Dark Green
&3	Dark Aqua
&4	Dark Red
&5	Purple
&6	Gold
&7	Gray
&8	Dark Gray
&9	Blue
&a	Green
&b	Aqua
&c	Red
&d	Pink
&e	Yellow
&f	White

Formatting Codes

&k	Obfuscated (scrambled text)
&l	Bold
&m	Strikethrough
&n	Underline
&o	Italic
&r	Reset Formatting

Installation

1. Download the latest .jar file from the Releases page.
2. Place the downloaded .jar file into your Velocity server's plugins folder.
3. Start or restart your Velocity server.
4. Edit the plugins/blockmessage/config.yml file as needed.

© 2025 MichiJP. All Rights Reserved.