Supply Black Market

A reputation-based illegal marketplace and mission hub for FiveM. Compatible with both QBCore and ESX. As your relationship with the NPC grows, better prices, more items, and more advanced missions become available.

Framework & Integration

Automatically detects the server framework (QBCore / ESX). Notification and targeting systems are fully configurable: supports **ox_lib, qb, esx** notifications, and **ox_target** / **qb-target** targeting. The currency symbol is also configurable.

NPC

The NPC spawns randomly at predefined locations (with weighted probability), stays for a limited time, then disappears and reappears elsewhere. During certain market events, the NPC may become completely unavailable.

Reputation

The higher your reputation, the better the prices and the more content becomes available. Purchases, successful deals, and missions increase it, while failures and busts reduce it.

Pricing System

Base prices are affected by reputation level, active market events, repeated purchases, and bargaining penalties. Inner Circle players can get up to 30% discount.

Bargaining

Players can offer their own price for items. Success depends on the offer ratio and unlocked skills. Too many failed attempts result in cooldowns and reputation penalties.

 Missions

Various mission types and difficulty levels (package delivery, vehicle theft, debt collection, zone control, etc.). Availability depends on reputation and skills. Rewards include money and reputation, with possible bonuses. Only one mission can be active at a time, with cooldowns between missions. Progress is tracked via a HUD.

Skill System

Skills can be unlocked using Skill Points (SP), including category access, bargaining bonuses, reduced bust risk, improved mission rewards, and price discounts. Skills are progression-based.

 Market Events

Each NPC spawn has a chance to trigger a market event:

• Shortage   -  Some categories blocked, prices increase

• Price Spike  -   All prices increase

• Raid Aftermath  -   NPC becomes unavailable

• Clearance  -  Prices drop

Bust Risk

Each purchase carries a risk of getting busted, increasing with item value. If caught, items may be confiscated and reputation reduced.

Blacklist

Repeated violations can result in temporary bans. If reputation drops too low, a permanent ban is applied.

Localization

Supports 20 languages:

• ar, bg, da, de, el, en, es, fa, fr, hi, hu, it, ja, ko, nl, pt, ro, ru, tr, zh-CN

Language can be changed in the config.

** Reputation System**

Four progression levels:

• Unknown  -  Base prices, limited access

• Known  -   Unlocks some categories and skills, small discounts

• Trusted  -  Advanced items and missions available, noticeable discounts

• Inner Circle  -  Maximum trust, best prices, full access

Reputation is built through purchases, successful deals, and completed missions, while failed deals, canceled trades, busts, and violations decrease it.

Pricing & Discounts

Price modifiers include:

• Reputation-based discounts (up to 30%)

• Repeated purchase price increase

• Bargaining penalties

• Additional Inner Circle discount (up to 10%)

Bargaining System

Players can negotiate prices. Success depends on offer ratio and skills. Each item has its own cooldown. Too many failed attempts trigger temporary locks and reputation loss. All values are configurable.

Mission System

Missions vary in type and difficulty and depend on reputation and skills. Some missions require specific skills to unlock.

Examples:

• Package delivery

• Vehicle theft

• Debt collection

Players receive money and reputation rewards, with optional bonuses for performance.

Skill System

Players earn Skill Points (SP) and unlock abilities such as:

• Category access

• Special missions

• Better bargaining success

• Reduced bust risk

• Faster reputation gain

• Increased mission rewards

• Price discounts

SP is earned through gameplay activities.

Market Events

Random events affect availability and pricing:

• Shortage  -  Categories blocked, prices increase

• Price Spike  -  Global price increase

• Raid Aftermath  -  NPC unavailable

• Clearance  -   Price reductions

Events are fully configurable (duration, multipliers, categories, chance).

Bust Risk

Each purchase carries risk based on item value. Higher reputation slightly reduces risk. Getting caught results in confiscation and penalties.

Blacklist System

Repeated violations result in temporary bans. If reputation drops below a threshold, a **permanent ban** is applied. All thresholds and durations are configurable.