Chat

From BadWolfMC Wiki
Revision as of 17:19, 22 January 2024 by Merc (talk | contribs) (Minor formatting/corrections)

General Chat & Messaging

  • /msg [playerName] (message) - Followed by a username (e.g. /msg mercurialmusic), this sends a private message to the target player. You can also click a user's name in chat (even if they're on another server) to auto-populate the /msg [playername] command.
  • /continue (message) or /c (message) - Continues the conversation with the last person you messaged. Useful when there's a lot of cross chatter to avoid confusing replies.
  • /reply (message) or /r - Followed by your message (e.g. /r hi!), this quickly and privately responds to the last player who messaged you. Be careful with this one if you have multiple conversations going!
  • /togglemsg or /togglepm - Want some quiet? This toggles your ability to receive private messages from all players. Also available from the Options Menu in /menu > options.
  • /ignore [playerName] or /block [playerName] - Followed by a username (e.g. /ignore mercurialmusic), this will ignore all public and private messages from a particular player.
  • /ignorelist - Allows you to see and manage your currently ignored players.
  • /unignore [playerName] or /unblock [playerName] - Removes the target player from your ignore list.
  • /me (message) - Emotes in the third person (e.g. "/me smiles" would print "*merc smiles"). This is only visible on the server you are currently connected to.
  • /mail send [playerName] (message) - sends mail to the target player whether online or offline. Usernames for offline players must be accurate.
  • /mail read - reads any received mail messages.
  • /mail clear - clears all mail messages from your inbox.

Chat Channels

Channels can be focused so that all of your normal chats go into that channel. If you prefer not to leave your currently focused channel you can prefix your message with either the alias command or the quick prefix so that only that prefixed chat goes into the target channel. The current list of publicly available chat channels are as follows:

Channel Alias Quick Prefix Description
Global /g, /global ! Typical global chat.
Local /l, /local Limited to players within a 230 block radius. This channel is highly recommended when working in close proximity to someone else to keep global chat sane.
  • /channel [channel] - Focuses the desired channel in your chat -- all messages that you type will appear in your focused channels.
  • /leave [channel] - Want some quiet? Leave the channel! Just don't forget that you left it...
  • /join [channel] - Rejoins a previously left channel.

Party Chat

You can also create your own temporary chat channels called party chats!

  • /party create - Host a party! After starting a party you can message your friends to join it. Note that while the party isn't publicly broadcast, anyone can still join it.
  • /party invite [playerName] - Invites the target player to your party chat.
  • /party disband - Removes the active party.
  • /party accept [playerName] - Join your friend's party!
  • /party leave - Leave the party.

Color & Formatting Codes

Minecraft allows for some formatting in chat, item names, books, and signs using hex codes and/or special prefixes or tags. Since they are entirely cosmetic, use of these codes is limited to our Diamond members. This system allows for the addition of exactly 16,777,216 colors to the game! Because no set format was defined by Mojang, plugin authors have created a patchwork of formats that differ depending on where you would like to use them.

Chat & Private Messages Format

BadWolfMC Chat uses Adventure's MiniMessage format which employs angle brackets ("<" and ">") for ridiculously easy chat formatting similar to BBCode or HTML. Multiple tags can be used on a single chat element, either as just a prefix "<[tag]>" or with a closing tag "</[tag]>" so that different formatting can be applied to multiple chat elements and across elements in the same line of text. For example, "<red><b>Hello World!</b></red>" would appear as "Hello World!". While "<yellow>Hello <blue>World</blue>!" would appear as "Hello World!". Note that in the latter example the <yellow> tag was not closed so it continues beyond the <blue> tag in the same line, making nested tags possible. Legacy color and formatting codes also work in chat.

MiniMessage Tags
Name Tag Description Example
Color <_colorname_> Accepts a hex code in #rrggbb format or any minecraft color constant: black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow, or white.
  • <yellow>Hello <blue>World</blue>!
Color (verbose) <color:_colorNameOrHex_> A more verbose way of defining colors, useful when using several tags at once. Accepts the same hex or color names as the Color tag.
  • <color:yellow>Hello <color:blue>World</color:blue>!
