# Sol Blackmarket - Realistic Criminal Laptop OS

**Sol Blackmarket** is a comprehensive, highly configurable criminal underworld system designed for FiveM servers running QBCore or ESX. It introduces a deep, progression-based ecosystem where players can participate in dark web activities directly from an encrypted laptop, complete illegal jobs, and build their reputation.

## 🌟 Key Features

*   **Universal Compatibility:** Automatically detects your framework (QBCore/ESX). Supports popular inventories (`qb-inventory`, `ox_inventory`) and interaction systems (`qb-target`, `ox_target`).

*   **Encrypted Access:** Accessing the dark web is highly restricted. Players must possess an `encrypted_laptop` item and, optionally, an `encrypted_usb` drive to log in, preventing random civilians from stumbling into criminal enterprises.

*   **Dynamic Black Market:** Players can purchase restricted weapons, tools, and equipment (like lockpicks and thermite). Deliveries are not instant—they take realistic times to arrive at discreet drop locations around the city.

*   **Risk & Tracking System:** The heat is always on. A robust tracking system can alert the police during orders. Placing too many orders consecutively triggers law enforcement tracking.

*   **Reputation & Progression:** Features a 6-tier reputation ladder (from *Unknown* to *Boss*). As players complete jobs, they gain reputation points unlocking access to heavier weaponry and more lucrative, high-risk contracts.

*   **Dark Web Jobs Ecosystem:**

    *   **Vehicle Theft (Chop Shop):** Steal basic cars, high-end vehicles, or exotic luxury cars and deliver them to hidden chop shops.

    *   **Package Runs:** Work as a mule delivering standard goods, hot cargo (with active police interest), or sensitive VIP cargo to locations across the city.

    *   **Elimination Contracts:** Take on hitman contracts targeting low-level bouncers up to heavily guarded syndicate bosses.

    *   **Search Radiuses:** Jobs don't give exact waypoints. Players are given a search area radius, encouraging active exploration and increasing job difficulty.

*   **Crypto Exchange:** Integration for custom cryptocurrencies, allowing players to exchange tokens at dynamically configured rates.

## 🛠️ Installation Guide

Follow these steps to get `sol-blackmarket` running on your server.

### 1. Database Setup

You must import the provided SQL files into your server's database to create the required tables for reputation, crypto tracking, and items.

*   Run the file `sol_blackmarket.sql` in your database manager (e.g., HeidiSQL, phpMyAdmin).

*   Run the file `items.sql` (if you are adding the items directly via SQL; otherwise, manually add the items to your framework's shared items configuration).

### 2. Add Items to Your Server

Ensure the items required for the script exist in your framework's item configuration (`qb-core/shared/items.lua` or `ox_inventory/data/items.lua`):

*   `encrypted_laptop`

*   `encrypted_usb` (if you enable `Config.RequireUSB = true` in the config)

### 3. Configure the Script

Open `config.lua` and adjust the settings to fit your server's needs:

*   Set your framework (`Config.Framework`).

*   Set your inventory and target system (`Config.Inventory` and `Config.Target`).

*   Modify currency types, purchase cooldowns, job rewards, and reputation requirements.

*   Adjust map locations, job settings, and available black market items.

### 4. Install the Resource

*   Place the `sol-blackmarket` folder into your `resources` directory (e.g., `[standalone]/sol-blackmarket`).

*   Add `ensure sol-blackmarket` to your `server.cfg` file.

### 5. Final Step

*   Restart your server or start the resource dynamically using `ensure sol-blackmarket` in your server console.

*   Give yourself an `encrypted_laptop` and try it out!

## ⚙️ Escrow & Editability

The script has been structured via `escrow_ignore` so server administrators and developers have direct access to heavily customize:

*   `config.lua`

*   Database `.sql` files

*   Locales and structural docs (`CUSTOMIZATION.md`, `CHANGELOG.md`)

Enjoy running your criminal underworld!