Do not skip this. A mod that is almost installed behaves exactly like a mod that is not installed, and working that out later — three chapters into a playthrough, after something has gone wrong — is far more painful than spending two minutes on it now.
On diskCheck one: the folder tree¶
This is what a complete, correct install looks like. Compare it against your own game folder.
Bendy and the Ink Machine\
│
├─ Bendy and the Ink Machine.exe the game
├─ Bendy and the Ink Machine_Data\ the game
├─ MonoBleedingEdge\ the game
├─ UnityPlayer.dll the game
├─ UnityCrashHandler64.exe the game
├─ steam_api64.dll the game (Steam copies)
│
├─ winhttp.dll BepInEx <- the hook. Must be HERE, beside the .exe
├─ doorstop_config.ini BepInEx <- the hook
├─ .doorstop_version BepInEx
├─ changelog.txt BepInEx
│
└─ BepInEx\
├─ cache\
│ └─ chainloader_typeloader.dat rebuilt whenever plugins change
├─ config\
│ ├─ BepInEx.cfg the loader's own settings
│ └─ stixsworldhd.bendy.ungodlyenhanced.cfg
│ generated on first run of Enhanced
├─ core\
│ ├─ 0Harmony.dll
│ ├─ BepInEx.dll
│ ├─ BepInEx.Preloader.dll
│ └─ Mono.Cecil*.dll
├─ patchers\ empty, and that is correct
├─ plugins\
│ ├─ UngodlyBendyEnhanced.dll <- Enhanced v1.2.0
│ └─ UngodlyBendyCommunityPatch.dll <- Community Patch v1.1.3
└─ LogOutput.log rewritten every launchThe same thing, in Explorer
Four captures of a finished install. Click any of them to read the file sizes and dates at full size.
View full size · 1752×320
View full size · 1752×215
View full size · 1752×130
View full size · 1752×130| If this is missing or wrong | What it means | Fix |
|---|---|---|
winhttp.dll is not beside the .exe | BepInEx was extracted one folder too deep, or not at all. | Redo BepInEx step 2 |
BepInEx\plugins\ does not exist | BepInEx has never successfully run. | BepInEx troubleshooting |
plugins\ exists but is empty | You extracted the archives but did not copy the DLLs in. | Enhanced step 3, Patch step 3 |
No stixsworldhd.bendy.ungodlyenhanced.cfg in config\ | Enhanced has not run yet, or it failed to load. | Launch the game once, then check again |
A .dll sits in BepInEx\ itself | Wrong folder — it will never be loaded from there. | Move it into plugins\ |
In LogOutput.logCheck two: the log¶
Open <game folder>\BepInEx\LogOutput.log in Notepad. You are looking for three things.
1. BepInEx started
[Message: BepInEx] BepInEx 5.4.23.5 - Bendy and the Ink Machine
[Info : BepInEx] Running under Unity v2022.3.x
[Message: BepInEx] Preloader started
[Message: BepInEx] Preloader finished2. Both plugins were found and loaded
[Message: Chainloader] Chainloader ready
[Info : Chainloader] 2 plugins to load
[Info : Chainloader] Loading [Ungodly Bendy Enhanced 1.2.0]
[Info : Chainloader] Loading [Ungodly Bendy Community Patch 1.1.3]
The number in N plugins to load is the fastest single check on this whole page.
| Log says | Meaning |
|---|---|
2 plugins to load | Correct. Both DLLs found. |
1 plugins to load | Only one DLL is in plugins\. Check which. |
0 plugins to load | BepInEx is running but the folder is empty or the DLLs are elsewhere. |
| No Chainloader line at all | BepInEx did not start. Nothing after this matters until that is fixed. |
3. Enhanced printed its banner
=============================================================
Ungodly Bendy Enhanced v1.2.0
by StixsworldHD (StixsmasterHD4k)
Press F7 in game to open the settings window.
=============================================================LiveCheck three: in the game¶
Launch the game, get to the main menu, and press F7. The settings window opens over the top.
View full size · 1920×1080Read the status panel
Bottom-left of the window. It is reporting what the mod has actually found on your machine, in this scene, right now — which makes it the most useful diagnostic in the whole mod.
| Line | What it means | What you want to see |
|---|---|---|
| Resolution | The resolution the game is running at this instant. | Your actual resolution |
| Aspect | The calculated aspect ratio label for it. | A sensible ratio — 16:9, 21:9, 16:10 |
| UI scale | The final scale factor being applied to the interface. | x1.000 at 1080p; about x2.000 at 4K |
| Canvases | How many UI canvases the mod found and took control of. | At least 1 |
| Profiles | Post-processing profiles found in this scene. | 0 at the main menu is normal — check again in a chapter |
| Cameras | Cameras found. Bendy uses a world camera and a weapon camera. | 2 in gameplay |
| Menu fit | Whether the aspect-ratio patch installed. | patched |
| SSAA | Supersampling state. | off unless you turned it on |
| physics rate | What the jitter fix decided to do. | See the table below |
Reading the physics rate line
| It says | Meaning | Action |
|---|---|---|
vanilla (no player in scene) | You are in a menu. There is no player to compensate, so nothing has been changed yet. This is correct at the main menu. | Start a chapter and look again |
144 Hz (compensated) or similar | Working. The physics rate was raised to match your display and the gravity compensation was applied successfully. | Nothing — this is the goal |
compensation unavailable | The game has been patched and the fields the compensation needs could not be found. The mod is correctly refusing to change the physics rate, because broken jump heights are worse than a little jitter. | Nothing you can do. Everything else still works. |
vanilla in gameplay | Physics Update Rate is set to Off on the Smoothness tab. | Set it to MatchRefreshRate |
DiagnosticsCheck four: the About tab¶
The last tab in the list carries a Diagnostics panel that goes further than the sidebar. This is the single most useful screen in the mod, and the one to screenshot if you ever need to report a problem.
View full size · 1920×1080Reading the Diagnostics panel
| Line | Shown here | What it tells you |
|---|---|---|
| Post-processing | no post-processing profiles found | Correct at the main menu. The menu scene has no profiles. Check again inside a chapter, where it should report two. |
| Cameras | 2 camera(s): Weapon, UI | Which cameras were found and identified. In gameplay you also get the world camera. |
| Managed canvases | 1 | How many UI canvases the scaler has taken control of. Anything above 0 means the UI fix is live. |
| Volumetric renderers | 0 | Zero at the menu is normal. In a chapter this should be 1. |
| Brightness effect | available | The vanilla brightness clamp was located and can be bypassed. |
| Menu aspect patch | installed | The one to check. The Harmony patch on AspectRatioUtil applied — this is the ultrawide fix. |
| Supersampling | off | Off unless you turned it on. If it says it failed, the log explains why. |
| Smoothness | vanilla (no player in scene) | Correct at the menu. In a chapter this becomes your refresh rate plus a compensation state. |
| Detected resolutions | 26 | How many display modes were merged from the seven sources. A plausible number for a single 1080p panel. |
Two buttons sit under the panel:
- Rescan everything now — forces an immediate sweep for cameras, profiles and canvases rather than waiting for the timer. Useful if you have just loaded into a chapter and want the numbers to update at once.
- Re-enable supersampling — clears the failure latch if SSAA switched itself off. It disables itself deliberately when the camera stack cannot accept a presenter without disturbing draw order, or when the GPU refuses the buffer size; the log says which.
DoneIf all four checks pass¶
The install is complete and you can stop reading. Everything after this page is optional: a reference for the settings, some starting points for your hardware, and a troubleshooting page for if something goes wrong later.