Commands Reference
Complete command documentation for Oxide Chat.
Complete command documentation for oxide-chat.
Overview
Oxide Chat provides roleplay-focused chat commands with proximity awareness, job-specific channels, and private messaging.
Command Features
| Feature | Description |
|---|---|
| Aliases | Multiple names for the same command |
| Proximity | Distance-based message delivery |
| Line of Sight | Optional visibility requirement |
| Cooldowns | Rate limiting per command type |
| Job Validation | Server-side job verification |
Roleplay Commands
Commands for in-character roleplay actions.
/me
Perform a roleplay action visible to nearby players.
/me waves hello to everyoneOutput: * John Smith waves hello to everyone
| Property | Value |
|---|---|
| Range | 15 meters |
| Line of Sight | Required |
| Cooldown | 1.5 seconds |
| Style | Italic, white text |
/do
Describe an environment or action result.
/do The door swings open with a creakOutput: ** The door swings open with a creak [John Smith]
| Property | Value |
|---|---|
| Range | 15 meters |
| Line of Sight | Required |
| Cooldown | 1.5 seconds |
| Style | Italic, gray text |
/whisper (/w)
Speak quietly to nearby players.
/whisper Hey, can you hear me?
/w Follow me quietlyOutput: John Smith whispers: Hey, can you hear me?
| Property | Value |
|---|---|
| Range | 3 meters |
| Line of Sight | Not required |
| Cooldown | 1.5 seconds |
| Style | Amber text |
/shout (/s)
Yell to players in a large area.
/shout EVERYBODY GET DOWN!
/s POLICE! STOP!Output: John Smith shouts: EVERYBODY GET DOWN!
| Property | Value |
|---|---|
| Range | 50 meters |
| Line of Sight | Not required |
| Cooldown | 1.5 seconds |
| Style | Red text |
Out of Character Commands
Commands for non-roleplay communication.
/ooc
Global out-of-character message visible to all players.
/ooc I need to go AFK for a minuteOutput: [OOC] John Smith (5): I need to go AFK for a minute
| Property | Value |
|---|---|
| Scope | Global (all players) |
| Cooldown | 5 seconds |
| Style | Amber text with OOC prefix |
/looc
Local out-of-character message visible to nearby players.
/looc Sorry, need to check my settingsOutput: Uses OOC styling but only visible to nearby players.
| Property | Value |
|---|---|
| Range | 20 meters |
| Line of Sight | Not required |
| Cooldown | 1.5 seconds |
| Style | Amber text with OOC prefix |
Private Messaging
Direct player-to-player communication.
/msg (/pm, /dm)
Send a private message to a specific player.
/msg 5 Hey, want to team up?
/pm 12 On my way to you
/dm 3 Check your phoneUsage: /msg [player_id] [message]
Output (to recipient): [PM from John Smith (5)]: Hey, want to team up?
Output (to sender): [PM to Jane Doe (12)]: Hey, want to team up?
| Property | Value |
|---|---|
| Scope | Private (two players) |
| Cooldown | 1 second |
| Style | Violet text (#a78bfa) |
/reply (/r)
Reply to the last player who sent you a PM.
/reply Sure, meet me at Legion Square
/r On my way!Usage: /reply [message]
| Property | Value |
|---|---|
| Scope | Private |
| Cooldown | 1 second |
| Requirement | Must have received a PM |
Reply Tracking
- Last PM sender is automatically tracked
- Disconnecting clears reply tracking
- Each new PM updates the reply target
Friends
Manage your in-game friends list. Friends are tied to your character, so they carry over between sessions. Friend requests are consent-based: the other player has to accept before you're added (unless they already sent you a request, in which case adding them accepts it automatically).
/friend
Add or remove a friend by their player ID.
/friend add 5 -- Send a friend request to player ID 5
/friend remove 5 -- Remove player ID 5 from your friendsUsage: /friend add [id] or /friend remove [id]
| Property | Value |
|---|---|
| Scope | The two players involved |
| Requirement | Target must be online |
The ID is the player's server ID, not their character ID. The full friends list, incoming requests, and blocking are also available in the friends panel of the chat UI.
Job Radio Commands
Job-specific chat channels. Requires the corresponding job.
The three radios below (police, EMS, mechanic) ship as ready-made examples, but they are now fully editable channels — an admin can restyle them, change which jobs use them, add more radios, or remove them, all in-game with no restart. Any channel an admin creates automatically shows up in the command suggestions (the autocomplete list) for the players allowed to use it. See the Admin Guide for how to create and manage channels.
/lspd (/pd, /leo)
Police department radio channel.
/lspd 10-4, responding to the scene
/leo Need backup at Legion SquareOutput: [LSPD] John Smith (Sergeant): 10-4, responding to the scene
| Property | Value |
|---|---|
| Required Job | police |
| Scope | All police players |
| Style | Blue text with LSPD prefix |
/medic (/ambulance)
Emergency medical services radio channel.
/medic Patient stabilized, en route to Pillbox
/ambulance Need a medic at the pierOutput: [EMS] John Smith (Paramedic): Patient stabilized, en route to Pillbox
| Property | Value |
|---|---|
| Required Job | ambulance |
| Scope | All EMS players |
| Style | Red text with EMS prefix |
/mechanic (/mech)
Mechanic shop radio channel.
/mechanic Vehicle ready for pickup
/mech New job at LSIAOutput: [MECHANIC] John Smith (Mechanic): Vehicle ready for pickup
| Property | Value |
|---|---|
| Required Job | mechanic |
| Scope | All mechanic players |
| Style | Orange text with MECHANIC prefix |
Admin Commands
All admin tools are grouped under a single /chat command, run as subcommands (an extra word after /chat). Type /chat on its own to see the available subcommands. These require admin permission — see the Admin Guide for who counts as an admin and how to grant it. The server console can always run them, no permission needed.
/chat announce
Send a server-wide announcement.
/chat announce Server restart in 10 minutesYou can split a heading from the body with a | (pipe symbol): the text before the pipe becomes a bold title, the text after it is the message.
/chat announce Event Tonight | Race meet at the docks, 8 PM| Property | Value |
|---|---|
| Permission | Admin (console bypasses the check) |
| Scope | All players |
| Cooldown | 30 seconds (the console has no cooldown) |
| Style | Red text with ANNOUNCEMENT prefix |
From the server console:
chat announce Server maintenance complete/chat autobroadcast
Turn the automatic announcements (see Configuration) on or off while the server is running. With no argument, it toggles the current state. Your choice is saved to the settings database, so it stays that way across restarts.
/chat autobroadcast on -- Enable automatic announcements
/chat autobroadcast off -- Disable automatic announcements
/chat autobroadcast -- Toggle on/off| Property | Value |
|---|---|
| Permission | Admin (console bypasses the check) |
| Scope | Server-wide |
From the server console:
chat autobroadcast off/chat clear
Clear the chat window for everyone, or for one player.
/chat clear -- Clear for all players
/chat clear 5 -- Clear only for player ID 5| Property | Value |
|---|---|
| Permission | Admin (console bypasses the check) |
| Scope | All players or one specific player |
From the server console:
chat clear/chat test
Send yourself one sample message of every chat type — a quick way to check colors and styling.
/chat test -- Send the samples to yourselfRun from the server console, there is no player to send to, so you must give a player ID:
chat test 5 -- Send the samples to player ID 5| Property | Value |
|---|---|
| Permission | Admin (console bypasses the check) |
/chat settings
Open the server settings panel — an in-game editor for the resource's configuration. Admin only, and it can only be opened in-game (not from the server console). Changes apply live to everyone. See the Admin Guide for the full walkthrough.
/chat settingsUtility Commands
/chat customize
Open your personal chat appearance settings. Available to every player (this one is not admin-only). You can also open it by clicking the gear icon in the chat header.
/chat customizeOpens a panel where you can customize, for yourself:
- Chat position
- Font size
- Fade time
- Background opacity
- Per-type visibility and colors
These settings are saved on your own computer and only affect what you see. They do not change anything for other players. For the server-wide settings an admin controls, see /chat settings and the Admin Guide.
Adding Custom Commands
Adding a Job Radio or Custom Channel (no code, no restart)
The supported way to add your own slash commands is the custom channel system, and it needs no file editing at all. An admin opens /chat settings, goes to Messaging → Chat Types, clicks Add, fills in the command, styling, and access rules, then presses Save Changes. The new command works immediately for everyone allowed to use it.
This covers most of what servers want a new command for: job radios, staff chat, business or event channels, and even short-range local radios. Each channel can have its own command and aliases, its own colors, and rules for who may send and who sees it. See the Admin Guide for a full walkthrough of every field (command, aliases, scope, restriction, jobs, cooldown, and so on).
Adding a brand-new roleplay command (needs an update)
The five roleplay commands — /me, /do, /whisper, /shout, and /looc — are built into the resource's code. Adding a new one of this kind (for example a /try command that rolls a 50/50 chance) is not something you can do from the config files, because the part that wires the command up lives in the encrypted portion of the resource.
If you need a new roleplay-style command that the custom-channel system above can't express, contact Oxide Studios support and we'll add it for you.