The Midnight Lurker Unofficial Port NeoForge 1.21.1
This is an unofficial port. The original mod was created by Voxla. I claim no ownership of the original mod or its assets.
About the original mod
The Midnight Lurker is a horror mod inspired by Man From The Fog and Cave Dweller.
A creature spawns nearby, lurks in the shadows, and watches you. What happens next depends on how you react.
Core mechanic: Look at it and it retreats. Ignore it or move closer, and the encounter escalates.
Original features
- Insanity system — the longer the Lurker remains nearby, the worse things become. New stages unlock increasingly dangerous behavior. Sleeping pauses insanity progression, while killing the Lurker resets it.
- Multiple Lurker variants, each with unique behavior:
- Faker — triggers jumpscares and increases insanity
- Hider — burrows underground when spotted
- Shadow — stalks caves and dark areas
- Shapeshifter — disguises itself as a villager and lures players into trading
- Aggressive — crawls, digs through terrain, and breaks glass and doors
- Void Hands — disguises itself as a trap and attacks when approached
- The Void dimension — accessible through a special portal
- Food and fishing mechanics — some items and events can affect insanity
- Configurable behavior — through configuration files or the Configured mod
- Sound design by Whirlygig
- Legacy SFX/Sound Design Z3R0TW0
Requirements
| Requirement | Version |
|---|---|
| Minecraft | 1.21.1 |
| Mod loader | NeoForge 21.1.234 or newer |
About this port
This project ports The Midnight Lurker to NeoForge 1.21.1 and fixes systems that were broken or incompatible after the update.
Status
| Feature | Status |
|---|---|
| Core stalking behavior | ✅ Working |
| All Lurker variants | ✅ Working |
| Insanity system and HUD | ✅ Working |
| The Void dimension | ✅ Fixed |
| Walking, running, ducking, and crawl animations | ✅ Fixed |
| Entity hitboxes and narrow doorway movement | ✅ Fixed |
| Weapons and armor stacking | ✅ Fixed |
| Structure generation and appearance | ✅ Fixed |
| Structure loot | ✅ Fixed |
| Translation book interface | ✅ Fixed |
| Legacy sound resource pack | ✅ Working |
| Original configuration | ✅ Working |
| Experimental port AI | 🧪 Beta, enabled by default |
Experimental features
Experimental features
This port includes optional AI features that were not part of the original 1.20.1 behavior. The 1x1 crawl mechanic existed in the original mod, but its navigation has been reworked for this port and remains experimental.
1x1 crawl navigation
The Lurker can detect connected 1x1 passages, reduce its hitbox, crawl through tunnels, use open trapdoors, attack while crawling, and leave passages without getting stuck.
Normal reachable paths still have priority over crawl routes.
Window observation
The Lurker can notice and watch players through glass without immediately becoming aggressive.
Window observation can interrupt background music and play a short audio cue.
Stealth and awareness
The Lurker now has:
- A blind spot behind its back
- Memory of the player's last visible position
- Hearing for walking, sprinting, jumping, swimming, crawling, and block breaking
- Reduced hearing through walls
- Silent movement for crouching players
When the player disappears, the Lurker may investigate the last position where the player was seen or heard.
House investigation
After observing a player through a window, the Lurker can remain near the building, patrol around it, react to sounds from inside, and search for a normal entrance without immediately becoming aggressive.
Experimental configuration
Experimental features are enabled by default.
Their settings can be found in:
config/midnightlurker_port_config.toml
Use the master switch to disable every experimental feature:
[port_features]
enabled = false
This restores behavior as close as possible to the original 1.20.1 mod.
Features can also be controlled individually:
[port_features.crawl]
enabled = true
[port_features.window_observation]
enabled = true
[port_features.stealth]
enabled = true
[port_features.house_investigation]
enabled = true
The configuration also contains settings for crawl speed, search radius, hearing distance, blind spot size, memory duration, investigation time, movement speed, and other AI parameters.
The original mod settings remain available separately in:
config/midnightlurker_config.toml
Known issues
- No critical issues are currently known.
- Experimental pathfinding may occasionally make imperfect decisions around unusual structures or complex terrain.
- Modded blocks with unusual collision shapes may affect crawl or entrance detection.
- Experimental features can be disabled individually if they cause problems.
Important note
The original author, Voxla, may release an official NeoForge port in the future. If you prefer an officially supported version, consider waiting for that release.
