/BepisPlugins

A collection of essential BepInEx plugins for games made by Illusion.

Primary LanguageC#GNU General Public License v3.0GPL-3.0

BepisPlugins

A collection of essential BepInEx plugins for Koikatu / Koikatsu Party, EmotionCreators, AI-Shoujo / AI-Girl, HoneySelect2, HoneyCome, SamabakeScramble / Summer Vacation Scramble, and other games by Illusion/Illgames. Check plugin descriptions below for a full list of included plugins.

If you wish to contribute or need help, check the #help channel on the Koikatsu discord server.

How to install

  1. The latest version of BepInEx 5, or in case of HoneyCome of BepInEx 6 (nightly build 668 or later) is required. Make sure it is installed and working before installing BepisPlugins. Latest version of the ConfigurationManager plugin is also recommended to be installed.
  2. Download the latest release archive for your game (specified by the two letter prefix, e.g. AI for AI-Girl) from the releases page above (not the "Clone or download" button).
  3. Extract the archive into your game directory (where the game exe and BepInEx folder are located). Replace old files if asked.

Plugin descriptions

You can see more information about some of the plugins by checking their config files in BepInEx\config (or by using the in-game ConfigurationManager plugin).

Note: Not all plugins might be available for a given game (not yet ported by anyone, or technically infeasible).

BGMLoader

Loads custom BGMs and clips played on game startup. Stock audio is replaced during runtime by custom clips from BepInEx\BGM and BepInEx\IntroClips directories.

Tutorial on how to replace sound clips and background music using BGMLoader.

ColorCorrector

(Koikatsu)

Allows configuration of some post-processing filters. (change of bloom amount, disable saturation filter)

ExtensibleSaveFormat

Allows additional data to be saved to character, coordinate and scene cards. The cards are fully compatible with non-modded game, the additional data is lost in that case. This is used by sideloader to store used mod information.

InputUnlocker

Allows user to input longer than normal values to InputFields. This allows longer names and other properties stored as text.

Screencap

Creates screenshots based on settings. Can create screenshots of much higher resolution than what the game is running at. It can make screen (F9 key) or character (F11 key) screenshots.

Sideloader

Loads mods packaged in .zip archives from the Mods directory without modifying the game files at all. You don't unzip them, just drag and drop to Mods folder in the game root.

It prevents mods from colliding with each other (i.e. 2 mods have same item IDs and can't coexist; sideloader automatically assigns correct IDs). It also makes it easy to disable/remove mods with no lasting effects on your game install (just remove the .zip, no game files are changed at any point).

More information and tutorial on sideloader-compatible mod creation.

Step-by-step guide for creating a simple texture mod.

Tool for automatically converting old list mods to sideloader-compatible form.

SliderUnlocker

Allows user to set values outside of the standard 0-100 range on all sliders in the editor.

IMGUIModule.Il2Cpp.CoreCLR.Patcher

(HoneyCome, SamabakeScramble)

Fixes issues with IMGUI caused by the game being IL2CPP that prevent other plugins like ConfigurationManager from being displayed correctly.

Removed plugins

Configuration Manager

Moved to https://github.com/BepInEx/BepInEx.ConfigurationManager

DeveloperConsole

Moved to https://github.com/BepInEx/DeveloperConsole

IPALoader

Moved to https://github.com/BepInEx/IPALoaderX

MessageCenter

Moved to https://github.com/BepInEx/MessageCenter

ScriptEngine

Moved to https://github.com/BepInEx/BepInEx.Debug

Obsolete plugins

DynamicTranslationLoader

Replaced by XUnity.AutoTranslator

ResourceRedirector

Replaced by XUnity.ResourceRedirector