Changeset 1032 for 1.8.3/trunk/game/txt/hlp/pennchat.hlp

Timestamp:

07/08/07 20:50:12 (1 year ago)

Author:

shawnw

Message:

Merged 1.8.3p4 into trunk

Files:

• 1.8.3/trunk/game/txt/hlp/pennchat.hlp (modified) (3 diffs)

1.8.3/trunk/game/txt/hlp/pennchat.hlp

@@ -35 +35 @@
-
-See also: chat, CHAN_USEFIRSTMATCH
+& @CHATFORMAT
+  @chatformat <object>[= <message>]
+
+  The @chatformat attribute is evaluated when an object receives
+  a channel message. The evaluated result, is displayed to the
+  player, otherwise the default message is shown. A null result,
+  as long as the attribute exists, shows nothing.
+
+  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 original message.
+
+    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"
+
+(continued in help @chatformat2)
+See also: @chat, @pageformat, speak()
+& @CHATFORMAT2
+  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)]),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(if(strmatch(%2,*[name(%!)]*),r,n),%5)
+
+(More examples in help @chatformat3)
+& @CHATFORMAT3
+  A popular feature in clients now available in PennMUSH 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))]
+
+  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)),
+           &,&amp;,<,&lt;,>,&gt;,%r,<BR>,%b%b,%b&nbsp;)]
+
+See also: @chat, @pageformat, speak()
-& CHAN_USEFIRSTMATCH
-  CHAN_USEFIRSTMATCH (any type)
@@ -107 +174 @@
-  @channel/mute <channel> = <yes|no>
-  @channel/gag <channel> = <yes|no>
-
+|duration
-
-  Some channels broadcast messages when players connect or disconnect from
@@ -124 +191 @@
-  @channel/recall shows you the most recent messages on the channel;
-  the number of messages depends on how the channel is configured, but
-
-
+
+
+
+
-
-  See "help @channel4" for more.