BanDialog v1.0.0

Native LiteBans ban dialogs for Velocity

BanDialog v1.0.0 replaces LiteBans' normal ban disconnect with a native Minecraft dialog shown while the player is still in the Velocity configuration phase.

Instead of being forwarded to a fallback server or receiving the default disconnect screen, banned players see a configurable ban notice with the punishment details. The default Disconnect button immediately closes the connection with the configured message.

Highlights

• Native configuration-phase dialogs for Minecraft 1.21.6+ clients
• LiteBans ban details and placeholders
• Datapack-style YAML dialog definitions
• MiniMessage colors and formatting, including <rainbow>, gradients, hex colors, and <newline>
• Compact multiline body text
• No backend-server access for banned players
• Configuration-phase keep-alives to prevent unintended client timeouts
• Immediate default Disconnect handling without "Waiting for Server"
• Console-only /bandialog reload command with safe, atomic configuration reloads
• Clean startup logging and shutdown cleanup for active dialog sessions

Requirements

• Java 21
• Velocity with 1.21.6+ dialog packet support
• LiteBans
• Minecraft 1.21.6+ clients

Installation

1. Install LiteBans on the Velocity proxy.
2. Place bandialog-1.0.0.jar in the plugins directory.
3. Start the proxy and edit plugins/bandialog/config.yml.
4. Run /bandialog reload from the proxy console after changing the configuration.

Important configuration note

The dialog section is a vanilla dialog definition expressed in YAML. Use <newline> in body.contents for compact line breaks, and use MiniMessage for colors and formatting.

See the README and generated config.yml for a complete configuration example and the supported placeholders.