ev_bodydrag

EV_BODYDRAG is a forked ressource from IceMallowz. Completely edited and changed to work properly and optimized.

EV Body Drag System

This document provides detailed instructions for setting up and using the EV Body Drag System. The system allows players to drag other players when they are incapacitated or dead. It integrates with QBCore and uses the osp_ambulance resource for death state checks.

---

Configuration

Core Settings

The system includes basic settings for distances and key mappings.

Config = {}
Config = setmetatable(Config, {})

Config.ShowDistance = 10.0 -- Distance to show the interaction option
Config.InteractDistance = 3.0 -- Maximum distance to drag a player

---

Client-Side Functionality

Core Functions

Get Closest Player

Finds the closest player to the current player using QBCore utilities.

function GetClosestPlayer()
    local player, distance = QBCore.Functions.GetClosestPlayer()
    return player or false
end

Check if a Player is Dead

This function checks if the target player is dead using the osp_ambulance export.

function isPedDeadOrNotFuckMyLifebeansOnTop(ped)
    local playerID = NetworkGetPlayerIndexFromPed(ped)
    local player = GetPlayerServerId(playerID)
    return exports["osp_ambulance"]:isDead(player)
end

---

Dragging Logic

The dragging functionality is triggered through events and can be controlled using ox_target and keybinds.

Start/Stop Dragging

Drag or stop dragging a player using the ev_target:drag event.

RegisterNetEvent('ev_target:drag')
AddEventHandler('ev_target:drag', function()
    local playerPed = PlayerPedId()
    local player = GetPlayerServerId(Player)
    if not drag then
        drag = true
        draggingPed = GetPlayerPed(Player)
        draggingPlayer = Player
        -- Animations and server event logic here
    else
        drag = false
        draggingPed = nil
        -- Stop dragging logic here
    end
end)

---

Interaction Integration

The system uses ox_target for interaction:

exports.ox_target:addGlobalPlayer({
    {
        label = 'Drag',
        icon = 'fas fa-hand-rock',
        distance = 3.0,
        onSelect = function(data)
            TriggerEvent('ev_target:drag')
            QBCore.Functions.Notify('You are dragging the player, press G to stop', 'success', 8000)
        end,
        canInteract = function(entity, distance)
            if exports["osp_ambulance"]:isDead(GetPlayerServerId(NetworkGetPlayerIndexFromPed(entity))) and distance <= Config.InteractDistance then
                return true
            else
                QBCore.Functions.Notify('You cannot drag this player', 'error', 5000)
                return false
            end
        end
    }
})

---

Keybinds

Custom keybinds for control during dragging:

• Move Right: Default key: D

• Move Left: Default key: A

• Stop Dragging: Default key: G

Example of adding a keybind:

RegisterCommand('g', function()
    if drag then
        TriggerEvent('ev_target:drag')
    end
end, false)

RegisterKeyMapping('g', 'Stop Dragging', 'keyboard', 'g')

---

Server-Side Functionality

Core Events

Attach Player

Trigger a client event to attach the dragging player.

RegisterServerEvent('ev-drag-server:attach')
AddEventHandler('ev-drag-server:attach', function(Player)
    TriggerClientEvent('ev-drag:attach', Player, source)
end)

Detach Player

Trigger a client event to detach the dragging player.

RegisterServerEvent('ev-drag-server:deattach')
AddEventHandler('ev-drag-server:deattach', function(Player)
    TriggerClientEvent('ev-drag:deattach', Player, source)
end)

---

Usage Guide

Dragging a Player

1. Approach a dead or incapacitated player.

2. Use the ox_target interaction to drag the player (default label: Drag).

3. Follow the prompts to drag the player.

4. Use the G key to stop dragging.

Interaction Validation

• The interaction option is only available if:

  • The player is dead or incapacitated (validated using osp_ambulance).

  • The target player is within the defined interaction distance.

---

Notes

• This script requires the osp_ambulance resource for death state checks.

• Ensure that the osp_ambulance export (:isDead) is properly integrated and functional.

• Customize distances, key mappings, and labels as needed to suit your server's preferences.