RiotChat

插件

· 作者 lb-acey

一款基础的通用聊天和 Tab 列表插件,支持 Luckperms 和 PlaceholderAPI

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

需要前置:LuckPerms

最新 beta-1.2 · 1.21.11 · Paper

一键开服(送7天)

RiotChat

RiotChat 是一款轻量级、专注于管理功能的 Spigot/Paper 聊天插件。它提供格式化聊天、提及高亮、持久化忽略系统、清除/公告工具、标签页头尾以及基于数据库的持久化静音系统和命令补全功能。

本自述文件记录了功能、安装(二进制/JAR)、配置、数据库、命令、权限以及如何报告问题。


功能

  • 支持前缀/后缀的格式化聊天(LuckPerms 集成)
  • 提及高亮与处理
  • 私聊(/msg、/reply)
  • 持久化忽略系统(基于数据库)
  • 可选项带公告和声音的聊天清除功能
  • 使用 MiniMessage 模板进行全服公告
  • 标签页头/尾部支持
  • 基于数据库存储的持久化静音系统:
    • /mute <player> [duration] [reason]
    • /unmute <player>
    • 静音记录存储在 riotchat_mutes 表中
    • /mute 命令的玩家名称和持续时间自动补全
  • 由配置文件驱动行为,支持 H2/MySQL

安装(JAR / 发布仓库)

此仓库旨在托管插件发布版本(JAR 文件),不一定包含源代码。要在你的服务器上安装该插件:

  1. 从此仓库的 Releases 页面或 Modrinth、SpigotMC、Hangar 下载发布的 JAR 文件。
  2. 将 JAR 文件复制到 Paper/Spigot 服务器的 plugins/ 目录中。
  3. 启动或重启服务器。插件将在首次运行时生成默认配置文件。

如果仓库中没有编译好的 JAR 文件,请查看 Releases 标签页或项目网站以获取二进制下载链接。


配置

主配置文件(首次运行时生成):插件文件夹中的 config.yml。重要配置键(示例):

  • enable-chat (boolean) — 聊天功能的总开关。
  • chat.separator (string) — 玩家名称与消息之间的分隔符。
  • chat.name-hover / chat.name-click (boolean) — 启用玩家名称上的悬停/点击行为。
  • clearchat.lines (int) — /clearchat 发送的空行数。
  • announce.format (MiniMessage 块) — 用于广播公告的模板。
  • database.type — H2 或 MYSQL。
  • database.h2.file — H2 文件路径(不含 .mv.db 后缀)。
  • database.mysql.* — MySQL 连接设置。

示例片段:

database:
  type: "H2"
  h2:
    file: "plugins/RiotChat/riotchat"

clearchat:
  lines: 120
  message: |
    <dark_gray>━━━━━━━━━━━━━━━━━━━━━━━━</dark_gray>
    <gradient:#00ffff:#00bcd4><bold>CHAT CLEARED</bold></gradient>
    <gray>The chat has been cleared by <b><cyan>%player_name%</cyan></b></gray>
    <dark_gray>━━━━━━━━━━━━━━━━━━━━━━━━</dark_gray>

命令

  • /msg <player> <message> — 发送私聊消息。
  • /reply <message> — 回复上一条私聊消息。
  • /announce <message> — 广播公告(权限:riotchat.announce)。
  • /clearchat [silent] — 清除聊天;silent 参数可抑制广播(权限:riotchat.clearchat)。
  • /togglechat — 切换全局聊天状态(权限:riotchat.chat.toggle)。
  • /ignore <player> — 切换对某玩家的忽略状态(权限:riotchat.ignore)。
  • /ignorelist — 显示你当前忽略的玩家列表。
  • /mute <player> [duration] [reason] — 静音某玩家(权限:riotchat.mute)。
    • 持续时间示例:10s、5m、1h、1d 或 perm(永久)。
    • 插件提供了 MuteTabCompleter,可建议玩家名称和常用持续时间。
  • /unmute <player> — 解除某玩家的静音状态(权限:riotchat.unmute)。

权限

建议的默认权限节点(请在你的权限系统中进行调整):

  • riotchat.color — 在聊天中使用颜色代码(默认:op)
  • riotchat.reload — 重新加载配置(默认:op)
  • riotchat.announce — 使用 /announce 命令(默认:op)
  • riotchat.ignore — 使用忽略相关命令(默认:op)
  • riotchat.clearchat — 清除聊天(默认:op)
  • riotchat.clearchat.bypass — 绕过清除聊天的效果(默认:false)
  • riotchat.chat.bypass — 绕过全局聊天禁用状态(默认:op)
  • riotchat.chat.toggle — 开启/关闭聊天(默认:op)
  • riotchat.mute — 静音玩家(默认:op)
  • riotchat.unmute — 解除玩家静音(默认:op)
  • riotchat.mute.bypass — 绕过静音限制(供工作人员使用)(默认:op)

故障排除

  • 数据库连接错误:请检查 config.yml 中的数据库设置及其可达性。

如果需要进一步帮助,请在仓库中提交 Issue,并附上服务器日志和配置片段。


贡献与源码

此仓库旨在托管插件发布版本(二进制 JAR 文件)。其中可能不包含插件源代码。如果你想贡献代码或请求源码,请提交 Issue 或查看项目页面以获取源码仓库链接。不接受针对已编译发布版仓库的拉取请求(Pull Request)。


许可证

本项目默认采用 MIT 许可证授权。


更新日志(简要)

  • v0.1 — 核心聊天格式化、忽略、消息传递、公告、清除聊天、标签页功能
  • v0.2 — 持久化静音系统、/mute//unmute 命令、MuteTabCompleter

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源