Chat: Difference between revisions

From BadWolfMC Wiki
m (Removed protection from "Chat")
 
(39 intermediate revisions by the same user not shown)
Line 1: Line 1:
__FORCETOC__
__FORCETOC__
== General Chat & Messaging ==
== General Chat & Messaging ==
* '''/msg''' - Followed by a username (e.g. /msg mercurialmusic), this sends a private message to the target player. You can also click a user's prefix to auto-populate the /msg [playername] command.
* '''/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.
* '''/reply''' 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!
* '''/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.
* '''/ignore''' - Followed by a username (e.g. /ignore mercurialmusic), this will ignore all private messages from a particular player.
* '''/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!
* '''/me''' - Emotes in the third person (e.g. "/me smiles" would print "*merc smiles")
* '''/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.
* '''/messagetoggle''' or '''/mtoggle''' - Want some quiet? This toggles your ability to receive private messages from all players.
* '''/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.
* '''<item>''' - Using this tag in a chat message inserts the name of your currently active item (in your main hand) and adds hover context to show enchantments, lore, etc.


== Chat Channels ==
== Chat Channels ==
* '''/chlist''' - Lists the available chat channels. These currently include:
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:
{| class="wikitable"
{| class="wikitable"
|-
|-
! '''Channel''' !! '''[alias]''' !! '''Description'''
! '''Channel''' !! '''Alias'''  
!Quick Prefix!! '''Description'''
|-
|-
| Global|| [g] || Typical global chat.
| Global|| /g, /global
|!|| Typical global chat.
|-
|-
| Local|| [l] || 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.
| 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.
| RolePlay|| [rp] || To be used for role play chat.
|-
| Trade|| [t] || For advertising your shop or requesting a trade.
|}
|}


* '''/channel [channel]''' or '''/ch [alias]''' - Focuses the desired channel in your chat -- all messages that you type will appear in your focused channels. Example: "/ch g" will focus the global channel.
* '''/channel [channel]''' - Focuses the desired channel in your chat -- all messages that you type will appear in your focused channels.
* '''/leave [channel]''' - Tired of seeing the role play chats? Leave the channel!
* '''/leave [channel]''' - Want some quiet? Leave the channel! Just don't forget that you left it...
* '''/join [channel]''' - Want to join a role play game after previously leaving the channel? Join the channel again here.
* '''/join [channel]''' - Rejoins a previously left channel.
* '''/listen [channel]''' - Listen to a channel without focusing it as the channel you're chatting in.
* '''/chwho [channel]''' - Lists the members listening on a particular channel.


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


* '''/party help''' - Use this for a quick command reference.
* '''/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 host''' - 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. This command is a toggle, so doing /party host again will end the party.
* '''/party invite [playerName]''' - Invites the target player to your party chat.
* '''/party join [player]''' - Join your friend's party!
* '''/party disband''' - Removes the active party.
* '''/party accept [playerName]''' - Join your friend's party!
* '''/party leave''' - Leave the party.
* '''/party leave''' - Leave the party.
* '''/party kick [player]''' - Kick the specified player from your own party.
* '''/party ban [player]''' - Prevents a player from joining your party. This feature does not seem to be working right now.
* '''/party unban [player]''' - Unban a player from your party.
* '''/party chat [on|off]''' - Focuses the party chat. This is slightly different from the channels since it requires either "/party chat on" or "/party chat off".  If this is toggled on you will receive an error message if you try to chat without being in a party.


== Color & Formatting Codes ==
Minecraft allows for some formatting in chat, item names, books, and signs using [https://www.w3schools.com/colors/colors_picker.asp hex codes] and/or special prefixes or tags. Since they are entirely cosmetic, use of these codes is limited to our [[Rank system|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><nowiki><b>Hello World!</b></nowiki></red>" would appear as "<span style="color:red">'''Hello World!'''</span>". While "<nowiki><yellow>Hello <blue>World</blue>!</nowiki>" would appear as "<span style="color:yellow">Hello </span><span style="color:blue">World</span><span style="color:yellow">!</span>". Note that in the latter example the <nowiki><yellow></nowiki> tag was not closed so it continues beyond the <nowiki><blue></nowiki> tag in the same line, making nested tags possible. Legacy color and formatting codes also work in chat.
{| class="wikitable"
|+MiniMessage Tags
!Name
!Tag
!Description
!Example
|-
|Color
|<_colorname_>
|Accepts a hex code in #rrggbb format or any minecraft color constant: <code>black</code>, <code>dark_blue</code>, <code>dark_green</code>, <code>dark_aqua</code>, <code>dark_red</code>, <code>dark_purple</code>, <code>gold</code>, <code>gray</code>, <code>dark_gray</code>, <code>blue</code>, <code>green</code>, <code>aqua</code>, <code>red</code>, <code>light_purple</code>, <code>yellow</code>, or <code>white</code>.
|
* <code><yellow>Hello <blue>World</blue>!</code>
|-
|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.
|
* <code><color:yellow>Hello <color:blue>World</color:blue>!</code>
|-
|Decoration
|<_decorationname_>
|Accepts bold (or b), italic (or i), underlined (or u), and strikethrough (or st).
|
* <code><underlined>This is <bold>important</bold>!</code>
|-
|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.
|
* <code><rainbow>Your text here!</rainbow></code>
* <code><rainbow:!>Your text here!</rainbow></code>
* <code><rainbow:2>Your text here!</rainbow></code>
* <code><rainbow:!2>Your text here!</rainbow></code>
|-
|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.
|
* <code><gradient:#5e4fa2:#f79459>Your text here!</gradient></code>
* <code><gradient:#5e4fa2:#f79459:red>Your text here!</gradient></code>
|}
==== External Formatting Tools ====
[https://webui.advntr.dev/ Adventure's MiniMessage Viewer] can be used to test and preview your formatting. Please note that we have disabled tags not listed above to avoid abuse.
[https://www.simplymc.art/Gradients/ 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 "<span style="color:red">Hello World!</span>". 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>}'''&l'''BadWolfMC{#5555FF<}" would produce a bold gradient as: <span style="color:#17B4E6">'''B'''</span><span style="color:#1FA8E9">'''a'''</span><span style="color:#279CEC">'''d'''</span><span style="color:#2E90EF">'''W'''</span><span style="color:#3685F3">'''o'''</span><span style="color:#3E79F6">'''l'''</span><span style="color:#466DF9">'''f'''</span><span style="color:#4D61FC">'''M'''</span><span style="color:#5555FF">'''C'''</span>. Note that multiple color gradients in the same expression would still require a new formatting code after each new hex code, for example, "{#17B4E6>}'''&l'''Bad{#2E90EF<>}'''&l'''WolfMC{#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 "<span style="color:red">Hello World!</span>". The full list of character codes can be seen in game using the '''/colors''' command and are as follows:
{| class="wikitable"
|-
! Color Name !! Legacy Code !! Hex Code
|-
| <span style="color:#AA0000">Dark Red</span> || &4 || #AA0000
|-
| <span style="color:#FF5555">Red</span> || &c || #FF5555
|-
| <span style="color:#FFAA00">Gold</span> || &6 || #FFAA00
|-
| <span style="color:#FFFF55">Yellow</span> || &e || #FFFF55
|-
| <span style="color:#00AA00">Dark Green</span> || &2 || #00AA00
|-
| <span style="color:#55FF55">Green</span> || &a || #55FF55
|-
| <span style="color:#00AAAA">Dark Aqua</span> || &3 || #00AAAA
|-
| <span style="color:#55FFFF">Aqua</span> || &b || #55FFFF
|-
| <span style="color:#0000AA">Dark Blue</span> || &1 || #0000AA
|-
| <span style="color:#5555FF">Blue</span> || &9 || #5555FF
|-
| <span style="color:#AA00AA">Dark Purple</span> || &5 || #AA00AA
|-
| <span style="color:#FF55FF">Light Purple</span> || &d || #FF55FF
|-
| <span style="color:#FFFFFF">White</span> || &f || #FFFFFF
|-
| <span style="color:#AAAAAA">Gray</span> || &7 || #AAAAAA
|-
| <span style="color:#555555">Dark Gray</span> || &8 || #555555
|-
| <span style="color:#000000">Black</span> || &0 || #000000
|-
| '''Bold''' || &l || <nowiki><b></nowiki>
|-
| <s>Strikethrough</s> || &m || <st>
|-
| <u>Underline</u> || &n || <nowiki><u></nowiki>
|-
| ''Italic'' || &o || <nowiki><i></nowiki>
|-
| Reset Code || &r || <reset>
|}
{{Ambox
| name  =
| type  = notice
| text  = <div>
Use of a color code will reset all formatting codes used previously, so if you'd like to format the text as well be careful to use the color code before the formatting code. For example, "&4&lHello World!" will return "<span style="color:red">'''Hello World!'''</span>" while using "&l&4Hello World!" will simply return "<span style="color:red">Hello World!</span>". Reset codes are used to reset all previously used color and formatting codes to the default color (white for chat and item names, black for books and signs).
</div>
}}
== 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.
[[Category:Tutorials]]
[[Category:Tutorials]]

Latest revision as of 20:33, 26 January 2024

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.
  • <item> - Using this tag in a chat message inserts the name of your currently active item (in your main hand) and adds hover context to show enchantments, lore, etc.

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