Bedwars1058 Formatting addon

Bedwars1058 - Modern Formatting Addon

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

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

```yaml #

█▄▄ █░█░█ █▀▀ █▀█ █▀█ █▀▄▀█ ▄▀█ ▀█▀ ▀█▀ █▀▀ █▀█

█▄█ ▀▄▀▄▀ █▀░ █▄█ █▀▄ █░▀░█ █▀█ ░█░ ░█░ ██▄ █▀▄

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:

```yaml

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.