CATAHA_CCCP-BetterFPSLimit icon

BetterFPSLimit

Better FPS limiter for Alt-Tab, Main Menu/Logbook, and Pause states, plus custom 144+ Hz framerate cap support.

Last updated 5 days ago
Total downloads 223
Total rating 1 
Categories Tweaks AI Generated
Dependency string CATAHA_CCCP-BetterFPSLimit-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

bbepis-BepInExPack-5.4.2117 icon
bbepis-BepInExPack

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.2117

README

Better FPS Limiter

Dynamically limits your framerate in the Main Menu, Logbook, Pause screen, and when the game is unfocused (Alt-Tab) to prevent your GPU from running at 100% load rendering 500+ useless frames. Additionally, bypasses the vanilla 144 Hz dropdown limit, allowing you to set any custom framerate cap for high-refresh-rate monitors (240 Hz, 360 Hz, etc.).

Configuration

Supports Risk of Options (and recommended to use) for real-time in-game configuration.

  • Enable Custom Gameplay FPS: Toggle the custom FPS limit during active runs. If disabled (false), framerate is uncapped (-1 / Unlimited) during gameplay.
  • Gameplay FPS Limit: Target FPS cap during active gameplay.
  • Force Disable VSync: Forces VSync off at all times so Unity's framerate limiter can function properly.
  • Limit FPS in Menu: Limits FPS while in the Main Menu, Logbook, and Character Select lobby.
  • Menu FPS Limit: Target FPS limit while in menus and the Logbook (Default: 60).
  • Limit FPS on Pause: Limits FPS whenever the pause menu (Esc) is open (works in both singleplayer and multiplayer).
  • Pause FPS Limit: Target FPS limit while the game is paused (Default: 60).
  • Limit FPS When Unfocused: Limits FPS when the game window is minimized or in the background (Alt-Tab).
  • Unfocused FPS Limit: Target FPS limit when the game window is unfocused (Default: 60).

State Priority & Modes

The mod evaluates the current game state dynamically and applies limits in the following priority order:

  1. Unfocused (Alt-Tab): Highest priority. Whenever the game window loses focus, the unfocused limit is applied immediately regardless of whether you are in a menu or in a run.
  2. Main Menu & Logbook: Active whenever no run is currently in progress (Title screen, Logbook 3D viewer, Character Select lobby).
  3. Paused: Active during a run whenever the game is paused or the Esc menu is open.
  4. Active Gameplay: Applies your custom high-refresh-rate cap (up to 540 FPS), or unlocks the framerate completely if Enable Custom Gameplay FPS is turned off.

Technical Notes & Known Limitations

  • Vanilla FPS Cap Setting is Overridden: While this mod is installed, changing the FPS Limit dropdown in the vanilla Risk of Rain 2 Video settings will have no effect, as the mod continuously manages Application.targetFrameRate. All framerate adjustments should be done through Risk of Options or the mod's config file.
  • VSync Must Be Disabled: Due to how the Unity engine works, Application.targetFrameRate is completely ignored whenever VSync is enabled (QualitySettings.vSyncCount > 0). To ensure framerate caps work in menus, Alt-Tab, and gameplay, this mod automatically forces VSync off whenever a limit is active. If you use FreeSync or G-Sync, keep VSync disabled in-game and cap your Gameplay FPS Limit slightly below your monitor's refresh rate (e.g., 230 FPS for 240 Hz).

Contact & Support

If you encounter any issues or have suggestions, feel free to reach out on Discord: goondrik