For the complete documentation index, see llms.txt. This page is also available as Markdown.

Player actions and the inspector

Finding a player

The Players tab has one search box for online and offline players: name, character name, server id, citizenid, or any identifier (license, license2, Steam, Discord, FiveM, Xbox). An owner's search also matches a player's last IP address. The address is only ever shown to an owner in game, never on the web panel, and an address search is written to the staff log.

Right click a player in the list for the player wheel.

The profile

Picking an online player opens their profile: a portrait, health, armour, hunger and thirst, flags (down, frozen, jailed, cuffed, in a vehicle, controls taken), job, gang and warning count. Below it, six sub tabs:

Sub tab
What is in it

Overview

Character sheet, accounts, identifiers with copy buttons, the latest staff notes, and quick actions: go to, bring, spectate, heal, revive, freeze, slap, ragdoll, feed, cuff, take controls, delete their vehicle, copy coords as vector4(...). Admins also get set on fire and explode, which ask for a second click.

Moderation

Warn, kick, jail, ban, mute and community service, see Punishments.

Inventory

View, give, remove and clear items.

Economy

Set cash, bank, crypto or black money, change job and grade, and the bank history when Renewed-Banking or qb-banking runs.

Records

Warnings, notes and ban history, filed by identifier so they work while the player is offline.

Tools

Weapons, ped model, routing bucket, give a vehicle, hunger and thirst, take their controls for a while, open their clothing menu, screenshot, screen check, and for the owner, delete their character.

An offline player from the search shows their records, bank history and, for the owner, the character delete.

Cuffs are rm_watch's own (an animation, the game's cuff flag and blocked controls), so they work with any police script. On Qbox and QBCore the ishandcuffed metadata is set too.

Character delete uses the framework's own delete on Qbox and QBCore. On ESX it removes the users row and the owned_vehicles, user_licenses and billing rows under it. You type the citizenid by hand first.

The inspector

/watchinspect or F8 (cfg.admin.inspectKey) switches it on and off.

  • With a mouse the cursor comes free. Hover a vehicle, a ped, a player or an object and a card follows the cursor, with a white outline on what you hover.

  • With a gamepad, or press Tab with a mouse, the camera stays yours and the card reads what is under the screen centre. Tab again frees the cursor.

Hovered
Shown

Vehicle

Plate, registered owner (and their server id when online), driver, speed, model, class, engine and body health, net id, distance

Player

Name and character, health, armour, job and grade, ping, staff role and duty, jailed or frozen, net id, distance

Ped or object

Model hash, health, coordinates, mission and frozen flags

The registered owner needs a framework. A car nobody owns reads "Not owned". Close the inspector with Esc or F8.

The player wheel

Open it on a player:

  • In the world: right click them with the inspector's cursor, or press E while aiming at them. On a car it opens on the driver.

  • In the menu: right click a player in the Players list.

The wheel holds heal, revive, freeze, spectate, go to, bring, screenshot, jail, kick and ban. A slice only appears when your role allows it.

Input
Does

Mouse

Click a slice. Click the centre or outside to close.

Keyboard

1 to 0 run a slice, arrows or Tab move, Enter runs, Esc closes.

Gamepad

Left stick or D-pad picks, A runs, B closes.

Jail, kick and ban open the punishment dialog.

Screenshots and screen check

Both need screenshot-basic.

Screenshot (Tools sub tab, the wheel, or the web panel) asks the player's game for a picture of their screen and shows it to you. With cfg.screenshot.upload = 'discord' a copy also goes to the screenshots webhook.

Screen check is an opt in anticheat. It takes a screenshot and looks for a known mod menu or trainer drawn on the screen. It only sees what is painted, not code, and it never punishes on its own: a hit is reported to staff for a human to judge.

For reliable results it needs your own OCR service in server.cfg (rm_watch_ocr_endpoint, see server.cfg lines). Without one there is no verdict: it says so and shows the screenshot to staff to judge.

Permissions

Action
Default
What it is

world:peek

moderator

Job, ping and registered owner on the inspector card

Everything else uses the action it runs (heal, freeze, kick and so on), each with its own role.

RedM: the profile shows initials instead of a portrait, and the inspector reads horses and wagons. See Differences from FiveM.