AeroChat

## AeroChat — ultra‑light chat for Paper, Purpur & Forks 1.21.X AeroChat is a tiny, fast chat formatter focused on simplicity and modern color features. ### Highlights - Paper 1.21.x only (requires Java 21) - LuckPerms integration (group/prefix) and PlaceholderAPI support - MiniMessage + gradients + legacy `&` and HEX (`&#RRGGBB`) - Configurable join messages (private and broadcast) - Commands: reload and clear chat - Designed to be extremely low overhead --- ## Screenshots / Gallery !(https://cdn.modrinth.com/data/cached_images/1109453d3eed077384cd80dd908091fa6d18b6e6.png) !(https://cdn.modrinth.com/data/cached_images/7dd64f12a1b52083cc351c63965b1ac3bf67656c.png) !(https://cdn.modrinth.com/data/cached_images/8e858150f39311a501f8a92b49ed3d1dbe07fe30.png) !(https://cdn.modrinth.com/data/cached_images/d50a036aa82d3039d9a851aa9afdde2d9146258c.png) --- ## Requirements - Java 21 (JDK 21) - Paper 1.21.x (not compatible with 1.19/1.20) - Optional (recommended): PlaceholderAPI and LuckPerms ## Installation 1) Download the built JAR (or build from source). 2) Drop it into your server's `plugins/` folder. 3) Start Paper. A default `config.yml` will be generated. ## Commands & permissions - `/aerochat reload` (alias: `/aec`) - Permission: `aerochat.reload` (default: op) - `/clearchat ` (alias: `/cc`) - Permission: `aerochat.clearchat` (default: op) ## Configuration guide (config.yml) Tokens you can use in templates: - `{prefix}` — resolved from group mapping or LuckPerms meta - `{player}` — player name (colorized via `player_color`) - `{message}` — the original chat component from Paper What you can write in text parts: - Legacy colors `&a`, bold `&l`, etc. - HEX as `&#ff8800` - MiniMessage tags, e.g. `<#ff8800>Hello</#ffaa00>` or `<gradient:#ff8800:#ffaa00>Hello</gradient>` - Shortcut: `<#AAAAAA>Your text</#BBBBBB>` becomes a gradient between those two colors (simple open/close only) Key options: - `player_color`: default color for `{player}` - `groups`: list of group names in priority order (LuckPerms primary is used) - `prefix.<group>`: prefix per group (accepts `&`, HEX, MiniMessage) - `chat-format`: chat template combining the tokens above - `join.welcome` / `join.broadcast`: enable and customize join messages - `clearchat.lines` and `clearchat.broadcast` for `/clearchat` Minimal example: ```yaml player_color: "&f" groups: prefix: admin: "<b><gradient:#C3613A:#E28787>ADMIN</gradient></b>" mod: "<b><gradient:#5732C4:#7779C4>MOD</gradient></b>" default: "<b><gradient:#857D7D:#D6D6D6>PLAYER</gradient></b>" chat-format: "{prefix} &7{player}&7: &f{message}" join: welcome: enabled: true message: "&aWelcome, {player}&a!" broadcast: enabled: true message: "<#f5a623>{player}</#f5a623> &ejoined the server" ``` ## Compatibility - Built against `paper-api:1.21.1-R0.1-SNAPSHOT` - `api-version: '1.21'` — it will not load on older major versions ## Performance AeroChat only runs on chat/join events and command invocations. It keeps no large caches and performs minimal string/component work per message. Expect negligible CPU and memory impact, even with MiniMessage. ClearChat sends N blank lines by design (brief burst of messages). ## Troubleshooting - “Unsupported API version '1.21'” → Your server isn’t 1.21.x. - “Java 21 required” or class version errors → Update your JDK/server to Java 21. - Placeholders aren’t resolving → Verify PlaceholderAPI is installed and the specific expansion you use is present. - Gradients/tags not applying → Ensure you’re using MiniMessage syntax in the static parts (tokens like `{message}` are kept as components and not reparsed). — Main class: `me.sanepe.aerochat.PaperBasePlugin` ## License MIT — see `LICENSE` for details.