## AeroChat \u2014 ultra\u2011light chat for Paper, Purpur & Forks 1.21.X<\/p>\n
AeroChat is a tiny, fast chat formatter focused on simplicity and modern color features.<\/p>\n
### Highlights
\n– Paper 1.21.x only (requires Java 21)
\n– LuckPerms integration (group\/prefix) and PlaceholderAPI support
\n– MiniMessage + gradients + legacy `&` and HEX (`&#RRGGBB`)
\n– Configurable join messages (private and broadcast)
\n– Commands: reload and clear chat
\n– Designed to be extremely low overhead<\/p>\n
—<\/p>\n
## Screenshots \/ Gallery
\n
\n
\n
\n
\n—<\/p>\n
## Requirements
\n– Java 21 (JDK 21)
\n– Paper 1.21.x (not compatible with 1.19\/1.20)
\n– Optional (recommended): PlaceholderAPI and LuckPerms<\/p>\n
## Installation
\n1) Download the built JAR (or build from source).
\n2) Drop it into your server’s `plugins\/` folder.
\n3) Start Paper. A default `config.yml` will be generated.<\/p>\n
## Commands & permissions
\n– `\/aerochat reload` (alias: `\/aec`)
\n\t– Permission: `aerochat.reload` (default: op)
\n– `\/clearchat [lines]` (alias: `\/cc`)
\n\t– Permission: `aerochat.clearchat` (default: op)<\/p>\n
## Configuration guide (config.yml)
\nTokens you can use in templates:
\n– `{prefix}` \u2014 resolved from group mapping or LuckPerms meta
\n– `{player}` \u2014 player name (colorized via `player_color`)
\n– `{message}` \u2014 the original chat component from Paper<\/p>\n
What you can write in text parts: Key options: Minimal example: ## Compatibility ## Performance ## Troubleshooting \u2014<\/p>\n Main class: `me.sanepe.aerochat.PaperBasePlugin`<\/p>\n ## License Ultra\u2011light chat plugin for Paper 1.21.x with LuckPerms\/PlaceholderAPI, MiniMessage gradients, and configurable join\/clear chat.<\/p>\n","protected":false},"featured_media":8122,"template":"","meta":{"_minecraft_slug":"aerochat","_minecraft_project_id":"6KwqhoZl","_minecraft_author":"sanepe","_minecraft_license":"MIT","_minecraft_downloads":206,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"aerochat.zip","_minecraft_size_bytes":84878,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T12:37:21.398548Z","_minecraft_date_created":"2025-11-02T06:23:35.004521Z","_minecraft_date_modified":"2025-11-13T17:30:50.984305Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/aerochat","_minecraft_icon_attachment_id":8122,"_minecraft_imported_at":"2026-05-31T15:06:16+00:00","_minecraft_import_hash":"f926b3aca98da51b14a7da13b9c905c1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[90,127,128,867,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-8121","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– Legacy colors `&a`, bold `&l`, etc.
\n– HEX as `&#ff8800`
\n– MiniMessage tags, e.g. `<#ff8800>Hello<\/#ffaa00>` or `
\n\t– Shortcut: `<#AAAAAA>Your text<\/#BBBBBB>` becomes a gradient between those two colors (simple open\/close only)<\/p>\n
\n– `player_color`: default color for `{player}`
\n– `groups`: list of group names in priority order (LuckPerms primary is used)
\n– `prefix.
\n– `chat-format`: chat template combining the tokens above
\n– `join.welcome` \/ `join.broadcast`: enable and customize join messages
\n– `clearchat.lines` and `clearchat.broadcast` for `\/clearchat`<\/p>\n
\n“`yaml
\nplayer_color: “&f”
\ngroups: [admin, mod, default]
\nprefix:
\n\tadmin: “
\n\tmod: “
\n\tdefault: “
\nchat-format: “{prefix} &7{player}&7: &f{message}”
\njoin:
\n\twelcome:
\n\t\tenabled: true
\n\t\tmessage: “&aWelcome, {player}&a!”
\n\tbroadcast:
\n\t\tenabled: true
\n\t\tmessage: “<#f5a623>{player}<\/#f5a623> &ejoined the server”
\n“`<\/p>\n
\n– Built against `paper-api:1.21.1-R0.1-SNAPSHOT`
\n– `api-version: ‘1.21’` \u2014 it will not load on older major versions<\/p>\n
\nAeroChat 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).<\/p>\n
\n– \u201cUnsupported API version ‘1.21’\u201d \u2192 Your server isn\u2019t 1.21.x.
\n– \u201cJava 21 required\u201d or class version errors \u2192 Update your JDK\/server to Java 21.
\n– Placeholders aren\u2019t resolving \u2192 Verify PlaceholderAPI is installed and the specific expansion you use is present.
\n– Gradients\/tags not applying \u2192 Ensure you\u2019re using MiniMessage syntax in the static parts (tokens like `{message}` are kept as components and not reparsed).<\/p>\n
\nMIT \u2014 see `LICENSE` for details.<\/p>\n","protected":false},"excerpt":{"rendered":"