-
Notifications
You must be signed in to change notification settings - Fork 7
Chat Tabs
Chat Tabs are mainly used for grouping similar messages together, like party chat, so that they are easily accessible in one place.
Note: Use PCERE2 flavor when testing Regex Patterns
Config > Chat Windows/Tabs > Chat Tabs > Chat Tabs
A single tab can appear/function different based on the server you are on. In order to account for that, you can create multiple
Tab Settingsfor the single tab, and customize theServer Pattern. The tab's settings are then switched based on whichServer Patternmatches the server's IP.
Name of the tab.
Regex Pattern Represents the regex pattern to use when deciding if messages should be added to the tab.
Ex.^Party >.*will add any message that starts withParty >to the tab.
Ex..*(?i)lowball.*will add any message that contains withlowball(ignoring lower/upper case) to the tab.
Link to test your expressions
Whether to use the formatted message or the raw message.
Mainly used for filtering between player and server messages since players cannot normally send messages with color.
Ex. The server can send the message§9Party §8>, if you had the regex
.*Party >.*then a player could send the messageParty >and it will be added to the tab. Using this option and adding the color codes to the regex will prevent that..*#5555ffParty §555555>.*
Link to color codes
If you want to filter for bolt/italics/etc it would look like so:#aa0000&l&o&n&m&ktest message, you MUST follow the ordering (color, isBold, isItalic, isUnderline, isStrikethrough, isObfuscated).
Ex. iftest message is RED and BOLDthe filter would be#ff5555<est message, iftest message is UNDERLINED and OBFUSCATEDthe filter would be&n&ktest message
Color =#000000 (hex color)
isBold =&l
isItalic =&o
isUnderline =&n
isStrikethrough =&m
isObfuscated =&k
Note: Everytime a message changes in format, you must redeclare the whole formatted filter. Ex.test message 1wheretest messageisREDbutmessageisRED and BOLDand1isRED and BOLD and ITALIC, then the filter would be#ff5555test #ff5555&lmessage #ff5555&l&o1
Text to prepend when sending messages in this tab.
Ex. I had a tab calledPartywhich contains all party messages and the auto prefix/pchat. Whenever I type in the tab, /pchat will be automatically prepended to my messages.hellowould become/pchat hello.
Priority of the tab. When adding messages, tabs are sorted by highest priority first. By default, if a message got added to a tab, tabs with a lower priority will be skipped.
Mainly used when an incoming message can be matched to multiple tabs and you only want the message to be added to a specific tab(s).
Ex. I only wantPartymessages to be added to thePartytab. I would set thePartytab higher than theAlltab.
Note: Messages that are added to a tabs will not skip other tabs with the same priority.
Always add messages to this tab regardless of priority, this tab's priority is also ignored.
Mainly used for overriding the above option.
Ex. I want theAlltab to have all messages but its priority is lower than another tab(s) (assuming the message can be added to the other tab(s)). This option will ensure the message will be added to theAlltab.
Skip other tabs if this tab is matched. Overrides Always Add.
Mainly used for overriding the above option.
Ex. If I have an exclusive tab with high priority for specific messages and I don't want other tab(s), with Always Add enabled, to contain it.
Pattern: (From|To) (\[.*?\]\s)?(\w+):\s(.*)
Tab Name Formatter: DM %GROUP_3%
Regex/Pattern Formatter: (From|To) (\[.*?\])?\s?%GROUP_3%:\s(.*)
Auto Prefix Formatter: /msg %GROUP_3%
Example Explanation:
Receive:
From [VIP+] CoolGuy: Hello World
Group 1:From
Group 2:[VIP+]
Group 3:CoolGuy
Group 4:Hello World
Tab Name Formatter:DM %GROUP_3%>DM CoolGuy(Name of new tab)
Regex/Pattern Formatter:(From|To) \[.*?\]\s?%GROUP_3%:\s(.*)>(From|To) \[.*?\]\s?CoolGuy:\s(.*)(The new tab will now match any message with this regex, which is any message From/To CoolGuy)
Auto Prefix Formatter:/msg %GROUP_3%>/msg CoolGuy(This becomes the new auto prefix for the new tab, if I type in this new tab it will send the message as a DM to CoolGuy)
Note: If you want the DM/any future DMs to ONLY go to the newly created tab, make sure you also set the priority higher than other tabs and skip others is true.
Pattern: \[((You -> (\w+))|((\w+) -> You))\] .* (Two parts)
Tab Name Formatter: DM %GROUP_3%%GROUP_5%%
Regex/Pattern Formatter: \[((You -> %GROUP_3%%GROUP_5%)|(%GROUP_3%%GROUP_5% -> You))\] .*
Auto Prefix Formatter: /msg %GROUP_3%%GROUP_5%
Example Explanation:
Receive:
[You -> Bob_123] Hello(Matches first part((You -> (\w+)))
Group 1:You -> Bob_123
Group 2:You -> Bob_123
Group 3:Bob_123
Receive:[Bob_123 -> You] Hello(Matches second part((\w+) -> You)))
Group 1:Bob_123 -> You
Group 4:Bob_123 -> You
Group 5:Bob_123
Note: You are allowed to stack the group indexes assuming they don't stack. Any %GROUP_X% that is not found is removed when the formatter is ran.
Tab Name Formatter (First part example):DM %GROUP_3%%GROUP_5%%>DM Bob_123(Group 5 not found, so it is removed ~DM %GROUP_3%)
Skip matching other tabs if this regex is matched. Ex. I receive a DM in the
Alltab but I want the DM to go into its own tab, and SKIPAll.
Regex Pattern
Represents the regex pattern to use when deciding if messages should be matched, basically the same as regular tab pattern above.
IMPORTANT: Make sure you use regex groups in order to correctly create the tab, see example above. Use %GROUP_X%, where X is the group number, to reference the group matched from the auto tab pattern.
The name of the newly created tab.
The regex pattern of the newly created tab.
The auto prefix of the newly created tab.
You can change the order of tabs by opening your chat. enabling movable chat, then click, hold, and drag the tab to the position you want it to be in.
, if you had the regex