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

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 [lines] (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:

player_color: "&f"
groups: [admin, mod, default]
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.