Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
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
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100README
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.
40does 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
0disables natural spawns for the selected moon or group. - Specific moon rules override group rules, and
vanillaormoddedoverrideall. - Commas or semicolons separate rules. Capitalization does not matter.
nonemust be used alone.- A rule without
:numberuses 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 Rulescovers 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