Skip to content

Mursisru/SmoothCamera

Repository files navigation

Developer: Mursisru

Smooth Camera AutoCenter

Nuclear Option BepInEx 5 Version License: MIT


Critical warnings

Important

BepInEx 5 (x64) required - install BepInEx before this mod.

Warning

Remove legacy SmoothCenter plugins - delete SmaathThirdPersonCamera.dll and com.alex.smoothcenter; both hook the same orbit camera pipeline and will conflict.

Tip

Configuration Manager recommended for in-game tuning of com.at747.smoothcamera.cfg.

Multi-mode smooth external camera for Nuclear Option (BepInEx 5). Replaces legacy com.alex.smoothcenter / SmaathThirdPersonCamera.dll.

Plugin GUID: com.at747.smoothcamera
Version: 1.0.0 (BepInEx semver) · dev build string in AppVersion.DisplayVersion

Table of contents

Features

Mode Behavior
Orbit Boresight combat camera, dynamic pitch-height framing, auto-center pan/tilt
Chase / TV External HUD + auto-center (TV view)
HUD Full flight HUD on local aircraft in external views; reticle compensates dynamic camera offset
G-LOC Blackout / vignette in external views

Requirements


Install

Important

BepInEx 5 (x64) required — install BepInEx in the Nuclear Option folder before this mod.

Warning

Remove legacy SmoothCenter plugins before enabling this mod: SmaathThirdPersonCamera.dll, com.alex.smoothcenter. Both hook the same orbit camera pipeline and will conflict.

  1. Download SmoothCamera_Engine.dll from Releases or build Release locally.

  2. Copy to:

    Nuclear Option\BepInEx\plugins\SmoothCamera_Engine.dll
    
  3. Launch the game. Config auto-creates at BepInEx\config\com.at747.smoothcamera.cfg.


Configuration

File: BepInEx\config\com.at747.smoothcamera.cfg (or edit via Configuration Manager).

Section Key Description
General Enabled Master toggle
Combat CombatFollowEnabled Boresight orbit camera
Orbit OrbitDynamicFramingStrength Dynamic camera height by pitch (0 = off)
Chase Chase view smoothing
TV TV view auto-center
HUD AlignHudToBoresight HUD reticle compensation for framing offset

Migration from legacy mods

Disable or delete com.alex.smoothcenter and SmaathThirdPersonCamera.dll before enabling Smooth Camera. Do not run both orbit-camera hook sets in the same session.


Build

msbuild SmoothCamera_Engine\SmoothCamera_Engine.csproj /p:Configuration=Release

Output: SmoothCamera_Engine\bin\Release\SmoothCamera_Engine.dll

Set NuclearOptionRoot in Directory.Build.props or Directory.Build.user.props if the game is not in the default Steam path.


Troubleshooting

Symptom Fix
Camera fights itself / jitter Remove legacy SmoothCenter DLLs
Plugin not listed Verify DLL path under BepInEx\plugins\
Hooks odd after update Delete BepInEx\cache\harmony_interop_cache.dat, restart

Logs: BepInEx\LogOutput.log — search for com.at747.smoothcamera.


License

MIT — see LICENSE.


Keywords

nuclear-option, bepinex, harmony, mod, smooth-camera, external-camera, csharp, unity

About

Smooth external camera and HUD for Nuclear Option (BepInEx)

Topics

Resources

License

Stars

2 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages