BwFormattingAddon

A lightweight Paper 1.21.1 addon that brings MiniMessage and &#RRGGBB hex color support to BedWars1058.

Write MiniMessage tags and hex colors directly in BedWars1058's existing language files, no source changes to BedWars1058 required.

---

Features

• &#RRGGBB hex color codes in all display surfaces
• Full MiniMessage syntax: gradients, bold, italic, colors, decorations, and more
• Covers chat messages, action bar, titles, subtitles, sidebar, and tab list
• Per-module toggles (messages, scoreboard, tab) via config.yml
• Zero changes to BedWars1058 required

Requirements

Requirement	Version
Minecraft (Paper)	1.21.1
PacketEvents	2.6.0
BedWars1058	Any current release, that supports 1.21.1

Installation

1. Download bw-formatting-addon-1.0.0.jar
2. Place it in your server's plugins/ folder alongside packetevents.jar and your BedWars1058 jar
3. Start the server, a default config.yml will be generated
4. Add MiniMessage tags or &#RRGGBB hex colors to BedWars1058's language files
5. Restart or reload

Configuration

#
# █▄▄ █░█░█ █▀▀ █▀█ █▀█ █▀▄▀█ ▄▀█ ▀█▀ ▀█▀ █▀▀ █▀█
# █▄█ ▀▄▀▄▀ █▀░ █▄█ █▀▄ █░▀░█ █▀█ ░█░ ░█░ ██▄ █▀▄
# version 1.0
#
# https://github.com/wolfylaboratory · https://wolfylab.one
#

enabled: true

# disable/enable formatting for parts of the plugin
modules:
  tab: true
  scoreboard: true
  messages: true

Key	Default	Description
enabled	true	Master on/off toggle
modules.tab	true	Tab list header, footer, player prefix and suffix
modules.scoreboard	true	Sidebar title
modules.messages	true	Chat, action bar, titles, subtitles

Usage

Open any BedWars1058 language file and use MiniMessage syntax or &#RRGGBB hex directly in the values:

# Hex color
some-message: "&#FF5500This is orange text"

# MiniMessage gradient
some-title: "<gradient:#FF0000:#0000FF>Gradient Title</gradient>"

# Bold + color
some-label: "<bold><red>Important</red></bold>"

# Per-character hex animation frame (sidebar logo)
some-line: "§l&#7771F8S§l&#7754F4t§l&#7771F8a§l&#768DFBb"

Standard & color codes (&a, &l, etc.) continue to work as before — BedWars1058 translates them to § codes before the addon processes them.

How It Works

BedWars1058 routes all display strings through ChatColor.translateAlternateColorCodes, which converts &X → §X but leaves &#RRGGBB and MiniMessage tags as-is. The addon registers a PacketEvents listener at HIGHEST priority and intercepts outgoing packets before they reach players. Each text field is processed through a three-step pipeline:

1. &#RRGGBB → <#RRGGBB> (normalize hex to MiniMessage syntax)
2. §X → MiniMessage tag (e.g. §a → <green>, §l → <bold>)
3. MiniMessage.deserialize() — parses everything into a rich Adventure Component

The Component is then re-injected into the packet and sent to the client.