MHR 启动画面管理器

MHR 启动画面管理器

管理 MHR: Sunbreak 启动图:可随机、固定选择,也可转换自定义图片。Manages the MHR: Sunbreak startup splash: randomize, keep one selected image, or convert custom images.

视觉效果

实现原理

random_splash_pool 随机选择一个 .tex.28 文件,并复制到游戏读取启动图的位置。

安装方法

主文件已经包含 mod 本体、转换脚本和 texconv.exe。 如果你想把 PNG/JPG/WebP 图片转换成启动图,还需要 ffmpeg

你可以:

  1. 自己安装 ffmpeg,并确保系统 PATH 能找到 ffmpeg.exe
  2. 或下载可选文件:FFmpeg for Custom Image Conversion,然后把里面的 ffmpeg.exe 放进 random_splash_tools

把压缩包内容解压到 MonsterHunterRise 游戏根目录。

正确结构应类似:

MonsterHunterRise\
reframework\
  autorun\
    random_next_splash.lua
data\
  random_splash_pool\
  random_splash_custom_images\
random_splash_tools\

需要 REFramework

REFramework 菜单功能

打开 REFramework 菜单,在 Script Generated UI 里找到:

  • MHR 启动画面管理器

常用选项

  • 脚本加载时自动随机化:开启后,每次脚本加载时都会随机准备下一次启动图。
  • 刷新启动画面列表:刷新启动图列表。添加或转换自定义图片后可以点它。
  • 下次启动画面:手动选择下一次启动要使用的背景图。
  • 应用选定的设置至下次启动:把当前选中的图指定为下一次启动图。
  • 随机化下次启动:手动随机一次下一次启动图。

如果想固定一张图:

  1. 取消勾选 Auto randomize on script load
  2. 在下拉框选择想要的图。
  3. 点击 Apply Selected For Next Startup

关于 Previously Installed Splash:

如果安装本 mod 前,游戏目录里已经有手动安装的启动图文件,脚本第一次加载时会把它们复制到 imported_current,并在列表里显示为 Previously Installed Splash。这是为了保留玩家原本已经安装的启动图;如果本地没有这类文件,就不会出现这个选项。

自定义图片转换

如果只使用内置启动图,不需要管 random_splash_tools

如果想使用自己的 PNG/JPG/WebP 图片,只需要用这一个入口:

random_splash_tools\Convert_Custom_Images.bat

用法:

  1. 把一张或多张图片拖到 Convert_Custom_Images.bat 上。
  2. 按数字选择图片处理模式。
  3. 工具会把图片转换成 .tex.28,并刷新 custom 列表。
  4. 进游戏后在 REFramework UI 里点 Refresh Splash List

也可以双击 Convert_Custom_Images.bat,然后把图片路径或文件夹路径粘进去。

支持格式:

  • .png
  • .jpeg
  • .jpg
  • .bmp
  • .tif
  • .tiff
  • .webp

处理模式:

  1. Fit + blurred background / 完整保留图片 + 模糊背景:推荐。保留完整原图,用模糊背景填满 1920x1080,避免裁掉主体,也避免游戏自己拉伸。
  2. Fit + black background / 完整保留图片 + 黑色背景:保留完整原图,空白区域为黑色。
  3. Crop to fill / 裁剪填满:画面铺满 1920x1080,但边缘可能被裁掉。
  4. Stretch / 强制拉伸:不裁剪,但非 16:9 图片会变形。不推荐,除非你明确想要这个效果。

转换是增量处理:

  • 原图内容和处理模式都没变时,再次运行会跳过。
  • 原图变了,或换了处理模式,会重新转换。

已经有转换好的 TEX 文件

如果你已经有现成的 .tex.28,可以直接放进:

reframework\data\random_splash_pool\custom\

最简单的放法是直接放这两个文件:

reframework/data/random_splash_pool/custom/splash_IM.tex.28
reframework/data/random_splash_pool/custom/splash_MR_IM.tex.28

然后运行一次:

random_splash_tools\Convert_Custom_Images.bat

它不会重新转换这些 TEX,只会刷新 manifest.json,并把它们加入可选列表。

也可以建子文件夹:

reframework\data\random_splash_pool\custom\my_splash\
  splash_IM.tex.28
  splash_MR_IM.tex.28

文件名必须是 splash_IM.tex.28splash_MR_IM.tex.28。只放一个文件不算完整启动图,不会作为有效项。

卸载

删除以下文件 / 目录:

  • reframework\autorun\random_next_splash.lua
  • reframework\data\random_splash_pool\
  • reframework\data\random_splash_custom_images\
  • reframework\data\random_splash_state.txt
  • reframework\data\random_splash_config.json
  • random_splash_tools\

如果想恢复原版启动图,请用你自己的备份恢复 natives 里的启动图文件。