Genshin Impact FOV Unlocker

A plugin for Genshin Impact that unlocks the camera's field of view (FOV) to values greater than the default of 45. It includes a DLL designed to be used in conjunction with genshin-fps-unlock. If you find the plugin useful, consider starring the repository 🌟!

demo.mp4

Disclaimer

While I have personally used this plugin without any issues and have not been banned, it is important to note that third-party plugins like this one are against the terms of use of the game. You are encouraged to review the source code and build it yourself to ensure transparency and understand the potential risks.

Furthermore, while the plugin itself is lightweight, increasing the field of view causes the game to render more objects on the screen, which will noticeably impact performance. Some graphical artifacts may also occur at extreme values.

Installation

1. Download the latest release of the genshin-fps-unlock tool.
   1. Navigate to the project's latest release.
   2. Download the unlockfps_nc.exe executable from the Assets section.
   3. Place the executable in a folder of your choice.
2. Download the latest release of the genshin-fov-unlock plugin.
   1. Navigate to the project's latest release.
   2. Download the plugin.zip archive from the Assets section.
   3. Unzip the contents of the archive to a folder of your choice other than the root directory of the genshin-fps-unlock tool. The archive includes the genshin_fov_unlock.dll library and the fov_config.json configuration.
3. Configure the genshin-fps-unlock tool to work with the plugin.
   1. Open the unlockfps_nc.exe executable.
   2. Navigate to Options → Settings → DLLs → Add.
   3. Add the path to the genshin_fov_unlock.dll file.
4. (Optional, if there are issues) Modify the plugin's settings.
   1. Open the fov_config.json file in a text editor.
   2. Modify the settings as desired. Refer to the Configuration section for more information.

The plugin should now be loaded the next time the game is launched with the genshin-fps-unlock tool by running the unlockfps_nc.exe executable. For more information on how to use the tool, refer to the project's README.

Usage

By default, the left arrow and right arrow keys cycle through the preset field of view values, and the down arrow key enables or disables the plugin. Due to the integrity check at the start of the game, it is now also needed to manually hook the plugin with the up arrow key when in the initial loading screen of the game as hooking it anywhere else may cause it to crash. Refer to the video below.

hook.mp4

Configuration

The plugin's behavior and settings can optionally be customized through the fov_config.json file located in the same directory as the genshin_fov_unlock.dll library. The following settings are available for configuration:

• enabled (bool): Default state of the plugin when the game starts.
• fov (int): Default FOV to use when the game starts.
• fov_presets (array of int): List of FOV values to cycle through using keybindings.
• interpolate (bool): Whether to interpolate FOV changes from cycling through presets, character bursts, or other sources. Smoothing and threshold settings are used when interpolation is enabled.
• smoothing (float): Time constant in seconds for the exponential filter. Lower values make the FOV changes more responsive.
• threshold (float): Time in milliseconds to use as a threshold for frame counting. An incorrect value may cause the FOV to fluctuate or not change at all. Default of 3 ms should work for most systems. If you are on a high-end system and the camera keeps "popping in", consider lowering this value to 2 ms, or disabling interpolation entirely. See this issue for more information.
• hook_key (int): Key to hook the plugin into the game.
• enable_key (int): Key to enable or disable the plugin.
• next_key (int): Key to cycle to the next FOV preset.
• prev_key (int): Key to cycle to the previous FOV preset.

Note: Key codes should be in decimal format. Refer to the virtual key codes documentation for valid values.

The default configuration is as follows:

{
    "enabled": true,
    "fov": 75,
    "fov_presets": [
        30,
        45,
        60,
        75,
        90,
        110
    ],
    "interpolate": true,
    "smoothing": 0.2,
    "threshold": 3.0,
    "hook_key": 38,
    "enable_key": 40,
    "next_key": 39,
    "prev_key": 37
}

Building

If you just want to use the plugin, you should follow the instructions in the Installation section. To build the plugin from source, follow these steps:

1. Ensure you are on Windows and have git, CMake, and MSVC installed.
2. Clone the repository and navigate to the project directory:

git clone https://github.com/z3lx/genshin-fov-unlock.git
cd genshin-fov-unlock

3. Configure the project (internet connection required for dependencies):

cmake .

4. Build the project:

cmake --build . --config Release

The compiled genshin_fov_unlock.dll library will be located in the Release directory. If you encounter issues with the precompiled MinHook library, consider recompiling it from source.

Attributions

• The offsets used in this project (line 49 of unlocker.cpp) were obtained from the genshin-utility project, licensed under the GPL-3.0 License.
• The minhook library is used under the BSD-2-Clause.
• The nlohmann/json library is used under the MIT License.

License

This project is licensed under the GPL-3.0 License. See the LICENSE file for more information.