Decoration <_decorationname_> Accepts bold (or b), italic (or i), underlined (or u), and strikethrough (or st).
  • <underlined>This is <bold>important</bold>!
Reset <reset> Closes all currently open tags, resetting color/decoration/etc. The reset tag cannot be closed. Best practice is to not rely on the reset tag and simply close any open tags using </[tag]>
Rainbow <rainbow:[!][phase]> Rainbow text! The ! option reverses the current rainbow order while the phase option modifies the color the rainbow begins with.
  • <rainbow>Your text here!</rainbow>
  • <rainbow:!>Your text here!</rainbow>
  • <rainbow:2>Your text here!</rainbow>
  • <rainbow:!2>Your text here!</rainbow>
Gradient <gradient:[color1]:[color...]:[phase]> Accepts a list of 1 to n colors, either hex or named colors and an optional phase parameter (range -1 to 1) allows you to shift the gradient around, creating animations.
  • <gradient:#5e4fa2:#f79459>Your text here!</gradient>
  • <gradient:#5e4fa2:#f79459:red>Your text here!</gradient>

External Formatting Tools

Adventure's MiniMessage Viewer can be used to test and preview your formatting. Please note that we have disabled events not listed above to avoid abuse.

SimplyMC's Gradient Generator is quite handy for finding the perfect hex code combinations.

Books, Items, and Signs Format

Non-chat formatting for books, item names, and signs can be achieved using the "{#rrggbb}Text" format. For example "{#FF0000}Hello World!" would appear as "Hello World!". With this method, many hex colors (currently slightly over 1,000) are also mapped directly to color names, so using "{#red}Hello World!" would achieve the same result. Note that this color mapping is different from the MiniMessage mapping, which is limited to the default Minecraft chat colors.

You can also use the /colorpicker command to bring up a clickable interface. Just click the color you want to populate the code in your chat bar or shift-click to insert it into existing text. From there it can be copied and pasted into anvils, etc.

Gradients in Books, Items, and Signs

Gradients can be achieved with hex codes using angle brackets to indicate direction of the gradient. The tag on the first color requires >, for example, {#red>}, colors in the middle require <>, for example {#green<>}, and the last color requires <, or {#blue<}. A fully formed gradient would look something like: "{#red>}The quick brown fox {#green<>}jumps over the lazy dog{#blue<}". The tags are picky and will fail if not accurately enclosed or if the color/hex code is poorly formed.

Formatting Codes in Books, Items, and Signs

Vanilla text formatting codes (e.g. bold, underline, etc.) can also be used with both legacy and hex codes, including in gradients. Similar to vanilla behavior, the formatting codes must be used after each unique hex code after the closing bracket of the hex code and before the text. For example, "{#17B4E6>}&lBadWolfMC{#5555FF<}" would produce a bold gradient as: BadWolfMC. Note that multiple color gradients in the same expression would still require a new formatting code after each new hex code, for example, "{#17B4E6>}&lBad{#2E90EF<>}&lWolfMC{#5555FF<}.

Legacy Character Codes

Text formatting is achieved by prefixing the text with an ampersand (&) immediately followed by a character code. For example, using "&4Hello World!" would appear as "Hello World!". The full list of character codes can be seen in game using the /colors command and are as follows:

Color Name Legacy Code Hex Code
Dark Red &4 #AA0000
Red &c #FF5555
Gold &6 #FFAA00
Yellow &e #FFFF55
Dark Green &2 #00AA00
Green &a #55FF55
Dark Aqua &3 #00AAAA
Aqua &b #55FFFF
Dark Blue &1 #0000AA
Blue &9 #5555FF
Dark Purple &5 #AA00AA
Light Purple &d #FF55FF
White &f #FFFFFF
Gray &7 #AAAAAA
Dark Gray &8 #555555
Black &0 #000000
Bold &l <b>
Strikethrough &m <st>
Underline &n <u>
Italic &o <i>
Reset Code &r <reset>

Nicknames

Diamond members are allowed a nickname in chat using these color codes, which must be set by an admin or moderator. Because of a character limit we are only able to use multiple colors using vanilla character codes, but can still use hex codes if only a single color or one color gradient using two colors is desired (for example {#green>}merc{#blue<}). Please note that the desired color(s) and format(s) must be legible in chat.