Agency Docs
QBESXStandalone

Agency-Blackmarket V2 Companion App

A living black market for FiveM on QBCore, Qbox, ESX or fully standalone.

v2.0.0Paid6 Pages

01Companion App

Agency-Blackmarket V2 works with the free Agency Companion app: control it and get live updates from your real phone or tablet, even when you are not in the city.

02Get the app

03How it works & security

  • The app talks to your server through the encrypted Agency relay (api.agencyg.de). Your server is never exposed publicly.
  • Every player gets a unique pairing code bound to their character. Requesting a new one invalidates the old code, and codes expire.
  • Your server tokens and permissions stay in-game. The app only mirrors what you are already allowed to do.
  • Works on every server with zero per-server setup.

+Good to know

With the free Agency Companion app, the black market fits in a pocket: players see the market, order for pickup, find their drops and get a push when something happens. They link the app in game on the Companion page of /ablackmarket.

Linking a Phone
The Companion page of /ablackmarket shows a QR code and a six digit code. The code stays valid for five minutes (Config.Companion.qrSeconds), and every player can link up to three phones (Config.Companion.maxDevices). Linked phones are listed on the same page and can be removed there.
Market and Reputation
The app shows the market with live prices, stock and running flash sales, the player's level with its perks and the latest deals.
Ordering from the Phone
From the level set in Config.Orders.remoteLevel, players order in the app. The order is paid in game from the player's money, so the player has to be in the city. It is then prepared and waits at a drop point like any other order.
Waypoints
A tap sets a waypoint in game to a ready order. From the level set in Config.Companion.locateLevel, the app can also set a waypoint to a dealer.
Push Notifications
The app reports when an order is ready or has expired, when a dealer the player knows has moved or was raided by the police, when a flash sale starts and when the player reaches a new level.

?Frequently asked questions

Do I have to set anything up for the app?

No. The connection runs through the Agency relay with the default settings. Config.Companion.enabled = false turns the app off.

Can a player order while not in the city?

No. Orders are paid in game, so the player has to be online. The market, the level and the history can be read at any time.

Still stuck after this page? Our support team takes it from here.