AeroChat

插件

· 作者 sanepe

适用于 Paper 1.21.x 的超轻量聊天插件,支持 LuckPerms/PlaceholderAPI、MiniMessage 渐变效果,以及可配置的加入/清空聊天功能。

0 本站下载 0 关注 更新于 1 年前

最新 1.2.0 · 1.21.10 · Paper / Purpur

一键开服(送7天)

AeroChat — 适用于 Paper、Purpur 及衍生版的超轻量聊天模组 1.21.X

AeroChat 是一款小巧、快速的聊天格式化工具,专注于简洁性和现代色彩特性。

亮点

  • 仅支持 Paper 1.21.x(需要 Java 21)
  • 集成 LuckPerms(组/前缀)并支持 PlaceholderAPI
  • 支持 MiniMessage + 渐变 + 传统 & 代码和 HEX 颜色(&#RRGGBB)
  • 可配置的加入消息(私聊与广播)
  • 命令:reload 和 clear chat
  • 设计为极低开销

截图 / 画廊

Join message example Clearing Chat Chat Format Example AeroChat Command Show

要求

  • Java 21 (JDK 21)
  • Paper 1.21.x(不兼容 1.19/1.20)
  • 可选(推荐):PlaceholderAPI 和 LuckPerms

安装

  1. 下载构建好的 JAR 文件(或从源代码构建)。
  2. 将其放入服务器的 plugins/ 文件夹中。
  3. 启动 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 文件。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源