Skip to content

1.2.4.1

Pre-release
Pre-release

Choose a tag to compare

@root-S7 root-S7 released this 19 Jul 16:41
· 222 commits to main since this release
d2a2c03

📌 功能介绍

新增规则系统,可对启动器的设置项进行校验和限制,确保某些版本在启动前满足必要配置。

✅ 支持功能:

  • 定义启动器设置的 强制规则(目前支持对最低内存、指定渲染器、Java)
  • 若用户误操作,启动前将 自动修复或提示 不符合规则的配置
  • 按版本粒度 精细控制启动规则
  • 所有规则均通过 JSON 文件 launcher_rules.json 定义,它位于 APK 的 assets/app_config/ 目录内

说明: 当前仅支持内存设置、渲染器指定、Java等设置项。且 Java 规则暂未启用,预计将在自定义 Java 打包功能完成后上线。

🧩 示例结构(launcherRules)

以下为 launcher_rules.jsonlauncherRules 字段的结构示例:

{
  "1.17": {
    "memory": {
      "minMemory": 3072,
      "tip": "内存最低要求为“${minMemory}MB”\n由于你的设备总运行内存只有“${totalMemory}GB”,不满足最低配置要求!"
    },
    "renderer": {
      "useRenderer": [
        {
          "packageName": "com.fcl.plugin.mobileglues",
          "name": "MobileGlues"
        }
      ],
      "downloadURL": "https://icraft.ren:90",
      "tip": "当前所使用的渲染器为『${setRenderer}』,要求的渲染器必须为『${requiredRenderer}』\n\n检测到您未安装该渲染器,请点击右下角按钮安装额外渲染器,否则游戏将不能启动!!!"
    },
    "java": {
      "useJava": ["jre8"],
      "downloadURL": "https://icraft.ren:90",
      "tip": "当前所使用的 Java 为“${useJava}”,要求必须是使用如下 Java 才可以启动游戏:\n${requiredJava}"
    }
  }
}

📌 支持的占位符列表

占位符 含义
${minMemory} 当前规则中要求的最小内存(单位 MB)
${totalMemory} 用户设备的总运行内存(单位 GB)
${setRenderer} 当前用户设置的渲染器显示名称
${requiredRenderer} 规则中要求使用的渲染器名称或别名
${useJava} 当前用户配置的 Java 名称
${requiredJava} 规则中要求使用的 Java 名称(数组转字符串)