hChat — 一款面向 Paper 1.20+ 服务器的现代化且功能完善的聊天系统。
支持聊天频道、私聊、@提及、 Moderation(慢速模式、锁定聊天、过滤器)、AFK、管理员聊天、邮件、回放等功能,以及更多。
功能特性 •
快速开始 •
命令 •
权限 •
配置 •
本地化 •
占位符 •
依赖项 •
构建 •
贡献指南
? 目录
✨ 功能特性
? 私聊消息
可自定义格式,支持悬停提示和点击回复
|
? @提及
可配置音效、高亮颜色和个性化通知
|
?️ 间谍模式
通过专用权限监控私聊消息
|
? 忽略系统
持久化的按玩家屏蔽列表,重启后依然保留
|
? 多语言
YAML 本地化文件,包括按玩家选择语言
|
? PlaceholderAPI
%hchat_spy_enabled%, %hchat_ignored%, DND, 最后上线时间…
|
? MiniMessage + Hex
支持 MiniMessage 标签、&#RRGGBB 十六进制颜色以及经典 & 代码
|
?️ 悬停与点击
每条聊天行均支持悬停提示和可点击操作
|
? 广播
手动 /bc 命令及自动广播调度器
|
?️ Moderation(管理)
慢速模式、聊天锁定和管理员聊天 (/sc)
|
? 过滤链
词过滤器 + 防大写、防 Unicode、防广告、防刷屏
|
? 聊天记录日志
每日轮转日志,支持可配置的保留策略
|
? 聊天频道
支持按世界、按权限划分,别名设置,冷却时间
|
? 邮件
离线消息功能,使用 /hchat mail read|clear|send
|
? AFK(挂机)
自动检测不活跃状态 + /afk [message]
|
? 全员提及
@everyone / @here 支持冷却时间和音效
|
⏱️ Ping 延迟与在线状态
/ping [player] 和 /seen <player>
|
? 聊天回放
/hchat replay [player] 基于环形缓冲区
|
⚡ 快速开始
? 安装
# 1. 从 Releases 下载最新 JAR 包
wget https://github.com/hauchdev/hChat/releases/latest/download/hChat.jar
# 2. 将其放入服务器的 plugins 文件夹
mv hChat.jar /your-server/plugins/
# 3. 确保已安装 PlaceholderAPI(必需)。推荐使用 LuckPerms,但不再强制要求
# 4. 重启或重载服务器
hChat 在首次启动时会生成 plugins/hChat/config.yml 和 plugins/hChat/lang/lang_en.yml。编辑这些文件后,运行 /hchat reload 即可。
? 命令
| 命令 |
别名 |
描述 |
权限 |
/message <player> <message> |
/msg, /tell, /w, /m, /whisper |
发送私人消息 |
hchat.message |
/reply <message> |
/r |
回复最近的一条私人消息 |
hchat.reply |
/broadcast <message> |
/bc |
向整个服务器广播一条消息 |
hchat.broadcast |
/ignore <player> |
— |
切换对特定玩家的忽略状态 |
hchat.ignore |
/ignore list |
— |
列出被忽略的玩家(点击取消忽略) |
hchat.ignore |
/spy |
— |
切换间谍模式(查看所有私人消息) |
hchat.spy |
/clear |
— |
清除所有玩家的聊天内容 |
hchat.clear |
/channel [name] |
/ch |
列出或切换你当前活跃的聊天频道 |
hchat.channel |
/slowmode <seconds|off|status> |
— |
全局聊天慢速模式(内存中,可绕过) |
hchat.slowmode |
/chatlock <on|off|status> |
— |
锁定 / 解锁整个聊天 |
hchat.chatlock |
/sc <message> |
— |
仅限工作人员使用的聊天频道 |
hchat.sc |
/dnd [on|off] |
— |
切换免打扰模式(拦截传入的私信) |
hchat.dnd |
/ping [player] |
— |
显示你的(或他人的)延迟 |
hchat.ping |
/seen <player> |
— |
该玩家上次向你发送消息的时间 |
hchat.seen |
/afk [message] |
— |
切换闲置状态(长时间无操作也会自动检测) |
hchat.afk |
/hchat reload |
— |
重新加载 config.yml 和语言文件 |
hchat.reload |
/hchat help |
— |
显示游戏内帮助菜单 |
hchat.help |
/hchat lang <lang> |
— |
切换你自己的玩家语言 |
hchat.lang |
/hchat about |
— |
版本、作者及功能概览 |
hchat.help |
/hchat mail <read|clear|send> |
— |
读取 / 清除 / 发送离线消息 |
hchat.help |
/hchat replay [player] |
— |
重印最近的聊天记录(可选按玩家筛选) |
hchat.help |
/hchat replay clear-buffer |
— |
清空重放缓冲区 |
hchat.clear |
⌨️ Tab 补全 — 每个命令在合理的地方都支持 Tab 补全:
/hchat 会补全其子命令(reload、help、lang、update,
受权限过滤),而 /hchat lang 会从 lang/ 目录中补全语言代码;
/message 和 /ignore 会补全在线玩家名称
(/message 还会建议离线玩家,因为它可以投递离线消息);
/channel 会补全已配置的频道 ID。
? 权限
| 权限 |
默认值 |
描述 |
hchat.* |
op |
访问所有 hChat 命令和功能 |
hchat.message |
true |
允许使用 /msg, /tell, /w, /m, /whisper |
hchat.reply |
true |
允许使用 /reply, /r |
hchat.broadcast |
op |
允许使用 /broadcast, /bc |
hchat.broadcast.color |
op |
允许在广播消息中使用颜色代码 |
hchat.ignore |
true |
允许使用 /ignore <player> |
hchat.spy |
op |
允许切换 /spy |
hchat.spy.all |
op |
接收所有私聊消息,无任何例外 |
hchat.clear |
op |
允许使用 /clear |
hchat.reload |
op |
允许使用 /hchat reload |
hchat.help |
true |
允许使用 /hchat help |
hchat.lang |
true |
允许使用 /hchat lang <lang> |
hchat.channel |
true |
允许使用 /channel 及频道切换 |
hchat.slowmode |
op |
允许使用 /slowmode |
hchat.slowmode.bypass |
op |
绕过全局聊天慢速模式 |
hchat.chatlock |
op |
允许使用 /chatlock |
hchat.chatlock.bypass |
op |
在聊天锁定期间仍可发言 |
hchat.sc |
op |
允许使用 /sc 工作人员聊天 |
hchat.dnd |
true |
允许使用 /dnd |
hchat.bypass.dnd |
op |
向启用 DND(勿扰模式)的玩家发送私信 |
hchat.ping |
true |
允许使用 /ping |
hchat.ping.others |
op |
允许使用 /ping <player> |
hchat.seen |
true |
允许使用 /seen |
hchat.afk |
true |
允许使用 /afk |
hchat.mention.everyone |
op |
允许使用 @everyone |
hchat.mention.here |
op |
允许使用 @here |
hchat.monitor.filter |
op |
当词过滤器触发玩家违规时接收警告 |
hchat.bypass-log |
op |
发送私聊消息但不将其写入聊天日志 |
⚙️ 配置
config.yml 会在首次启动时自动生成。该文件还控制插件发出的所有音频/视觉提示。
? 查看完整 config.yml
# 添加新选项时会自动递增 config-version;
# 你的设置始终会被保留(旧文件备份为
# config-backup-v{n}.yml)。
config-version: 10
lang: en
debug: false
update-checker:
enabled: true
notify-admins: true
project: "hchat"
chat:
default-format: "&7%luckperms_prefix% {player} %luckperms_suffix%&8: &f{message}"
hex-colors: true
formats:
vip:
permission: hchat.chat.format.vip
format: "&6&lVIP &8» &e{prefix}{player}{suffix} &8: &f{message}"
mvp:
permission: hchat.chat.format.mvp
format: "&b&lMVP &8» &b{prefix}{player}{suffix} &8: &7{message}"
admin:
permission: hchat.chat.format.admin
format: "&c&lADMIN &8» &c{prefix}{player}{suffix} &8: &7{message}"
# 动态聊天令牌:[ping] [item] [coords] [world] [afk]
placeholders:
ping:
enabled: true
symbol: "▪"
show-value: true
value-suffix: "ms"
good-max: 80
medium-max: 150
good-color: "&a"
medium-color: "&e"
bad-color: "&c"
value-color: "&7"
item:
enabled: true
coords:
enabled: true
format: "&7({x}, {y}, {z})"
world:
enabled: true
format: "&7{world}"
afk:
enabled: true
placeholder: "%essentials_afk%"
afk-values: ["yes", "true"]
format: "&c[AFK]&r "
welcome:
enabled: true
message: "&a&l欢迎 &e{player} &a&l加入服务器!"
hide-vanilla: true
motd-on-join: false
sound:
enabled: true
sound: "entity.player.levelup"
volume: 0.6
pitch: 1.0
first-join:
enabled: true
message: "&6&l★ &e{player} &6是首次加入!"
hide-vanilla: true
quit:
enabled: true
message: "&c{player} &7离开了服务器。"
hide-vanilla: true
mentions:
sound:
enabled: true
sound: "entity.experience_orb.pickup"
volume: 1.0
pitch: 1.0
colors:
enabled: true
color: "6A3FF"
# 加粗高亮(聊天中无法实现真实的背景色)。
highlight: true
everyone-permission: hchat.mention.everyone
here-permission: hchat.mention.here
everyone-cooldown-seconds: 60
everyone-sound:
enabled: true
sound: "entity.wither.spawn"
volume: 1.0
pitch: 1.0
direct-messages:
sender:
format: "&7[&e你 &7-> &e{receiver}&7] &7{message}"
hover-text:
enabled: false
receiver:
format: "&7[&e{sender} &7-> &e你&7] &7{message}"
hover-text:
enabled: true
clickable-actions:
enabled: true
reply-command: "/msg {sender}"
silenced-action-bar:
enabled: true
text: "&e{receiver} 已被禁言 - 消息未发送。"
spy-format: "&e{sender} &7-> &e{target}&7: &7{message}"
hover-text:
enabled: true
format:
- "6FF7F %player_name%"
- "&7"
- "&e点击发送私聊"
channels:
default-by-permission:
- permission: hchat.channel.default.vip
channel: vip
hint-on-switch: true
hint-on-join: true
global:
range: -1
local:
format: "&8[本地] &7{player} &8» &f{message}"
range: 80
action-bar-hint: "&e附近有人正在交谈"
alias: "#l"
staff:
format: "&c[工作人员] {player} &8» &f{message}"
speak-permission: hchat.channel.staff
see-permission: hchat.channel.staff.see
alias: "#staff"
vip:
format: "&e[VIP] {player} &8» &f{message}"
speak-permission: hchat.chat.format.vip
alias: "#vip"
trade:
format: "&6[交易] {player} &8» &f{message}"
cooldown-ms: 5000
alias: "#trade"
world:
format: "&7[{world}] {player} &8» &f{message}"
range: -1
per-world: true
alias: "#world"
broadcast:
enabled: true
cooldown-ms: 0
format:
- ""
- "૧F5广播:"
- "{message}"
example1:
enabled: true
message: "&#F52727此广播每 10 分钟发送一次。在 /hChat/config.yml 中编辑"
interval: 600
display-in-console: true
offline-messages:
max-pending: 10
sound:
enabled: true
sound: "entity.experience_orb.pickup"
volume: 1.0
pitch: 1.0
logging:
private-messages:
enabled: true
path: logs
retention-days: 30
word-filter:
enabled: true
words: ["blacklist1", "blacklist2"]
action: "block" # block | mask | warn
Advanced filters (config v6): anti-caps, anti-unicode, anti-ad,
anti-spam - see the "Filters" section below.
filters:
anti-caps:
enabled: true
max-uppercase-percent: 70
min-length: 8
action: "mask"
anti-unicode:
enabled: true
block-invisible: true
action: "block"
anti-ad:
enabled: true
patterns:
- "(?<![a-zA-Z0-9])([a-z0-9-]+\.)+(com|net|org|gg|io)"
- "(discord\.gg/|discordapp\.com/invite/)"
sensitivity: medium
whitelist:
- "tu-servidor.com"
- "discord.gg/tuinvite"
action: "warn"
anti-spam:
enabled: true
global-cooldown-ms: 1500
flood:
max-messages: 5
window-seconds: 3
similarity-threshold: 0.8
action: "block"
replay:
capacity: 50
afk:
enabled: true
auto-timeout-seconds: 300
check-interval-seconds: 30
unset-on-activity: true
notify-unset: true
slowmode:
enabled: true
seconds: 3
bypass-permission: hchat.slowmode.bypass
chat-lock:
enabled: true
bypass-permission: hchat.chatlock.bypass
staff-chat:
format: "&c[工作人员] {player} &8» &f{message}"
log-to-console: true
death-message:
enabled: true
format: "&c☠ &7{player} &f死于 {cause}"
custom:
FALL: "&c{player} 学会了飞行。"
LAVA: "&c{player} 与岩浆交了朋友。"
</details>
### ? 可用占位符
| 占位符 | 替换为 |
|---------------|------------------------------------------------------|
| `{sender}` | 发送者的显示名称 |
| `{receiver}` | 接收者的显示名称 |
| `{target}` | 目标名称(间谍视角) |
| `{message}` | 实际的消息正文 |
| `{player}` | 玩家名称(提及、离线消息等) |
| `%player_name%` | 由 PlaceholderAPI 解析,适用于任何注册了该钩子的插件 |
渲染器分两遍处理每个条目:首先替换占位符,然后 `MessageFormatter` 解析格式。格式的解析方式由 `chat.format-mode` 控制:
| 模式 | 行为 |
|---------------|----------------------------------------------------------------------|
| `legacy` | 经典 `&` 代码 + `&#RRGGBB` 十六进制颜色(默认,向后兼容) |
| `minimessage` | [MiniMessage](https://docs.advntr.dev/minimessage) 标签 (`<red>`, `<gradient:red:blue>`, `<#RRGGBB>`, 悬停/点击) —— 经典 `&` 代码和 `&#RRGGBB` 十六进制颜色仍会被转换 |
| `auto` | 当格式包含 `&` 代码时使用 Legacy 模式,否则使用 MiniMessage 模式 |
每个频道都可以使用自己的 `format-mode` 键覆盖全局模式,因此 Legacy 模式的 `global` 频道和 MiniMessage 模式的 `staff` 频道可以共存。在 MiniMessage 模式下,玩家类型的文本始终会被转义:玩家可以使用 `&` 颜色,但不能注入标签、点击或悬停事件。
#### ? 动态聊天令牌
hChat 自身在聊天格式(默认格式、`chat.formats.*` 和频道格式)中渲染以下 NoNChat 风格的令牌:
| 令牌 | 替换为 |
|--------------|----------------------------------------------------------------|
| `[ping]` | 彩色延迟指示器(绿色 ≤ `good-max`,黄色 ≤ `medium-max`,红色高于该值),可选显示 `ms` 数值 |
| `[item]` | 主手物品;悬停显示包含名称、附魔、耐久条和描述的提示框 |
| `[coords]` | 玩家位置,格式为 `x, y, z` |
| `[world]` | 当前世界名称 |
| `[afk]` | 当玩家处于空闲状态时添加 `[AFK]` 前缀(内置 `/afk` + 不活动检测,PAPI 回退) |
示例格式:`"[ping] [afk]&7{player}&8: &f{message}"`。每个令牌都可以在 `config.yml` 的 `placeholders:` 部分启用/禁用并进行调整(包括 ping 颜色/阈值、坐标/世界格式、AFK 占位符及其 `afk-values`)。令牌在 PAPI 之后于 `Component` 级别解析,因此玩家键入的字面量 `[ping]` 永远不会被转换为指示器。
---
## ? 聊天频道
频道为每次对话提供独立的格式、可见范围、权限和冷却时间。Ship config 包含 `global`(全局)、`local`(基于距离)、`staff`(工作人员)、`vip`、`trade`(交易)和 `world`(按世界)频道。
| 功能 | 配置位置 |
|---------|-------|
| 频道格式、范围、冷却时间、别名 | `channels.<id>.*` |
| 频道的 MiniMessage 覆盖 | `channels.<id>.format-mode` |
| 发言/查看权限 | `speak-permission`, `see-permission` |
| 基于距离的本地聊天 + 动作栏提示 | `range`, `action-bar-hint` |
| 按世界划分的频道(不跨世界) | `per-world: true` + `{world}` |
| 进入时通过权限自动加入 | `default-by-permission` |
| 切换/加入时的动作栏提示 | `hint-on-switch`, `hint-on-join` |
```yaml
channels:
local:
format: "&8[Local] &7{player} &8» &f{message}"
range: 80
action-bar-hint: "&e附近有人正在交谈"
alias: "#l"
staff:
format: "&c[Staff] {player} &8» &f{message}"
speak-permission: hchat.channel.staff
see-permission: hchat.channel.staff.see
alias: "#staff"
在游戏中:/channel 列出频道(点击可切换),/channel <name> 切换你的活动频道(跨会话记住),#staff hello 可从任何地方发送到指定频道。默认频道(global)使用 chat.default-format 或基于权限的 chat.formats(vip/mvp/admin)。
? 本地化
语言文件位于 plugins/hChat/lang/。插件自带 lang_en.yml 并支持任意数量的附加文件。
# lang_es.yml
no-permission: "&c你没有权限!"
player-only: "&c只有玩家可以使用此命令!"
player-offline: "&c玩家离线!"
mentioned: "&#ffffff你在聊天中被 TFFB8{player} 提及!"
从 config.yml 切换全服务器语言:
lang: es
每个玩家也可以使用 /hchat lang <lang> 覆盖自己的语言(存储在 plugins/hChat/storage/player-lang.yml 中)。在运行时,消息首先查找玩家专属文件,当键缺失或玩家未选择语言时,回退到 config.yml 中的全服务器 lang 设置。
? 占位符
当安装 PlaceholderAPI 时,hChat 会注册以下占位符。
| 占位符 |
描述 |
%hchat_spy_enabled% |
Spy Mode: Enabled / Spy Mode: Disabled |
%hchat_ignored% |
You are ignoring players / You are not ignoring anyone |
%hchat_ignored_<name>% |
针对单个玩家的忽略检查 (true / false,不区分大小写) |
%hchat_ignored_count% |
该玩家当前忽略的玩家数量 |
%hchat_dnd_enabled% |
DND: Enabled / DND: Disabled |
%hchat_last_sender% |
最近给你发送私聊的玩家名称 |
%hchat_last_message_part% |
你收到的最后一条私聊消息的前 30 个字符(带省略号) |
%hchat_last_seen% |
Received N minutes ago / No recent messages |
任何针对当前离线玩家解析的占位符都会返回 lang_en.yml 中定义的安全(无玩家)措辞。
?️ 过滤器
每条聊天消息都按以下顺序经过过滤器链:
word-filter → anti-unicode → anti-caps → anti-ad → anti-spam。
每个过滤器都支持相同的操作:
| 操作 |
行为 |
block |
丢弃消息并用 message-filtered 通知发送者。 |
mask |
将违规部分替换为 *,然后转发消息。 |
warn |
让消息通过,并向所有拥有 hchat.monitor.filter 权限的玩家发出提示。 |
lowercase |
将消息转换为小写(用于反大写)。 |
词过滤器
word-filter:
enabled: true
words:
- "blacklist1"
- "blacklist2"
action: "block" # block | mask | warn
反大写
阻止/屏蔽/转换几乎全是大写的消息(max-uppercase-percent, min-length)。
反 Unicode
阻止用于绕过过滤器的不可见字符:零宽空格、方向覆盖、BOM、标签字符(U+E0000+)和软连字符。
反广告
匹配具有可配置正则表达式模式的 URL 和 Discord 邀请链接,加上始终通过的白名单(子字符串匹配)。
filters:
anti-ad:
enabled: true
patterns:
- "(?<![a-zA-Z0-9])([a-z0-9-]+\\.)+(com|net|org|gg|io)"
- "(discord\\.gg/|discordapp\\.com/invite/)"
whitelist:
- "tu-servidor.com"
action: "warn"
ℹ️ 默认的 TLD 列表故意排除了 me —— help.me 会在正常文本中产生误报。
反垃圾信息
全局单玩家冷却时间(global-cooldown-ms)以及洪水检测:在 window-seconds 内超过 max-messages 条消息,或高度相似的重复(similarity-threshold),将被阻止。
filters:
anti-spam:
enabled: true
global-cooldown-ms: 1500
flood:
max-messages: 5
window-seconds: 3
similarity-threshold: 0.8
action: "block"
? 广播
/broadcast <message>(别名 /bc)会向服务器上的每位玩家显示一个可配置的多行广播。格式在 config.yml 中的 broadcast.format 下设置,支持占位符以及十六进制颜色代码。拥有 hchat.broadcast.color 权限的玩家可以在广播正文中使用颜色代码。
对于定时公告,请在 broadcast.<id> 下添加额外的条目,包含 enabled、message、interval(秒)和 display-in-console:
broadcast:
example1:
enabled: true
message: "&#F52727This is a recurring broadcast every 10 minutes"
interval: 600
display-in-console: true
调度器由 AutoBroadcastManager 实现。
ℹ️ Discord 桥接: 当启动时安装了 DiscordSRV,hChat 会记录一条确认信息并为即将到来的聊天桥接预留集成(参见 ROADMAP.md)。目前不会将任何广播或 /msg 中继到 Discord。
? 邮件(离线消息)
如果玩家在 Steve 处于离线状态时运行 /msg Steve hola,该消息将以发送者名称和时间戳存储在 OfflineMessageStore 中(每位接收者的待处理消息上限为 offline-messages.max-pending)。当 Steve 登录时,他会看到一个可点击的摘要——&eYou have 3 pending messages. Click to read. ——而不是自动投递:
| 命令 |
作用 |
/hchat mail read |
列出所有待处理的消息(点击回复) |
/hchat mail clear |
清除你自己的待处理消息 |
/hchat mail send <p> <msg> |
/msg 的快捷方式 |
消息仅在阅读或清除时被移除,如果 offline-messages.sound.enabled: true,则玩家在加入时会播放一段声音。如果目标玩家从未加入过服务器(hasPlayedBefore() == false),/msg 将回退到标准的 player-not-found 提示。
? AFK
hChat 内置了 AFK 系统——无需 Essentials:
/afk 用于切换;/afk <message> 可以带着原因进入 AFK 状态。
- 在
afk.auto-timeout-seconds(默认 300 秒)的不活动后,玩家会自动被标记为 AFK。
- 任何真实活动(移动、聊天、命令、交互)都会清除该状态(
afk.unset-on-activity);返回的玩家会在聊天中宣布(afk.notify-unset)。
[afk] 聊天令牌使用此状态(当内置功能禁用时使用 PAPI 作为后备)。
? 开发者 API
HChatProvider 是其他插件的公共入口点。获取单例实例,然后使用其访问器:
import dev.hauch.hchat.api.HChatProvider;
import dev.hauch.hchat.model.ChatChannel;
public class MyListener implements Listener {
public void demo() {
HChatProvider api = HChatProvider.get();
// 当前正在间谍监听的人
for (java.util.UUID uuid : api.spyManager().getSpies()) {
// ...
}
// 玩家收到的最后一条私信
api.messageHistory().getLastMessage(player.getUniqueId());
// 玩家的活跃频道
ChatChannel channel = api.channelManager().activeChannel(player);
// 通过现有频道(staff, vip...)进行广播,
// 尊重其查看权限
api.publishToChannel(api.channelManager().get("staff"),
"Server restarting in 5 minutes!");
// DND 状态
api.dndManager().isDnd(player);
}
}
ℹ️ HChatProvider.get() 在插件完全初始化之前(前几个 ticks)会抛出 IllegalStateException。请从 ServerLoadEvent 或之后访问它。依赖 hChat 的其他插件应在它们的 plugin.yml 中将其声明为 softdepend(或 depend)。
? 代理说明 (Velocity / BungeeCord)
hChat 运行在后端服务器上,而不是代理上:
Player#getUniqueId 和 %player_name% 在 Velocity 和 BungeeCord 后面仍然有效——Paper 会将真实的 UUID 和名称转发给后端。
- 私聊、离线消息、忽略列表和 DND 状态都是每个后端服务器独立的。连接到服务器 A 的玩家无法向服务器 B 上的玩家发送
/msg;如需跨服务器聊天,请使用代理端的解决方案或 DiscordSRV 桥接。
{world} 和 [coords] 占位符将在玩家当前所在的后端服务器上解析。
- 更新检查器、faststats.dev 指标和自动广播调度器在每个后端实例上仅运行一次——如果你运行的是一个网络并且不希望重复的公告,请在除一台服务器之外的所有服务器上禁用自动广播。
? 依赖项
✅ 必需
| 插件 |
版本 |
用途 |
| Paper |
1.20+ |
服务器 API (Adventure, AsyncChatEvent) |
| PlaceholderAPI |
2.11+ |
占位符, Vault/LuckPerms 桥接 |
? 可选 (softdepend)
如果启动时检测到 DiscordSRV,hChat 会记录一条确认信息,以便管理员知道挂钩已注册。目前尚未实现将 /msg 和 /broadcast 转发到 Discord 的功能 —— 请参阅 ROADMAP.md 了解计划的桥接方案。
? 指标统计 (faststats.dev)
hChat 内置了 faststats.dev 用于匿名插件统计数据 —— 无需额外下载,也无需配置:指标统计始终开启。绝不会收集任何玩家或聊天数据,仅收集匿名的插件使用计数器。
?️ 从源码构建
要求:JDK 21 和 Maven 3.5+。
# 克隆仓库
git clone https://github.com/hauchdev/hChat.git
cd hChat
# 编译并打包
mvn clean package
# 阴影 JAR 位于:plugin-dist/target/hChat-<version>.jar
ℹ️ 发行版 —— 插件版本只存在于一个地方:根目录 pom.xml 顶部的 <revision> 属性。只需在此处修改它(或通过 Maven 传递 -Drevision=1.3.0),所有模块、经过过滤的 plugin.yml 中的版本号以及最终的 jar 文件名都会自动更新。你无需触碰其他 13 个 POM 文件。
CI 通过 .github/workflows/build.yml 进行配置:每次推送到 dev 分支都会运行 mvn clean verify。带有 v* 标签的构建还会发布 GitHub Release,其中包含打包好的 JAR 文件。
? 贡献
非常欢迎提交 Pull Requests 和提供想法。
请遵循 Conventional Commits 规范(西班牙语或英语均可)。每当添加命令、权限或功能时,请更新 lang_en.yml / plugin.yml / README.md,并确保 mvn clean verify 保持绿色(即测试通过)。请参阅 ROADMAP.md 了解整体规划及 upcoming phases。
? 许可证
根据 MIT 许可证发布。
Made with ❤️ by Hauchdev
hChat — A modern and complete chat system for Paper 1.20+ servers.
Chat channels, direct messages, mentions, moderation (slowmode, chatlock, filters), AFK, staff chat, mail, replay, and more.
Features •
Quick Start •
Commands •
Permissions •
Configuration •
Localization •
Placeholders •
Dependencies •
Building •
Contributing
? Table of Contents
✨ Features
? Direct Messages
Customizable format with hover tooltips and click-to-reply
|
? @Mentions
Configurable sound, highlight color, and personal notification
|
?️ Spy Mode
Monitor private messages with a dedicated permission
|
? Ignore System
Persistent per-player block list that survives reloads
|
? Multi-language
YAML localization, including per-player language selection
|
? PlaceholderAPI
%hchat_spy_enabled%, %hchat_ignored%, DND, last seen…
|
? MiniMessage + Hex
MiniMessage tags, &#RRGGBB hex and classic & codes
|
?️ Hover & Click
Tooltips and clickable actions on every chat line
|
? Broadcasts
Manual /bc plus auto-broadcast scheduler
|
?️ Moderation
Slowmode, chat lock and staff chat (/sc)
|
? Filter Chain
Word filter + anti-caps, anti-unicode, anti-ad, anti-spam
|
? Chat Logger
Rotating daily logs with configurable retention
|
? Chat Channels
Per-world, per-permission, aliases, cooldowns
|
? Mail
Offline messages with /hchat mail read|clear|send
|
? AFK
Automatic inactivity detection + /afk [message]
|
? Mass Mentions
@everyone / @here with cooldown + sound
|
⏱️ Ping & Seen
/ping [player] and /seen <player>
|
? Chat Replay
/hchat replay [player] on a ring buffer
|
⚡ Quick Start
? Installation
# 1. Download the latest JAR from Releases
wget https://github.com/hauchdev/hChat/releases/latest/download/hChat.jar
# 2. Drop it into your server's plugins folder
mv hChat.jar /your-server/plugins/
# 3. Make sure PlaceholderAPI is installed (required). LuckPerms is
# recommended but no longer required
# 4. Restart or reload your server
hChat generates plugins/hChat/config.yml and plugins/hChat/lang/lang_en.yml
on first start. Edit them, then run /hchat reload.
? Commands
| Command |
Aliases |
Description |
Permission |
/message <player> <message> |
/msg, /tell, /w, /m, /whisper |
Send a private message |
hchat.message |
/reply <message> |
/r |
Reply to the most recent private message |
hchat.reply |
/broadcast <message> |
/bc |
Broadcast a message to the whole server |
hchat.broadcast |
/ignore <player> |
— |
Toggle ignoring a specific player |
hchat.ignore |
/ignore list |
— |
List ignored players (click to unignore) |
hchat.ignore |
/spy |
— |
Toggle spy mode (see all private messages) |
hchat.spy |
/clear |
— |
Clear the chat of every player |
hchat.clear |
/channel [name] |
/ch |
List or switch your active chat channel |
hchat.channel |
/slowmode <seconds|off|status> |
— |
Global chat slowmode (in-memory, bypassable) |
hchat.slowmode |
/chatlock <on|off|status> |
— |
Lock / unlock the whole chat |
hchat.chatlock |
/sc <message> |
— |
Staff-only chat channel |
hchat.sc |
/dnd [on|off] |
— |
Toggle do-not-disturb (blocks incoming DMs) |
hchat.dnd |
/ping [player] |
— |
Show your (or someone else's) latency |
hchat.ping |
/seen <player> |
— |
When the player last sent you a message |
hchat.seen |
/afk [message] |
— |
Toggle AFK (auto-detected after inactivity too) |
hchat.afk |
/hchat reload |
— |
Reload config.yml and language files |
hchat.reload |
/hchat help |
— |
Show the in-game help menu |
hchat.help |
/hchat lang <lang> |
— |
Switch your own player language |
hchat.lang |
/hchat about |
— |
Version, authors and feature overview |
hchat.help |
/hchat mail <read|clear|send> |
— |
Read / clear / send offline messages |
hchat.help |
/hchat replay [player] |
— |
Reprint recent chat (optionally filtered by player) |
hchat.help |
/hchat replay clear-buffer |
— |
Empty the replay buffer |
hchat.clear |
⌨️ Tab completion — every command supports it where it makes sense:
/hchat completes its subcommands (reload, help, lang, update,
filtered by permission) and /hchat lang completes the language codes
from lang/; /message and /ignore complete online player names
(/message also suggests offline players, since it can deliver offline
messages); /channel completes the configured channel ids.
? Permissions
| Permission |
Default |
Description |
hchat.* |
op |
Access to every hChat command and feature |
hchat.message |
true |
Allows /msg, /tell, /w, /m, /whisper |
hchat.reply |
true |
Allows /reply, /r |
hchat.broadcast |
op |
Allows /broadcast, /bc |
hchat.broadcast.color |
op |
Allows color codes inside broadcast messages |
hchat.ignore |
true |
Allows /ignore <player> |
hchat.spy |
op |
Allows toggling /spy |
hchat.spy.all |
op |
Receive every private message without exception |
hchat.clear |
op |
Allows /clear |
hchat.reload |
op |
Allows /hchat reload |
hchat.help |
true |
Allows /hchat help |
hchat.lang |
true |
Allows /hchat lang <lang> |
hchat.channel |
true |
Allows /channel and channel switching |
hchat.slowmode |
op |
Allows /slowmode |
hchat.slowmode.bypass |
op |
Bypass the global chat slowmode |
hchat.chatlock |
op |
Allows /chatlock |
hchat.chatlock.bypass |
op |
Keep talking while the chat is locked |
hchat.sc |
op |
Allows /sc staff chat |
hchat.dnd |
true |
Allows /dnd |
hchat.bypass.dnd |
op |
Send DMs to players with DND enabled |
hchat.ping |
true |
Allows /ping |
hchat.ping.others |
op |
Allows /ping <player> |
hchat.seen |
true |
Allows /seen |
hchat.afk |
true |
Allows /afk |
hchat.mention.everyone |
op |
Allows using @everyone |
hchat.mention.here |
op |
Allows using @here |
hchat.monitor.filter |
op |
Receive warnings when the word filter trips on a player |
hchat.bypass-log |
op |
Send private messages without writing them to the chat logger |
⚙️ Configuration
config.yml is generated automatically on first start. The same file
also controls every audio / visual cue the plugin emits.
? View full config.yml
# config-version is bumped automatically when new options are added;
# your settings are always kept (old file backed up as
# config-backup-v{n}.yml).
config-version: 10
lang: en
debug: false
update-checker:
enabled: true
notify-admins: true
project: "hchat"
chat:
default-format: "&7%luckperms_prefix% {player} %luckperms_suffix%&8: &f{message}"
hex-colors: true
formats:
vip:
permission: hchat.chat.format.vip
format: "&6&lVIP &8» &e{prefix}{player}{suffix} &8: &f{message}"
mvp:
permission: hchat.chat.format.mvp
format: "&b&lMVP &8» &b{prefix}{player}{suffix} &8: &7{message}"
admin:
permission: hchat.chat.format.admin
format: "&c&lADMIN &8» &c{prefix}{player}{suffix} &8: &7{message}"
# Dynamic chat tokens: [ping] [item] [coords] [world] [afk]
placeholders:
ping:
enabled: true
symbol: "▪"
show-value: true
value-suffix: "ms"
good-max: 80
medium-max: 150
good-color: "&a"
medium-color: "&e"
bad-color: "&c"
value-color: "&7"
item:
enabled: true
coords:
enabled: true
format: "&7({x}, {y}, {z})"
world:
enabled: true
format: "&7{world}"
afk:
enabled: true
placeholder: "%essentials_afk%"
afk-values: ["yes", "true"]
format: "&c[AFK]&r "
welcome:
enabled: true
message: "&a&lWelcome &e{player} &a<o the server!"
hide-vanilla: true
motd-on-join: false
sound:
enabled: true
sound: "entity.player.levelup"
volume: 0.6
pitch: 1.0
first-join:
enabled: true
message: "&6&l★ &e{player} &6just joined for the first time!"
hide-vanilla: true
quit:
enabled: true
message: "&c{player} &7left the server."
hide-vanilla: true
mentions:
sound:
enabled: true
sound: "entity.experience_orb.pickup"
volume: 1.0
pitch: 1.0
colors:
enabled: true
color: "6A3FF"
# Bold highlight (a real background color is not possible in chat).
highlight: true
everyone-permission: hchat.mention.everyone
here-permission: hchat.mention.here
everyone-cooldown-seconds: 60
everyone-sound:
enabled: true
sound: "entity.wither.spawn"
volume: 1.0
pitch: 1.0
direct-messages:
sender:
format: "&7[&eYou &7-> &e{receiver}&7] &7{message}"
hover-text:
enabled: false
receiver:
format: "&7[&e{sender} &7-> &eYou&7] &7{message}"
hover-text:
enabled: true
clickable-actions:
enabled: true
reply-command: "/msg {sender}"
silenced-action-bar:
enabled: true
text: "&e{receiver} is muted - the message was not delivered."
spy-format: "&e{sender} &7-> &e{target}&7: &7{message}"
hover-text:
enabled: true
format:
- "6FF7F %player_name%"
- "&7"
- "&eClick to send a private message"
channels:
default-by-permission:
- permission: hchat.channel.default.vip
channel: vip
hint-on-switch: true
hint-on-join: true
global:
range: -1
local:
format: "&8[Local] &7{player} &8» &f{message}"
range: 80
action-bar-hint: "&eThere are people talking near you"
alias: "#l"
staff:
format: "&c[Staff] {player} &8» &f{message}"
speak-permission: hchat.channel.staff
see-permission: hchat.channel.staff.see
alias: "#staff"
vip:
format: "&e[VIP] {player} &8» &f{message}"
speak-permission: hchat.chat.format.vip
alias: "#vip"
trade:
format: "&6[Trade] {player} &8» &f{message}"
cooldown-ms: 5000
alias: "#trade"
world:
format: "&7[{world}] {player} &8» &f{message}"
range: -1
per-world: true
alias: "#world"
broadcast:
enabled: true
cooldown-ms: 0
format:
- ""
- "૧F5Broadcast:"
- "{message}"
example1:
enabled: true
message: "&#F52727This broadcast sent every 10 minutes. Edit in /hChat/config.yml"
interval: 600
display-in-console: true
offline-messages:
max-pending: 10
sound:
enabled: true
sound: "entity.experience_orb.pickup"
volume: 1.0
pitch: 1.0
logging:
private-messages:
enabled: true
path: logs
retention-days: 30
word-filter:
enabled: true
words: ["blacklist1", "blacklist2"]
action: "block" # block | mask | warn
# Advanced filters (config v6): anti-caps, anti-unicode, anti-ad,
# anti-spam - see the "Filters" section below.
filters:
anti-caps:
enabled: true
max-uppercase-percent: 70
min-length: 8
action: "mask"
anti-unicode:
enabled: true
block-invisible: true
action: "block"
anti-ad:
enabled: true
patterns:
- "(?<![a-zA-Z0-9])([a-z0-9-]+\\.)+(com|net|org|gg|io)"
- "(discord\\.gg/|discordapp\\.com/invite/)"
sensitivity: medium
whitelist:
- "tu-servidor.com"
- "discord.gg/tuinvite"
action: "warn"
anti-spam:
enabled: true
global-cooldown-ms: 1500
flood:
max-messages: 5
window-seconds: 3
similarity-threshold: 0.8
action: "block"
replay:
capacity: 50
afk:
enabled: true
auto-timeout-seconds: 300
check-interval-seconds: 30
unset-on-activity: true
notify-unset: true
slowmode:
enabled: true
seconds: 3
bypass-permission: hchat.slowmode.bypass
chat-lock:
enabled: true
bypass-permission: hchat.chatlock.bypass
staff-chat:
format: "&c[Staff] {player} &8» &f{message}"
log-to-console: true
death-message:
enabled: true
format: "&c☠ &7{player} &fdied by {cause}"
custom:
FALL: "&c{player} learned to fly."
LAVA: "&c{player} made friends with the magma."
? Available placeholders
| Placeholder |
Replaced with |
{sender} |
Sender's display name |
{receiver} |
Recipient's display name |
{target} |
Target name (spy view) |
{message} |
The actual message body |
{player} |
Player name (mentions, offline messages, etc.) |
%player_name% |
Resolved by PlaceholderAPI for any hook registered on it |
The renderer resolves every entry in two passes: first placeholders are
substituted, then MessageFormatter parses the format. How formats are
parsed is controlled by chat.format-mode:
| Mode |
Behavior |
legacy |
Classic & codes + &#RRGGBB hex (default, backwards compatible) |
minimessage |
MiniMessage tags (<red>, <gradient:red:blue>, <#RRGGBB>, hover/click) — classic & codes and &#RRGGBB hex are still translated |
auto |
Legacy when the format contains & codes, MiniMessage otherwise |
Every channel can override the global mode with its own format-mode
key, so a global channel in legacy and a staff channel in
MiniMessage can coexist. Player-typed text is always escaped under
MiniMessage modes: players can use & colors but cannot inject tags,
click or hover events.
? Dynamic chat tokens
hChat renders the following NoNChat-style tokens itself, inside every chat
format (default format, chat.formats.* and channel formats):
| Token |
Replaced with |
[ping] |
Colored latency indicator (green ≤ good-max, yellow ≤ medium-max, red above) with optional ms value |
[item] |
Main-hand item; hover shows a tooltip with name, enchantments, durability bar and lore |
[coords] |
Player position as x, y, z |
[world] |
Current world name |
[afk] |
[AFK] prefix when the player is away (built-in /afk + inactivity detection, PAPI fallback) |
Example format: "[ping] [afk]&7{player}&8: &f{message}". Each token
can be enabled/disabled and tuned under the placeholders: section of
config.yml (ping colors/thresholds, coords/world formats, the AFK
placeholder and its afk-values). Tokens are resolved at the Component
level after PAPI, so a literal [ping] typed by a player is never
turned into an indicator.
? Chat Channels
Channels give every conversation its own format, visibility range,
permissions and cooldown. Ship config includes global, local
(distance-based), staff, vip, trade and world (per-world).
| Feature |
Where |
| Channel format, range, cooldown, aliases |
channels.<id>.* |
| Per-channel MiniMessage override |
channels.<id>.format-mode |
| Speak / see permissions |
speak-permission, see-permission |
| Distance-based local chat + action-bar hint |
range, action-bar-hint |
| Per-world channel (never crosses worlds) |
per-world: true + {world} |
| Auto-join by permission on entry |
default-by-permission |
| Action-bar hint on switch / join |
hint-on-switch, hint-on-join |
channels:
local:
format: "&8[Local] &7{player} &8» &f{message}"
range: 80
action-bar-hint: "&eThere are people talking near you"
alias: "#l"
staff:
format: "&c[Staff] {player} &8» &f{message}"
speak-permission: hchat.channel.staff
see-permission: hchat.channel.staff.see
alias: "#staff"
In game: /channel lists channels (click to switch), /channel <name>
switches your active channel (remembered between sessions) and
#staff hello sends to a channel from anywhere. The default channel
(global) uses chat.default-format / the permission-based
chat.formats (vip/mvp/admin).
? Localization
Language files live in plugins/hChat/lang/. The plugin ships
lang_en.yml and supports any number of additional files.
# lang_es.yml
no-permission: "&cYou do not have permission!"
player-only: "&cOnly players can use this command!"
player-offline: "&cPlayer is offline!"
mentioned: "&#ffffffYou were mentioned in chat by TFFB8{player}!"
Switch the server-wide language from config.yml:
lang: es
Each player can also override their own language with
/hchat lang <lang> (stored in plugins/hChat/storage/player-lang.yml).
At runtime, messages are looked up in the per-player file first and
fall back to the server-wide lang setting from config.yml when the
key is missing or the player has not chosen a language.
? Placeholders
When PlaceholderAPI
is installed, hChat registers the placeholders listed below.
| Placeholder |
Description |
%hchat_spy_enabled% |
Spy Mode: Enabled / Spy Mode: Disabled |
%hchat_ignored% |
You are ignoring players / You are not ignoring anyone |
%hchat_ignored_<name>% |
Per-player ignore check (true / false, case-insensitive) |
%hchat_ignored_count% |
Number of players this player is currently ignoring |
%hchat_dnd_enabled% |
DND: Enabled / DND: Disabled |
%hchat_last_sender% |
Name of the player who most recently sent you a private message |
%hchat_last_message_part% |
First 30 characters (with ellipsis) of the last private message you received |
%hchat_last_seen% |
Received N minutes ago / No recent messages |
Any placeholder that resolves against a player who is currently offline
returns the safe (no-player) phrasing defined in lang_en.yml.
?️ Filters
Every chat message runs through a filter chain in this order:
word-filter → anti-unicode → anti-caps → anti-ad → anti-spam.
Each filter supports the same actions:
| Action |
Behavior |
block |
Drops the message and notifies the sender with message-filtered. |
mask |
Replaces the offending part with *, then forwards the message. |
warn |
Lets the message through and pings every player with hchat.monitor.filter. |
lowercase |
Transforms the message to lowercase (anti-caps). |
Word filter
word-filter:
enabled: true
words:
- "blacklist1"
- "blacklist2"
action: "block" # block | mask | warn
Anti-caps
Blocks / masks / lowercases messages that are mostly uppercase
(max-uppercase-percent, min-length).
Anti-unicode
Blocks invisible characters used to bypass filters: zero-width spaces,
direction overrides, BOM, tag characters (U+E0000+) and soft hyphens.
Anti-advertisement
Matches URLs and Discord invites with configurable regex patterns plus a
whitelist (substring match) that always passes.
filters:
anti-ad:
enabled: true
patterns:
- "(?<![a-zA-Z0-9])([a-z0-9-]+\\.)+(com|net|org|gg|io)"
- "(discord\\.gg/|discordapp\\.com/invite/)"
whitelist:
- "tu-servidor.com"
action: "warn"
ℹ️ The default TLD list omits me on purpose — help.me would
false-positive on normal prose.
Anti-spam
A global per-player cooldown (global-cooldown-ms) plus flood detection:
more than max-messages within window-seconds, or a near-identical
repeat (similarity-threshold), are blocked.
filters:
anti-spam:
enabled: true
global-cooldown-ms: 1500
flood:
max-messages: 5
window-seconds: 3
similarity-threshold: 0.8
action: "block"
? Broadcasts
/broadcast <message> (alias /bc) shows a configurable multi-line
broadcast to every player on the server. The format is set under
broadcast.format in config.yml and supports placeholders plus hex
colors. Players with hchat.broadcast.color can use color codes inside
the broadcast body.
For scheduled announcements, drop additional entries under
broadcast.<id> with enabled, message, interval (in seconds) and
display-in-console:
broadcast:
example1:
enabled: true
message: "&#F52727This is a recurring broadcast every 10 minutes"
interval: 600
display-in-console: true
The scheduler is implemented in AutoBroadcastManager.
ℹ️ Discord bridge: when DiscordSRV is installed at startup,
hChat logs a confirmation and reserves the integration for the
upcoming chat bridge (see ROADMAP.md). No
broadcast or /msg is currently relayed to Discord.
? Mail (Offline Messages)
If a player runs /msg Steve hola while Steve is offline, the message
is stored with the sender name and timestamp in OfflineMessageStore
(capped at offline-messages.max-pending per recipient). When Steve logs
in he sees a clickable summary — &eYou have 3 pending messages. Click to read. — instead of automatic delivery:
| Command |
What it does |
/hchat mail read |
Lists every pending message (click to reply) |
/hchat mail clear |
Purges your own pending messages |
/hchat mail send <p> <msg> |
Shortcut for /msg |
Messages are only removed when read or cleared, and a sound plays on
join if offline-messages.sound.enabled: true. If the target has never
joined the server (hasPlayedBefore() == false), /msg falls back to
the standard player-not-found message.
? AFK
hChat has a built-in AFK system — no Essentials needed:
/afk toggles it; /afk <message> goes AFK with a reason.
- After
afk.auto-timeout-seconds (default 300) of inactivity, players
are marked AFK automatically.
- Any real activity (movement, chat, commands, interactions) removes the
state (
afk.unset-on-activity); returning players are announced in
chat (afk.notify-unset).
- The
[afk] chat token uses this state (with a PAPI fallback when the
built-in feature is disabled).
? Developer API
HChatProvider is the public entry point for other plugins. Get the
singleton, then use its accessors:
import dev.hauch.hchat.api.HChatProvider;
import dev.hauch.hchat.model.ChatChannel;
public class MyListener implements Listener {
public void demo() {
HChatProvider api = HChatProvider.get();
// who is spying right now
for (java.util.UUID uuid : api.spyManager().getSpies()) {
// ...
}
// last private message received by a player
api.messageHistory().getLastMessage(player.getUniqueId());
// the player's active channel
ChatChannel channel = api.channelManager().activeChannel(player);
// broadcast through an existing channel (staff, vip, ...),
// honoring its see-permission
api.publishToChannel(api.channelManager().get("staff"),
"Server restarting in 5 minutes!");
// DND state
api.dndManager().isDnd(player);
}
}
ℹ️ HChatProvider.get() throws IllegalStateException before the plugin
is fully initialized (first ticks). Access it from ServerLoadEvent or
later. Other plugins depending on hChat should declare it as a
softdepend (or depend) in their plugin.yml.
? Proxy note (Velocity / BungeeCord)
hChat runs inside the backend servers, not on the proxy:
Player#getUniqueId and %player_name% keep working behind Velocity and
BungeeCord — Paper forwards the real UUID and name to the backend.
- Private messages, offline messages, ignore and DND state are per
backend server. A player connected to server A cannot
/msg a player
on server B; for cross-server chat use a proxy-side solution or the
DiscordSRV bridge.
{world} and [coords] placeholders resolve on the backend the player
is currently on.
- The update checker, faststats.dev metrics and the auto-broadcast scheduler run once per
backend instance — disable auto-broadcast on all but one server if you
run a network and do not want duplicated announcements.
? Dependencies
✅ Required
| Plugin |
Version |
Purpose |
| Paper |
1.20+ |
Server API (Adventure, AsyncChatEvent) |
| PlaceholderAPI |
2.11+ |
Placeholders, Vault/LuckPerms bridge |
? Optional (softdepend)
| Plugin |
Purpose |
| LuckPerms |
Permission management (recommended; no longer required) |
| Vault |
Economy + chat formatting hook |
| DiscordSRV |
Detected at startup; full cross-chat bridge planned for a future release |
If DiscordSRV is present at startup, hChat logs a confirmation so
admins know the hook is registered. Forwarding of /msg and
/broadcast to Discord is not implemented yet — see ROADMAP.md
for the planned bridge.
? Metrics (faststats.dev)
hChat bundles faststats.dev for anonymous plugin
statistics — no extra download needed and nothing to configure: metrics
are always on. No player or chat data is ever collected, only anonymous
plugin usage counters.
?️ Building from Source
Requirements: JDK 21 and Maven 3.5+.
# Clone the repository
git clone https://github.com/hauchdev/hChat.git
cd hChat
# Compile & package
mvn clean package
# The shaded JAR is at: plugin-dist/target/hChat-<version>.jar
ℹ️ Releases — the plugin version lives in one place: the
<revision> property at the top of the root pom.xml. Change it there
(or pass -Drevision=1.3.0 to Maven) and every module, the filtered
plugin.yml version and the final jar name follow automatically. You
never have to touch the other 13 POM files.
CI is wired through .github/workflows/build.yml: every push to dev
runs mvn clean verify. Tagged v* builds additionally publish a
GitHub Release with the packaged JAR.
? Contributing
Pull requests and ideas are very welcome.
Please follow Conventional Commits (Spanish or English both fine),
update lang_en.yml / plugin.yml / README.md whenever you add a
command, permission, or feature, and make sure mvn clean verify
stays green. See ROADMAP.md for the larger picture and
upcoming phases.
? License
Released under the MIT License.
Made with ❤️ by Hauchdev
评论 0
登录后参与评分
还没有评论,来抢沙发吧