sServerMessages

插件

· 作者 ScypterV

控制服务器的加入、退出、踢出、死亡和进度提示消息。保留原版样式、隐藏,或用自定义带颜色的文本和占位符替换它们。轻量级,无依赖项,一个 JAR 文件适用于 Spigot、Paper、Purpur 和 Folia 的 1.8.8–26.x 版本。

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

最新 1.0.1 · 26.3 · Bukkit / Folia

一键开服(送7天)

sServerMessages

一款轻量级的 Bukkit/Spigot/Paper/Purpur/Folia 插件,用于控制服务器的广播消息: 加入、退出、踢出、死亡和进度达成。在 config.yml 中为每种消息选择一种模式: 保持原版、隐藏它,或将其替换为你自己的文本。服务器上的所有玩家都会看到 替换后的文本。无依赖项,无 GUI,无针对单个玩家或分组设置。

一个 jar 包涵盖从 1.8.8 到 26.x 的所有服务器版本。

功能

  • 每条消息有三种模式:vanilla(原版)、hide(隐藏)、replace(替换)。空的 message 也会隐藏。
  • 针对不同死因(坠落、火焰、生物、玩家等)分别设置死亡文本,并有一个通用回退文本。
  • 占位符:{player} 适用于所有情况,{killer}/{cause} 用于死亡,{reason} 用于踢出, {advancement} 用于进度达成。
  • 支持所有地方的 & 颜色代码,以及在 1.16+ 版本中支持 &#RRGGBB 十六进制颜色。
  • 使用 /sservermessages reload 实现热重载。

安装

  1. 将 sServerMessages-1.0.0.jar 放入服务器的 plugins 文件夹。
  2. 启动一次服务器以生成 plugins/sServerMessages/config.yml。
  3. 编辑配置文件并运行 /sservermessages reload。

配置

join:
  mode: replace            # vanilla | hide | replace
  message: "&e{player} &7加入了服务器"

quit:
  mode: replace
  message: "&e{player} &7离开了服务器"

kick:
  mode: replace
  message: "&e{player} &7被踢出服务器: &c{reason}"

death:
  mode: replace
  message: "&c{player} &7死了"
  causes:
    player: "&c{player} &7被玩家 &c{killer} 击杀"
    mob: "&c{player} &7被生物 &c{killer} 击杀"
    fall: "&c{player} &7摔死了"
  names:
    fall: "坠落"

advancement:
  mode: replace
  message: "&e{player} &7获得了成就 &a{advancement}"

占位符

消息类型 占位符
join, quit {player}
kick {player}, {reason}
death {player}, {killer}, {cause}
advancement {player}, {advancement}

死亡

死因取自 getLastDamageCause(),该接口在所有支持的版本中都存在。文本选择顺序如下:

  1. 如果击杀者是玩家,则使用 player;如果是其他实体(例如投射物的射手),则使用 mob。
  2. 小写的伤害原因名称,如 fall、fire_tick、lava、drowning、void、 explosion、entity_attack。
  3. 通用的 message。

如果在旧版本中不存在某些死因名称,则永远不会匹配它们。对于某个死因,空字符串会隐藏该死因的消息。{cause} 是 names 中的可读名称,否则回退到美化后的死因名称。当没有击杀者时,{killer} 为空。

踢出

kick 是其他玩家在有人被踢出时看到的消息。被踢玩家在断开连接屏幕上看到的原因不会改变。在大多数版本中,踢出操作后会跟随一个退出事件;插件确保踢出消息优先,因此不会重复播报玩家离开。

进度达成

平台 替换/隐藏
Paper, Purpur, Folia (1.16+) 是
Spigot,以及在使用消息 API 之前的 Paper(如 1.12.2) 否,保留原版消息
早于 1.12 的服务器 无此事件

这是通过实际测试验证的,而非凭记忆。Spigot API(26.1.2 及 1.12 时代)拥有 PlayerAdvancementDoneEvent,仅包含 getAdvancement(),无法更改或取消公告。 Paper 添加了 message(Component)(已在 1.16.5、26.1.2 和 Folia 26.1.2 上确认;在 Paper 1.12.2 上缺失)。

插件通过反射调用 Paper 方法,并从带颜色的旧式文本构建 Adventure 组件,因此它仍可与 spigot-api 1.8.8 编译。在不具备该方法的核心上,插件会在启动时记录一条警告,并保留原版消息。插件故意不切换 announceAdvancements 游戏规则,因为插件不应更改服务器状态。

{advancement} 是 API 暴露的进度标题(在 26.x 中),否则是一个美化的键名,例如 "Mine stone"(开采石头)。配方类进度永远不会被公告,因此被忽略。

命令

命令 描述
/sservermessages reload 重新加载 config.yml。别名:/ssm。

权限:sservermessages.reload(默认:op)。插件使用普通的 Bukkit 权限,因此 LuckPerms 和其他权限插件无需任何集成即可配合使用。控制台始终可以执行重载。

如果 config.yml 损坏,之前的设置将继续生效,错误信息将打印到控制台。

兼容性

Spigot, Paper, Purpur 和 Folia (folia-supported: true)。插件不使用调度器,且设置字段为 volatile,因此在 Folia 的区域线程上读取这些字段是安全的。

构建

./gradlew build

需要 JDK 21 进行构建,因为 JDK 25 已不再支持 targeting Java 8。verifyModernApi 任务还会针对 paper-api 26.3 重新编译源代码,并且需要安装 JDK 25 作为其工具链;它作为 check 的一部分运行。bStats 已被着色并重定位至 com.scypter.sservermessages.libs.bstats。

许可证

请参阅 LICENSE。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源