hChat

插件

· 作者 hauchdev

适用于 Paper 的现代一体化聊天插件

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

最新 1.4.1 · 26.3 · Bukkit / Paper

一键开服(送7天)

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: "&#54A3FF"
  # 加粗高亮(聊天中无法实现真实的背景色)。
  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: - "&#54FF7F %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: - "" - "&#2791F5广播:" - "{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你在聊天中被 &#84FFB8{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)

插件 用途
LuckPerms 权限管理(推荐;不再必需)
Vault 经济系统与聊天格式挂钩
DiscordSRV 启动时检测;计划在未来版本中实现完整的跨平台聊天桥接

如果启动时检测到 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

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源