Skip to content

Generic utility plugins for the BepInEx plugin loader (IL2CPP)

License

Notifications You must be signed in to change notification settings

BepInEx/BepInEx.Utility.IL2CPP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BepInEx Utility IL2CPP

Various universal BepInEx utility plugins for Unity games compiled with IL2CPP. Projects marked with netFM are for BepInEx 6 pre1, while projects marked with net6 are for the latest BepInEx 6 builds.

If the game is not compiled with IL2CPP, use BepInEx.Utility instead.

Prerequisites

netFM / BepInEx 6 pre1

net6 / BepInEx 6 latest

Installation

  • Download the desired plugin from the Releases Section.
  • Extract the .zip file in the game folder (where game.exe is).

Graphics Settings

Change graphics settings like resolution, full screen and vSync in the Configuration Manager. Press F5 to open.
New Feature: Apply setings on startup. This will overwrite the game settings, use with caution.

Enable Resize

Enable window resizing when in windowed mode. An overhaul of Enable Resize from BepInEx project made to increase compatibility.

Mute In Background

Mute a game when it loses focus, i.e. when alt-tabbed. Ported form BepInEx Utility.

Enable Full Screen Toggle

Allow toggling full screen with alt+enter in games where that has been disabled. Ported form BepInEx Utility.

Message Center

A simple plugin that shows any log entries marked as "Message" on screen. Ported form BepInEx Utility
Plugins generally use the "Message" log level for things that they want the user to read.

How to make my mod compatible?
Use the Logger of your plugin and call its LogMessage method or Log method and pass in LogLevel.Message as a parameter. You don't have to reference this plugin, and everything will work fine if this plugin doesn't exist.

Please avoid abusing the messages! Only show short and clear messages that the user is likely to understand and find useful. Avoid showing many messages in a short succession.

New Feature: Black List

Suppress console messages containing certain words. Available in Configuration Manager.

ByteFiddler (patcher)

This patcher allows you to replace a sequence of bytes in the memory of the current process. Use with caution!

  1. Run the game once to generate BepInEx\config\ByteFiddler.cfg and edit it.
  2. Change the settings as needed, read setting descriptions for more info.
  3. Run the game and the plugin will replace the found pattern with the replacement pattern. Check the log for errors or the success message.

ProcessAffinityOverride (patcher)

This patcher allows you to override processor affinity of the current process.

  1. Run the game once to generate BepInEx\config\ProcessAffinityOverride.cfg and edit it.
  2. Change the settings as needed, read setting descriptions for more info.
  3. Run the game and the plugin should change the affinity. Check the log for errors or the success message. You can see if it worked by checking process affinity in Task Manager.