Skip to Content
Mavix

Chat System

The chat window, its roleplay commands and the job chats.

The chat is where players type roleplay actions, talk out of character, post adverts and use commands.

How it works

Press T to open the chat and type a message or a command. Each kind of message has its own colour, so it is easy to see what is an action, an out-of-character message or a job message. When you start typing /, the chat suggests commands. There is also an emoji picker and a settings button.

The chat: each message type has its own label, with command chips under the box.
The chat: each message type has its own label, with command chips under the box.

Keys & commands

Key / commandWhat it doesWho
TOpens the chatEveryone
/me <text>An action, for example /me opens the door. Only players near you see it. If you wear a mask, your name is hidden.Everyone
/do <text>A description, for example /do the door is locked. Only players near you see it.Everyone
/ooc <text>Out-of-character message to everyoneEveryone
/tweet <text>A Twitter-style post to everyoneEveryone
/yellowpages <text>An advert to everyone. Costs $500 from your bank.Everyone
/whisper <id> <text>A private message to one playerEveryone
/showidentityShows your name, gender, date of birth and job to players right next to youEveryone
/charinfoShows your own name, job, bank and cashEveryone
/clearchatClears your chatEveryone
/playmusic <link>Plays music from a link around you. Players near you hear it too. /stopmusic stops it, /musicvolume <0-100> sets the volume.Everyone
/police <text>Message to all policePolice
/emschat <text>Message to all EMSEMS
/gang <text>Message to the members of your own gangGang members
/announce <text>A server-wide announcementAdmins
/adminwhisper <text>A message to staffAdmins

Other systems add their own commands to the chat, for example /hud (HUD System) and /report (Misc Systems).

Config options

File: [cfx]/[gameplay]/mvx_chat/Config.lua

OptionWhat it changesExample
Config.ShowChatKeyKey that opens the chat'T'
Config.YellowPageFeeBank money a yellow pages advert costs. 0 makes it free.500
Config.EnableEmojiMenuShows the emoji pickertrue
Config.OOCMessageWithoutCommandIf true, a message without a command is sent as OOCfalse
Config.DefaultSuggestionsCommands shown first in the suggestions{ command = 'me', color = '#00000098' }
Config.TypeColorsThe colour of each kind of message

Restart mvx_chat after a change.

Admin Quick Test

A second player helps to check who sees what. Their server ID is <id> below (press F9 to see IDs).

Setup

  1. Type /setjob me unemployed 0 and /giveaccountmoney me bank 1000.
  2. Ask the second player to stand next to you.

Stage 1: roleplay messages

  1. Press T. The chat opens and suggests commands when you type /.
  2. Type /me waves. You and the player next to you see it in the "me" colour with your name.
  3. Ask the second player to walk more than 10 m away and type /do the door is locked. They no longer see it.
  4. Put on any mask (clothing store or the Appearance System) and type /me nods. The name shows as Anonymous.

Stage 2: messages to everyone

  1. Type /ooc hello. Every player sees it, wherever they are.
  2. Type /tweet first post. Every player sees a Twitter-style post.
  3. Type /yellowpages Test advert. Every player sees the advert and $500 leaves your bank. Check with /charinfo before and after: the bank is $500 lower.
  4. Type /whisper <id> hi. Only that player sees it.

Stage 3: personal commands

  1. Type /charinfo. Only you see your name, job, bank and cash.
  2. Type /showidentity with the second player right next to you (under 3 m). They see your name, gender, date of birth and job.
  3. Type /playmusic <a music link>. Music plays around you and the second player hears it nearby. /musicvolume 20 makes it quieter, /stopmusic stops it.
  4. Type /clearchat. Your chat is empty.

Stage 4: job and admin chats

  1. Type /police test. Nothing is sent, because you are not police.
  2. Type /setjob me police 0 and /police test again. Only players on the police job see it.
  3. Type /setjob me ambulance 0 and /emschat test. Only players on the ambulance job see it.
  4. Type /announce Server test. Every player sees the announcement. /adminwhisper test goes to staff only.

The end. Roleplay messages stay within 10 m, OOC, tweets, adverts and announcements reach everyone, a yellow pages advert costs $500 from the bank, and job chats only reach that job.

If it doesn't work: the player does not have $500 in the bank for an advert, the job name is wrong for job chats, the player is not an admin for /announce, or a message was sent again too fast (there is a short wait).

On this page