Installation

🚀 Quick Installation (5 minutes)

Step 1: Install Dependencies

Make sure you have the following installed on your server:

1. oxmysql — Required for database persistence

2. An inventory system — Any of the supported inventories listed below

Add them to your server.cfg before alone-implants:

ensure oxmysql
ensure your_inventory_resource

Supported Inventories

Inventory	Auto-Detected	Notes
ox_inventory	✅	Recommended
qs-inventory	✅	Full support
ps-inventory	✅	Full support
codem-inventory	✅	Full support
core_inventory	✅	Full support
origen_inventory	✅	Full support
tgiann-inventory	✅	Full support
mf-inventory	✅	Full support
qb-inventory	✅	QB-Core native
ESX native	✅	ESX built-in items

The script auto-detects which inventory you're using. No manual configuration needed in most cases. If auto-detection fails, you can force it in config.lua (see Configuration Guide).

Step 2: Install the Resource

1. Copy the folder alone-implants to your resources folder

2. Add to server.cfg:

ensure alone-implants

Step 3: Import the Database

Import the SQL file to create the required table:

-- File: sql/install.sql
CREATE TABLE IF NOT EXISTS `player_implants` (
    `id` INT AUTO_INCREMENT PRIMARY KEY,
    `identifier` VARCHAR(60) NOT NULL,
    `socket_id` VARCHAR(32) NOT NULL,
    `implant_id` VARCHAR(64) NOT NULL,
    `level` INT DEFAULT 1,
    `durability` FLOAT DEFAULT 100.0,
    `installed_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    UNIQUE KEY `unique_socket` (`identifier`, `socket_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

Step 4: Add Implant Items to Your Inventory

Register the implant items in your inventory system. Below are examples for the most common inventories.

ox_inventory — ox_inventory/data/items.lua

['implant_double_jump'] = {
    label = 'Double Jump Actuators',
    weight = 500,
    stack = false,
    description = 'Cybernetic leg actuators for mid-air jumps',
},
['implant_dash'] = {
    label = 'Dash Module',
    weight = 500,
    stack = false,
    description = 'Directional propulsion module',
},
['implant_sprint_boost'] = {
    label = 'Sprint Boost',
    weight = 500,
    stack = false,
    description = 'Temporary sprint speed augmentation',
},
['implant_night_optics'] = {
    label = 'Night Optics',
    weight = 300,
    stack = false,
    description = 'Cybernetic night vision implant',
},
['implant_adrenal_burst'] = {
    label = 'Adrenal Burst',
    weight = 500,
    stack = false,
    description = 'Adrenaline surge combat implant',
},
['implant_fall_dampener'] = {
    label = 'Fall Dampener',
    weight = 400,
    stack = false,
    description = 'Impact absorption system',
},
['implant_breath_assist'] = {
    label = 'Breath Assist',
    weight = 300,
    stack = false,
    description = 'Extended underwater breathing module',
},
['implant_stabilizer'] = {
    label = 'Stabilizer',
    weight = 400,
    stack = false,
    description = 'Recoil and shake reduction system',
},
['implant_pain_editor'] = {
    label = 'Pain Editor',
    weight = 400,
    stack = false,
    description = 'Neural pain suppression module',
},
['implant_inventory_expansion'] = {
    label = 'Titanium Spine / Cargo Frame',
    weight = 800,
    stack = false,
    description = 'Increases carry capacity and inventory slots',
},

qs-inventory / ps-inventory — Database or items config

Add items via your inventory's item creation system (usually an admin panel or database insert). Each item needs:

Field	Value
name	implant_double_jump, implant_dash, etc.
label	Double Jump Actuators, Dash Module, etc.
weight	300–800
type	item
unique	true

qb-inventory / qbx_core — shared/items.lua

implant_double_jump     = { name = 'implant_double_jump',     label = 'Double Jump Actuators',     weight = 500, type = 'item', image = 'implant_double_jump.png',     unique = true, useable = false, shouldClose = true, description = 'Cybernetic leg actuators for mid-air jumps' },
implant_dash            = { name = 'implant_dash',            label = 'Dash Module',                weight = 500, type = 'item', image = 'implant_dash.png',            unique = true, useable = false, shouldClose = true, description = 'Directional propulsion module' },
implant_sprint_boost    = { name = 'implant_sprint_boost',    label = 'Sprint Boost',               weight = 500, type = 'item', image = 'implant_sprint_boost.png',    unique = true, useable = false, shouldClose = true, description = 'Temporary sprint speed augmentation' },
implant_night_optics    = { name = 'implant_night_optics',    label = 'Night Optics',               weight = 300, type = 'item', image = 'implant_night_optics.png',    unique = true, useable = false, shouldClose = true, description = 'Cybernetic night vision implant' },
implant_adrenal_burst   = { name = 'implant_adrenal_burst',   label = 'Adrenal Burst',              weight = 500, type = 'item', image = 'implant_adrenal_burst.png',   unique = true, useable = false, shouldClose = true, description = 'Adrenaline surge combat implant' },
implant_fall_dampener   = { name = 'implant_fall_dampener',   label = 'Fall Dampener',              weight = 400, type = 'item', image = 'implant_fall_dampener.png',   unique = true, useable = false, shouldClose = true, description = 'Impact absorption system' },
implant_breath_assist   = { name = 'implant_breath_assist',   label = 'Breath Assist',              weight = 300, type = 'item', image = 'implant_breath_assist.png',   unique = true, useable = false, shouldClose = true, description = 'Extended underwater breathing module' },
implant_stabilizer      = { name = 'implant_stabilizer',      label = 'Stabilizer',                 weight = 400, type = 'item', image = 'implant_stabilizer.png',      unique = true, useable = false, shouldClose = true, description = 'Recoil and shake reduction system' },
implant_pain_editor     = { name = 'implant_pain_editor',     label = 'Pain Editor',                weight = 400, type = 'item', image = 'implant_pain_editor.png',     unique = true, useable = false, shouldClose = true, description = 'Neural pain suppression module' },
implant_inventory_expansion = { name = 'implant_inventory_expansion', label = 'Titanium Spine / Cargo Frame', weight = 800, type = 'item', image = 'implant_inventory_expansion.png', unique = true, useable = false, shouldClose = true, description = 'Increases carry capacity and inventory slots' },

codem-inventory / core_inventory / origen_inventory / tgiann-inventory / mf-inventory

Use the item management system provided by your inventory. Register each implant item with these names:

implant_double_jump
implant_dash
implant_sprint_boost
implant_night_optics
implant_adrenal_burst
implant_fall_dampener
implant_breath_assist
implant_stabilizer
implant_pain_editor
implant_inventory_expansion

Set each as unique (non-stackable) with appropriate weight values (300-800g).

Step 5: Add Implant Images

Place item images in your inventory's image folder. The folder varies by inventory:

Inventory	Image Folder
ox_inventory	ox_inventory/web/images/
qs-inventory	qs-inventory/html/images/
ps-inventory	ps-inventory/html/images/
qb-inventory	qb-inventory/html/images/
codem-inventory	codem-inventory/html/images/
core_inventory	core_inventory/html/images/
origen_inventory	origen_inventory/html/images/
tgiann-inventory	tgiann-inventory/html/images/
mf-inventory	mf-inventory/html/images/

Image file names:

implant_double_jump.png
implant_dash.png
implant_sprint_boost.png
implant_night_optics.png
implant_adrenal_burst.png
implant_fall_dampener.png
implant_breath_assist.png
implant_stabilizer.png
implant_pain_editor.png
implant_inventory_expansion.png

Step 6: Configure (Optional)

Edit config.lua to adjust settings. See the Configuration Guide for all options.

Step 7: Ready!

1. Restart the server

2. Join the server

3. Use the command: /implants

4. Start installing implants!

⚙️ Basic Configuration

Framework (Automatic)

The script automatically detects your framework:

• ESX ✅

• QB-Core ✅

• QBOX ✅

You don't need to configure anything — it works automatically.

Language

Config.Locale = 'en'  -- 'en' = English, 'es' = Spanish

Clinic Locations

By default, the implant menu can be opened anywhere. To restrict it to clinics:

Config.Clinic = {
    RequireClinic = true,
    Zones = {
        { coords = vec3(312.2, -592.8, 43.3), radius = 4.0 },
        -- Add more locations as needed
    },
}

🔧 Ensure Order

Make sure your server.cfg has the correct order:

ensure oxmysql
ensure your_inventory_resource   -- e.g., ox_inventory, qs-inventory, etc.
ensure alone-implants

Note: The script auto-detects your inventory. Just ensure it starts before alone-implants.

✅ Verify Installation

Check if it Works

1. Open the interface: /implants

2. Verify you can see:

   • Implant catalog on the left

   • Body map in the center

   • Info panel on the right

   • Passive slots below the catalog

Quick Test

1. Give yourself an implant: giveitem [id] implant_double_jump 1

2. Open the interface: /implants

3. Drag the implant to a leg socket

4. Verify it installed and the keybind works

🔒 Asset Escrow Note

This script uses Tebex Asset Escrow. Only config.lua is editable. All client, server, and NUI files are protected. You can customize all behavior through the configuration options documented in the Configuration Guide.

📚 Next Step

Once installed, read the Configuration Guide to fine-tune the system.

---

Having problems? Check the Troubleshooting Guide.

Last updated: February 2026