NoFloor-NightmareFreddyFix icon

NightmareFreddyFix

Nightmare Freddy as a brand new Enemy! Beware the Freddles! Original mod by TheWeavers

Last updated a day ago
Total downloads 221
Total rating 0 
Categories Mods Monsters Bug Fixes AI Generated
Dependency string NoFloor-NightmareFreddyFix-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100
Evaisa-LethalLib-1.2.0 icon
Evaisa-LethalLib

Personal modding tools for Lethal Company

Preferred version: 1.2.0

README

Nightmare Freddy Fix V81

An unofficial compatibility update for Nightmare Freddy by Felix Allard (TheWeavers), made for Lethal Company v81.

This community-maintained fix brings Nightmare Freddy and his Freddles back to the game on v81, with updated enemy/network handling and more flexible moon spawn settings. This is not an official release by TheWeavers or Felix Allard. The original mod, characters, gameplay concept, and original creative work are credited below.

Original mod

Nightmare Freddy was created by Felix Allard (TheWeavers). The original release introduces Nightmare Freddy and the Freddles as outside enemies in Lethal Company.

Original source and project: https://github.com/FelixAllard/Nightmare-Freddy-LC

This package is an unofficial v81 fix based on the original mod. It is not affiliated with or endorsed by the original developer.

How the mod works

Freddles

Freddles emerge outside and move toward the ship. You need to stop them before too many settle inside:

  • Before they reach the ship: keep looking at them long enough to make them disappear.
  • After they settle in the ship: use a flashlight to burn them away.

Once enough Freddles reach the ship, Nightmare Freddy begins to manifest. The required number can be adjusted through the mod's existing difficulty settings. Freddles remaining after Freddy appears can become aggressive, so clearing them early is important.

Nightmare Freddy

When Nightmare Freddy manifests, his lullaby announces his arrival. He hunts players around the ship, prioritizing targets based on their distance from Freddy and the ship. Contact with aggressive Freddles is dangerous, and once Freddy has appeared, the situation becomes much harder to control.

The original gameplay was designed with a crew in mind, especially one where someone remains aboard the ship. Solo play is possible but may be considerably more difficult.

What's changed in this unofficial v81 fix?

  • Updated compatibility with Lethal Company v81.
  • Reworked network initialization and RPC timing for Freddy and Freddles.
  • Improved server-authoritative enemy spawning and behavior handling.
  • Adjusted Freddle navigation and arrival handling.
  • Replaced the LethalBestiary dependency with LethalLib.
  • Added customizable natural spawn rules for vanilla moons, modded moons, and named moons.

This is a community compatibility fix, not a redesign of the original mod. Behavior may still vary with other mods, custom moons, or multiplayer setups.

Requirements

  • BepInExPack 5.4.2100 (BepInEx-BepInExPack-5.4.2100)
  • LethalLib 1.2.0 (Evaisa-LethalLib-1.2.0)
  • Lethal Company v81

LethalBestiary is not required. LethalLib is used to register the enemies and their network prefabs. Other installed mods may still require LethalBestiary independently.

Installing or updating

Install with a Thunderstore-compatible mod manager, or extract the included NightmareFreddy folder under BepInEx/plugins when installing manually. Keep NightmareFreddy.dll, freddlesmodassets, and freddymodassets together in that folder.

Remove or disable the original Nightmare Freddy package before using this one. Both use the original plugin identifier and must not be loaded together. Restart the game after making configuration changes.

Configuration guide

Start the game once to generate the configuration file, then close the game before editing it:

BepInEx/config/Xilef992.NightmareFreddy.cfg

Moon selection and natural spawn weights

Find the [Spawn] section and edit Moon Rules:

[Spawn]
Moon Rules = all:40

You can select a group (all, vanilla, modded), individual moons by name, or a combination. Each rule can optionally use :number to specify its relative spawn weight.

Setting Effect
all:40 All vanilla and modded moons, weight 40.
vanilla:40 Vanilla moons only, weight 40.
modded:40 Modded moons only, weight 40.
Experimentation, Titan Only those two vanilla moons, using the default weight.
Gloom:60, Polarus:30 Only those two custom moons, with different weights.
vanilla:40, modded:15 Different weights for vanilla and modded moons.
all:40, Titan:100, Gloom:0 All moons at 40, except Titan at 100 and Gloom disabled.
none Disable all natural spawns of Freddy and Freddles.

Important rules:

  • Weights are not percentages. 40 does not mean a 40% chance. The game uses relative weights when choosing from eligible outside enemies.
  • Valid weights are integers from 0 to 10000. A weight of 0 disables natural spawns for the selected moon or group.
  • Specific moon rules override group rules, and vanilla or modded override all.
  • Commas or semicolons separate rules. Capitalization does not matter.
  • none must be used alone.
  • A rule without :number uses the default weight in [Rarity].
  • Freddy and Freddles share the moon rules for natural spawning.
  • Manual spawning through admin or debugging tools can bypass natural spawn restrictions.

For example, to allow Freddy only on modded moons with a high relative weight:

[Spawn]
Moon Rules = modded:300

To allow him everywhere except Gloom:

[Spawn]
Moon Rules = all:40, Gloom:0

Default rarity

The existing [Rarity] setting defines the weight used when a moon rule does not specify one:

[Rarity]
How rare do you want Freddy to spawn? = 40

Changing this value does not override rules that have their own :weight (such as Titan:100). The game must be restarted for the moon spawn registration to update.

Other options

The original mod also provides difficulty and behavior settings. Their explanations are written as comments in the generated configuration file. Change only the settings you understand and keep a backup before extensive testing.

Troubleshooting

  • Freddy never spawns: confirm that Moon Rules covers the current moon and that the assigned weight is above zero. A positive weight only makes him eligible to spawn; it never guarantees a spawn in a given round.
  • Freddy appears on a supposedly excluded moon: close the game, save your config, restart it, and verify that the intended rule was loaded. Also check for duplicates of the original Nightmare Freddy mod.
  • Missing files or broken models: verify that both original asset bundles are present beside NightmareFreddy.dll.
  • Other mods fail after removing LethalBestiary: those mods may need the original library even though this Freddy fix does not.
  • Multiplayer problems: ensure every player uses the same mod version and compatible configuration/modpack.

Credits and attribution

Original mod and creative contributors:

  • Felix Allard (TheWeavers): original Nightmare Freddy mod; concept, Unity assembly, Freddles animation, shaders, sound editing, and original mod image.
  • GIOVy: playtesting, especially networking tests.
  • Shrki: helped develop the concept, sourced the Freddy model, and provided Five Nights at Freddy's background information.
  • Mixamo: Freddy animation resources, as credited by the original author.
  • MusikMaker 2022: sound editing, as credited by the original author.

Unofficial v81 compatibility work: NoFloor. The v81 changes include runtime/network compatibility work, migration to LethalLib, and configurable moon spawn rules. NoFloor is not the original creator of Nightmare Freddy.

The original source code is distributed under the MIT License, copyright (c) 2024 FelixAllard. See the included LICENSE.txt for the license notice. Rights to any third-party models, music, sounds, or other non-code assets may be governed by separate terms.

Original repository: https://github.com/FelixAllard/Nightmare-Freddy-LC