Skip to content

A lightweight FiveM QBCore script that adds realistic wheelchair functionality to your server! Players can pick up, place, and give keys for wheelchairs using a simple target system.

Notifications You must be signed in to change notification settings

djontop/dj_wheelchair

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🦽 DJ Wheelchair Script — FiveM (QBCore, OX Target, QB Target, OX Inventory Support)

A powerful, expandable, and optimized wheelchair system for QBCore servers. Includes spawning, picking up, key-sharing, multiple inventory systems, and multiple target systems.

Perfect for immersive hospital RP, accessibility, EMS roleplay, and more.


✨ Features

  • 🦽 Spawn a Wheelchair using a usable item

  • 🎯 Supports both major target systems

    • ox_target
    • qb-target
  • 📦 Supports both major inventory systems

    • ox_inventory
    • qb-inventory
  • 🔑 Share Wheelchair Keys with nearby players

  • 🧹 Safe cleanup on resource stop

  • Wheelchairs spawn with configurable fuel

  • 🚫 Prevent pickup if someone is seated

  • 🧍 Distance-based player detection

  • 🔔 Clean notifications and easy configuration

  • 🧩 Fully synced between all players


🛠 Requirements

Dependency Required Notes
QBCore Framework Core required
ox_target or qb-target ⚠️ Optional Must choose one
ox_inventory or qb-inventory ⚠️ Optional Must choose one
vehiclekeys script ⚠️ Optional For key sharing

2️⃣ Add to server.cfg

ensure dj_wheelchair

🗃️ Inventory Support

This script supports both QB-Inventory and OX Inventory. Choose your system in Config.lua:

OX Inventory

Config.Inventory = 'ox_inventory'

Item setup — add to ox_inventory/data/items.lua:

['wheelchair'] = {
    label = 'Wheelchair',
    weight = 5000,
    stack = false,
    close = true,
    consume = 0,
    client = {
        export = 'dj_wheelchair.spawnWheelchair'
    }
}

QB Inventory / qb-inventory

Config.Inventory = 'qb'

Add item to qb-core/shared/items.lua:

["wheelchair"] = {
    "name": "wheelchair",
    "label": "Wheelchair",
    "weight": 5000,
    "type": "item",
    "image": "wheelchair.png",
    "unique": true,
    "useable": true,
    "shouldClose": true,
    "description": "A foldable wheelchair."
},

🎯 Target System Support

This script supports both:

ox_target

Config.Target = 'ox_target'

qb-target

Config.Target = 'qb-target'

Script automatically builds the correct actions for whichever system you choose.

Includes:

  • 🛒 Pickup Wheelchair
  • 🔑 Share Keys

🔧 Configuration (Config.lua Overview)

Config.ItemName = 'wheelchair'
Config.WheelchairModel = 'prop_wheelchair_01'
Config.SpawnDistance = 2.0
Config.ShareKeysDistance = 3.0
Config.DefaultFuel = 100

Config.Target = 'qb-target' -- or 'ox_target'
Config.Inventory = 'qb' -- or 'ox_inventory'

🎮 How Players Use It

🧍 1. Use Wheelchair Item

  • Removes item from inventory
  • Spawns a wheelchair in front of player
  • Gives keys automatically
  • Target options appear

🎯 2. Player Interactions

  • Pick up wheelchair
  • Share keys with nearby players

🔑 3. Key Sharing

  • Shows list of players within range
  • Select player using input dialog
  • Keys get transferred via vehiclekeys

🚀 Credits

Script by: DJONTOP_143 If this script helps your server, please ⭐ star the GitHub repo!

Wheelchair Model: 🔗 https://github.com/AndreIakko/wheelchair Huge thanks for making the model available to the community ❤️

📄 License

Free to use and modify for personal/server use. ⚠️ Not allowed to resell or re-distribute for profit.

About

A lightweight FiveM QBCore script that adds realistic wheelchair functionality to your server! Players can pick up, place, and give keys for wheelchairs using a simple target system.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages