Enhance your Roleplay server with the most advanced, aggressive, and loyal NPC companion script. Whether you are a Mafia Boss needing protection or a Solo Player looking for a backup, this script provides a highly customizable "Socio" (Partner) that follows your lead and defends you to the death.

🔥 Key Features

• Smart Vehicle Logic: Unlike other scripts, your partner won't pull you out of the driver's seat. They intelligently find the nearest free seat and warp in if the vehicle is moving too fast.
• Proactive Combat AI: Optimized Relationship Groups. Your partner is programmed to hate the police and anyone who aims a weapon at you. They don't just stand there—they take cover and push enemies.
• Tactical Drive-bys: Your companion can engage in combat while you are driving, providing covering fire from the passenger seat.
• Job-Locked Companions: Restrict access to companions based on player jobs (e.g., Mafia, Gang, Police, VIP).
• Interaction System: Fully integrated with ox_target and qb-menu for a seamless UI experience.
• Medical & Rescue System:
  • Carry System: Pick up your downed partner and move them to safety.
  • Revive System: Use specific items (via ox_inventory) to bring your partner back into the fight.
• Dynamic Blips: Always know where your partner is with a real-time map blip that updates based on their job.

🛠️ Technical Details

Feature

Compatibility

Framework

QB-Core / ESX (Auto-detect)

Target System

ox_target

Inventory

ox_inventory (for Revive items)

Menu

qb-menu / ox_lib

Optimization

0.00ms (Idle) / ~0.02ms (Active Combat)

📋 Commands & Controls

• /socio - Opens the management menu (Restore, Fire, Toggle Attack Mode).
• Carry Key (Configurable) - Drop your partner when carrying them.
• Targeting - Right-click your partner to toggle "Follow/Wait" or check their Health/Armor status.

📦 What's included in the Config?

• Set different Ped models per job.
• Define custom weapons, health, and armor for each companion type.
• Adjust NPC accuracy and combat aggressiveness.
• Full language localization (Locales).

Get the ultimate protection for your players today!