UnityFPSUnlocker 项目安装与使用教程

1. 项目目录结构及介绍

UnityFPSUnlocker 项目的目录结构如下：

UnityFPSUnlocker/
├── .gitignore
├── CMakeLists.txt
├── LICENSE
├── README.md
├── README_en.md
├── README_jp.md
├── TargetList.json
├── TargetList_jp.json
└── UnityFPSUnlocker/
    └── (其他项目相关文件)

目录结构介绍

• .gitignore: Git 忽略文件，用于指定哪些文件或目录不需要被 Git 跟踪。
• CMakeLists.txt: CMake 构建配置文件，用于配置项目的构建过程。
• LICENSE: 项目许可证文件，本项目使用 MIT 许可证。
• README.md: 项目的主 README 文件，包含项目的介绍、安装和使用说明。
• README_en.md: 项目的英文 README 文件。
• README_jp.md: 项目的日文 README 文件。
• TargetList.json: 目标列表配置文件，用于指定不同游戏的 FPS 设置。
• TargetList_jp.json: 日文版本的目标列表配置文件。
• UnityFPSUnlocker/: 项目的主要代码目录，包含项目的核心代码文件。

2. 项目的启动文件介绍

UnityFPSUnlocker 项目的启动文件主要是 UnityFPSUnlocker 目录下的相关文件。这些文件负责实现 FPS 解锁的核心功能。具体的启动文件可能包括：

• UnityFPSUnlocker.cpp: 项目的主要实现文件，包含 FPS 解锁的核心逻辑。
• UnityFPSUnlocker.h: 项目的头文件，包含类的定义和函数声明。

3. 项目的配置文件介绍

TargetList.json

TargetList.json 是 UnityFPSUnlocker 项目的主要配置文件，用于指定不同游戏的 FPS 设置。配置文件的结构如下：

{
  "global": {
    "delay": 10,
    "mod_opcode": true,
    "fps": 90,
    "scale": 1.0
  },
  "custom": {
    "com.random.package.name.a": {
      "fps": 60
    },
    "com.random.package.name.b": {
      "mod_opcode": false
    },
    "com.random.package.name.c": {
      "delay": 5
    }
  }
}

配置项说明

• global: 全局配置节点，包含所有游戏的默认设置。

  • delay: 游戏载入后等待的秒数，单位为秒。
  • mod_opcode: 是否修改 opcode，如果游戏会重新锁定 FPS，可以将此项设置为 true。
  • fps: 需要设置的 FPS，设置为 0 以禁用。
  • scale: 设置分辨率的倍数，一般保持 1.0 即可，必须为小数。

• custom: 自定义配置节点，覆盖全局配置，单独生效。

  • key: 包名，例如 com.random.package.name.a。
  • fps: 同上。
  • mod_opcode: 同上。
  • delay: 同上。
  • scale: 同上。

使用说明

1. 下载 TargetList.json 文件并放入 /data/local/tmp/TargetList.json。
2. 根据需要修改配置文件中的参数。
3. 模块会通过判断游戏数据目录是否存在 /sdcard/Android/data/[包名]/files/il2cpp 来自动加载配置。

通过以上步骤，您可以成功配置和使用 UnityFPSUnlocker 项目，实现手机上 Unity 游戏的 FPS 解锁。