布局配置（layout 段）

基本信息

属性 值
配置段名 layout
配置文件 config/Betterloadingscreen/betterloadingscreen.cfg
写入位置 MinecraftDisplayer.open(Configuration) 中调用 cfg.getBoolean/getString/getFloat

配置项

资源路径字段

字段 类型 默认 说明
background String betterloadingscreen:textures/backgrounds/01.png 主背景纹理
title String betterloadingscreen:textures/transparent.png logo/title 资源（注释提醒 BLS 提供 transparent.png 作为占位）
mainProgressBar String betterloadingscreen:textures/mainProgressBar.png 主进度条
mainProgressBarAnimated String betterloadingscreen:textures/mainProgressBar.png 动态主进度条（同纹理不同采样区域）

注：useImgur=true 时启动时 background 会被第一张被覆盖的图取代（来自 ImgurCacheManager.setupImgurGallery 回调）。

坐标字段（每行都是 [srcX, srcY, srcW, srcH, dstX, dstY, dstW, dstH]）

字段 默认 备注
titlePos [0, 0, 256, 256, 0, 50, 187, 145] logo 区域
mainProgressBarPos [0, 0, 194, 24, 0, -50, 194, 16] 主进度条静态
mainProgressBarPosAnimated [0, 24, 194, 24, 0, -50, 194, 16] 主进度条动态
memoryBarPos [0, 0, 194, 24, 0, 48, 194, 16] 内存条静态
memoryBarPosAnimated [0, 24, 194, 24, 0, 48, 194, 16] 内存条动态
mainProgressBarTextPos [0, -30] 主进度条文本（仅 [x, y]）
mainProgressBarPercentagePos [0, -40] 主进度条百分比
secondaryProgressBarPos [0, 0, 194, 24, 0, -83, 188, 12] 副进度条静态
secondaryProgressBarPosAnimated [0, 24, 194, 24, 0, -83, 188, 12] 副进度条动态
secondaryProgressBarTextPos [0, -65] 副进度条文本
secondaryProgressBarPercentagePos [0, -75] 副进度条百分比

解析时使用 stringToIntArray / intArrayToString，所以配置值写成 [0, -50, 194, 16] 即可。

颜色 / 透明度

字段 类型 默认 范围 说明
loadingBarsColor String fdf900 hex 动态加载条颜色（ffffff 即纯白无着色）
loadingBarsAlpha float 0.5 [0, 1] 动态加载条透明度
textShadow Boolean true – 文本是否带阴影
textColor String ffffff hex 文本颜色，校验后归一为 6 位

背景相关（部分字段位于 changing background 段，但功能耦合在 layout）

字段 类型 默认 说明
backgroundList String {betterloadingscreen:textures/backgrounds/01.png, betterloadingscreen:textures/backgrounds/02.png} 花括号包裹、逗号分隔的随机背景列表
randomBackgrounds Boolean true 是否启用随机背景

加载条 layout

  • 主进度条宽度由 progressPos[6] 决定。
  • 副进度条在主进度条上方 -83 像素；尺寸比主进度条略小。
  • 内存条在主进度条下方 +48 像素。

数值

数值 默认
loadingBarsColor fdf900（亮黄）
loadingBarsAlpha 0.5F
textShadow true
textColor ffffff
randomBackgrounds true
backgroundList 见上

相关条目