From ec42acc5001497157a6db824ad5414c1a79d2801 Mon Sep 17 00:00:00 2001
From: tduva
Note: This feature must be enabled in the Settings + under "Commands" (otherwise replacements in labels have no effect).
+ +You can use Custom Command replacements in the label of inline commands + or submenus. The label is updated:
+ +For example if you have a counter command that increases a number, it
+ could show the current number in the menu entry label by reading it from
+ the settings via $get()
:
+Increase counter ($get(var,c))=/set2 var c $calc($get(var,c) + 1) +
You can also use this to hide an entry, by adding a required replacement,
+ like $$is(mystatus:M)
, which will cause the entire label to
+ be empty if you are not a mod in the channel and thus will not be added
+ to the menu. Just adding $$is(mystatus:M)
will add true
+ if you are a mod, so you can wrap it in an $if()
(in this
+ example it's a submenu called "Mod Menu"):
+@$if($$is(mystatus:M),Mod Menu) +
Note: Compared to identifiers + for regular commands, some information may be missing in the context of + labels and restrictions.
+ +Note: This feature must be enabled in the Settings + under "Commands" (otherwise added restrictions have no effect).
+ +You can add restrictions to individual menu entries or a group of + entries. The restriction is applied (entries added or removed):
+ +The restriction must always be on it's own line and start and + end with a square bracket, which contain a Custom Command that is + surrounded by spaces. If the Custom Command returns a non-empty value + the menu entries will show up, otherwise they are hidden.
+ +[ <restriction using custom command> ]
[<name> <restriction using custom command> ]
<name>
+ is used to identify where the section ends. Different restrictions
+ can be nested inside eachother, causing them all to be applied to
+ the affected menu entries.[/<name>]
Example:
+ ++[mod $is(mystatus:M) ] +@Modes +.Emoteonly[E]=/emoteonly +.Emoteonly Off[O]=/emoteonlyoff +.Subsonly[S]=/subscribers +.Subsonly Off[D]=/subscribersoff +Clear[C]=/clear + +[ $ifeq($datetime(M),9,true) ] +/Subtember +[/mod] + +[ $is(chan:joshimuz\,botimuz) ] +/JoshFAQ /JoshSub +
The "Modes" submenu, the "Clear" command and the "Subtember" command only
+ show when you are a mod in the channel. The $is()
+ function uses Highlight syntax
+ and returns an empty value if it doesn't match. It's that Custom Command
+ part that defines the actual restriction, the "mod" in [mod ... ]
+ is arbitrarily named, it just has to match the closing [/mod]
.
The "Subtember" command has an additional requirement though, defined
+ directly above it, which uses the functions $ifeq()
and $datetime()
to
+ only show the menu entry when the month is September.
The "/JoshFAQ" and "/JoshSub" commands only show in the channel #joshimuz
+ or #botimuz. Note that the \,
between the channel names
+ requires the backslash to escape the comma,
+ meaning it tells the Custom Command parser that the comma isn't meant as
+ a function parameter separator, but rather to separate the channels in
+ the Highlighting syntax.
Note: Compared to identifiers + for regular commands, some information may be missing in the context of + labels and restrictions.
+In the User Dialog Buttons setting you can use some special commands:
diff --git a/help/help-guide2.html b/help/help-guide2.html index 26f81d9..533defc 100644 --- a/help/help-guide2.html +++ b/help/help-guide2.html @@ -20,7 +20,7 @@If you can't fix this problem and there are no other error messages that
may indicate what is going wrong, then you can still proceed with opening the
- link by clicking on "Open URL" in the dialog (or this link, which has all permissions Chatty needs). Chatty won't be able to
+ link by clicking on "Open URL" in the dialog (or this link, which has all permissions Chatty needs). Chatty won't be able to
receive the token automatically (your browser will tell you that it can't
load the page when you get to http://127.0.0.1:61324
), so you have to
read on in the next section, especially
diff --git a/help/help-releases.html b/help/help-releases.html
index c1d212d..1354c19 100644
--- a/help/help-releases.html
+++ b/help/help-releases.html
@@ -17,6 +17,7 @@
+ 0.25 | 0.24.1 | 0.24 | 0.23 | @@ -74,7 +75,43 @@ full list of changes.
+### Twitch Features +- Added amount/currency next to Hype Chat messages, added `config:hypechat` + Highlighting prefix +- Switched to new follower API (only allows moderators to see the list of + followers, count is visible for everyone though) +- Added multi-month subs info to subscriber notifications +- Improved badge tooltips based on updated API information + +### Custom Commands +- Context Menu/User Dialog custom entries/buttons: + - Added ability to show entries only when they match certain restrictions + (for example based on channel or user status, see the Custom Commands help) + - Entries with empty labels now get removed, so using a required replacement + in a label can also serve to hide it based on certain conditions + - Added more context-specific parameters for use in labels and restrictions + - Added ability to use replacements in User Dialog button labels, like you can + in context menus as well +- Added settings to trigger commands when middle-clicking on user in chat + (equivalent to Ctrl+clicking, in the Settings under "Chat") + +### Other +- Select associated message in a few more cases when opening User Dialog +- Improved support for different `.wav` file formats +- Updated Gradle to 8.2.1 (and related build changes) +- Updated Java for the Windows Standalone +- Updated help + +### Bugfixes +- Fixed channel status warning appearing in Admin Dialog when it shouldn't ++ +
diff --git a/help/help-settings.html b/help/help-settings.html index 39396a0..0c397dc 100644 --- a/help/help-settings.html +++ b/help/help-settings.html @@ -1085,6 +1085,7 @@
config:restricted
- Match messages by
restricted users shown only for moderators. Note that
messages by monitored users can not be matched yet.config:hypechat
- Match Hype Chat messages.blacklist:
to specify one or more text patterns
diff --git a/help/help-troubleshooting.html b/help/help-troubleshooting.html
index cf71da7..5736d5c 100644
--- a/help/help-troubleshooting.html
+++ b/help/help-troubleshooting.html
@@ -34,6 +34,7 @@
If Chatty can't access some files (e.g. sounds), you may have to give the
+ JAR Launcher additional access. Go to System Preferences - Security -
+ Privacy - Full Disk Access
and add the Jar Launcher.app
+ to the list.
+ More information..