@chatformat
@chatformat
Section titled “@chatformat”@chatformat <object>[=<message>]
The chatformat attribute is evaluated when an object receives a channel message. If the attribute exists, its evaluated result is shown to the object instead of the default message. If the attribute exists but returns nothing, the object will not see anything.
Registers
- %0: The ‘type’ of the message. It is a single character that will always be set:
",;or:for say, semipose and pose, respectively|for an @cemit@for a “system” message - such as “Walker has connected.”- %1: The channel name. e.g: “Public”, “Admin”, “Softcode”
- %2: The message as typed (post-evaluation, if necessary) by the speaker. Be warned, though - if type is ’@’, then %2 will contain the entire message, and will include the name of the speaker that caused it
- %3: The speaker name, unless channel is set NO_NAME
- %4: The speaker’s channel title, unless none is set, or the channel is NO_TITLE
- %5: The default message, as shown when no chatformat is set
- %6: The ‘say’ string for the message. This will usually be “says”, unless altered by the SPEECHTEXT mogrifier
- %7: A space-separated list of extra options. Currently can contain: “silent” if a silent @cemit caused this message, otherwise “noisy”
If the channel is NO_NAME, and the speaker either has no title or the channel is also set NO_TITLE, then %3 will be “Someone”.
::: seealso
Wrapping channel messages
Section titled “Wrapping channel messages”Examples
Walker’s preferred @chatformat, which strips all ansi out, wraps every line to your width and prefixes them with <ChannelName>:
@chatformat me=<%1> [switch(%0,@,%2,edit(wrap(speak(&[if(%4,%4%b)]%3,%0[stripansi(%2)],%6\\,),sub(width(%!),add(4,strlen(%1)))),%r,%r<%1>%b))]If you’re on a system with chat_strip_quote set to “no”, you might want to change the ‘%0%2’ arg to speak() to ‘[switch(%0,\",%2,%0%2)]’
Suppose you want it just like the old version, but anytime somebody says your name, you want it all in red:
@chatformat me=ansi(switch(%2,*[name(%!)]*,r,n),%5)Channel color themes
Section titled “Channel color themes”A popular feature in clients now available in SharpMUSH directly: Let’s suppose you want “Public” channel chatter to all be green, “Softcode” to be blue and “Admin” to be cyan.
@chatformat me=ansi(switch(%1,Public,g,Softcode,b,Admin,c,n),%5)Maybe you dislike players who re-@name themselves a lot:
&playernames me=#6061:Walker #7:Javelin #6388:Cheetah@chatformat me=<%1> [switch(%0,@,%2,speak(&[if(%4,%4%b)][firstof(after(grab(v(playernames),%#:*),:),%3)],%2,%6\\,))]Or you’re writing a loggerbot, and you want to convert all channel input to HTML:
@chatformat me=CHAT:%1:[edit(switch(%0,@,%2,speak(if(%4,%4%b)%3,%0%2,%6\\,)),&,&,<,<,>,>,%r,<BR>,%b%b,%b )]or
@chatformat me=CHAT:%1:[render(switch(%0,@,%2,speak(if(%4,%4%b)%3,%0%2,%6\\,)),html)]