Nutcracker Fire Warning is a client-side BepInEx plugin for Lethal Company that adds readable shotgun timing warnings for Nutcracker enemies.
The plugin does not change enemy behavior, shotgun damage, networking, or game balance. It only displays local visual warnings based on the Nutcracker's current combat state and the game's firing timing.
The warning follows the Nutcracker's in-game shotgun timing:
0.5s when the Nutcracker has enemyHP <= 11.3s when the held shotgun has one shell loaded1.75s otherwiseThe final fire-window warning activates shortly before the predicted shot. This window is configurable.
The config file is created after first launch:
BepInEx/config/aueser.lethalcompany.nutcrackerfirewarning.cfg
Main options:
EnableUiFireWindow: Enables the side-bar fire-window pulse and text.EnableModelOutlineFireWindow: Enables the Nutcracker model fire-window warning.ModelOutlineMode: Selects model warning mode. MeshSilhouette uses model-based warning behavior; ScreenBox uses a screen-space fallback rectangle.ModelPulseMode: Selects SourcePulse, CloneShell, or Both.ModelPulseIntensity: Controls red-white pulse emission intensity.ModelPulseAlpha: Controls pulse color alpha.ModelWarningMaxDistance: Limits model warnings by distance. Set to 0 or lower to disable distance filtering.ModelWarningRequireCameraVisible: Requires the Nutcracker to be inside the local camera view before showing the model warning.ModelOutlineWidth: Controls ScreenBox line width and CloneShell expansion width.MeshOutlineScale: Extra scale multiplier for CloneShell mode.FireWindowSeconds: Seconds before the predicted shot when final warnings activate.PreAimMaxDistance: Maximum distance for the yellow pre-aim danger bar.MonitorActiveScanInterval: Fallback scan interval while Nutcrackers are present.MonitorIdleScanInterval: Fallback scan interval while no Nutcrackers are present.EnableDebugLogs: Enables diagnostic logging.DumpModelAudit: Logs Nutcracker renderer and mesh information when model warning data is built.Debug options are intended for troubleshooting and should normally remain disabled during regular play.
Install through a mod manager, or place the plugin folder under:
BepInEx/plugins/
Expected manual install layout:
BepInEx/plugins/NutcrackerFireWarning/NutcrackerFireWarning.dll
This plugin is client-side and visual-only. Each player who wants the warning needs to install it locally.
SourcePulse is the recommended model warning mode. Some Unity game meshes are
not readable at runtime, so shell-based mesh outlines may be less reliable on
unmodified game assets.
Licensed under the MIT License.