AeroChat — 适用于 Paper、Purpur 及衍生版的超轻量聊天模组 1.21.X
AeroChat 是一款小巧、快速的聊天格式化工具,专注于简洁性和现代色彩特性。
亮点
- 仅支持 Paper 1.21.x(需要 Java 21)
- 集成 LuckPerms(组/前缀)并支持 PlaceholderAPI
- 支持 MiniMessage + 渐变 + 传统
& 代码和 HEX 颜色(&#RRGGBB)
- 可配置的加入消息(私聊与广播)
- 命令:reload 和 clear chat
- 设计为极低开销
截图 / 画廊

要求
- Java 21 (JDK 21)
- Paper 1.21.x(不兼容 1.19/1.20)
- 可选(推荐):PlaceholderAPI 和 LuckPerms
安装
- 下载构建好的 JAR 文件(或从源代码构建)。
- 将其放入服务器的
plugins/ 文件夹中。
- 启动 Paper。将生成默认的
config.yml 配置文件。
命令与权限
/aerochat reload (别名: /aec)
- 权限:
aerochat.reload (默认: op)
/clearchat [lines] (别名: /cc)
- 权限:
aerochat.clearchat (默认: op)
配置指南 (config.yml)
模板中可用的占位符:
{prefix} — 从组映射或 LuckPerms 元数据解析
{player} — 玩家名称(通过 player_color 着色)
{message} — 来自 Paper 的原始聊天组件
文本部分可写入的内容:
- 传统颜色
&a、加粗 &l 等
- HEX 颜色格式为
&#ff8800
- MiniMessage 标签,例如
<#ff8800>Hello</#ffaa00> 或 <gradient:#ff8800:#ffaa00>Hello</gradient>
- 快捷方式:
<#AAAAAA>Your text</#BBBBBB> 将在两种颜色之间形成渐变(仅简单的打开/关闭标签)
关键选项:
player_color: {player} 的默认颜色
groups: 按优先级排列的组名列表(使用 LuckPerms 主组)
prefix.<group>: 每个组的前缀(接受 &、HEX、MiniMessage)
chat-format: 结合上述占位符的聊天模板
join.welcome / join.broadcast: 启用并自定义加入消息
clearchat.lines 和 clearchat.broadcast 用于 /clearchat
最小化示例:
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"
兼容性
- 基于
paper-api:1.21.1-R0.1-SNAPSHOT 构建
api-version: '1.21' — 不会在较早的主版本上加载
性能
AeroChat 仅在聊天/加入事件和命令调用时运行。它不保留大型缓存,每条消息仅执行最少的字符串/组件处理。即使使用 MiniMessage,也能预期极低的 CPU 和内存影响。ClearChat 故意发送 N 行空白内容(短暂的消息爆发)。
故障排除
- “Unsupported API version '1.21'” → 您的服务器不是 1.21.x 版本。
- “Java 21 required” 或类版本错误 → 请将 JDK/服务器更新到 Java 21。
- 占位符未解析 → 验证是否已安装 PlaceholderAPI 且存在您使用的特定扩展插件。
- 渐变/标签未应用 → 确保在静态部分中使用 MiniMessage 语法(像
{message} 这样的占位符作为组件保留,不会被重新解析)。
—
主类: me.sanepe.aerochat.PaperBasePlugin
许可证
MIT — 详见 LICENSE 文件。
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
- Download the built JAR (or build from source).
- Drop it into your server's
plugins/ folder.
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