Player Actions
On this page8
Everything staff can do to a player, in one table: what it does, what the player sees, the permission it needs and whether it works on an offline player.
Where the buttons are
| Place | Which buttons |
|---|---|
| Players page, in the profile | All of them, in three groups: Quick actions, Moderation and Give / set |
| Reports page, on a ticket you handle | The same buttons, for the person you selected on the ticket |
| Quick menu, Players tab | Spectate, Freeze, Go to, Bring to me |
A button your rank may not use is not shown. With no button at all the profile says: "Your rank has no actions for this player."
The rank rule
| Who acts on whom | Allowed |
|---|---|
| Staff on a player without a rank | Yes |
| Staff on staff of a lower rank | Yes |
| Staff on staff of the same or a higher rank | No: "That player has the same or a higher rank than you." |
| A super-admin on anybody | Yes |
| Staff with a rank on a super-admin | No |
| Staff on themselves | Yes, with three exceptions (below) |
| Not on yourself | Text |
|---|---|
| Freeze, Kick, Ban, Warn, Jail | "You cannot use this on yourself." |
| Spectate | "You cannot spectate yourself." |
| Release from a jail somebody else put you in | "You cannot let yourself out of jail." |
A super-admin can freeze and release themselves. The rule holds for offline players too.
All actions
Words in [brackets] are filled in by the panel. "Nothing" means the panel shows the player no text.
| Button | What it does | What the player sees | Permission | Needs | Offline |
|---|---|---|---|---|---|
| Go to | Moves you to the player | Nothing | Go to player (player.goto) | No | |
| Bring to me | Moves the player to where you stand | Nothing | Bring player (player.bring) | No | |
| Spectate | You watch the player. Your own character is hidden meanwhile | Nothing | Spectate (player.spectate) | No | |
| Freeze | Locks the player in place and takes them out of their vehicle | "You were frozen by staff." | Freeze / unfreeze (player.freeze) | No | |
| Unfreeze | Lets the player move again | "You can move again." | Freeze / unfreeze (player.freeze) | No | |
| Revive | Stands a dead or downed player up, with full health | "You were revived by staff." | Revive (player.revive) | No | |
| Heal | Full health and full armour | Nothing | Heal (player.heal) | No | |
| Screenshot | Shows you a picture of the player's screen | Nothing | Screenshot (player.screenshot) | screenshot-basic | No |
| Inventory | Opens the player's inventory on your screen | Nothing | Open inventory (player.inventory) | ox_inventory | No |
| Kill | The character dies at once. The panel asks first | Nothing | Kill (player.kill) | No | |
| Kick | Removes the player from the server. They can join again | "You have been kicked: [reason]" | Kick (player.kick) | No | |
| Ban | Bans the player, for a number of minutes or for good | The ban message with the reason. See Bans & Warns | Ban (player.ban) | Yes | |
| Jail | Sends the player to the admin jail or to the police prison | Admin jail: "You were sent to admin jail for [minutes] minute(s). Reason: [reason]" | Jail / release (player.jail) | Police prison: a prison script | No |
| Release from jail | Lets the player out. The panel asks first | Admin jail: "You were released from jail." | Jail / release (player.jail) | Yes, from the admin jail | |
| Warn | Puts a warning on the player's record | "You have been warned: [reason]" | Warn (player.warn) | Yes | |
| Message | Sends a private message | A notice and a chat line: "[staff name]: [message]" | Private message (player.dm) | No | |
| Give Money | Adds money to one account | Nothing | Give / take money (player.money) | No | |
| Take Money | Takes money from one account | Nothing | Give / take money (player.money) | No | |
| Give Item | Puts an item into the inventory | Nothing | Give items (player.items) | A supported inventory | No |
| Set Job | Changes job and grade | Nothing | Set job (player.job) | No | |
| Set Model | Changes the character to another ped model | The character changes | Set model (player.model) | No | |
| Reset look | Gives the player their own saved character back: model, face, hair and clothes. The panel asks first | Their own look comes back | Set model (player.model) | A clothing script | No |
| Set Bucket | Moves the player to another dimension | Nothing | Set bucket (player.routing) | No |
- An action on an offline player also needs the Offline players permission (
player.offline). The release from the admin jail does not. - Money, items and jobs go through your framework and your inventory. They may show a notice of their own.
- The police prison shows what your prison script shows. See Jail.
- Every action is written to the Logs.
What staff fill in
| Button | Fields | Rules |
|---|---|---|
| Kick | Reason | An empty reason becomes "Kicked by staff" |
| Ban | Reason. Duration in minutes | An empty reason becomes "No reason given". Duration 0 = permanent |
| Jail | Which jail. Minutes. Reason | Starts on Admin jail and 10 minutes. Minutes go from 1 to 10080 (one week). An empty reason becomes "No reason given" |
| Warn | Reason | An empty reason becomes "No reason given" |
| Message | Message | Up to 300 characters. An empty message is not sent: "Write a message first." |
| Give Money, Take Money | Account. Amount | Starts on bank and 1000. The amount must be more than 0 |
| Give Item | Item name. Amount | Starts on amount 1 |
| Set Job | Job name. Grade | Starts on grade 0 |
| Set Model | Ped model | Starts on mp_m_freemode_01 |
| Set Bucket | Bucket number | From 0 to 65535. 0 is the normal world |
Good to know
| Action | Detail |
|---|---|
| Go to | Your old position is kept. Go back in the quick menu returns you there. See Self Tools |
| Spectate | You follow the player into their dimension and get your own back afterwards. Stop with Stop at the bottom of the quick menu. If the player leaves: "[name] left: spectating stopped." |
| Screenshot | The picture opens in the panel. It is not saved: "The picture is not saved. It is gone when you close this." |
| Jail | The Jail button becomes Release from jail while the player is jailed. Police prison is only offered when a prison script was found |
| Jail and sits | A player in a sit room cannot be jailed from here: "This player is in a sit room. Jail them when you end the sit." See Sits |
| Ban, Kick | The profile closes, because the player is gone |
| Reset look | The way back from Set Model. The panel asks "Reset look: [name]?" with the line "They get their own character look back." The look is loaded by your clothing script, so it can take a moment |
| Reset look, no clothing script | Nothing changes. The player reads: "No clothing script was found to load your character." The panel still says "[name] got their own look back": it cannot see what happened in the player's game |
Messages staff can get
| Message | Why |
|---|---|
| "You do not have permission to do that." | The rank does not have the permission |
| "That player has the same or a higher rank than you." | The rank rule |
| "That player is no longer online." | The player left before the action arrived |
| "That player is offline." | The action only works on an online player |
| "That player is still loading in. Try again in a moment." | A jail was tried before the character stood in the world |
| "screenshot-basic is not running on this server." | Start the screenshot-basic resource |
| "The screenshot could not be taken." | The player's game did not send a picture |
| "Opening an inventory works with ox_inventory only." | The server uses another inventory |
| "That is not a valid account." / "The amount must be more than 0." | Check the Give Money or Take Money fields |
| "The money could not be changed. Check the account name and the amount." | The framework refused the account, or the player does not have that much |
| "The item could not be given. Check the name and their free space." | Wrong item name, or the inventory is full |
| "The job could not be set. Check the job name and the grade." | The framework does not know that job or grade |
| "Enter an item name." / "Enter a job name." / "Enter a model name." | The field was left empty |
| "The dimension must be a number from 0 to 65535." | Check the Set Bucket field |
| "This server has no police prison connected." | No prison script was found. See Prison Scripts |
| "The admin jail is switched off on this server." | Config.AdminJail is false. See Jail |
| "This player is already in jail." / "This player is not in jail." | Reload the profile |
Settings
| Key | What it changes here | Page |
|---|---|---|
Config.InventorySystem | Which inventory Give Item uses | General |
Config.NotifySystem | How the notices are drawn for the player | General |
Config.BanMessage, Config.BanHardware | The ban text, and whether a ban also blocks the PC | Bans |
Config.AdminJail | Where the admin jail is, or false to switch it off | Jail |
Config.Permissions, Config.DefaultRanks | The permission list, and the ranks made at the first start | Super-Admin & Ranks |
Limits
- Go to and Bring to me change the position only, not the dimension. For a player in another dimension use Spectate or Set Bucket.
- A freeze ends when the player leaves the server.
- Revive brings the character back to life, then tells your ambulance script that the player is
up again.
qb-ambulancejob,qbx_medical(Qbox),esx_ambulancejobandesx_death(ESX 1.16 and newer) work out of the box. Another ambulance script gets its line in the open filebridge/ambulance.lua. Until then it may still count the player as dead. See Bridge Files. - Set Model gives the character the default look of that model. A name the game does not know changes nothing. Reset look is the way back.
- Reset look works with
illenium-appearance,qb-clothing, and ESXskinchangerwithesx_skin. Another clothing script gets its call in the open filebridge/appearance.lua. See Bridge Files. The panel stores no looks itself. - Inventory works with
ox_inventoryonly. Screenshot needsscreenshot-basic. - An offline player gets no notice of a warning.
- More limits: Known Limitations.