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 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