VanillaLoop - Narrow Passage System

A production-ready narrow passage system for Unreal Engine 5.8, built in C++ around hand-authored root motion animations. The character walks up to a gap between two walls, turns to the wall and squeezes through sideways, step by step, with its back to the wall or facing it, in single player, in multiplayer and for AI. Includes the full Narrow Passage Set animation pack.

🎥 [Preview Video] | 📖 [Documentation] | 🎮 [Playable Demo]

If you only need the animations, check out the Narrow Passage Set pack.

🧩 System Features (C++ Plugin)

- Every Step on the Grid: Every move is a hand-authored root motion animation and ends exactly on the passage's step grid, so the feet do not slide, on passages of any length.

- Two Styles: Back To Wall (hands down at the waist) and Face To Wall (hands raised on the wall). Either wall can be the one the character holds on to.

- Hands on the Wall: An optional anim node moves the arms and fingers so the palms and fingers lie on the wall. It only corrects the animation, can be switched off per style or per character, and is tuned with a data asset.

- Passage Actor: A straight gap that builds both walls itself from one cube mesh. Length, width, style and wall side are set per instance, an End Handle in the viewport drags the length, and Snap Length To Steps rounds it to whole animation steps.

- Both Ends: A passage is entered from its Start end or its End end. The component picks the animation variant that turns the right way for that end by itself.

- Ledges: One wall only, a ledge floor along it and a drop on the open side.

- One-Way Passages: Entered at one end only, with no turning back inside.

- Level Walls: Switch Build Walls off and fit the passage to the walls of your level; an orange outline shows the gap.

- Full Move Set: Enter at either end, step in both directions, stop on any step, change direction on the spot, turn a step around halfway, and step out at either end.

- Close Camera: The spring arm moves in behind the character inside the gap and the view stays along the passage. Characters whose view does not come from a spring arm get the same view through a camera modifier.

- Multiplayer Ready: Listen and dedicated servers with no setup. Every move is checked by the server, and players who join late see characters in the right pose.

- AI Characters: The same component, driven from a Behavior Tree, State Tree or Blueprint. The demo map includes a working AI that goes through a passage on its own.

- Game Animation Sample Support: Works with the GASP CMC character (Manny and Quinn), hands on the wall included, with no Anim Blueprint changes and no retargeting.

- Easy Integration: Add one component to any Character. It reuses your Move action, so your input code doesn't change. Add one Slot node to your Anim Blueprint and you are ready to squeeze through.

- Keyboard & Gamepad: The passage keys are mapped at runtime, no input assets needed. Change them in Project Settings.

- Swappable Animations: All 72 animations with their step lengths in one Anim Set data asset. Swap it per character or skeleton, or use your own.

- Editor Tools: Project-wide defaults, Data Validation, Map Check, a per-frame trace, hand contact switches, Visual Logger support and an optional HUD with a context prompt.

📦 Assets Included (72 Animation Files)

- Full Narrow Passage Set Library: 36 Root Motion + 36 In Place animations. The system plays the root motion set; the in-place versions are included for your own use.

- Back To Wall (Type 01): 18 Root Motion + 18 In Place - enter, step, idle, change of direction and exit, for both sides and both ends.

- Face To Wall (Type 02): 18 Root Motion + 18 In Place - the same moves with the hands raised on the wall.

- Ready to Play: A ready character, game mode and player controller, an optional HUD, the hand contact Anim Blueprint with its hand profile, and a demo map with 8 stations (both styles, a short passage, a 9 m passage, a ledge over a drop, level walls, an AI character and a one-way passage) plus an animation showcase of all 72 animations.

- AI Assistant Guide: AGENTS.md for Claude Code, Cursor and Copilot - rules, API and recipes - as a separate download.

- Source Files: Downloadable from the Additional Files section on the website.

✅ Requirements & Limitations

- Unreal Engine 5.8.

- Characters based on ACharacter with Character Movement and Enhanced Input. The GASP Mover pawns are not supported.

- Passages are straight and level and can face any direction (yaw). Pitch, roll and scaling are not supported.

- Passages are entered at their two ends, not from the side.

- The character only stops on hold points: the length is `2 × Start + N × Loop`, rounded for you by Snap Length To Steps. The shortest passage is one step, about 1.9 m.

- The width is 50 cm by default and 30 cm at the minimum; the animations were checked at 50 cm, and below 40 cm the body goes into the walls.

- The hand contact is made for flat, vertical walls. Bumps, pipes or recesses under the hands are not supported, and it is tuned on Manny at 50 cm: other meshes and widths may need a profile of their own.

- AI walks to the passage through your own logic (there is no NavMesh link), then enters it with one call.

- Manny is recommended. Quinn plays the same moves; other skeletons need the 36 animations retargeted.

🛠 Technical Details

- Code Modules: NarrowPassageSystem (Runtime), NarrowPassageSystemEditor (Editor)

- Number of C++ Classes: 14

- Number of Blueprints: 7 (demo character, AI character, game mode, player controller, the hand contact Anim Blueprint, the demo character's Anim Blueprint and the touch interface)

- Network Replicated: Yes (listen and dedicated server, players and AI)

- Supported Development Platforms: Windows, macOS, Linux

- Supported Target Build Platforms: Windows, macOS, Linux

- Project Types: Blueprint & C++ (the plugin ships compiled)

- Engine Plugins Used: Enhanced Input, Control Rig

- Rig: Epic Skeleton (UE5 Mannequin, Manny recommended), IK bones included

- Performance: Passages do not tick; the work only happens while a character is in a passage.

- Documentation: [vanillaloop.com/docs/narrow-passage-system]

- Example Map: Lvl_NarrowPassageDemo, included in the plugin

⭐ Support & Feedback

Your feedback fuels our updates. If you find this system useful, please consider leaving a review! It helps us understand your needs and improve future updates.


🤔 Need help or more info?

Join our [Discord], visit [www.vanillaloop.com], or email [contact@vanillaloop.com]