通用配置（general 段）

基本信息

属性 值
配置段名 general
配置文件 config/Betterloadingscreen/betterloadingscreen.cfg
写入时机 ProgressDisplayer.start(File) 首次启动时创建

配置项

useMinecraft

  • 类型：Boolean
  • 默认：true
  • 作用：选择 IDisplayer 实现。
    • true（默认）→ MinecraftDisplayerWrapper（使用 Minecraft 的 OpenGL 上下文）。
    • false → FrameDisplayer（Swing 窗口）或 LoggingDisplayer（headless 时）。
  • 注意：注释明确"设为 false 后界面可能变黑"。
  • 客户端限制：仅当 ProgressDisplayer.isClient() 返回 true 时才读取；服务端跳过。

playSound

  • 类型：Boolean
  • 默认：true
  • 作用：加载完成后是否播放提示音（默认 betterloadingscreen:rhapsodia_orb，对应 rhapsodia_orb.ogg）。
  • 行为：由 MinecraftDisplayerWrapper.close() 启动一个 2 秒延时的守护线程，调用 MinecraftDisplayer.playFinishedSound()。

sound

  • 类型：String
  • 默认：betterloadingscreen:rhapsodia_orb
  • 作用：覆盖提示音资源路径。若填写的路径找不到有效 SoundEventAccessorComposite，自动回退到默认；默认也找不到时记录 warn 并静默。

font

  • 类型：String
  • 默认：textures/font/ascii.png
  • 作用：覆盖字体纹理。注释提示：俄语 mod “Client Fixer” 用户应改为 textures/font/ascii_fat.png；资源包中的字体也会被自动加载。

threadedRendering

  • 类型：Boolean
  • 默认：true
  • 作用：是否在独立线程中渲染启动画面（共享 OpenGL 上下文，FML SplashProgress 的做法）。
    • true → 独立线程 + SharedDrawable；动画连续更新。
    • false → 在主线程渲染；动画只在进度变化时更新。Android 等不支持共享上下文的平台需关闭。
  • 节流：关闭时由 MIN_MAIN_THREAD_FRAME_INTERVAL_NS = 50_000_000L（50ms）做帧率限制；阶段切换 + sub-progress 完成时强制立即渲染。

数值

数值 默认值 范围 说明
useMinecraft true – 决定 displayer
playSound true – 完成提示音
sound betterloadingscreen:rhapsodia_orb – 提示音资源
font textures/font/ascii.png – 字体纹理
threadedRendering true – 是否线程渲染

相关条目