📘 Civ Interaction Documentation Overview

Civ Interaction is a lightweight roleplay utility for QB-Core servers (old & new) that allows civilian-to-civilian interactions such as robbing, dragging, and vehicle placement — all through qb-radialmenu.

The script is designed to be:

Optimized

Easy to configure

Compatible with multiple inventory systems

RP-friendly and stable

✨ Features 🔓 Rob Players

Opens the actual target player inventory

Requires hands up (optional)

Progress bar with animation

Supports multiple inventory systems

🤝 Drag Players

Simple and reliable drag system

Toggle drag on/off

Move players during RP scenarios

No job restrictions (civilian friendly)

🚗 Vehicle Interactions

Put players into vehicles

Take players out of vehicles

Works while dragging

🎯 Radial Menu Integration

Fully integrated with qb-radialmenu

No commands needed

Clean, user-friendly access

🧠 Auto Detection

Auto-detects supported inventory systems

Auto-detects hands-up scripts

Manual override available in config

📦 Supported Systems Inventories

qb-inventory (legacy)

jpr-inventory

Hands-Up Scripts

qb-handsup

op-crime

dpemotes

rpemotes

Animation fallback (automatic)

📋 Requirements

QB-Core (old or new)

qb-radialmenu

One supported inventory:

qb-inventory (legacy) or

jpr-inventory

No SQL required.

📁 Installation

Download the resource

Place it into your resources folder:

resources/[standalone]/civ-interaction

Add to your server.cfg:

ensure civ-interaction

Configure settings in config.lua

Restart your server

⚙️ Configuration config.lua

Config = {}

-- Inventory system
-- 'auto'
-- 'qb-inventory-legacy'
-- 'jpr-inventory'
Config.Inventory = 'auto'

-- Hands-up system
-- 'auto', 'qb-handsup', 'op-crime', 'dpemotes', 'rpemotes', 'animation'
Config.HandsUp = 'auto'

-- Robbing settings
Config.RequireHandsUp = true
Config.RobTime = 3500
Config.Distance = 2.0

-- Debug
Config.Debug = true

🧩 How It Works Robbing

Player selects Rob from the radial menu

Target must be within range

(Optional) Target must have hands up

Progress bar completes

Target’s inventory opens for the robber

Dragging

Player selects Drag from the radial menu

Drag toggles on/off

Target moves with the player

Used for kidnappings, robberies, and RP scenarios

Vehicles

Put In Vehicle places the target into the nearest vehicle

Take Out Vehicle removes the target safely

🧠 Inventory Auto-Detection

When Config.Inventory = 'auto', the script checks:

jpr-inventory

qb-inventory

The first running inventory is used automatically.

You may force an inventory manually in the config if needed. put this in qb-redialmenu

-- ===============================
-- CIVILIAN INTERACTIONS
-- ===============================
{
    id = 'civ_interactions',
    title = 'Player',
    icon = 'user',
    items = {
        {
            id = 'civ_rob',
            title = 'Rob',
            icon = 'user-ninja',
            type = 'client',
            event = 'civ-interaction:radial:rob',
            shouldClose = true
        },
        {
            id = 'civ_drag',
            title = 'Drag',
            icon = 'people-pulling',
            type = 'client',
            event = 'civ-interaction:radial:drag',
            shouldClose = true
        },
        {
            id = 'civ_put_vehicle',
            title = 'Put In Vehicle',
            icon = 'car-side',
            type = 'client',
            event = 'civ-interaction:radial:putinveh',
            shouldClose = true
        },
        {
            id = 'civ_take_vehicle',
            title = 'Take Out Vehicle',
            icon = 'person-walking-arrow-right',
            type = 'client',
            event = 'civ-interaction:radial:takeoutveh',
            shouldClose = true
        }
    }
},