概述
Custom Splash 是一个自定义 Minecraft 标题界面黄色闪烁标语(Splash Text)的 Fabric 模组,不依赖 Fabric API。
标语通过 JSON 配置文件和代码注册生成,无需修改游戏客户端文件。模组支持 Minecraft 1.14 至 26.3 的全部正式版本,共 48 个版本,标语仅在客户端显示。
配置
首次启动时,模组在 config 目录下生成 customsplash.json。文件包含一个 splashes 数组,每个元素对应一条标语,可设置 text(文本)、weight(权重)、color(颜色)与 conditions(显示条件)四个字段。
{
"splashes": [
{ "text": "Custom Splash 已加载" },
{ "text": "你好,{player}!", "weight": 5, "color": "#FFAA00" },
{ "text": "彩虹标语", "color": "rainbow:25" },
{ "text": "周末快乐", "conditions": { "weekend": true } }
]
}weight 表示相对出现概率,默认值为 1,数值越大出现频率越高。配置文件、已启用的资源包与通过 SplashRegistry.add 注册的标语合并为同一候选池,按权重随机选取。候选池为空或所有条目均不满足条件时,标题界面恢复显示原版标语。
占位符
| 占位符 | 替换内容 |
|---|
| {player}、{username} | 当前玩家名称,无法获取时显示 player |
| {date} | 当天日期,格式 yyyy-MM-dd |
| {time} | 当前时间,格式 HH:mm |
| {mc_version}、{MC}、{version} | 当前运行的 Minecraft 版本 |
| {mods}、{mods_count} | 已加载模组数量 |
占位符在标语被选取时一次性替换,{time} 对应标题界面渲染的时刻。无法解析的占位符保留原样。
颜色
color 字段支持以下六种写法。
| 写法 | 效果 |
|---|
| #RRGGBB | 整条标语使用单一颜色 |
| #RRGGBB,#RRGGBB | 两色渐变,按字符均分 |
| #RRGGBB,#RRGGBB,… | 多于两个颜色的渐变 |
| gradient:#RRGGBB,… | 显式声明为渐变,效果同上 |
| rainbow | 彩虹循环,每个字符相差 15 度色相 |
| rainbow:45 | 彩虹循环,自定义每个字符的色相跨度 |
渐变按字符采样,首尾字符与设定的颜色完全一致。无法解析的颜色值会被忽略,标题界面恢复使用原版黄色。
Minecraft 1.20 及以后版本通过 SplashRenderer 逐字符渲染,渐变与彩虹按插值结果真实呈现。Minecraft 1.14 至 1.19 版本的标语为纯文本,无法逐字符着色,此时模组为每个字符添加最接近的原版颜色代码(§),单色则为整条文本添加一个颜色代码。
显示条件
conditions 字段中的条件需同时满足,该条标语才会进入候选池。
| 字段 | 取值与规则 |
|---|
| time | day 表示 6 时至 18 时,night 表示 18 时至次日 6 时 |
| date | MM-DD 表示单日,MM-DD。.MM-DD 表示区间,区间可跨年 |
| weekend | true 仅周六与周日显示,false 仅工作日显示 |
| player | 玩家名称列表,不区分大写字母与小写字母 |
| mods | 模组 ID 列表,列出的模组需全部加载 |
| chance | 0.0 至 1.0 的随机概率 |
资源包
资源包可通过 assets/customsplash/splashes.txt 添加标语。
文件中每一行非空内容成为一条标语,以 # 开头的行被忽略。已启用的资源包会自动重新读取,调用 SplashRegistry.reload() 可立即刷新。
开发接口
import dev.arrbrants.customsplash.SplashRegistry;
public class MyMod implements ModInitializer {
@Override
public void onInitialize() {
SplashRegistry.add("Hello! Fabric!");
SplashRegistry.add("Powered by Mixin", 3);
}
}
SplashRegistry.add(String text)以默认权重 1 注册标语,add(String text,int weight)指定权重,可在模组初始化阶段或标题界面渲染前的任意时刻调用。SplashRegistry 还提供 remove(String)、clear() 、list() 、count() 与 reload() 。pick() 返回选取的标语文本,pickEntry() 返回标语文本及其颜色。