> For the complete documentation index, see [llms.txt](https://risenova-scripts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://risenova-scripts.gitbook.io/docs/risenova-black-market/risenova-black-market.md).

# RiseNova Black Market

RiseNova BlackMarket is a dealer-based black market system for FiveM servers. Players can purchase restricted items, complete contracts to receive discounted prices, increase their reputation, and collect reserved merchandise from private sellers.

### <mark style="color:$primary;">Features</mark>

<mark style="color:$success;">Dealer System</mark>

* Configurable dealer locations
* Random starting locations
* Automatic dealer relocation
* Fixed-location option
* Job restrictions
* Configurable NPC models

<mark style="color:$success;">Black Market Store</mark>

* Custom storefront interface
* Search and category filters
* Direct purchases
* Contract-based purchases
* Reputation requirements

<mark style="color:$success;">Contract System</mark>

* Five contract mission types
* Configurable mission locations
* Mission time limits
* Discounted item purchases
* Contract cooldowns

### <mark style="color:$primary;">Supported Frameworks</mark>

* ESX
* QBCore
* QBOX

### <mark style="color:$primary;">Supported Inventories</mark>

* qb-inventory
* ox\_inventory

Custom inventories can be integrated inside **bridge/inventory.lua**

### <mark style="color:$primary;">Supported Target Systems</mark>

* qb-target
* ox\_target

### <mark style="color:$primary;">Dependencies</mark>

Required:

* OneSync
* oxmysql
* One supported framework
* One supported vehicle keys system
* One supported inventory resource
* One supported target system

Optional:

* ox\_lib for notifications

### <mark style="color:$primary;">Installation</mark>

1. Place the resource inside your resources folder.
2. <mark style="color:red;">Make sure the resource name is exactly:</mark>&#x20;

```
RiseNova_BlackMarket
```

3. Add the resource to your server.cfg

```
ensure RiseNova_BlackMarket
```

4. Open `config.lua` and select your framework, inventory system, target system, vehicle-key resource, notifications, and language.
5. Configure the item names, prices, stock, required reputation, purchase modes, and available contracts.
6. Keep automatic database creation enabled:

```lua
Config.AutoCreateDatabase = true
```

Alternatively, manually import:

```
sql/install.sql
```

### <mark style="color:$danger;">Important</mark>

Make sure all items used in your black market exist in your inventory resource.