> For the complete documentation index, see [llms.txt](https://devmosaic.gitbook.io/devmosaic/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devmosaic.gitbook.io/devmosaic/resources/devmosaic-dm-movement.md).

# Dm Movement

`dm-movement` is a lightweight, high-performance tactical movement system for FiveM. It introduces dynamic ledge climbing, smart obstacle vaulting, tactical leaning with corner camera peeking, and realistic muzzle obstruction ballistics.

Built from the ground up to be standalone, `dm-movement` requires zero external frameworks or dependencies and runs seamlessly on **Qbox**, **QBCore**, **ESX**, or standalone FiveM servers.

***

### Key Features

* **Smart Ledge Traversal & Vaulting**: Automatically measures obstacle height and depth to smoothly vault over low fences, mantle medium walls, and climb tall ledges up to 2.55 metres.
* **Fall Catch Mechanic**: Players falling past ledges can catch the edge mid-air and pull themselves up.
* **Tactical Leaning**: Smooth left and right leaning animations with wall obstruction detection to prevent clipping through solid geometry.
* **Dynamic Corner Peeking**: Integrated cinematic camera offset and slight zoom when leaning to give clear line-of-sight around corners.
* **Muzzle Obstruction & Ballistics**: Raycasts from the weapon barrel to prevent firing when gun barrels are pressed against walls or obstacles, accompanied by an in-game blocked indicator.
* **Controller & Gamepad Support**: Optional controller button mappings for leaning (LB / RB).
* **Zero Dependencies**: Standalone resource with zero framework requirements.
* **Escrow Protected with Open Config**: Core mathematical algorithms protected via FiveM Keymaster, with `shared/config.lua` completely open for server customization.

### Resource Name

The resource folder should be named:

```
dm-movement
```

### In This Section

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-download">:download:</i></td><td><strong>Installation</strong></td><td>Setup guide, server.cfg, and key mapping.</td><td><a href="/devmosaic/resources/devmosaic-dm-movement/installation.md">Installation</a></td></tr><tr><td><i class="fa-gear">:gear:</i></td><td><strong>Configuration</strong></td><td>All traversal, leaning, camera, and ballistics settings in config.lua.</td><td><a href="/devmosaic/resources/devmosaic-dm-movement/configuration.md">Configuration</a></td></tr><tr><td><i class="fa-gamepad">:gamepad:</i></td><td><strong>Controls And Features</strong></td><td>How vaulting, climbing, leaning, and muzzle obstruction work in-game.</td><td><a href="/devmosaic/resources/devmosaic-dm-movement/controls-and-features.md">Controls And Features</a></td></tr><tr><td><i class="fa-code">:code:</i></td><td><strong>Exports</strong></td><td>Client exports to check state or enable/disable movement.</td><td><a href="/devmosaic/resources/devmosaic-dm-movement/exports.md">Exports</a></td></tr><tr><td><i class="fa-lock">:lock:</i></td><td><strong>Escrow And Support</strong></td><td>Asset protection details, open files, and support channels.</td><td><a href="/devmosaic/resources/devmosaic-dm-movement/escrow-and-support.md">Escrow And Support</a></td></tr></tbody></table>