• >
  • 魔改Mod
  • >
  • ArrBrants 的自定义闪烁标语 (ArrBrants' Custom Splash Texts)
ArrBrants 的自定义闪烁标语 (ArrBrants' Custom Splash Texts)
模组属性评比

距离显示结果还剩5票~

路过的这位少侠,你觉得这款Mod怎么样,可否愿意来评一评它呢?登录并评比
更新日志
  • 暂无日志..

历史编辑记录更多
    管理组

      暂无管理组..

    编辑组

      暂无编辑组..

    最近参与编辑
    活跃
    开源

    ArrBrants 的自定义闪烁标语

    ArrBrants' Custom Splash Texts

    0.0

    无人问津

    昨日指数: 5
    昨日平均指数: 39.723

    653

    总浏览

    --

    资料填充率


    如何下载?
    • 概述

      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 字段中的条件需同时满足,该条标语才会进入候选池。

      字段取值与规则
      timeday 表示 6 时至 18 时,night 表示 18 时至次日 6 时
      dateMM-DD 表示单日,MM-DD。.MM-DD 表示区间,区间可跨年
      weekendtrue 仅周六与周日显示,false 仅工作日显示
      player玩家名称列表,不区分大写字母与小写字母
      mods模组 ID 列表,列出的模组需全部加载
      chance0.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() 返回标语文本及其颜色。

    短评加载中..