Bring realistic mobility aids to your FiveM roleplay server with a lightweight, EMS-ready crutch and wheelchair system. This resource adds animating crutches and a drivable wheelchair vehicle, integrates with common inventories and notification frameworks, and is optimized for minimal performance impact. Ideal for medics, roleplay scenarios, and accessibility-focused servers.

Preview

Screenshots available in the resource folder.

Requirements

– ox_lib (context menus and helpers) – One of these inventory solutions: ox_inventory / qbox, qb-inventory (with qb-core), qs-inventory, codem inventory, or implement custom hooks in config.lua – Optional: Notifier (ScriptiqNetwork Notifier), mythic_notify, ESX ShowNotification support, and a Discord webhook if server-side logging is enabled – Ensure wheelchair model and metadata are streamed as described in installation

Installation

– Place diamond_crutches in your resources folder and add an ensure line in server.cfg for both ox_lib and diamond_crutches – Stream the wheelchair model files under stream/[wheelchair]/ and place model metas in wheelchair_data/ as referenced in fxmanifest.lua – If using the crutch YDR/YTYP, keep them in stream/[crutch]/ and match the DLC_ITYP_REQUEST path – Apply the provided SQL to your database to enable inventory interaction and logging hooks

Config Highlights

– Configure inventory adapter selection and custom callbacks in config.lua – Toggle notification adapter (Notifier, mythic_notify, ox_lib, ESX, chat, or custom) – Adjust behavior options: prevent exiting chair, enable Hold E logic, set push mode behavior, and customize cooldowns – Specify prop/model paths and DLC_ITYP_REQUEST entries for streamed assets

Controls & Behavior

– Activating crutches applies an animation and prop; player cannot sprint, jump, or drive while active – Weapons are auto-unarmed on activation with a friendly notification and cooldown – A clipset is applied when aids are active and removed on deactivate – Wheelchair uses add-on vehicle model iak_wheelchair; player seats as driver – Push mode: nearby players can press E on an empty chair to push (forward/back with W/S) – Optional lock prevents exiting the chair unless configured otherwise

EMS Workflow

– Medics can apply crutches or place players into the wheelchair using an inventory item – Applying aids to others requires the configured item in the medic’s inventory – Workflow integrates with server-side callbacks to verify and remove items when used

Notification Systems

Toggle a single notification adapter in config.lua. Supported adapters include: – Notifier: exports[‘Notifier’]:ShowNotification(title, message, type, duration) – mythic_notify: exports[‘mythic_notify’]:SendAlert(type, message, duration) – ox_lib context helpers – ESX: ESX.ShowNotification(message) – Chat/print fallback – Custom: implement ClientNotify(title, message, type, duration) in your own hook All adapters are routed through a single ClientNotify wrapper to keep calls consistent across frameworks.

Inventory Adapters

Client and server inventory helpers used by the script: – Client: HasItemClient(item, amount) – Server: HasItemServer(src, item, amount) and RemoveItemServer(src, item, amount) Supported out of the box: – ox_inventory / qbox wrapper – qb-inventory (+ qb-core) – qs-inventory (client Search(item) returns qty) – codem inventory via custom hook – Custom inventory integrations via Config.Inventory.Custom callbacks in config.lua

Performance

This resource is optimized for low overhead with throttled loops and event-driven toggles: – Idle: ~0.00 ms – Crutch active: ~0.09 ms – Wheelchair (worst case): ~0.10 ms Only controls run per-frame; state checks are throttled to minimize CPU impact.

License & Credits

– Code: © Diamond Scripts – Snow Morales – Crutch prop: prop_mads_crutch01 (credit MadsL) – Wheelchair model: iak_wheelchair (credit iakkoise) – Thanks to the community for testing and feedback

Support & Contribution

– Report issues and suggestions in the resource thread – Contribute notification or inventory adapters by posting snippets for inclusion – For direct contact and quick questions, reach out via the resource’s support channel

Features

– Animated crutches with prop and movement restrictions (no sprint/jump/drive while active) – Drivable add-on wheelchair vehicle (iak_wheelchair) – EMS-ready application flow to apply aids to other players using inventory items – Inventory-aware adapters: ox_inventory / qbox, qb-inventory, qs-inventory, codem, or custom hooks – Framework-agnostic notifications: Notifier, mythic_notify, ox_lib, ESX, chat, or custom – ox_lib context menu support for in-world interactions – Pushable wheelchair behavior with player-controlled push movement – Configurable exit, hold-to-exit, and lock behaviors – Optimized performance with throttled loops and event-driven toggles – Simple install and clear config options for quick setup on qb-core, ESX, or standalone servers

Download

Download this mod using the links below:

• Download Mod