> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexdev.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> A framework-agnostic crutch system for FiveM. Players use an inventory crutch item to limp, EMS can prescribe and remove crutches on patients, and a hospital medic NPC removes crutches in exchange…

A framework-agnostic crutch system for FiveM. Players use an inventory crutch item to limp, EMS can prescribe and remove crutches on patients, and a hospital medic NPC removes crutches in exchange for money. Drop-in compatible with any ambulance job that sets a recognized job name.

## In this section

* [Installation](/nex_crutchsystem/installation)
* [Configuration](/nex_crutchsystem/configuration)
* [Player & EMS usage](/nex_crutchsystem/usage)
* [Commands](/nex_crutchsystem/commands)
* [Exports & events](/nex_crutchsystem/exports)
* [Troubleshooting](/nex_crutchsystem/troubleshooting)

## What you get

* Works on **Qbox, QBCore, ESX, and ND\_Core** — auto-detected
* Inventory bridge prefers **ox\_inventory**; QB / ESX legacy inventories supported via the snippets in `install/items.lua`
* **Usable crutch item** — toggle on/off with a configurable use count before the item breaks
* **EMS prescribe / remove** — third-eye option on any player; takes a crutch from EMS inventory and force-equips the patient for a configurable duration
* **Auto-force export** — `ForceCrutch` so any ambulance job can apply a crutch after check-in or respawn
* **Hospital medic NPC** — spawns at every configured medical center, removes the crutch for money (or for free), server-validated
* **Custom UI** — medic dialog, EMS menu, patient HUD, admin panel; each panel can be turned off independently
* **Admin tooling** — `/addcrutch`, `/removecrutch`, `/crutchadmin` (all command names configurable)
* **Rate-limited & server-validated** — every player-triggered event is throttled and re-checked server-side; spoofing NUI events can't bypass the gates
* `escrow_ignore` on `config.lua` and the bridge files so your settings and any custom framework / inventory adapters survive updates

## Compatibility

* **Any ambulance resource** — the bridge only reads `playerData.job.name`. As long as your ambulance job sets a name listed in `Config.AllowedJobs`, EMS interactions work. No hardcoding to a specific ambulance script.
* **Legacy crutch resources** — the hospital NPC also fires removal hooks for `wasabi_crutch`, `ak47_crutch`, and `ak47_qb_crutch` (configurable). Lets you run this alongside another crutch script during a migration.