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

FeatureDescription
AliasesMultiple names for the same command
ProximityDistance-based message delivery
Line of SightOptional visibility requirement
CooldownsRate limiting per command type
Job ValidationServer-side job verification

Roleplay Commands

Commands for in-character roleplay actions.

/me

Perform a roleplay action visible to nearby players.

/me waves hello to everyone

Output: * John Smith waves hello to everyone

PropertyValue
Range15 meters
Line of SightRequired
Cooldown1.5 seconds
StyleItalic, white text

/do

Describe an environment or action result.

/do The door swings open with a creak

Output: ** The door swings open with a creak [John Smith]

PropertyValue
Range15 meters
Line of SightRequired
Cooldown1.5 seconds
StyleItalic, gray text

/whisper (/w)

Speak quietly to nearby players.

/whisper Hey, can you hear me?
/w Follow me quietly

Output: John Smith whispers: Hey, can you hear me?

PropertyValue
Range3 meters
Line of SightNot required
Cooldown1.5 seconds
StyleAmber text

/shout (/s)

Yell to players in a large area.

/shout EVERYBODY GET DOWN!
/s POLICE! STOP!

Output: John Smith shouts: EVERYBODY GET DOWN!

PropertyValue
Range50 meters
Line of SightNot required
Cooldown1.5 seconds
StyleRed 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 minute

Output: [OOC] John Smith (5): I need to go AFK for a minute

PropertyValue
ScopeGlobal (all players)
Cooldown5 seconds
StyleAmber text with OOC prefix

/looc

Local out-of-character message visible to nearby players.

/looc Sorry, need to check my settings

Output: Uses OOC styling but only visible to nearby players.

PropertyValue
Range20 meters
Line of SightNot required
Cooldown1.5 seconds
StyleAmber 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 phone

Usage: /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?

PropertyValue
ScopePrivate (two players)
Cooldown1 second
StyleViolet 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]

PropertyValue
ScopePrivate
Cooldown1 second
RequirementMust 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 friends

Usage: /friend add [id] or /friend remove [id]

PropertyValue
ScopeThe two players involved
RequirementTarget 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 Square

Output: [LSPD] John Smith (Sergeant): 10-4, responding to the scene

PropertyValue
Required Jobpolice
ScopeAll police players
StyleBlue text with LSPD prefix

/medic (/ambulance)

Emergency medical services radio channel.

/medic Patient stabilized, en route to Pillbox
/ambulance Need a medic at the pier

Output: [EMS] John Smith (Paramedic): Patient stabilized, en route to Pillbox

PropertyValue
Required Jobambulance
ScopeAll EMS players
StyleRed text with EMS prefix

/mechanic (/mech)

Mechanic shop radio channel.

/mechanic Vehicle ready for pickup
/mech New job at LSIA

Output: [MECHANIC] John Smith (Mechanic): Vehicle ready for pickup

PropertyValue
Required Jobmechanic
ScopeAll mechanic players
StyleOrange 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 minutes

You 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
PropertyValue
PermissionAdmin (console bypasses the check)
ScopeAll players
Cooldown30 seconds (the console has no cooldown)
StyleRed 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
PropertyValue
PermissionAdmin (console bypasses the check)
ScopeServer-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
PropertyValue
PermissionAdmin (console bypasses the check)
ScopeAll 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 yourself

Run 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
PropertyValue
PermissionAdmin (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 settings

Utility 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 customize

Opens 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.

Next Steps