Admin Commands

Admin commands and permissions for oxide-blackmarket.

Everything is a subcommand of a single /blackmarket command. Running /blackmarket on its own (or with an unknown subcommand) shows the usage line.

/blackmarket <settings|relocate|status|goto|setrep|checkrep>

Commands

Dealer Commands

/blackmarket relocate

/blackmarket relocate

Moves every active dealer to a fresh random location with full stock. Useful after changing Config.Locations or if a dealer ever ends up somewhere bad.

/blackmarket status

/blackmarket status

Sends you a notification with how many dealers are currently active (for example, "3 dealer(s) currently active"). With Config.Debug = true, it also prints each dealer's network ID and spawn location to the server console.

/blackmarket goto

/blackmarket goto

Teleports you to a spot right in front of the nearest active dealer — wherever he has wandered to, not just where he spawned. The fastest way to check on one.

Reputation Commands

/blackmarket setrep

/blackmarket setrep [playerId] [amount]

Examples:

/blackmarket setrep 1 0
/blackmarket setrep 1 350
/blackmarket setrep 1 1000

Sets the player's reputation to the exact amount (whole numbers of zero or more). You get a confirmation, and the player gets a notification with their new reputation and tier name. Handy for testing tiers or rewarding/punishing players.

Tier thresholds:

/blackmarket checkrep

/blackmarket checkrep
/blackmarket checkrep [playerId]

Shows reputation, tier number, and tier name. With no player ID, it checks your own.

Settings Menu

/blackmarket settings

/blackmarket settings

Opens an in-game editor for the resource's settings — the same values stored in the oxide_settings database table (see Configuration). Changes apply live and are saved to the database immediately; no restart needed.

• Settings are split into a Basic view (the common toggles and numbers most servers touch) and an Advanced view (fine-tuning and grouped settings), with a search box.
• Each changed field is highlighted; Save Changes commits them, and each field has a reset button that restores the shared/config.lua factory default.
• Everything is editable in-game, including the big data structures:
  • Dealer spawn locations and arrest drop-off points — press Place to set a point in the world: a translucent preview appears, aim to position it, scroll to rotate, left-click to confirm (right-click/ESC cancels). Teleport jumps you to an existing point. Editing these relocates the dealers live.
  • Shop inventory and sellable items — pick items from a searchable catalog (with images), then set their prices, stock, reputation, and category.
  • Reputation tiers, dispatch alerts, pager intel, and hit-squad weapons are edited through grouped forms.

Only admins can open the menu, and every save is re-checked server-side, so a non-admin cannot change settings even by forging the request. In-world placement requires an up-to-date o-link (it provides the placement tool).

Permissions

All subcommands require the group.admin permission group. The check happens once inside the /blackmarket handler — you don't need to add any add_ace lines for individual commands.

If your admins aren't already in group.admin, add them in your server.cfg:

add_principal identifier.fivem:1234567 group.admin

Replace 1234567 with the admin's FiveM ID (or use their license: / discord: identifier — any identifier type works). If your framework or admin system already puts staff in group.admin, nothing extra is needed.

These commands are meant to be run in game — they notify and teleport the person who runs them.

Notes

• Config.Debug = true prints useful [oxide-blackmarket] lines to the server console while testing. Turn it off on a live server.
• /blackmarket status followed by /blackmarket goto is the fastest way to confirm a fresh install works.

Next Steps