Mob Crawl

Mob Crawl 
Mob Crawl teaches hostile mobs to crawl through 1-block gaps.

You know the situation: you break a single block, hit a mob through the hole, and it can do nothing back. Players have been able to crawl since 1.14 — mobs never could. This mod fixes that. A zombie that sees you behind a 1-block gap lies down and squeezes through, exactly the way you would.
Made for horror and underground survival modpacks. Digging a 1-block hole is no longer a safe spot: whatever is chasing you lies down and crawls in after you.

Features

• Crawling through 1-block gaps, both at floor level and one block up — mobs pull themselves up into a hole in a wall, not just under it.
• Crawling under low ceilings, so mobs no longer suffocate in tight tunnels.
• Proper crawling pose: the body lies down, the head looks ahead, the arms reach forward along the ground.
• Creepers can still explode while crawling. You are not safe just because it is lying down.
• Purposeful behaviour. A mob crawls to reach you and stands back up once it has. It does not crawl around for no reason.
• Safe by default. Only 16 tested vanilla hostile humanoids are enabled out of the box. Nothing else in your modpack is touched unless you enable it yourself.
• Fully configurable in game, without restarts and without editing files.

In-game commands

All commands require operator permissions and apply immediately.

• /mobcrawl status — why a nearby mob is or is not crawling
• /mobcrawl enabled <true|false> — master switch
• /mobcrawl whitelistOnly <true|false> — restrict crawling to the whitelist
• /mobcrawl whitelist add|remove|list <entity> — allow a mob to crawl
• /mobcrawl blacklist add|remove|list <entity> — forbid a mob completely
• /mobcrawl tiltBlacklist add|remove|list <entity> — keep the crawling, drop the model tilt

Tab completion suggests every entity registered in your instance, including modded ones, plus modid:* masks for a whole mod at once.

Adding modded mobs

Nothing modded is enabled by default, because the pose is tuned for vanilla humanoid proportions. Adding your own takes one command:

/mobcrawl whitelist add somemod:some_zombie

Works best with mobs roughly the size and shape of a zombie or a skeleton. If a modded mob crawls correctly but its model does not lie down properly — usually because the mod draws it with its own animation system — keep the crawling and disable the tilt for it:

/mobcrawl tiltBlacklist add somemod:some_zombie

Configuration

config/mobcrawl-common.toml, every option documented in the file itself: crawl height, crawl speed, step assist, hostile-only mode, whether a target is required, target distance, path check interval, low-ceiling crawling, suffocation protection, creeper explosions while crawling, model tilt and its angle.

Performance

Only mobs that pass the filter are processed, path checks are throttled, and list matching is cached per entity type. The mod adds no measurable cost even in large modpacks.

Compatibility

Forge 1.20.1. Server-side logic with a client-side pose, safe on dedicated servers. Does not conflict with player crawling mods such as Dynamic Crawling, which affect players only. Mobs added by other mods are supported through the whitelist.

Installation

Install Forge for 1.20.1 and drop the jar into your mods folder. No dependencies.

Author: Get-6aget
License: All Rights Reserved