# Introduction

## 🚀 What is Alone Implants?

Alone Implants is a complete cyberpunk-style implant system for your FiveM server. It allows players to install, upgrade, and manage cybernetic augmentations through a modern drag-and-drop NUI interface with a full body map, heat management, cooldowns, and durability wear.

## ✨ Key Features

### 🧬 Implant System

* **10 unique implants** — 5 active abilities and 5 passive augmentations
* **3-level upgrades** — Each implant can be upgraded up to level 3
* **Drag & drop installation** — Intuitive body map interface
* **Active & passive slots** — Body map sockets for actives, dedicated passive grid

### 🔥 Heat & Overheat

* **Heat management** — Each active ability generates heat
* **Overheat lockout** — System locks for a configurable time at max heat
* **Debuff system** — Reduced performance while overheated
* **Category-based decay** — Different cooldown rates per implant type

### 🛡️ Durability & Wear

* **Wear system** — Implants degrade with use
* **Breakable implants** — Broken implants are automatically removed
* **Recovery chance** — Configurable probability of recovering items on uninstall

### 🎯 Cooldown HUD

* **Persistent overlay** — Always visible circular progress indicators
* **Three states** — Active (cyan), Cooldown (blue), Overheat (red)
* **Non-intrusive** — Only shows when timers are active

### 💰 Economy

* **Money costs** — Configurable installation and upgrade costs
* **Item requirements** — Require specific items for installation
* **Level scaling** — Cost multiplier per upgrade level

## 🎮 Compatibility

### Supported Frameworks

* ✅ **ESX** — Full compatibility
* ✅ **QB-Core** — Full compatibility
* ✅ **QBOX** — Full compatibility
* ✅ **Auto-detection** — No configuration needed

### Dependencies

* ✅ **oxmysql** — Database persistence (required)
* ✅ **ox\_inventory** — Inventory integration (recommended)

## 🧬 Available Implants

### ⚡ Active Implants (Body Map)

Active implants are installed on the body map and require a key press to activate.

| Implant           | Socket       | Description                       |
| ----------------- | ------------ | --------------------------------- |
| **Double Jump**   | Legs         | Execute a second jump mid-air     |
| **Dash**          | Legs / Spine | Quick directional dash            |
| **Sprint Boost**  | Legs / Spine | Temporary sprint speed increase   |
| **Night Optics**  | Head         | Toggle night vision               |
| **Adrenal Burst** | Chest        | Short burst: sprint + melee boost |

### 🛡️ Passive Implants (Passive Slots)

Passive implants are installed in the 4 passive slots on the left panel and provide constant bonuses.

| Implant                 | Description                                |
| ----------------------- | ------------------------------------------ |
| **Fall Dampener**       | Reduces fall damage                        |
| **Breath Assist**       | Extends underwater breathing time          |
| **Stabilizer**          | Reduces camera shake and recoil            |
| **Pain Editor**         | Reduces ragdoll and stumbling              |
| **Inventory Expansion** | Increases carry weight and inventory slots |

## 🖥️ Interface

### Body Map (Active Implants)

* **Front view** — Head, Chest, Arms, Legs
* **Back view** — Spine
* **Drag & drop** — Drag from catalog to body socket
* **Visual feedback** — Compatible sockets glow when dragging

### Passive Slots (Passive Implants)

* **4 dedicated slots** — Below the catalog on the left panel
* **Drag & drop** — Same intuitive system as body map
* **Cyberpunk aesthetic** — Corner accents and glow effects

### Info Panel

* **Details view** — Shows implant stats, level, durability
* **Install / Uninstall / Upgrade** — Action buttons
* **Real-time updates** — Changes reflect immediately

## 🚀 Quick Installation

1. **Copy** `alone-implants` to your `resources` folder
2. **Import** the SQL file: `sql/install.sql`
3. **Add to server.cfg**: `ensure alone-implants`
4. **Configure** `config.lua` to your liking
5. **Restart the server**
6. **Ready!** Use `/implants` to open the interface

## 🔒 Asset Escrow

This script uses **Tebex Asset Escrow**. Only `config.lua` is editable. All other files (client, server, NUI) are protected and cannot be modified.

**What you CAN configure:**

* All settings in `config.lua`
* Clinic locations, keybinds, economy, heat, durability, locales
* Implant property overrides via `Config.ImplantOverrides`

**What you CANNOT modify:**

* Client/server Lua files
* NUI (React interface) source code
* Shared utility and implant catalog files

## 📚 Next Steps

* [Installation Guide](/getting-started/installation.md) — Step by step setup
* [Configuration Guide](/getting-started/configuration.md) — All config options explained
* [Implants Guide](/usage/implants-guide.md) — Detailed implant information
* [Keybinds](/usage/keybinds.md) — Key mapping and controls
* [Troubleshooting](/support/troubleshooting.md) — Common issues and solutions

***

*Last updated: February 2026*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://implants.alonestore.com/getting-started/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
