GRID Legends 画质工具

这是一个用于制作、导出和直接修改 GRID Legends 安卓版画质配置的 Android 工具，使用 Kotlin 和 Jetpack Compose 开发。

应用提供两条独立路线：无需游戏目录授权即可基于内置真实配置制作并导出 preferences，或通过 Root、Shizuku、SAF 直接读取和修改游戏配置。

功能

• 读取和写入 GRID Legends 的 preferences 配置文件。
• 支持游戏真实使用的 registry 风格 XML 结构。
• 能区分同名配置项所在的路径，避免误改 GraphicsSettings、Graphics、Performance、Setup 中的同名字段。
• 支持手动调整帧率、分辨率、画质、反射、后处理、HDR、SSR、体积光等项目。
• 新增环境光遮蔽、光照质量、后视镜、粒子效果、轮胎痕迹、天气效果、渲染倍率、垂直同步和减少雨水共 9 项调整。
• Android 平台不会主动修改 MetalFX，避免写入不适用于该平台的图形选项。
• 内置低配、中配、高配、极限四组共 20 份真实配置，可用于制作和导出画质文件。
• 无需游戏目录授权，即可从内置预设制作并导出完整、无扩展名的 preferences 文件，并保留预设文件中的其他设置。
• 支持 Root、Shizuku 和 SAF 三种访问方式，直接编辑游戏目录中的配置文件。
• Android 11-15 默认使用 SAF 目录授权访问；如果系统文件选择器拦截 Android/data，可切换到 Shizuku 或 Root。
• Android 16 及以上默认使用 Shizuku 访问游戏目录。

目标游戏

• 包名：com.feralinteractive.gridlegends_android
• 配置文件路径：

/sdcard/Android/data/com.feralinteractive.gridlegends_android/files/feral_app_support/preferences

使用说明

无需授权：制作并导出配置

1. 在首页选择“从预设制作画质文件”。

2. 从低配、中配、高配、极限四组共 20 份真实配置中选择一个预设。

3. 修改需要的参数，或不修改直接导出。

4. 将导出的无扩展名 preferences 手动复制到：

   /sdcard/Android/data/com.feralinteractive.gridlegends_android/files/feral_app_support/preferences
   

手动替换前请关闭游戏并备份原文件。 导出的是完整 preferences，会保留所选预设文件中的其他设置；应用不会清洗或移除 donor 配置中的其他字段。

需要授权：直接编辑游戏配置

1. 安装并启动 GRID Legends 至少一次，让游戏生成配置文件。
2. 打开本工具并完成目录授权、Shizuku 授权或 Root 授权。
3. 进入画质编辑页。
4. 手动调整参数，或选择一个画质预设并点击“应用预设”。
5. 点击保存后重启游戏，让配置生效。此流程会直接编辑游戏目录中的 preferences。

访问方式

• Root：已有 Magisk、KernelSU、APatch 等 Root 环境时，可在首页选择 Root 权限访问。
• Android 11-15：默认使用系统文件选择器授权游戏目录；如果出现“无法使用此文件夹”，请在首页改用 Shizuku 或 Root。
• Android 16 及以上：默认使用 Shizuku 授权访问游戏目录。

如果部分 ROM 限制了 Android/data 目录选择，SAF 授权可能失败，这种情况下可以考虑使用 Shizuku 或 Root。

构建

这是一个单模块 Android 项目，只使用 Gradle 构建。

./gradlew assembleDebug
./gradlew assembleRelease

Release 构建配置位于 app/build.gradle.kts。

注意事项

• 极限和 HDR 预设负载很高，低端设备可能无法稳定进入游戏。
• 直接编辑流程保存前会自动创建备份文件。
• 手动替换导出的 preferences 前，请关闭游戏并备份原文件。
• 应用会尽量保留未管理的 XML 字段，只替换当前工具管理的画质项。
• 本工具是非官方开源项目，与 Codemasters、EA、Feral Interactive 无从属或授权关系。
• GRID Legends、Codemasters、EA、Feral Interactive 等名称和商标归其各自权利方所有。