BetterChat

插件

· 作者 roguiii

支持现代 MiniMessage 聊天格式,可自定义加入、离开和首次加入消息,提及高亮显示,并可选集成 PlaceholderAPI 和 ServerRoles。

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

最新 2.1.0+mc26.3 · 26.3 · Paper / Purpur

一键开服(送7天)

BetterChat

适用于 Paper/Purpur 26.3 — Java 25 — 版本 2.1.0

BetterChat 使用 MiniMessage 格式重写了服务器的聊天、加入、离开和首次加入消息。它内置了占位符,可选支持 PlaceholderAPI 和 ServerRoles 集成,以及提及高亮系统——所有配置均通过一个注释详尽的 config.yml 文件进行驱动。

消息管道默认设计为安全模式:玩家输入的消息会被转义并最后插入,因此普通玩家无法在聊天中注入颜色、格式标签或占位符。

功能

  • MiniMessage 聊天格式 — 在配置的格式字符串中完全支持渐变、颜色、装饰和重置。
  • 加入/离开/首次加入消息 — 每项均可独立切换,并完全支持格式化。
  • 内置占位符 — {player}、{displayname}、{world}、{online}、{message}。
  • 可选 PlaceholderAPI 支持 — 当安装了 PlaceholderAPI 时,可在格式字符串中使用任何 %placeholder%(例如 %serverroles_prefix_formatted%)。
  • 可选 ServerRoles 集成 — 通过 PlaceholderAPI 提供角色前缀和颜色。
  • 提及高亮 — @name 会以可配置的颜色和声音高亮显示被提及的玩家。
  • 安全消息处理 — 玩家消息内容不经过 PlaceholderAPI 处理,除非玩家拥有格式权限,否则会被转义。
  • 基于权限的格式化 — 只有拥有 betterchat.format 权限的玩家才能在自身消息中使用 MiniMessage 标签。
  • 双语语言文件 — 包含 en_US 和 pt_PT。
  • 游戏内格式调试 — 逐步检查占位符解析管道。

命令

命令 描述 权限
/betterchat 显示命令用法。 (无)
/betterchat reload 重新加载配置文件和语言文件,重新检测 PlaceholderAPI。 betterchat.admin
/betterchat debugpapi [player] 打印玩家的占位符解析管道。 betterchat.admin
/betterchat debugformat [player] 打印玩家已解析的聊天/加入/离开格式。 betterchat.admin

别名:/bchat。

权限

节点 描述 默认值
betterchat.admin 访问 /betterchat 管理子命令(reload, debugpapi, debugformat)。 op
betterchat.format 允许玩家在自身的聊天消息中使用 MiniMessage 格式标签。 false

关于 betterchat.format 的说明:授予此节点允许玩家在消息中使用 MiniMessage 标签。仅将其授予可信玩家。没有该权限的玩家其标签会被自动转义,因此他们的消息内容始终以字面形式显示。

配置

默认 config.yml:

language: en_US

features:
  chat-format: true
  join-quit-messages: true
  first-join-message: true
  # If true, players with betterchat.format can use MiniMessage tags in their messages.
  allow-message-minimessage-with-permission: true
  mention-highlight:
    enabled: true
    sound: "entity.experience_orb.pickup"
    format: "<yellow>@{mentioned}</yellow>"

formats:
  # Supports both built-in {placeholders} and PlaceholderAPI %placeholders%.
  chat: "%serverroles_prefix_formatted% %serverroles_color%{player}<reset>: <white>{message}</white>"
  join: "<green>+ <gray>{player}</gray></green>"
  quit: "<red>- <gray>{player}</gray></red>"
  first-join: "<gold>* <gray>{player}</gray> <yellow>joined for the first time!</yellow></gold>"

debug:
  papi: false
  placeholder-flow: false

关键点:

  • 占位符 — 内置的 {...} 占位符优先解析,然后是 PlaceholderAPI 的 %...%,最后是 {message} 的插入(仅限聊天)。消息内容不经过 PlaceholderAPI 处理,从而防止从聊天中注入占位符。
  • formats.chat — 默认格式通过 PlaceholderAPI 使用 ServerRoles 占位符。如果您未运行 PlaceholderAPI,请将其替换为纯文本格式,例如 "<gray>{player}</gray>: <white>{message}</white>"。
  • mention-highlight — 设置 sound: "" 以禁用提及音效。
  • debug — 正常操作时保持两项关闭;placeholder-flow 会输出非常详细的日志。

安装

  1. 需要 Paper 或 Purpur 26.3 以及 Java 25(2.0.0 运行于 26.2,1.x 运行于 1.21.x)。
  2. (可选但推荐)如果您的格式字符串使用 %...% 占位符或 ServerRoles 集成,请安装 PlaceholderAPI。
  3. 将 BetterChat.jar 放入服务器的 plugins/ 文件夹。
  4. 启动服务器一次以生成 config.yml 和语言文件。
  5. 根据需要编辑 config.yml 并运行 /betterchat reload。

依赖

  • PlaceholderAPI(可选) — 仅在您的格式中使用 %...% 占位符(包括默认的基于 ServerRoles 的聊天格式)时需要。如果没有它,内置的 {...} 占位符和 MiniMessage 仍然有效;任何 %...% 令牌将保持未解析状态。
  • ServerRoles(可选) — 通过 PlaceholderAPI 提供角色前缀/颜色占位符。

支持 / 源码

源代码:

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源